Visual Servoing Platform
version 3.3.0 under development (2020-02-17)
|
#include <visp3/core/vpIoTools.h>
Static Public Member Functions | |
static const std::string & | getBuildInformation () |
static void | getUserName (std::string &username) |
static std::string | getUserName () |
static std::string | getenv (const std::string &env) |
static std::string | getViSPImagesDataPath () |
static void | getVersion (const std::string &version, unsigned int &major, unsigned int &minor, unsigned int &patch) |
static bool | checkDirectory (const std::string &dirname) |
static bool | checkFifo (const std::string &filename) |
static bool | checkFilename (const std::string &filename) |
static bool | copy (const std::string &src, const std::string &dst) |
static void | makeDirectory (const std::string &dirname) |
static void | makeFifo (const std::string &dirname) |
static std::string | makeTempDirectory (const std::string &dirname) |
static std::string | path (const std::string &pathname) |
static bool | remove (const std::string &filename) |
static bool | rename (const std::string &oldfilename, const std::string &newfilename) |
static std::string | getAbsolutePathname (const std::string &pathname) |
static std::string | getFileExtension (const std::string &pathname, bool checkFile=false) |
static std::string | getName (const std::string &pathname) |
static std::string | getNameWE (const std::string &pathname) |
static std::string | getParent (const std::string &pathname) |
static std::string | createFilePath (const std::string &parent, const std::string &child) |
static bool | isAbsolutePathname (const std::string &pathname) |
static bool | isSamePathname (const std::string &pathname1, const std::string &pathname2) |
static std::pair< std::string, std::string > | splitDrive (const std::string &pathname) |
static std::vector< std::string > | splitChain (const std::string &chain, const std::string &sep) |
static std::vector< std::string > | getDirFiles (const std::string &dirname) |
static void | readBinaryValueLE (std::ifstream &file, int16_t &short_value) |
static void | readBinaryValueLE (std::ifstream &file, uint16_t &ushort_value) |
static void | readBinaryValueLE (std::ifstream &file, int32_t &int_value) |
static void | readBinaryValueLE (std::ifstream &file, uint32_t &int_value) |
static void | readBinaryValueLE (std::ifstream &file, float &float_value) |
static void | readBinaryValueLE (std::ifstream &file, double &double_value) |
static void | writeBinaryValueLE (std::ofstream &file, const int16_t short_value) |
static void | writeBinaryValueLE (std::ofstream &file, const uint16_t ushort_value) |
static void | writeBinaryValueLE (std::ofstream &file, const int32_t int_value) |
static void | writeBinaryValueLE (std::ofstream &file, const uint32_t int_value) |
static void | writeBinaryValueLE (std::ofstream &file, float float_value) |
static void | writeBinaryValueLE (std::ofstream &file, double double_value) |
static bool | parseBoolean (std::string input) |
static std::string | trim (std::string s) |
Configuration file parsing | |
static bool | loadConfigFile (const std::string &confFile) |
static bool | readConfigVar (const std::string &var, float &value) |
static bool | readConfigVar (const std::string &var, double &value) |
static bool | readConfigVar (const std::string &var, int &value) |
static bool | readConfigVar (const std::string &var, unsigned int &value) |
static bool | readConfigVar (const std::string &var, bool &value) |
static bool | readConfigVar (const std::string &var, std::string &value) |
static bool | readConfigVar (const std::string &var, vpColor &value) |
static bool | readConfigVar (const std::string &var, vpArray2D< double > &value, const unsigned int &nCols=0, const unsigned int &nRows=0) |
static void | setBaseName (const std::string &s) |
static void | setBaseDir (const std::string &dir) |
static void | addNameElement (const std::string &strTrue, const bool &cond=true, const std::string &strFalse="") |
static void | addNameElement (const std::string &strTrue, const double &val) |
static std::string | getBaseName () |
static std::string | getFullName () |
static void | saveConfigFile (const bool &actuallySave=true) |
static void | createBaseNamePath (const bool &empty=false) |
Static Public Attributes | |
static const char | separator |
Static Protected Attributes | |
static std::string | baseName = "" |
static std::string | baseDir = "" |
static std::string | configFile = "" |
static std::vector< std::string > | configVars = std::vector<std::string>() |
static std::vector< std::string > | configValues = std::vector<std::string>() |
File and directories basic tools.
The example below shows how to manipulate the functions of this class to create first a directory which name corresponds to the user name and then create a file in this directory.
The example below shows how to read a configuration file and how to create a name for experiment files. We assume the following file "/home/user/demo/config.txt" :
Definition at line 158 of file vpIoTools.h.
|
static |
Augments the prefix of the experiment files by strTrue if cond is verified, and by strFalse otherwise.
strTrue | : String to add if cond is true |
cond | : Condition managing the file name |
strFalse | : String to add if cond is false (default "") |
Definition at line 1215 of file vpIoTools.cpp.
References baseName.
|
static |
Augments the prefix of the experiment files by strTrue followed by val.
strTrue | : String to add |
val | : Value to add |
Definition at line 1231 of file vpIoTools.cpp.
References baseName.
|
static |
Check if a directory exists.
dirname | : Directory to test if it exists. The directory name is converted to the current system's format; see path(). |
Definition at line 422 of file vpIoTools.cpp.
References path(), and separator.
Referenced by checkFifo(), copy(), createBaseNamePath(), getDirFiles(), getFileExtension(), vpSimulatorAfma6::init(), vpSimulatorViper850::init(), vpSimulatorAfma6::initArms(), vpSimulatorViper850::initArms(), makeDirectory(), makeFifo(), makeTempDirectory(), vpServoData::open(), remove(), vpRobotFranka::setLogFolder(), and vpWireFrameSimulator::vpWireFrameSimulator().
|
static |
Check if a fifo file exists.
fifofilename | : Fifo filename to test if it exists. |
Definition at line 482 of file vpIoTools.cpp.
References checkDirectory(), vpException::notImplementedError, path(), and separator.
Referenced by makeFifo(), and remove().
|
static |
Check if a file exists.
filename | : Filename to test if it exists. |
Definition at line 730 of file vpIoTools.cpp.
References path().
Referenced by copy(), vpDot2::defineDots(), getFileExtension(), getViSPImagesDataPath(), vpAROgre::init(), vpRobotViper850::init(), vpMbTracker::initClick(), vpMbTracker::loadCAOModel(), vpMbTracker::loadModel(), makeFifo(), vpImageIo::read(), and remove().
|
static |
Copy a src file or directory in dst.
src | : Existing file or directory to copy. |
dst | : New copied file or directory. |
Definition at line 772 of file vpIoTools.cpp.
References checkDirectory(), checkFilename(), vpException::fatalError, and path().
Referenced by saveConfigFile().
|
static |
Creates the directory baseDir/baseName. If already exists, empties it if empty is true. Useful to save the images corresponding to a particular experiment.
empty | : Indicates if the new directory has to be emptied |
Definition at line 1250 of file vpIoTools.cpp.
References baseDir, baseName, checkDirectory(), makeDirectory(), and remove().
|
static |
Return the file path that corresponds to the concatenated parent and child string files by adding the corresponding separator for unix or windows.
The corresponding path is also converted. Under windows, all the "/" characters are converted into "\\" characters. Under Unix systems all the "\\" characters are converted into "/" characters.
Definition at line 1537 of file vpIoTools.cpp.
References path(), and separator.
Referenced by vpMbTracker::loadCAOModel().
|
static |
Returns the absolute path using realpath() on Unix systems or GetFullPathName() on Windows systems.
Definition at line 1495 of file vpIoTools.cpp.
References vpException::fatalError.
Referenced by isSamePathname(), and vpMbTracker::loadCAOModel().
|
static |
Gets the base name (prefix) of the experiment files.
Definition at line 250 of file vpIoTools.cpp.
References baseName.
|
static |
Return build informations (OS, compiler, build flags, used 3rd parties...).
Definition at line 225 of file vpIoTools.cpp.
|
static |
List of files in directory, in alphabetical order. There is no difference if pathname contains terminating backslash or not Unlike scandir(), does not return "." and ".."
pathname | : path to directory |
Definition at line 1796 of file vpIoTools.cpp.
References checkDirectory(), vpException::fatalError, and path().
Referenced by vpVideoReader::getFrame().
|
static |
Get the content of an environment variable.
env | : Environment variable name (HOME, LOGNAME...). |
vpIoException::cantGetenv | : If an error occur while getting the environment variable value. |
Definition at line 355 of file vpIoTools.cpp.
References vpIoException::cantGetenv.
Referenced by getUserName(), getViSPImagesDataPath(), vpSimulatorAfma6::init(), vpSimulatorViper850::init(), vpSimulatorAfma6::initArms(), vpSimulatorViper850::initArms(), and vpWireFrameSimulator::vpWireFrameSimulator().
|
static |
Returns the extension of the file or an empty string if the file has no extension. If checkFile flag is set, it will check first if the pathname denotes a directory and so return an empty string and second it will check if the file denoted by the pathanme exists. If so, it will return the extension if present.
pathname | : The pathname of the file we want to get the extension. |
checkFile | : If true, the file must exist otherwise an empty string will be returned. |
The following code shows how to use this function:
It produces the following output:
Definition at line 1357 of file vpIoTools.cpp.
References checkDirectory(), and checkFilename().
|
static |
Gets the full path of the experiment files : baseDir/baseName
Definition at line 256 of file vpIoTools.cpp.
|
static |
Returns the name of the file or directory denoted by this pathname.
Definition at line 1438 of file vpIoTools.cpp.
References path(), and separator.
Referenced by vpVideoReader::getFrame(), getNameWE(), vpMbTracker::loadCAOModel(), and vpVideoReader::setFileName().
|
static |
Returns the name of the file without extension or directory denoted by this pathname.
Definition at line 1460 of file vpIoTools.cpp.
References getName().
|
static |
Returns the pathname string of this pathname's parent.
Definition at line 1473 of file vpIoTools.cpp.
References path(), and separator.
Referenced by vpVideoReader::getFrame(), vpMbTracker::loadCAOModel(), vpKeyPoint::loadLearningData(), and vpKeyPoint::saveLearningData().
|
static |
Get the user name.
username | : The user name. When the username cannot be retrieved, set username to "unknown" string. |
Definition at line 271 of file vpIoTools.cpp.
References getenv().
|
static |
Get the user name.
Definition at line 318 of file vpIoTools.cpp.
|
static |
Extract major, minor and patch from a version given as "x.x.x". Ex: If version is "1.2.1", major will be 1, minor 2 and patch 1.
version | : String to extract the values. |
major | : Extracted major. |
minor | : Extracted minor. |
patch | : Extracted patch. |
Definition at line 382 of file vpIoTools.cpp.
|
static |
Get ViSP images data path. ViSP images data can be installed from Debian or Ubuntu visp-images-data package. It can be also installed from ViSP-images.zip that can be found on http://visp.inria.fr/download page.
This function returns the path to the folder that contains the data.
If the path is not found, returns an empty string.
Definition at line 1292 of file vpIoTools.cpp.
References checkFilename(), and getenv().
|
static |
Return whether a path is absolute.
Definition at line 1578 of file vpIoTools.cpp.
References splitDrive().
Referenced by vpMbTracker::loadCAOModel(), and vpKeyPoint::loadLearningData().
|
static |
Return true if the two pathnames are identical.
Definition at line 1602 of file vpIoTools.cpp.
References getAbsolutePathname(), and path().
|
static |
Reads the configuration file and parses it.
confFile | : path to the file containing the configuration parameters to parse. |
Definition at line 971 of file vpIoTools.cpp.
References configFile, configValues, configVars, vpMath::minimum(), and path().
|
static |
Create a new directory. It will create recursively the parent directories if needed.
dirname | : Directory to create. The directory name is converted to the current system's format; see path(). |
vpIoException::cantCreateDirectory | : If the directory cannot be created. |
Definition at line 572 of file vpIoTools.cpp.
References vpIoException::cantCreateDirectory, checkDirectory(), vpIoException::invalidDirectoryName, and path().
Referenced by createBaseNamePath(), vpServoData::open(), vpKeyPoint::saveLearningData(), and vpRobotFranka::setLogFolder().
|
static |
Create a new FIFO file. A FIFO file is a special file, similar to a pipe, but actually existing on the hard drive. It can be used to communicate data between multiple processes.
[in] | fifoname | : Pathname of the fifo file to create. |
vpIoException::invalidDirectoryName | : The dirname is invalid. |
vpIoException::cantCreateDirectory | : If the file cannot be created. |
Definition at line 623 of file vpIoTools.cpp.
References vpIoException::cantCreateDirectory, checkDirectory(), checkFifo(), checkFilename(), and vpIoException::invalidDirectoryName.
|
static |
Create a new temporary directory with a unique name based on dirname parameter.
dirname | : Name of the directory to create, or location of an existing directory. If dirname corresponds to an existing directory, dirname is considered as a parent directory. The temporary directory is then created inside the parent directory. Otherwise, dirname needs to end with "XXXXXX", which will be converted into random characters in order to create a unique directory name. |
vpIoException::invalidDirectoryName | : The dirname is invalid. |
vpIoException::cantCreateDirectory | : If the directory cannot be created. |
Definition at line 671 of file vpIoTools.cpp.
References vpIoException::cantCreateDirectory, checkDirectory(), and vpIoException::invalidDirectoryName.
|
static |
Definition at line 2019 of file vpIoTools.cpp.
Referenced by vpMbTracker::loadCAOModel().
|
static |
Converts a path name to the current system's format.
pathname | : Path name to convert. Under windows, converts all the "/" characters in the pathname string into "\\" characters. Under Unix systems converts all the "\\" characters in the pathname string into "/" characters. |
Definition at line 931 of file vpIoTools.cpp.
Referenced by checkDirectory(), checkFifo(), checkFilename(), copy(), createFilePath(), getDirFiles(), getName(), getParent(), isSamePathname(), vpMbTracker::loadCAOModel(), loadConfigFile(), makeDirectory(), vpImageIo::read(), and remove().
|
static |
Read a 16-bits integer value stored in little endian.
Definition at line 1860 of file vpIoTools.cpp.
Referenced by vpKeyPoint::loadLearningData().
|
static |
Read a 16-bits unsigned integer value stored in little endian.
Definition at line 1873 of file vpIoTools.cpp.
|
static |
Read a 32-bits integer value stored in little endian.
Definition at line 1886 of file vpIoTools.cpp.
|
static |
Read a 32-bits unsigned integer value stored in little endian.
Definition at line 1899 of file vpIoTools.cpp.
|
static |
Read a float value stored in little endian.
Definition at line 1912 of file vpIoTools.cpp.
|
static |
Read a double value stored in little endian.
Definition at line 1925 of file vpIoTools.cpp.
|
static |
Tries to read the parameter named var as a float.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. |
Definition at line 1018 of file vpIoTools.cpp.
References configValues, and configVars.
Referenced by readConfigVar().
|
static |
Tries to read the parameter named var as a double.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. |
Definition at line 1046 of file vpIoTools.cpp.
References configValues, and configVars.
|
static |
Tries to read the parameter named var as a int.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. |
Definition at line 1075 of file vpIoTools.cpp.
References configValues, and configVars.
|
static |
Tries to read the parameter named var as a unsigned int.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. |
Definition at line 1097 of file vpIoTools.cpp.
References readConfigVar().
|
static |
Tries to read the parameter named var as a bool.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. |
Definition at line 1113 of file vpIoTools.cpp.
References readConfigVar().
|
static |
Tries to read the parameter named var as a std::string.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. |
Definition at line 1145 of file vpIoTools.cpp.
References configValues, and configVars.
|
static |
Tries to read the parameter named var as a vpColor.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. See vpColor.cpp for the color number. |
Definition at line 1129 of file vpIoTools.cpp.
References vpColor::getColor(), and readConfigVar().
|
static |
Tries to read the parameter named var as a vpMatrix. If nCols and nRows are indicated, will resize the matrix. Otherwise, will try to read as many values as indicated by the dimension of value.
var | : Name of the parameter in the configuration file. |
value | : Value to be read. |
nCols | : Column dimension if resized. |
nRows | : Row dimension if resized |
Definition at line 1172 of file vpIoTools.cpp.
References configValues, configVars, vpArray2D< Type >::getCols(), vpArray2D< Type >::getRows(), and vpArray2D< Type >::resize().
|
static |
Remove a file or a directory.
file_or_dir | : File name or directory to remove. |
Definition at line 855 of file vpIoTools.cpp.
References checkDirectory(), checkFifo(), checkFilename(), vpException::fatalError, and path().
Referenced by createBaseNamePath().
|
static |
Rename an existing file oldfilename in newfilename.
oldfilename | : File to rename. |
newfilename | : New file name. |
Definition at line 913 of file vpIoTools.cpp.
|
static |
Copy the initial configuration file to the experiment directory.
actuallySave | : If false, do not copy the file. |
Definition at line 1269 of file vpIoTools.cpp.
References baseDir, baseName, configFile, and copy().
|
static |
Sets the base directory of the experiment files.
dir | : Directory where the data will be saved. |
Definition at line 244 of file vpIoTools.cpp.
References baseDir.
|
static |
Sets the base name (prefix) of the experiment files.
s | : Prefix of the experiment files. |
Definition at line 238 of file vpIoTools.cpp.
References baseName.
|
static |
Split a chain.
chain | : Input chain to split. |
sep | : Character separator. |
The following code shows how to use this function:
It produces the following output:
Definition at line 1767 of file vpIoTools.cpp.
Referenced by vpDisplayOpenCV::getScreenSize(), vpSimulatorAfma6::init(), vpAROgre::init(), vpSimulatorViper850::init(), vpSimulatorAfma6::initArms(), vpSimulatorViper850::initArms(), vpMbTracker::loadCAOModel(), vpSimulatorAfma6::readPosFile(), vpRobotAfma4::readPosFile(), vpSimulatorViper850::readPosFile(), vpRobotAfma6::readPosFile(), vpRobotFranka::readPosFile(), vpRobotViper650::readPosFile(), vpRobotViper850::readPosFile(), vpRobotPtu46::readPositionFile(), vpRobotBiclops::readPositionFile(), and vpWireFrameSimulator::vpWireFrameSimulator().
|
static |
Split a path in a drive specification (a drive letter followed by a colon) and the path specification. It is always true that drivespec + pathspec == p Inspired by the Python 2.7.8 module.
Definition at line 1622 of file vpIoTools.cpp.
Referenced by isAbsolutePathname().
|
static |
Remove leading and trailing whitespaces from a string.
Definition at line 2033 of file vpIoTools.cpp.
Referenced by vpMbTracker::loadCAOModel(), and vpMbTracker::parseParameters().
|
static |
Write a 16-bits integer value in little endian.
Definition at line 1938 of file vpIoTools.cpp.
Referenced by vpKeyPoint::saveLearningData().
|
static |
Write a 16-bits unsigned integer value in little endian.
Definition at line 1952 of file vpIoTools.cpp.
|
static |
Write a 32-bits integer value in little endian.
Definition at line 1966 of file vpIoTools.cpp.
|
static |
Write a 32-bits unsigned integer value in little endian.
Definition at line 1980 of file vpIoTools.cpp.
|
static |
Write a float value in little endian.
Definition at line 1994 of file vpIoTools.cpp.
|
static |
Write a double value in little endian.
Definition at line 2008 of file vpIoTools.cpp.
|
staticprotected |
Definition at line 252 of file vpIoTools.h.
Referenced by createBaseNamePath(), getFullName(), saveConfigFile(), and setBaseDir().
|
staticprotected |
Definition at line 251 of file vpIoTools.h.
Referenced by addNameElement(), createBaseNamePath(), getBaseName(), getFullName(), saveConfigFile(), and setBaseName().
|
staticprotected |
Definition at line 253 of file vpIoTools.h.
Referenced by loadConfigFile(), and saveConfigFile().
|
staticprotected |
Definition at line 255 of file vpIoTools.h.
Referenced by loadConfigFile(), and readConfigVar().
|
staticprotected |
Definition at line 254 of file vpIoTools.h.
Referenced by loadConfigFile(), and readConfigVar().
|
static |
Define the directory separator character, backslash ('\') for windows platform or slash ('/') otherwise.
Definition at line 185 of file vpIoTools.h.
Referenced by checkDirectory(), checkFifo(), createFilePath(), getName(), and getParent().