Loads and runs sensors. More...
#include <Manager.hh>
Public Member Functions | |
Manager () | |
constructor More... | |
virtual | ~Manager () |
destructor More... | |
void | AddPluginPaths (const std::string &_path) |
Adds colon delimited paths sensor plugins may be. More... | |
SensorId | AddSensor (std::unique_ptr< Sensor > _sensor) |
Add a sensor for this manager to manage. More... | |
template<typename SensorType , typename SdfType > | |
SensorType * | CreateSensor (SdfType _sdf) |
Create a sensor from an SDF ovject with a known sensor type. More... | |
SensorId | CreateSensor (sdf::ElementPtr _sdf) |
Create a sensor from SDF without a known sensor type. More... | |
SensorId | CreateSensor (const sdf::Sensor &_sdf) |
Create a sensor from SDF without a known sensor type. More... | |
bool | Init () |
Initialize the sensor library without rendering or physics. More... | |
bool | Remove (const SensorId _id) |
Remove a sensor by ID. More... | |
void | RunOnce (const std::chrono::steady_clock::duration &_time, bool _force=false) |
Run the sensor generation one step. More... | |
Sensor * | Sensor (SensorId _id) |
Get an instance of a loaded sensor by sensor id. More... | |
Detailed Description
Loads and runs sensors.
This class is responsible for loading and running sensors, and providing sensors with common environments to generat data from.
The primary interface through which to load a sensor is LoadSensor(). This takes an sdf element pointer that should be configured with everything the sensor will need. Custom sensors configuration must be in the <plugin> tag of the sdf::Element. The manager will dynamically load the sensor library and update it.
- Remarks
- This class is not thread safe.
Constructor & Destructor Documentation
◆ Manager()
Manager | ( | ) |
constructor
◆ ~Manager()
|
virtual |
destructor
Member Function Documentation
◆ AddPluginPaths()
void AddPluginPaths | ( | const std::string & | _path | ) |
Adds colon delimited paths sensor plugins may be.
Referenced by Manager::CreateSensor().
◆ AddSensor()
SensorId AddSensor | ( | std::unique_ptr< Sensor > | _sensor | ) |
Add a sensor for this manager to manage.
- See also
- Sensor()
- Parameters
-
[in] _sensor Pointer to the sensor
- Returns
- A sensor id that refers to the created sensor. NO_SENSOR is returned on error.
Referenced by Manager::CreateSensor().
◆ CreateSensor() [1/3]
|
inline |
Create a sensor from an SDF ovject with a known sensor type.
- See also
- Sensor()
- Parameters
-
[in] _sdf An SDF element or DOM object.
- Template Parameters
-
SensorType Sensor type SdfType It may be an sdf::ElementPtr
containing a sensor or ansdf::Sensor
.
- Returns
- A pointer to the created sensor. Null returned on error. The Manager keeps ownership of the pointer's lifetime.
References Manager::AddPluginPaths(), Manager::AddSensor(), SensorFactory::CreateSensor(), std::endl(), std::move(), ignition::sensors::NO_SENSOR, Manager::Remove(), Manager::RunOnce(), and Manager::Sensor().
◆ CreateSensor() [2/3]
SensorId CreateSensor | ( | sdf::ElementPtr | _sdf | ) |
Create a sensor from SDF without a known sensor type.
- See also
- Sensor()
- Parameters
-
[in] _sdf pointer to the sdf element
- Returns
- A sensor id that refers to the created sensor. NO_SENSOR is returned on erro.
- Deprecated:
- Sensor registration is deprecated, so it's necessary to provide the specific sensor type to create it. Use the templated
CreateSensor
function.
◆ CreateSensor() [3/3]
SensorId CreateSensor | ( | const sdf::Sensor & | _sdf | ) |
Create a sensor from SDF without a known sensor type.
- See also
- Sensor()
- Parameters
-
[in] _sdf SDF sensor DOM object
- Returns
- A sensor id that refers to the created sensor. NO_SENSOR is returned on erro.
- Deprecated:
- Sensor registration is deprecated, so it's necessary to provide the specific sensor type to create it. Use the templated
CreateSensor
function.
◆ Init()
bool Init | ( | ) |
Initialize the sensor library without rendering or physics.
- Returns
- True if successfully initialized, false if not
◆ Remove()
bool Remove | ( | const SensorId | _id | ) |
Remove a sensor by ID.
- Parameters
-
[in] _sensorId ID of the sensor to remove
- Returns
- True if the sensor exists and removed.
Referenced by Manager::CreateSensor().
◆ RunOnce()
void RunOnce | ( | const std::chrono::steady_clock::duration & | _time, |
bool | _force = false |
||
) |
Run the sensor generation one step.
- Parameters
-
_time The current simulated time _force If true, all sensors are forced to update. Otherwise a sensor will update based on it's Hz rate.
Referenced by Manager::CreateSensor().
◆ Sensor()
Get an instance of a loaded sensor by sensor id.
- Parameters
-
[in] _id Idenitifier of the sensor.
- Returns
- Pointer to the sensor, nullptr on error.
Referenced by Manager::CreateSensor().
The documentation for this class was generated from the following file: