commenting headers already done, adding positions for filename and filepath, pos instead of Positions{}

This commit is contained in:
2019-08-07 11:52:03 +02:00
parent 4ceee97c03
commit cff4d162c1
3 changed files with 48 additions and 41 deletions

View File

@ -101,15 +101,15 @@ class Detector {
* @param pos detector positions * @param pos detector positions
* @returns file name prefix * @returns file name prefix
*/ */
Result<std::string> getFileName() const; Result<std::string> getFileName(Positions pos = {}) const;
/** /**
* Sets the receiver file name prefix * Sets the receiver file name prefix
* @param fname file name prefix * @param fname file name prefix
*/ */
void setFileName(const std::string &fname); void setFileName(const std::string &fname, Positions pos = {});
Result<std::string> getFilePath() const; Result<std::string> getFilePath(Positions pos = {}) const;
void setFilePath(const std::string &fname); void setFilePath(const std::string &fname, Positions pos = {});
Result<bool> getFileWrite(Positions pos = {}) const; Result<bool> getFileWrite(Positions pos = {}) const;
void setFileWrite(bool value, Positions pos = {}); void setFileWrite(bool value, Positions pos = {});
Result<bool> getFileOverWrite(Positions pos = {}) const; Result<bool> getFileOverWrite(Positions pos = {}) const;
@ -122,6 +122,10 @@ class Detector {
void setSubExptime(ns t, Positions pos = {}); void setSubExptime(ns t, Positions pos = {});
Result<ns> getPeriod(Positions pos = {}) const; Result<ns> getPeriod(Positions pos = {}) const;
void setPeriod(ns t, Positions pos = {}); void setPeriod(ns t, Positions pos = {});
// dhanya
}; };
} // namespace sls } // namespace sls

View File

