Intel® RealSense™ Cross Platform API
Intel Realsense Cross-platform API
|
Exposes sensor options functionality for C compilers. More...
Go to the source code of this file.
Classes | |
struct | rs2_option_rect |
struct | rs2_option_value |
The value of an option, in a known option type. More... |
Typedefs | |
typedef enum rs2_option | rs2_option |
Defines general configuration controls. These can generally be mapped to camera UVC controls, and can be set / queried at any time unless stated otherwise. | |
typedef enum rs2_option_type | rs2_option_type |
Defines known option value types. | |
typedef struct rs2_option_rect | rs2_option_rect |
typedef struct rs2_option_value | rs2_option_value |
The value of an option, in a known option type. | |
typedef enum rs2_sr300_visual_preset | rs2_sr300_visual_preset |
For SR300 devices: provides optimized settings (presets) for specific types of usage. | |
typedef enum rs2_rs400_visual_preset | rs2_rs400_visual_preset |
For RS400 devices: provides optimized settings (presets) for specific types of usage. | |
typedef enum rs2_l500_visual_preset | rs2_l500_visual_preset |
For L500 devices: provides optimized settings (presets) for specific types of usage. | |
typedef enum rs2_sensor_mode | rs2_sensor_mode |
For setting the camera_mode option. | |
typedef enum rs2_ambient_light | rs2_ambient_light |
DEPRECATED! - Use RS2_OPTION_DIGITAL_GAIN instead. | |
typedef enum rs2_digital_gain | rs2_digital_gain |
digital gain for RS2_OPTION_DIGITAL_GAIN option. | |
typedef enum rs2_host_perf_mode | rs2_host_perf_mode |
values for RS2_OPTION_HOST_PERFORMANCE option. | |
typedef enum rs2_emitter_frequency_mode | rs2_emitter_frequency_mode |
values for RS2_EMITTER_FREQUENCY option. | |
typedef enum rs2_depth_auto_exposure_mode | rs2_depth_auto_exposure_mode |
values for RS2_OPTION_DEPTH_AUTO_EXPOSURE_MODE option. | |
typedef enum rs2_gyro_sensitivity | rs2_gyro_sensitivity |
values for RS2_OPTION_GYRO_SENSITIVITY option. |
Exposes sensor options functionality for C compilers.
typedef enum rs2_ambient_light rs2_ambient_light |
DEPRECATED! - Use RS2_OPTION_DIGITAL_GAIN instead.
typedef enum rs2_depth_auto_exposure_mode rs2_depth_auto_exposure_mode |
values for RS2_OPTION_DEPTH_AUTO_EXPOSURE_MODE option.
typedef enum rs2_digital_gain rs2_digital_gain |
digital gain for RS2_OPTION_DIGITAL_GAIN option.
typedef enum rs2_emitter_frequency_mode rs2_emitter_frequency_mode |
values for RS2_EMITTER_FREQUENCY option.
typedef enum rs2_gyro_sensitivity rs2_gyro_sensitivity |
values for RS2_OPTION_GYRO_SENSITIVITY option.
typedef enum rs2_host_perf_mode rs2_host_perf_mode |
values for RS2_OPTION_HOST_PERFORMANCE option.
typedef enum rs2_l500_visual_preset rs2_l500_visual_preset |
For L500 devices: provides optimized settings (presets) for specific types of usage.
typedef enum rs2_option rs2_option |
Defines general configuration controls. These can generally be mapped to camera UVC controls, and can be set / queried at any time unless stated otherwise.
typedef struct rs2_option_rect rs2_option_rect |
A rectangle expressed in 64 bits, used with rs2_option_value::as_rect. Same semantics as rs2_set_region_of_interest.
typedef enum rs2_option_type rs2_option_type |
Defines known option value types.
typedef struct rs2_option_value rs2_option_value |
The value of an option, in a known option type.
typedef enum rs2_rs400_visual_preset rs2_rs400_visual_preset |
For RS400 devices: provides optimized settings (presets) for specific types of usage.
typedef enum rs2_sensor_mode rs2_sensor_mode |
For setting the camera_mode option.
typedef enum rs2_sr300_visual_preset rs2_sr300_visual_preset |
For SR300 devices: provides optimized settings (presets) for specific types of usage.
enum rs2_ambient_light |
values for RS2_OPTION_DEPTH_AUTO_EXPOSURE_MODE option.
enum rs2_digital_gain |
enum rs2_gyro_sensitivity |
enum rs2_host_perf_mode |
values for RS2_OPTION_HOST_PERFORMANCE option.
For L500 devices: provides optimized settings (presets) for specific types of usage.
enum rs2_option |
Defines general configuration controls. These can generally be mapped to camera UVC controls, and can be set / queried at any time unless stated otherwise.
Enumerator | |
---|---|
RS2_OPTION_BACKLIGHT_COMPENSATION | Enable / disable color backlight compensation |
RS2_OPTION_BRIGHTNESS | Color image brightness |
RS2_OPTION_CONTRAST | Color image contrast |
RS2_OPTION_EXPOSURE | Controls exposure time of color camera. Setting any value will disable auto exposure |
RS2_OPTION_GAIN | Color image gain |
RS2_OPTION_GAMMA | Color image gamma setting |
RS2_OPTION_HUE | Color image hue |
RS2_OPTION_SATURATION | Color image saturation setting |
RS2_OPTION_SHARPNESS | Color image sharpness setting |
RS2_OPTION_WHITE_BALANCE | Controls white balance of color image. Setting any value will disable auto white balance |
RS2_OPTION_ENABLE_AUTO_EXPOSURE | Enable / disable auto-exposure |
RS2_OPTION_ENABLE_AUTO_WHITE_BALANCE | Enable / disable color image auto-white-balance |
RS2_OPTION_VISUAL_PRESET | Provide access to several recommend sets of option presets for the depth camera |
RS2_OPTION_LASER_POWER | Power of the laser emitter (mW), with 0 meaning projector turned off |
RS2_OPTION_ACCURACY | Set the number of patterns projected per frame. The higher the accuracy value the more patterns projected. Increasing the number of patterns help to achieve better accuracy. Note that this control is affecting the Depth FPS |
RS2_OPTION_MOTION_RANGE | Motion vs. Range trade-off, with lower values allowing for better motion sensitivity and higher values allowing for better depth range |
RS2_OPTION_FILTER_OPTION | Set the filter to apply to each depth frame. Each one of the filter is optimized per the application requirements |
RS2_OPTION_CONFIDENCE_THRESHOLD | The confidence level threshold used by the Depth algorithm pipe to set whether a pixel will get a valid range or will be marked with invalid range |
RS2_OPTION_EMITTER_ENABLED | Emitter select: 0 - disable all emitters. 1 - enable laser. 2 - enable auto laser. 3 - enable LED. |
RS2_OPTION_FRAMES_QUEUE_SIZE | Number of frames the user is allowed to keep per stream. Trying to hold-on to more frames will cause frame-drops. |
RS2_OPTION_TOTAL_FRAME_DROPS | Total number of detected frame drops from all streams |
RS2_OPTION_AUTO_EXPOSURE_MODE | Auto-Exposure modes: Static, Anti-Flicker and Hybrid |
RS2_OPTION_POWER_LINE_FREQUENCY | Power Line Frequency control for anti-flickering Off/50Hz/60Hz/Auto |
RS2_OPTION_ASIC_TEMPERATURE | Current Asic Temperature |
RS2_OPTION_ERROR_POLLING_ENABLED | disable error handling |
RS2_OPTION_PROJECTOR_TEMPERATURE | Current Projector Temperature |
RS2_OPTION_OUTPUT_TRIGGER_ENABLED | Enable / disable trigger to be outputted from the camera to any external device on every depth frame |
RS2_OPTION_MOTION_MODULE_TEMPERATURE | Current Motion-Module Temperature |
RS2_OPTION_DEPTH_UNITS | Number of meters represented by a single depth unit |
RS2_OPTION_ENABLE_MOTION_CORRECTION | Enable/Disable automatic correction of the motion data |
RS2_OPTION_AUTO_EXPOSURE_PRIORITY | Allows sensor to dynamically adjust the frame rate depending on lighting conditions |
RS2_OPTION_COLOR_SCHEME | Color scheme for data visualization |
RS2_OPTION_HISTOGRAM_EQUALIZATION_ENABLED | Perform histogram equalization post-processing on the depth data |
RS2_OPTION_MIN_DISTANCE | Minimal distance to the target |
RS2_OPTION_MAX_DISTANCE | Maximum distance to the target |
RS2_OPTION_TEXTURE_SOURCE | Texture mapping stream unique ID |
RS2_OPTION_FILTER_MAGNITUDE | The 2D-filter effect. The specific interpretation is given within the context of the filter |
RS2_OPTION_FILTER_SMOOTH_ALPHA | 2D-filter parameter controls the weight/radius for smoothing. |
RS2_OPTION_FILTER_SMOOTH_DELTA | 2D-filter range/validity threshold |
RS2_OPTION_HOLES_FILL | Enhance depth data post-processing with holes filling where appropriate |
RS2_OPTION_STEREO_BASELINE | The distance in mm between the first and the second imagers in stereo-based depth cameras |
RS2_OPTION_AUTO_EXPOSURE_CONVERGE_STEP | Allows dynamically adjust the converge step value of the target exposure in Auto-Exposure algorithm |
RS2_OPTION_INTER_CAM_SYNC_MODE | Impose Inter-camera HW synchronization mode. Applicable for D400/L500/Rolling Shutter SKUs |
RS2_OPTION_STREAM_FILTER | Select a stream to process |
RS2_OPTION_STREAM_FORMAT_FILTER | Select a stream format to process |
RS2_OPTION_STREAM_INDEX_FILTER | Select a stream index to process |
RS2_OPTION_EMITTER_ON_OFF | When supported, this option make the camera to switch the emitter state every frame. 0 for disabled, 1 for enabled |
RS2_OPTION_ZERO_ORDER_POINT_X | Deprecated!!! - Zero order point x |
RS2_OPTION_ZERO_ORDER_POINT_Y | Deprecated!!! - Zero order point y |
RS2_OPTION_LLD_TEMPERATURE | LDD temperature |
RS2_OPTION_MC_TEMPERATURE | MC temperature |
RS2_OPTION_MA_TEMPERATURE | MA temperature |
RS2_OPTION_HARDWARE_PRESET | Hardware stream configuration |
RS2_OPTION_GLOBAL_TIME_ENABLED | disable global time |
RS2_OPTION_APD_TEMPERATURE | APD temperature |
RS2_OPTION_ENABLE_MAPPING | Enable an internal map |
RS2_OPTION_ENABLE_RELOCALIZATION | Enable appearance based relocalization |
RS2_OPTION_ENABLE_POSE_JUMPING | Enable position jumping |
RS2_OPTION_ENABLE_DYNAMIC_CALIBRATION | Enable dynamic calibration |
RS2_OPTION_DEPTH_OFFSET | Offset from sensor to depth origin in millimetrers |
RS2_OPTION_LED_POWER | Power of the LED (light emitting diode), with 0 meaning LED off |
RS2_OPTION_ZERO_ORDER_ENABLED | DEPRECATED! - Toggle Zero-Order mode |
RS2_OPTION_ENABLE_MAP_PRESERVATION | Preserve previous map when starting |
RS2_OPTION_FREEFALL_DETECTION_ENABLED | Enable/disable sensor shutdown when a free-fall is detected (on by default) |
RS2_OPTION_AVALANCHE_PHOTO_DIODE | Changes the exposure time of Avalanche Photo Diode in the receiver |
RS2_OPTION_POST_PROCESSING_SHARPENING | Changes the amount of sharpening in the post-processed image |
RS2_OPTION_PRE_PROCESSING_SHARPENING | Changes the amount of sharpening in the pre-processed image |
RS2_OPTION_NOISE_FILTERING | Control edges and background noise |
RS2_OPTION_INVALIDATION_BYPASS | Enable\disable pixel invalidation |
RS2_OPTION_AMBIENT_LIGHT | DEPRECATED! - Use RS2_OPTION_DIGITAL_GAIN instead. |
RS2_OPTION_DIGITAL_GAIN | Change the depth digital gain see rs2_digital_gain for values |
RS2_OPTION_SENSOR_MODE | The resolution mode: see rs2_sensor_mode for values |
RS2_OPTION_EMITTER_ALWAYS_ON | Enable Laser On constantly (GS SKU Only) |
RS2_OPTION_THERMAL_COMPENSATION | Depth Thermal Compensation for selected D400 SKUs |
RS2_OPTION_TRIGGER_CAMERA_ACCURACY_HEALTH | DEPRECATED as of 2.46! |
RS2_OPTION_RESET_CAMERA_ACCURACY_HEALTH | DEPRECATED as of 2.46! |
RS2_OPTION_HOST_PERFORMANCE | Set host performance mode to optimize device settings so host can keep up with workload, for example, USB transaction granularity, setting option to low performance host leads to larger USB transaction size and reduced number of transactions which improves performance and stability if host is relatively weak as compared to workload |
RS2_OPTION_HDR_ENABLED | Enable / disable HDR |
RS2_OPTION_SEQUENCE_NAME | HDR Sequence name |
RS2_OPTION_SEQUENCE_SIZE | HDR Sequence size |
RS2_OPTION_SEQUENCE_ID | HDR Sequence ID - 0 is not HDR; sequence ID for HDR configuration starts from 1 |
RS2_OPTION_HUMIDITY_TEMPERATURE | Humidity temperature [Deg Celsius] |
RS2_OPTION_ENABLE_MAX_USABLE_RANGE | Turn on/off the maximum usable depth sensor range given the amount of ambient light in the scene |
RS2_OPTION_ALTERNATE_IR | Turn on/off the alternate IR, When enabling alternate IR, the IR image is holding the amplitude of the depth correlation. |
RS2_OPTION_NOISE_ESTIMATION | Noise estimation - indicates the noise on the IR image |
RS2_OPTION_ENABLE_IR_REFLECTIVITY | Enables data collection for calculating IR pixel reflectivity |
RS2_OPTION_AUTO_EXPOSURE_LIMIT | Set and get auto exposure limit in microseconds. If the requested exposure limit is greater than frame time, it will be set to frame time at runtime. Setting will not take effect until next streaming session. |
RS2_OPTION_AUTO_GAIN_LIMIT | Set and get auto gain limits ranging from 16 to 248. If the requested gain limit is less than 16, it will be set to 16. If the requested gain limit is greater than 248, it will be set to 248. Setting will not take effect until next streaming session. |
RS2_OPTION_AUTO_RX_SENSITIVITY | Enable receiver sensitivity according to ambient light, bounded by the Receiver Gain control. |
RS2_OPTION_TRANSMITTER_FREQUENCY | changes the transmitter frequencies increasing effective range over sharpness. |
RS2_OPTION_VERTICAL_BINNING | Enables vertical binning which increases the maximal sensed distance. |
RS2_OPTION_RECEIVER_SENSITIVITY | Control receiver sensitivity to incoming light, both projected and ambient (same as APD on L515). |
RS2_OPTION_AUTO_EXPOSURE_LIMIT_TOGGLE | Enable / disable color image auto-exposure |
RS2_OPTION_AUTO_GAIN_LIMIT_TOGGLE | Enable / disable color image auto-gain |
RS2_OPTION_EMITTER_FREQUENCY | Select emitter (laser projector) frequency, see rs2_emitter_frequency for values |
RS2_OPTION_DEPTH_AUTO_EXPOSURE_MODE | Select depth sensor auto exposure mode see rs2_depth_auto_exposure_mode for values |
RS2_OPTION_OHM_TEMPERATURE | Temperature of the Optical Head Sensor |
RS2_OPTION_SOC_PVT_TEMPERATURE | Temperature of PVT SOC |
RS2_OPTION_GYRO_SENSITIVITY | Control of the gyro sensitivity level, see rs2_gyro_sensitivity for values |
RS2_OPTION_REGION_OF_INTEREST | The rectangular area used from the streaming profile |
RS2_OPTION_ROTATION | |
RS2_OPTION_COUNT | Rotates frames Number of enumeration values. Not a valid input: intended to be used in for-loops. |
enum rs2_option_type |
For RS400 devices: provides optimized settings (presets) for specific types of usage.
enum rs2_sensor_mode |
For SR300 devices: provides optimized settings (presets) for specific types of usage.
const char * rs2_ambient_light_to_string | ( | rs2_ambient_light | preset | ) |
void rs2_delete_option_value | ( | rs2_option_value const * | handle | ) |
Clean up a value and all it points to
[in] | handle | value to delete |
void rs2_delete_options_list | ( | rs2_options_list * | list | ) |
Deletes options list
[in] | list | list to delete |
const char * rs2_depth_auto_exposure_mode_to_string | ( | rs2_depth_auto_exposure_mode | mode | ) |
const char * rs2_digital_gain_to_string | ( | rs2_digital_gain | preset | ) |
const char * rs2_emitter_frequency_mode_to_string | ( | rs2_emitter_frequency_mode | mode | ) |
float rs2_get_option | ( | const rs2_options * | options, |
rs2_option | option, | ||
rs2_error ** | error ) |
read option value from the sensor
[in] | options | the options container |
[in] | option | option id to be queried |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
const char * rs2_get_option_description | ( | const rs2_options * | options, |
rs2_option | option, | ||
rs2_error ** | error ) |
get option description
[in] | options | the options container |
[in] | option | option id to be checked |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
rs2_option rs2_get_option_from_list | ( | const rs2_options_list * | options, |
int | i, | ||
rs2_error ** | error ) |
get the specific option from options list
[in] | i | the index of the option |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
const char * rs2_get_option_name | ( | const rs2_options * | options, |
rs2_option | option, | ||
rs2_error ** | error ) |
get option name
[in] | options | the options container |
[in] | option | option id to be checked |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
void rs2_get_option_range | ( | const rs2_options * | sensor, |
rs2_option | option, | ||
float * | min, | ||
float * | max, | ||
float * | step, | ||
float * | def, | ||
rs2_error ** | error ) |
retrieve the available range of values of a supported option
[in] | sensor | the RealSense device |
[in] | option | the option whose range should be queried |
[out] | min | the minimum value which will be accepted for this option |
[out] | max | the maximum value which will be accepted for this option |
[out] | step | the granularity of options which accept discrete values, or zero if the option accepts continuous values |
[out] | def | the default value of the option |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
rs2_option_value const * rs2_get_option_value | ( | const rs2_options * | options, |
rs2_option | option_id, | ||
rs2_error ** | error ) |
read option value from the sensor
[in] | options | the options container |
[in] | option_id | option id to be queried |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
const char * rs2_get_option_value_description | ( | const rs2_options * | options, |
rs2_option | option, | ||
float | value, | ||
rs2_error ** | error ) |
get option value description (in case specific option value hold special meaning)
[in] | options | the options container |
[in] | option | option id to be checked |
[in] | value | value of the option |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
rs2_option_value const * rs2_get_option_value_from_list | ( | const rs2_options_list * | options, |
int | i, | ||
rs2_error ** | error ) |
get the specific option from options list
[in] | i | the index of the option |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
rs2_options_list * rs2_get_options_list | ( | const rs2_options * | options, |
rs2_error ** | error ) |
get the list of supported options of options container
[in] | options | the options container |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
int rs2_get_options_list_size | ( | const rs2_options_list * | options, |
rs2_error ** | error ) |
get the size of options list
[in] | options | the option list |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
const char * rs2_gyro_sensitivity_to_string | ( | rs2_gyro_sensitivity | mode | ) |
const char * rs2_host_perf_mode_to_string | ( | rs2_host_perf_mode | perf | ) |
int rs2_is_option_read_only | ( | const rs2_options * | options, |
rs2_option | option, | ||
rs2_error ** | error ) |
check if an option is read-only
[in] | options | the options container |
[in] | option | option id to be checked |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
const char * rs2_l500_visual_preset_to_string | ( | rs2_l500_visual_preset | preset | ) |
rs2_option rs2_option_from_string | ( | const char * | option_name | ) |
Get the specific rs2_option identifier given its name if found, or RS2_OPTION_COUNT if not. See rs2_option_to_string() for the reverse.
[in] | option_name | the case-sensitive option name |
const char * rs2_option_to_string | ( | rs2_option | option | ) |
Returns the option name if the option exists, or "UNKNOWN" otherwise. See rs2_option_from_string() for the reverse.
[in] | option | the option identifier |
const char * rs2_option_type_to_string | ( | rs2_option_type | type | ) |
Returns the option type as a string, or "UNKNOWN" otherwise.
[in] | type | the option type identifier |
const char * rs2_rs400_visual_preset_to_string | ( | rs2_rs400_visual_preset | preset | ) |
const char * rs2_sensor_mode_to_string | ( | rs2_sensor_mode | preset | ) |
void rs2_set_option | ( | const rs2_options * | options, |
rs2_option | option, | ||
float | value, | ||
rs2_error ** | error ) |
write new value to sensor option
[in] | options | the options container |
[in] | option | option id to be queried |
[in] | value | new value for the option |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
void rs2_set_option_value | ( | rs2_options const * | options, |
rs2_option_value const * | option_value, | ||
rs2_error ** | error ) |
write new value to sensor option
[in] | options | the options container |
[in] | option_value | option id, type, and value to be set |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
void rs2_set_options_changed_callback | ( | rs2_options * | options, |
rs2_options_changed_callback_ptr | callback, | ||
rs2_error ** | error ) |
Sets a callback in case an option in this options container value is updated. Will create a thread that will periodically check the options in the container for updates. The update period is determined by the context's 'options-update-interval' setting.
[in] | options | the options container |
[in] | callback | callback function pointer to update on value changes |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
void rs2_set_options_changed_callback_cpp | ( | rs2_options * | options, |
rs2_options_changed_callback * | callback, | ||
rs2_error ** | error ) |
Sets a callback in case an option in this options container value is updated
[in] | options | the options container |
[in] | callback | callback object created from c++ application. ownership over the callback object is moved to librealsense |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |
const char * rs2_sr300_visual_preset_to_string | ( | rs2_sr300_visual_preset | preset | ) |
int rs2_supports_option | ( | const rs2_options * | options, |
rs2_option | option, | ||
rs2_error ** | error ) |
check if particular option is supported by a subdevice
[in] | options | the options container |
[in] | option | option id to be checked |
[out] | error | if non-null, receives any error that occurs during this call, otherwise, errors are ignored |