Raytrix Light Field SDK  v3.0
Logo
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Properties Events Groups Pages
Light Field Parameter API functions

Functions to get/set API parameters. More...

Functions

RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, unsigned &uValue)
 Get a parameter of type unsigned integer. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, double &dValue)
 Get a parameter of type double. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, Rx::CRxString &sValue)
 Get a parameter of type Rx::CRxString. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, Rx::CRxArrayUInt &aValue)
 Get Parameter of type CRxArrayUInt. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, Rx::CRxArrayDouble &aValue)
 Get Parameter of type CRxArrayDouble. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, Rx::CRxArrayString &aValue)
 Get Parameter of type CRxArrayString. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, const unsigned uIndex, unsigned &uValue)
 Get Parameter of type unsigned int.This function is related to the overloaded function RxGetPar(EPar::ID ePar, Rx::CRxArrayUInt aValue) and will return the Value of the parameter array on given index. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, const unsigned uIndex, double &dValue)
 Get Parameter of type unsigned int. This function is related to the overloaded function RxGetPar(EPar::ID ePar, Rx::CRxArrayDouble aValue) and will return the Value of the parameter array on given index. More...
 
RXLF_API void Rx::ApiLF::RxGetPar (EPar::ID ePar, const unsigned uIndex, Rx::CRxString &sValue)
 Get Parameter of type unsigned int. This function is related to the overloaded function RxGetPar(EPar::ID ePar, Rx::CRxArrayString aValue) and will return the Value of the parameter array on given index. More...
 
RXLF_API void Rx::ApiLF::RxGetParName (EPar::ID ePar, Rx::CRxString &sValue)
 Get the string representation of a parameter. More...
 
RXLF_API void Rx::ApiLF::RxGetParProperties (EPar::ID ePar, Rx::CRxString &sValue, bool &bReadAccess, bool &bWriteAccess, EParameterDataType::ID &eParameterType)
 Get the Properties of a parameter. More...
 
RXLF_API void Rx::ApiLF::RxGetParRange (EPar::ID ePar, unsigned &uMin, unsigned &uMax)
 Get the range of a parameter. More...
 
RXLF_API void Rx::ApiLF::RxGetParRange (EPar::ID ePar, double &dMin, double &dMax)
 Get the range of a parameter. More...
 
RXLF_API void Rx::ApiLF::RxGetParRange (EPar::ID ePar, size_t &iArrayLenMin, size_t &iArrayLenMax, unsigned &uMin, unsigned &uMax)
 Get the range of a parameter. Some array-based parameter have a dynamic array size. The parameter iArrayLenMin and iArrayLenMax returns the allowed length of the array on a zero based index. More...
 
RXLF_API void Rx::ApiLF::RxGetParRange (EPar::ID ePar, size_t &iArrayLenMin, size_t &iArrayLenMax, double &uMin, double &uMax)
 Get the range of a parameter. Some array-based parameter have a dynamic array size. The parameter iArrayLenMin and iArrayLenMax returns the allowed length of the array on a zero based index. More...
 
RXLF_API void Rx::ApiLF::RxLoadParameter (const Rx::CRxString &sxFilename)
 Loads all writable API parameter from file. Its mandatory to bind a light field image before. More...
 
RXLF_API void Rx::ApiLF::RxSaveParameter (const Rx::CRxString &sxFilename)
 Saves all writable API parameter to file. Its mandatory to bind a light field image before. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const unsigned &uValue)
 Set a parameter of type unsigned integer. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const double &dValue)
 Set a parameter of type double. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const Rx::CRxString &sValue)
 Set a parameter of type Rx::CRxString. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const Rx::CRxArrayUInt &aValue)
 Set a parameter of typeRx::CRxArrayUInt. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const Rx::CRxArrayDouble &aValue)
 Set a parameter of type Rx::CRxArrayDouble. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const Rx::CRxArrayString &aValue)
 Set a parameter of type Rx::CRxArrayString. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const unsigned uIndex, const unsigned &uValue)
 Set a Parameter of type unsiged. This function is related to void Rx::ApiLF::RxSetPar(Rx::ApiLF::EPar::ID ePar,const Rx::CRxArrayUInt aValue) and sets the Value of the array on the given index. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const unsigned uIndex, const double &dValue)
 Set a Parameter of type unsiged. This function is related to void Rx::ApiLF::RxSetPar(EPar::ID ePar, const Rx::CRxArrayDouble& aValue) and sets the Value of the array on the given index. More...
 
