InitFusionParameters Class Reference

Holds the options used to initialize the Fusion object. More...

Functions

 InitFusionParameters (UNIT coordinate_units_=UNIT::MILLIMETER, COORDINATE_SYSTEM coordinate_system_=COORDINATE_SYSTEM::IMAGE, bool output_performance_metrics=true, int verbose_=0, unsigned timeout_period_number_=5, SynchronizationParameter synchronization_parameters_=SynchronizationParameter())
 Default constructor. More...
 
bool save (String filename, SERIALIZATION_FORMAT format=SERIALIZATION_FORMAT::JSON) const
 Saves the current set of parameters into a file to be reloaded with the load() method. More...
 
bool load (String filename, SERIALIZATION_FORMAT format=SERIALIZATION_FORMAT::JSON)
 Loads a set of parameters from the values contained in a previously saved file. More...
 
bool encode (String &serialized_content, SERIALIZATION_FORMAT format=SERIALIZATION_FORMAT::JSON) const
 Generate a JSON Object (with the struct type as a key) containing the serialized struct, converted into a string. More...
 
bool decode (const String &serialized_content, SERIALIZATION_FORMAT format=SERIALIZATION_FORMAT::JSON)
 Fill the structure from the serialized json object contained in the input string. More...
 
bool operator== (const InitFusionParameters &param1) const
 Comparison operator ==. More...
 
bool operator!= (const InitFusionParameters &param1) const
 Comparison operator !=. More...
 

Attributes

UNIT coordinate_units
 This parameter allows you to select the unit to be used for all metric values of the SDK (depth, point cloud, tracking, mesh, and others). More...
 
COORDINATE_SYSTEM coordinate_system
 Positional tracking, point clouds and many other features require a given COORDINATE_SYSTEM to be used as reference. This parameter allows you to select the COORDINATE_SYSTEM used by the Camera to return its measures. More...
 
bool output_performance_metrics
 It allows users to extract some stats of the Fusion API like drop frame of each camera, latency, etc... More...
 
int verbose
 Enable the verbosity mode of the SDK. More...
 
unsigned timeout_period_number
 If specified change the number of period necessary for a source to go in timeout without data. For example, if you set this to 5 then, if any source do not receive data during 5 period, these sources will go to timeout and will be ignored. More...
 
SynchronizationParameter synchronization_parameters
 Specifies the parameters used for data synchronization during fusion. More...
 

Detailed Description

Holds the options used to initialize the Fusion object.

Constructor and Destructor

◆ InitFusionParameters()

InitFusionParameters ( UNIT  coordinate_units_ = UNIT::MILLIMETER,
COORDINATE_SYSTEM  coordinate_system_ = COORDINATE_SYSTEM::IMAGE,
bool  output_performance_metrics = true,
int  verbose_ = 0,
unsigned  timeout_period_number_ = 5,
SynchronizationParameter  synchronization_parameters_ = SynchronizationParameter() 
)

Default constructor.

Functions

◆ save()

bool save ( String  filename,
SERIALIZATION_FORMAT  format = SERIALIZATION_FORMAT::JSON 
) const

Saves the current set of parameters into a file to be reloaded with the load() method.

Parameters
filename: Name of the file which will be created to store the parameters (extension '.yml' will be added if not set).
Returns
True if the file was successfully saved, otherwise false.
Warning
For security reasons, the file must not already exist.
In case a file already exists, the method will return false and existing file will not be updated.

◆ load()

bool load ( String  filename,
SERIALIZATION_FORMAT  format = SERIALIZATION_FORMAT::JSON 
)

Loads a set of parameters from the values contained in a previously saved file.

Parameters
filename: Path to the file from which the parameters will be loaded (extension '.yml' will be added at the end of the filename if not detected).
Returns
True if the file was successfully loaded, otherwise false.

◆ encode()

bool encode ( String serialized_content,
SERIALIZATION_FORMAT  format = SERIALIZATION_FORMAT::JSON 
) const

Generate a JSON Object (with the struct type as a key) containing the serialized struct, converted into a string.

Parameters
serialized_contentoutput string containing the JSON Object
formatserialization format, default is JSON
Returns
True if file was successfully saved, otherwise false.

◆ decode()

bool decode ( const String serialized_content,
SERIALIZATION_FORMAT  format = SERIALIZATION_FORMAT::JSON 
)

Fill the structure from the serialized json object contained in the input string.

Parameters
serialized_contentinput string containing the JSON Object
formatserialization format, default is JSON
Returns
True if the decoding was successful, otherwise false.

◆ operator==()

bool operator== ( const InitFusionParameters param1) const

Comparison operator ==.

Parameters
InitFusionParametersto compare
Returns
true if the two struct are identical

◆ operator!=()

bool operator!= ( const InitFusionParameters param1) const

Comparison operator !=.

Parameters
InitFusionParametersto compare
Returns
true if the two struct are different

Variables

◆ coordinate_units

UNIT coordinate_units

This parameter allows you to select the unit to be used for all metric values of the SDK (depth, point cloud, tracking, mesh, and others).

Default : UNIT::MILLIMETER

◆ coordinate_system

COORDINATE_SYSTEM coordinate_system

Positional tracking, point clouds and many other features require a given COORDINATE_SYSTEM to be used as reference. This parameter allows you to select the COORDINATE_SYSTEM used by the Camera to return its measures.

This defines the order and the direction of the axis of the coordinate system.
Default : COORDINATE_SYSTEM::IMAGE

◆ output_performance_metrics

bool output_performance_metrics

It allows users to extract some stats of the Fusion API like drop frame of each camera, latency, etc...

◆ verbose

int verbose

Enable the verbosity mode of the SDK.

◆ timeout_period_number

unsigned timeout_period_number

If specified change the number of period necessary for a source to go in timeout without data. For example, if you set this to 5 then, if any source do not receive data during 5 period, these sources will go to timeout and will be ignored.

Note
This parameter is deprecated. Use data_source_timeout present in synchronization_parameters instead.

◆ synchronization_parameters

SynchronizationParameter synchronization_parameters

Specifies the parameters used for data synchronization during fusion.

The SynchronizationParameter struct encapsulates the synchronization parameters that control the data fusion process.