@ -266,13 +266,13 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* Set acquiring flag in shared memory * Set acquiring flag in shared memory
* @param b acquiring flag * @param b acquiring flag
*/ */
void setAcquiringFlag(bool flag); void setAcquiringFlag(bool flag);//
/** /**
* Get acquiring flag from shared memory * Get acquiring flag from shared memory
* @returns acquiring flag * @returns acquiring flag
*/ */
bool getAcquiringFlag() const; bool getAcquiringFlag() const;//
/** /**
* Check if acquiring flag is set, set error if set * Check if acquiring flag is set, set error if set
@ -329,7 +329,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param multiId multi detector Id * @param multiId multi detector Id
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
*/ */
static void freeSharedMemory(int multiId, int detPos = -1); static void freeSharedMemory(int multiId, int detPos = -1);//
/** /**
* Free shared memory and delete shared memory structure * Free shared memory and delete shared memory structure
@ -361,7 +361,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @returns concatenated hostnames of all detectors or hostname of specific * @returns concatenated hostnames of all detectors or hostname of specific
* one * one
*/ */
std::string getHostname(int detPos = -1) const; std::string getHostname(int detPos = -1) const;//
/** /**
* Appends detectors to the end of the list in shared memory * Appends detectors to the end of the list in shared memory
@ -578,7 +578,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* Load configuration from a configuration File * Load configuration from a configuration File
* @param fname configuration file name * @param fname configuration file name
*/ */
void readConfigurationFile(const std::string &fname); void readConfigurationFile(const std::string &fname);//
/** /**
* Write current configuration to a file * Write current configuration to a file
@ -715,14 +715,14 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param val starting frame number * @param val starting frame number
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
*/ */
void setStartingFrameNumber(const uint64_t value, int detPos = -1); void setStartingFrameNumber(const uint64_t value, int detPos = -1);//
/** /**
* Get starting frame number for the next acquisition * Get starting frame number for the next acquisition
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns starting frame number * @returns starting frame number
*/ */
uint64_t getStartingFrameNumber(int detPos = -1); uint64_t getStartingFrameNumber(int detPos = -1);//
/** /**
* Set/get timer value (not all implemented for all detectors) * Set/get timer value (not all implemented for all detectors)
@ -742,7 +742,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @returns exposure time in ns, or s if specified * @returns exposure time in ns, or s if specified
*/ */
double setExposureTime(double t = -1, bool inseconds = false, double setExposureTime(double t = -1, bool inseconds = false,
int detPos = -1); int detPos = -1);//
/** /**
* Set/get exposure period * Set/get exposure period
@ -752,7 +752,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @returns exposure period in ns, or s if specified * @returns exposure period in ns, or s if specified
*/ */
double setExposurePeriod(double t = -1, bool inseconds = false, double setExposurePeriod(double t = -1, bool inseconds = false,
int detPos = -1); int detPos = -1);//
/** /**
* Set/get delay after trigger (Gotthard, Jungfrau(not for this release)) * Set/get delay after trigger (Gotthard, Jungfrau(not for this release))
@ -773,7 +773,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @returns sub frame exposure time in ns, or s if specified * @returns sub frame exposure time in ns, or s if specified
*/ */
double setSubFrameExposureTime(double t = -1, bool inseconds = false, double setSubFrameExposureTime(double t = -1, bool inseconds = false,
int detPos = -1); int detPos = -1);//
/** /**
* (Advanced users) * (Advanced users)
@ -959,7 +959,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns value read from register * @returns value read from register
*/ */
uint32_t readRegister(uint32_t addr, int detPos = -1); uint32_t readRegister(uint32_t addr, int detPos = -1);//
/** /**
* Set bit in a register. For Advanced users * Set bit in a register. For Advanced users
@ -968,7 +968,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns value read from register * @returns value read from register
*/ */
uint32_t setBit(uint32_t addr, int n, int detPos = -1); uint32_t setBit(uint32_t addr, int n, int detPos = -1);//
/** /**
* Clear bit in a register. For Advanced users * Clear bit in a register. For Advanced users
@ -977,7 +977,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns value read from register * @returns value read from register
*/ */
uint32_t clearBit(uint32_t addr, int n, int detPos = -1); uint32_t clearBit(uint32_t addr, int n, int detPos = -1);//
/** /**
* Validates the format of the detector MAC address and sets it * Validates the format of the detector MAC address and sets it
@ -1787,7 +1787,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns output file directory * @returns output file directory
*/ */
std::string getFilePath(int detPos = -1); std::string getFilePath(int detPos = -1);//
/** /**
* Sets up the file directory * Sets up the file directory
@ -1795,14 +1795,14 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param s file directory * @param s file directory
* @returns file dir * @returns file dir
*/ */
std::string setFilePath(const std::string &path, int detPos = -1); std::string setFilePath(const std::string &path, int detPos = -1);//
/** /**
* Returns file name prefix * Returns file name prefix
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns file name prefix * @returns file name prefix
*/ */
std::string getFileName(int detPos = -1); std::string getFileName(int detPos = -1);//
/** /**
* Sets up the file name prefix * Sets up the file name prefix
@ -1810,7 +1810,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param s file name prefix * @param s file name prefix
* @returns file name prefix * @returns file name prefix
*/ */
std::string setFileName(const std::string &fname, int detPos = -1); std::string setFileName(const std::string &fname, int detPos = -1);//
/** /**
* Sets the max frames per file in receiver * Sets the max frames per file in receiver
@ -1887,20 +1887,20 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* Receiver starts listening to packets * Receiver starts listening to packets
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
*/ */
void startReceiver(int detPos = -1); void startReceiver(int detPos = -1);//
/** /**
* Stops the listening mode of receiver * Stops the listening mode of receiver
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
*/ */
void stopReceiver(int detPos = -1); void stopReceiver(int detPos = -1);//
/** /**
* Gets the status of the listening mode of receiver * Gets the status of the listening mode of receiver
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns status * @returns status
*/ */
runStatus getReceiverStatus(int detPos = -1); runStatus getReceiverStatus(int detPos = -1);//
/** /**
* Gets the number of frames caught by receiver * Gets the number of frames caught by receiver
@ -1942,13 +1942,13 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns file write enable * @returns file write enable
*/ */
int setFileWrite(bool value, int detPos = -1); int setFileWrite(bool value, int detPos = -1);//
/** /**
* Gets file write enable * Gets file write enable
* @returns file write enable * @returns file write enable
*/ */
int getFileWrite(int detPos = -1) const; int getFileWrite(int detPos = -1) const;//
/** /**
* Sets/Gets receiver master file write enable * Sets/Gets receiver master file write enable
@ -1971,14 +1971,14 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns file overwrite enable * @returns file overwrite enable
*/ */
int setFileOverWrite(bool enable, int detPos = -1); int setFileOverWrite(bool enable, int detPos = -1);//
/** /**
* Gets file over write enable * Gets file over write enable
* @param detPos -1 for all detectors in list or specific detector position * @param detPos -1 for all detectors in list or specific detector position
* @returns file over write enable * @returns file over write enable
*/ */
int getFileOverWrite(int detPos = -1) const; int getFileOverWrite(int detPos = -1) const;//
/** /**
* (previously setReadReceiverFrequency) * (previously setReadReceiverFrequency)
@ -2212,7 +2212,7 @@ class multiSlsDetector : public virtual slsDetectorDefs {
* index, loops for measurements, calls required call backs. * index, loops for measurements, calls required call backs.
* @returns OK or FAIL depending on if it already started * @returns OK or FAIL depending on if it already started
*/ */
int acquire(); int acquire();//
/** /**
* Combines data from all readouts and gives it to the gui * Combines data from all readouts and gives it to the gui

View File

@ -96,34 +96,37 @@ void Detector::setPeriod(ns t, Positions pos) {
} }
// File // File
void Detector::setFileName(const std::string &fname) { void Detector::setFileName(const std::string &fname, Positions pos) {
pimpl->Parallel(&slsDetector::setFileName, Positions{}, fname); pimpl->Parallel(&slsDetector::setFileName, pos, fname);
} }
Result<std::string> Detector::getFileName() const { Result<std::string> Detector::getFileName(Positions pos) const {
return pimpl->Parallel(&slsDetector::setFileName, Positions{}, ""); return pimpl->Parallel(&slsDetector::setFileName, pos, "");
} }
void Detector::setFilePath(const std::string &fpath) { void Detector::setFilePath(const std::string &fpath, Positions pos) {
pimpl->Parallel(&slsDetector::setFilePath, Positions{}, fpath); pimpl->Parallel(&slsDetector::setFilePath, pos, fpath);
} }
Result<std::string> Detector::getFilePath() const { Result<std::string> Detector::getFilePath(Positions pos) const {
return pimpl->Parallel(&slsDetector::getFilePath, Positions{}); return pimpl->Parallel(&slsDetector::getFilePath, pos);
} }
void Detector::setFileWrite(bool value, Positions pos) { void Detector::setFileWrite(bool value, Positions pos) {
pimpl->Parallel(&slsDetector::setFileWrite, Positions{}, value); pimpl->Parallel(&slsDetector::setFileWrite, pos, value);
} }
Result<bool> Detector::getFileWrite(Positions pos) const { Result<bool> Detector::getFileWrite(Positions pos) const {
return pimpl->Parallel(&slsDetector::getFileWrite, Positions{}); return pimpl->Parallel(&slsDetector::getFileWrite, pos);
} }
void Detector::setFileOverWrite(bool value, Positions pos) { void Detector::setFileOverWrite(bool value, Positions pos) {
pimpl->Parallel(&slsDetector::setFileOverWrite, Positions{}, value); pimpl->Parallel(&slsDetector::setFileOverWrite, pos, value);
} }
Result<bool> Detector::getFileOverWrite(Positions pos) const { Result<bool> Detector::getFileOverWrite(Positions pos) const {
return pimpl->Parallel(&slsDetector::getFileOverWrite, Positions{}); return pimpl->Parallel(&slsDetector::getFileOverWrite, pos);
} }
// dhanya
} // namespace sls } // namespace sls