RXLF_API void Rx::ApiLF::RxSetPar (EPar::ID ePar, const unsigned uIndex, const Rx::CRxString &sValue)
 Set a Parameter of type unsiged. This function is related to void Rx::ApiLF::RxSetPar(EPar::ID ePar, const Rx::CRxArrayString& aValue) and sets the Value of the array on the given index. More...
 

Detailed Description

Functions to get/set API parameters.

With these functions parameters of the API can be read and set. The parameter IDs are defined in Rx::ApiLF::EPar. Note that the parameters starting with Rx::ApiLF::EPar::Cam_ and Rx::ApiLF::EPar::CamCal_ have to be read and set with Rx::ApiLF::RxCamGetPar and Rx::ApiLF::RxCamSetPar, with the exeception of Rx::ApiLF::EPar::Cam_Count. The parameters are grouped in the following categories:

Attention
Getting and setting of camera parameter demands a bound camera.

Function Documentation

RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
unsigned &  uValue 
)

Get a parameter of type unsigned integer.

Warning
If the parameter referenced by ePar does not relate to an unsigned parameter an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_int
Parameters
eParThe parameter ID. Allowed enum values are:
[out]uValueOn return contains the parameter value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
double &  dValue 
)

Get a parameter of type double.

Warning
If the parameter referenced by ePar does not relate to an double parameter an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_float.
Parameters
eParThe parameter ID. Allowed enum values are:
[out]dValueOn return contains the parameter value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
Rx::CRxString sValue 
)

Get a parameter of type Rx::CRxString.

Warning
If the parameter referenced by ePar does not relate to an string parameter an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_string
Parameters
eParThe parameter ID. Allowed enum values are:
[out]sValueOn return contains the parameter value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
Rx::CRxArrayUInt aValue 
)

Get Parameter of type CRxArrayUInt.

Warning
If the parameter referenced by ePar does not relate to an Rx::CRxArrayUInt parameter, then an Rx::ApiLF::CRxApiException is thrown.
Parameters
eParThe parameter ID. Allowed enum values are:
[out]aValueThe array containing the parameter Value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
Rx::CRxArrayDouble aValue 
)

Get Parameter of type CRxArrayDouble.

Warning
If the parameter referenced by ePar does not relate to an Rx::CRxArrayDouble parameter, then an Rx::ApiLF::CRxApiException is thrown.
Parameters
eParThe parameter ID. Allowed enum values are:
[out]aValueThe array containing the parameter Value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
Rx::CRxArrayString aValue 
)

Get Parameter of type CRxArrayString.

Warning
If the parameter referenced by ePar does not relate to an Rx::CRxArrayString parameter, then an Rx::ApiLF::CRxApiException is thrown.
Parameters
[in]eParThe parameter ID.
[out]aValueThe array containing the parameter Value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
const unsigned  uIndex,
unsigned &  uValue 
)

Get Parameter of type unsigned int.This function is related to the overloaded function RxGetPar(EPar::ID ePar, Rx::CRxArrayUInt aValue) and will return the Value of the parameter array on given index.

Warning
If the parameter referenced by ePar does not relate to an Rx::CRxArrayUInt parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_array_int
Parameters
eParThe parameter ID. Allowed enum values are:
[in]uIndexThe array index.
[out]uValueThe variable containing the parameter Value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
const unsigned  uIndex,
double &  dValue 
)

Get Parameter of type unsigned int. This function is related to the overloaded function RxGetPar(EPar::ID ePar, Rx::CRxArrayDouble aValue) and will return the Value of the parameter array on given index.

Warning
If the parameter referenced by ePar does not relate to an Rx::CRxArrayDouble parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_array_float
Parameters
eParThe parameter ID. Allowed enum values are:
[in]uIndexThe array index.
[out]dValueThe variable containing the parameter Value.
RXLF_API void Rx::ApiLF::RxGetPar ( EPar::ID  ePar,
const unsigned  uIndex,
Rx::CRxString sValue 
)

Get Parameter of type unsigned int. This function is related to the overloaded function RxGetPar(EPar::ID ePar, Rx::CRxArrayString aValue) and will return the Value of the parameter array on given index.

Warning
If the parameter referenced by ePar does not relate to an Rx::CRxArrayString parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_array_string
Parameters
[in]eParThe parameter ID.
[in]uIndexThe array index.
[out]sValueThe variable containing the parameter Value.
RXLF_API void Rx::ApiLF::RxGetParName ( EPar::ID  ePar,
Rx::CRxString sValue 
)

Get the string representation of a parameter.

Parameters
eParThe parameter ID. Allowed enums are in Rx::ApiLF::EPar.
[out]sValueOn return contains the parameter string representation.
RXLF_API void Rx::ApiLF::RxGetParProperties ( EPar::ID  ePar,
Rx::CRxString sValue,
bool &  bReadAccess,
bool &  bWriteAccess,
EParameterDataType::ID eParameterType 
)

Get the Properties of a parameter.

Parameters
eParThe parameter ID. Allowed enums are in Rx::ApiLF::EPar.
[out]sValueOn return contains the parameter string representation.
[out]bReadAccessOn return contains the parameter ReadAccess flag.
[out]bWriteAccessOn return contains the parameter WriteAccess flag.
[out]eParameterTypeOn return contains the paramater DataType.
RXLF_API void Rx::ApiLF::RxGetParRange ( EPar::ID  ePar,
unsigned &  uMin,
unsigned &  uMax 
)

Get the range of a parameter.

Attention
If the parameter referenced by ePar does not relate to an unsigned parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_range_int.
Parameters
eParThe parameter ID. Allowed enum values are:
[out]uMinThe minimal value.
[out]uMaxThe maximal value.
RXLF_API void Rx::ApiLF::RxGetParRange ( EPar::ID  ePar,
double &  dMin,
double &  dMax 
)

Get the range of a parameter.

Warning
If the parameter referenced by ePar does not relate to an double parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_get_par_range_float.
Parameters
eParThe parameter ID. Allowed enum values are:
[out]dMinThe minimal value.
[out]dMaxThe maximal value.
RXLF_API void Rx::ApiLF::RxGetParRange ( EPar::ID  ePar,
size_t &  iArrayLenMin,
size_t &  iArrayLenMax,
unsigned &  uMin,
unsigned &  uMax 
)

Get the range of a parameter. Some array-based parameter have a dynamic array size. The parameter iArrayLenMin and iArrayLenMax returns the allowed length of the array on a zero based index.

Halcon Plugin - Function Name:
rx_get_par_range_array_int.
Parameters
eParThe parameter ID. Allowed enum values are:
[out]iArrayLenMinZero-based index of the array length minimum.
[out]iArrayLenMaxZero-based index of the array length maximum.
[out]uMinThe minimum.
[out]uMaxThe maximum.
RXLF_API void Rx::ApiLF::RxGetParRange ( EPar::ID  ePar,
size_t &  iArrayLenMin,
size_t &  iArrayLenMax,
double &  uMin,
double &  uMax 
)

Get the range of a parameter. Some array-based parameter have a dynamic array size. The parameter iArrayLenMin and iArrayLenMax returns the allowed length of the array on a zero based index.

Halcon Plugin - Function Name:
rx_get_par_range_array_float.
Parameters
eParThe parameter ID. Allowed enum values are:
[out]iArrayLenMinZero-based index of the array length minimum.
[out]iArrayLenMaxZero-based index of the array length maximum.
[out]uMinThe minimum.
[out]uMaxThe maximum.
RXLF_API void Rx::ApiLF::RxLoadParameter ( const Rx::CRxString sxFilename)

Loads all writable API parameter from file. Its mandatory to bind a light field image before.

Halcon Plugin - Function Name:
rx_load_parameter.
Parameters
sxFilenameThe filename.
RXLF_API void Rx::ApiLF::RxSaveParameter ( const Rx::CRxString sxFilename)

Saves all writable API parameter to file. Its mandatory to bind a light field image before.

This save routine will not store API parameter related to a specific device(e.g.camera or cuda device).

The following parameter groups are excluded from saving:

  • Camera - all parameter starting with Rx::ApiLF::EPar::Cam_XXXX
  • MLA - all parameter starting with Rx::ApiLF::EPar::MLA_XXXX

in addition to the excluded groups, the following parameter are also excluded:

Halcon Plugin - Function Name:
rx_save_parameter.
Parameters
sxFilenameThe filename.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const unsigned &  uValue 
)

Set a parameter of type unsigned integer.

Warning
If the parameter referenced by ePar does not relate to an unsigned integer parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_set_par_int
Parameters
eParThe parameter ID. Allowed enum values are:
uValueThe parameter value.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const double &  dValue 
)

Set a parameter of type double.

Warning
If the parameter referenced by ePar does not relate to an double parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_set_par_float
Parameters
eParThe parameter ID. Allowed enum values are:
dValueThe parameter value.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const Rx::CRxString sValue 
)

Set a parameter of type Rx::CRxString.

Attention
If the parameter referenced by ePar does not relate to an double parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_set_par_string
Parameters
eParThe parameter ID. Allowed enum values are:
sValueThe parameter value.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const Rx::CRxArrayUInt aValue 
)

Set a parameter of typeRx::CRxArrayUInt.

Attention
If the parameter referenced by ePar does not relate to an Rx::CRxArrayUInt parameter, then a Rx::ApiLF::CRxApiException is thrown.
Parameters
eParThe parameter ID. Allowed enum values are:
aValueThe value.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const Rx::CRxArrayDouble aValue 
)
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const Rx::CRxArrayString aValue 
)

Set a parameter of type Rx::CRxArrayString.

Attention
If the parameter referenced by ePar does not relate to an Rx::CRxArrayString parameter, then a Rx::ApiLF::CRxApiException is thrown.
Parameters
eParThe parameter.
aValueThe parameter's value.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const unsigned  uIndex,
const unsigned &  uValue 
)

Set a Parameter of type unsiged. This function is related to void Rx::ApiLF::RxSetPar(Rx::ApiLF::EPar::ID ePar,const Rx::CRxArrayUInt aValue) and sets the Value of the array on the given index.

Attention
If the parameter referenced by ePar does not relate to an Rx::CRxArrayUInt parameter, then a Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_set_par_array_int.
Parameters
eParThe parameter ID. Allowed enum values are:
uIndexThe index of the array.
uValueThe value to set.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const unsigned  uIndex,
const double &  dValue 
)

Set a Parameter of type unsiged. This function is related to void Rx::ApiLF::RxSetPar(EPar::ID ePar, const Rx::CRxArrayDouble& aValue) and sets the Value of the array on the given index.

Warning
If the parameter referenced by ePar does not relate to an Rx::CRxArrayDouble parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_set_par_array_float.
Parameters
eParThe parameter ID. Allowed enum values are:
uIndexThe index of the array.
dValueThe value to set.
RXLF_API void Rx::ApiLF::RxSetPar ( EPar::ID  ePar,
const unsigned  uIndex,
const Rx::CRxString sValue 
)

Set a Parameter of type unsiged. This function is related to void Rx::ApiLF::RxSetPar(EPar::ID ePar, const Rx::CRxArrayString& aValue) and sets the Value of the array on the given index.

Attention
If the parameter referenced by ePar does not relate to an Rx::CRxArrayString parameter, then an Rx::ApiLF::CRxApiException is thrown.
Halcon Plugin - Function Name:
rx_set_par_array_string.
Parameters
eParThe parameter ID.
uIndexThe index of the array.
sValueThe value to set.