Advanced.h File Reference

#include "ObTypes.h"

Go to the source code of this file.

Macros
#define	ob_depth_work_mode_list_count   ob_depth_work_mode_list_get_count
#define	ob_device_preset_list_count   ob_device_preset_list_get_count

Functions
OB_EXPORT ob_depth_work_mode	ob_device_get_current_depth_work_mode (const ob_device *device, ob_error **error)
	Get the current depth work mode.
OB_EXPORT const char *	ob_device_get_current_depth_work_mode_name (const ob_device *device, ob_error **error)
	Get current depth mode name.
OB_EXPORT ob_status	ob_device_switch_depth_work_mode (ob_device *device, const ob_depth_work_mode *work_mode, ob_error **error)
	Switch the depth work mode by ob_depth_work_mode. Prefer to use ob_device_switch_depth_work_mode_by_name to switch depth mode when the complete name of the depth work mode is known.
OB_EXPORT ob_status	ob_device_switch_depth_work_mode_by_name (ob_device *device, const char *mode_name, ob_error **error)
	Switch the depth work mode by work mode name.
OB_EXPORT ob_depth_work_mode_list *	ob_device_get_depth_work_mode_list (const ob_device *device, ob_error **error)
	Request the list of supported depth work modes.
OB_EXPORT uint32_t	ob_depth_work_mode_list_get_count (const ob_depth_work_mode_list *work_mode_list, ob_error **error)
	Get the depth work mode count that ob_depth_work_mode_list hold.
OB_EXPORT ob_depth_work_mode	ob_depth_work_mode_list_get_item (const ob_depth_work_mode_list *work_mode_list, uint32_t index, ob_error **error)
	Get the index target of ob_depth_work_mode from work_mode_list.
OB_EXPORT void	ob_delete_depth_work_mode_list (ob_depth_work_mode_list *work_mode_list, ob_error **error)
	Free the resources of ob_depth_work_mode_list.
OB_EXPORT const char *	ob_device_get_current_preset_name (const ob_device *device, ob_error **error)
	Get the current preset name.
OB_EXPORT const char *	ob_device_get_current_preset_depth_work_mode_version (const ob_device *device, ob_error **error)
	Get the version of the current depth work mode.
OB_EXPORT void	ob_device_load_preset (ob_device *device, const char *preset_name, ob_error **error)
	Get the available preset list.
OB_EXPORT void	ob_device_load_preset_by_depth_work_mode_version (ob_device *device, const char *preset_name, const char *version, ob_error **error)
	Load the preset by preset name and the target depth work mode version. When multiple presets share the same name, the version selects the exact one.
OB_EXPORT void	ob_device_load_preset_from_json_file (ob_device *device, const char *json_file_path, ob_error **error)
	Load preset from json string.
OB_EXPORT void	ob_device_load_preset_from_json_data (ob_device *device, const char *presetName, const uint8_t *data, uint32_t size, ob_error **error)
	Load custom preset from data.
OB_EXPORT void	ob_device_export_current_settings_as_preset_json_file (ob_device *device, const char *json_file_path, ob_error **error)
	Export current settings as a preset json file.
OB_EXPORT void	ob_device_export_current_settings_as_preset_json_data (ob_device *device, const char *presetName, const uint8_t **data, uint32_t *dataSize, ob_error **error)
	Export current device settings as a preset json data.
OB_EXPORT ob_device_preset_list *	ob_device_get_available_preset_list (const ob_device *device, ob_error **error)
	Get the available preset list.
OB_EXPORT void	ob_delete_preset_list (ob_device_preset_list *preset_list, ob_error **error)
	Delete the available preset list.
OB_EXPORT uint32_t	ob_device_preset_list_get_count (const ob_device_preset_list *preset_list, ob_error **error)
	Get the number of preset in the preset list.
OB_EXPORT const char *	ob_device_preset_list_get_name (const ob_device_preset_list *preset_list, uint32_t index, ob_error **error)
	Get the name of the preset in the preset list.
OB_EXPORT bool	ob_device_preset_list_has_preset (const ob_device_preset_list *preset_list, const char *preset_name, ob_error **error)
	Check if the preset list has the preset.
OB_EXPORT const char *	ob_device_preset_list_get_depth_work_mode_version (const ob_device_preset_list *preset_list, uint32_t index, ob_error **error)
	Get the target depth work mode version of the preset at the specified index.
OB_EXPORT bool	ob_device_is_frame_interleave_supported (const ob_device *device, ob_error **error)
	Check if the device supports the frame interleave feature.
OB_EXPORT void	ob_device_load_frame_interleave (ob_device *device, const char *frame_interleave_name, ob_error **error)
	load the frame interleave mode according to frame interleave name.
OB_EXPORT const char *	ob_device_get_current_frame_interleave_name (const ob_device *device, ob_error **error)
	Get current frame interleave name.
OB_EXPORT ob_device_frame_interleave_list *	ob_device_get_available_frame_interleave_list (ob_device *device, ob_error **error)
	Get the available frame interleave list.
OB_EXPORT void	ob_delete_frame_interleave_list (ob_device_frame_interleave_list *frame_interleave_list, ob_error **error)
	Delete the available frame interleave list.
OB_EXPORT uint32_t	ob_device_frame_interleave_list_get_count (ob_device_frame_interleave_list *frame_interleave_list, ob_error **error)
	Get the number of frame interleave in the frame interleave list.
OB_EXPORT const char *	ob_device_frame_interleave_list_get_name (ob_device_frame_interleave_list *frame_interleave_list, uint32_t index, ob_error **error)
	Get the name of frame interleave in the frame interleave list.
OB_EXPORT bool	ob_device_frame_interleave_list_has_frame_interleave (ob_device_frame_interleave_list *frame_interleave_list, const char *frame_interleave_name, ob_error **error)
	Check if the interleave ae list has the interleave ae.
OB_EXPORT ob_preset_resolution_config_list *	ob_device_get_available_preset_resolution_config_list (ob_device *device, ob_error **error)
	Get the available preset resolution config list.
OB_EXPORT uint32_t	ob_device_preset_resolution_config_get_count (ob_preset_resolution_config_listob_preset_resolution_config_list *ob_preset_resolution_config_listob_preset_resolution_config_list, ob_error **error)
	Get the number of preset resolution in the preset resolution list.
OB_EXPORT OBPresetResolutionConfig	ob_device_preset_resolution_config_list_get_item (const ob_preset_resolution_config_listob_preset_resolution_config_list *ob_preset_resolution_config_listob_preset_resolution_config_list, uint32_t index, ob_error **error)
	Get the preset resolution in the preset resolution list.
OB_EXPORT void	ob_delete_preset_resolution_config_list (ob_preset_resolution_config_listob_preset_resolution_config_list *ob_preset_resolution_config_listob_preset_resolution_config_list, ob_error **error)
	Delete the available preset resolution list.
OB_EXPORT bool	ob_device_is_color_preset_supported (const ob_device *device, ob_error **error)
	Check if the device supports color preset.
OB_EXPORT const char *	ob_device_get_current_color_preset_name (const ob_device *device, ob_error **error)
	Get the current color preset name.
OB_EXPORT void	ob_device_switch_color_preset (ob_device *device, const char *preset_name, ob_error **error)
	Switch the color preset by name.
OB_EXPORT ob_color_preset_list *	ob_device_get_color_preset_list (const ob_device *device, ob_error **error)
	Get the available color preset list.
OB_EXPORT uint32_t	ob_color_preset_list_get_count (const ob_color_preset_list *list, ob_error **error)
	Get the number of color preset in the list.
OB_EXPORT const char *	ob_color_preset_list_get_name (const ob_color_preset_list *list, uint32_t index, ob_error **error)
	Get the name of color preset at the specified index.
OB_EXPORT void	ob_delete_color_preset_list (ob_color_preset_list *list, ob_error **error)
	Delete the color preset list.

Macro Definition Documentation

ob_depth_work_mode_list_count

#define ob_depth_work_mode_list_count   ob_depth_work_mode_list_get_count

Definition at line 447 of file Advanced.h.

ob_device_preset_list_count

#define ob_device_preset_list_count   ob_device_preset_list_get_count

Definition at line 448 of file Advanced.h.

Function Documentation

ob_device_get_current_depth_work_mode()

OB_EXPORT ob_depth_work_mode ob_device_get_current_depth_work_mode	(	const ob_device *	device,
		ob_error **	error )

Get the current depth work mode.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

ob_depth_work_mode The current depth work mode.

Referenced by ob::Device::getCurrentDepthWorkMode(), and ob_device_get_current_depth_work_mode().

ob_device_get_current_depth_work_mode_name()

OB_EXPORT const char * ob_device_get_current_depth_work_mode_name	(	const ob_device *	device,
		ob_error **	error )

Get current depth mode name.

According the current preset name to return current depth mode name

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

const char* return the current depth mode name.

Referenced by ob::Device::getCurrentDepthModeName(), and ob_device_get_current_depth_work_mode_name().

ob_device_switch_depth_work_mode()

OB_EXPORT ob_status ob_device_switch_depth_work_mode	(	ob_device *	device,
		const ob_depth_work_mode *	work_mode,
		ob_error **	error )

Switch the depth work mode by ob_depth_work_mode. Prefer to use ob_device_switch_depth_work_mode_by_name to switch depth mode when the complete name of the depth work mode is known.

Parameters

[in]	device	The device object.
[in]	work_mode	The depth work mode from ob_depth_work_mode_list which is returned by ob_device_get_depth_work_mode_list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

ob_status The switch result. OB_STATUS_OK: success, other failed.

Referenced by ob_device_switch_depth_work_mode(), and ob::Device::switchDepthWorkMode().

ob_device_switch_depth_work_mode_by_name()

OB_EXPORT ob_status ob_device_switch_depth_work_mode_by_name	(	ob_device *	device,
		const char *	mode_name,
		ob_error **	error )

Switch the depth work mode by work mode name.

Parameters

[in]	device	The device object.
[in]	mode_name	The depth work mode name which is equal to ob_depth_work_mode.name.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

ob_status The switch result. OB_STATUS_OK: success, other failed.

Referenced by ob_device_switch_depth_work_mode_by_name(), and ob::Device::switchDepthWorkMode().

ob_device_get_depth_work_mode_list()

OB_EXPORT ob_depth_work_mode_list * ob_device_get_depth_work_mode_list	(	const ob_device *	device,
		ob_error **	error )

Request the list of supported depth work modes.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

ob_depth_work_mode_list The list of ob_depth_work_mode.

Referenced by ob::Device::getDepthWorkModeList(), and ob_device_get_depth_work_mode_list().

ob_depth_work_mode_list_get_count()

OB_EXPORT uint32_t ob_depth_work_mode_list_get_count	(	const ob_depth_work_mode_list *	work_mode_list,
		ob_error **	error )

Get the depth work mode count that ob_depth_work_mode_list hold.

Parameters

[in]	work_mode_list	Data structure containing a list of ob_depth_work_mode
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The total number contained in ob_depth_work_mode_list

Referenced by ob::OBDepthWorkModeList::getCount(), and ob_depth_work_mode_list_get_count().

ob_depth_work_mode_list_get_item()

OB_EXPORT ob_depth_work_mode ob_depth_work_mode_list_get_item	(	const ob_depth_work_mode_list *	work_mode_list,
		uint32_t	index,
		ob_error **	error )

Get the index target of ob_depth_work_mode from work_mode_list.

Parameters

[in]	work_mode_list	Data structure containing a list of ob_depth_work_mode
[in]	index	Index of the target ob_depth_work_mode
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

ob_depth_work_mode

Referenced by ob::OBDepthWorkModeList::getOBDepthWorkMode(), and ob_depth_work_mode_list_get_item().

ob_delete_depth_work_mode_list()

OB_EXPORT void ob_delete_depth_work_mode_list	(	ob_depth_work_mode_list *	work_mode_list,
		ob_error **	error )

Free the resources of ob_depth_work_mode_list.

Parameters

[in]	work_mode_list	Data structure containing a list of ob_depth_work_mode
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob_delete_depth_work_mode_list(), and ob::OBDepthWorkModeList::~OBDepthWorkModeList().

ob_device_get_current_preset_name()

OB_EXPORT const char * ob_device_get_current_preset_name	(	const ob_device *	device,
		ob_error **	error )

Get the current preset name.

The preset mean a set of parameters or configurations that can be applied to the device to achieve a specific effect or function.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The current preset name, it should be one of the preset names returned by ob_device_get_available_preset_list.

Referenced by ob::Device::getCurrentPresetName(), and ob_device_get_current_preset_name().

ob_device_get_current_preset_depth_work_mode_version()

OB_EXPORT const char * ob_device_get_current_preset_depth_work_mode_version	(	const ob_device *	device,
		ob_error **	error )

Get the version of the current depth work mode.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

const char* The version string, e.g. "1.2.3". Empty string when the device does not support versioned modes.

Referenced by ob::Device::getCurrentPresetDepthWorkModeVersion(), and ob_device_get_current_preset_depth_work_mode_version().

ob_device_load_preset()

OB_EXPORT void ob_device_load_preset	(	ob_device *	device,
		const char *	preset_name,
		ob_error **	error )

Get the available preset list.

Attention

After loading the preset, the settings in the preset will set to the device immediately. Therefore, it is recommended to re-read the device settings to update the user program temporarily.

Parameters

[in]	device	The device object.
[in]	preset_name	Pointer to an error object that will be set if an error occurs. The name should be one of the preset names returned by ob_device_get_available_preset_list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob::Device::loadPreset(), and ob_device_load_preset().

ob_device_load_preset_by_depth_work_mode_version()

OB_EXPORT void ob_device_load_preset_by_depth_work_mode_version	(	ob_device *	device,
		const char *	preset_name,
		const char *	version,
		ob_error **	error )

Load the preset by preset name and the target depth work mode version. When multiple presets share the same name, the version selects the exact one.

Parameters

[in]	device	The device object.
[in]	preset_name	The preset name. The name should be one of the preset names returned by ob_device_get_available_preset_list.
[in]	version	The target depth work mode version string, e.g. "1.2.3". Must not be empty.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob::Device::loadPreset(), and ob_device_load_preset_by_depth_work_mode_version().

ob_device_load_preset_from_json_file()

OB_EXPORT void ob_device_load_preset_from_json_file	(	ob_device *	device,
		const char *	json_file_path,
		ob_error **	error )

Load preset from json string.

After loading the custom preset, the settings in the custom preset will set to the device immediately.

After loading the custom preset, the available preset list will be appended with the custom preset and named as the file name.

Parameters

[in]	device	The device object.
[in]	json_file_path	The json file path.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob::Device::loadPresetFromJsonFile(), and ob_device_load_preset_from_json_file().

ob_device_load_preset_from_json_data()

OB_EXPORT void ob_device_load_preset_from_json_data	(	ob_device *	device,
		const char *	presetName,
		const uint8_t *	data,
		uint32_t	size,
		ob_error **	error )

Load custom preset from data.

After loading the custom preset, the settings in the custom preset will set to the device immediately.

After loading the custom preset, the available preset list will be appended with the custom preset and named as the presetName.

Attention

The user should ensure that the custom preset data is adapted to the device and the settings in the data are valid.

It is recommended to re-read the device settings to update the user program temporarily after successfully loading the custom preset.

Parameters

[in]	device	The device object.
[in]	presetName	The name of the custome preset.
[in]	data	The custom preset data.
[in]	size	The size of the custom preset data.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob::Device::loadPresetFromJsonData(), and ob_device_load_preset_from_json_data().

ob_device_export_current_settings_as_preset_json_file()

OB_EXPORT void ob_device_export_current_settings_as_preset_json_file	(	ob_device *	device,
		const char *	json_file_path,
		ob_error **	error )

Export current settings as a preset json file.

After exporting the custom preset, the available preset list will be appended with the custom preset and named as the file name.

Parameters

[in]	device	The device object.
[in]	json_file_path	The json file path.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob::Device::exportSettingsAsPresetJsonFile(), and ob_device_export_current_settings_as_preset_json_file().

ob_device_export_current_settings_as_preset_json_data()

OB_EXPORT void ob_device_export_current_settings_as_preset_json_data	(	ob_device *	device,
		const char *	presetName,
		const uint8_t **	data,
		uint32_t *	dataSize,
		ob_error **	error )

Export current device settings as a preset json data.

After exporting the preset, a new preset named as the presetName will be added to the available preset list.

Attention

The memory of the data is allocated by the SDK, and will automatically be released by the SDK.

The memory of the data will be reused by the SDK on the next call, so the user should copy the data to a new buffer if it needs to be preserved.

Parameters

[in]	device	The device object.
[in]	presetName	The name of the custome preset.
[out]	data	Return the preset json data.
[out]	dataSize	Return the size of the preset json data.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob::Device::exportSettingsAsPresetJsonData(), and ob_device_export_current_settings_as_preset_json_data().

ob_device_get_available_preset_list()

OB_EXPORT ob_device_preset_list * ob_device_get_available_preset_list	(	const ob_device *	device,
		ob_error **	error )

Get the available preset list.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The available preset list.

Referenced by ob::Device::getAvailablePresetList(), and ob_device_get_available_preset_list().

ob_delete_preset_list()

OB_EXPORT void ob_delete_preset_list	(	ob_device_preset_list *	preset_list,
		ob_error **	error )

Delete the available preset list.

Parameters

[in]	preset_list	The available preset list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob_delete_preset_list(), and ob::DevicePresetList::~DevicePresetList().

ob_device_preset_list_get_count()

OB_EXPORT uint32_t ob_device_preset_list_get_count	(	const ob_device_preset_list *	preset_list,
		ob_error **	error )

Get the number of preset in the preset list.

Parameters

[in]	preset_list	The available preset list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The number of preset in the preset list.

Referenced by ob::DevicePresetList::getCount(), and ob_device_preset_list_get_count().

ob_device_preset_list_get_name()

OB_EXPORT const char * ob_device_preset_list_get_name	(	const ob_device_preset_list *	preset_list,
		uint32_t	index,
		ob_error **	error )

Get the name of the preset in the preset list.

Parameters

[in]	preset_list	The available preset list.
[in]	index	The index of the preset in the preset list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The name of the preset in the preset list.

Referenced by ob::DevicePresetList::getName(), and ob_device_preset_list_get_name().

ob_device_preset_list_has_preset()

OB_EXPORT bool ob_device_preset_list_has_preset	(	const ob_device_preset_list *	preset_list,
		const char *	preset_name,
		ob_error **	error )

Check if the preset list has the preset.

Parameters

[in]	preset_list	The available preset list.
[in]	preset_name	The name of the preset.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

Whether the preset list has the preset. If true, the preset list has the preset. If false, the preset list does not have the preset.

Referenced by ob::DevicePresetList::hasPreset(), and ob_device_preset_list_has_preset().

ob_device_preset_list_get_depth_work_mode_version()

OB_EXPORT const char * ob_device_preset_list_get_depth_work_mode_version	(	const ob_device_preset_list *	preset_list,
		uint32_t	index,
		ob_error **	error )

Get the target depth work mode version of the preset at the specified index.

Parameters

[in]	preset_list	Data structure containing a list of presets
[in]	index	Index of the target preset
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

const char* The version string of the depth work mode, e.g. "1.2.3". Empty string when the device does not support versioned modes.

Referenced by ob::DevicePresetList::getDepthWorkModeVersion(), and ob_device_preset_list_get_depth_work_mode_version().

ob_device_is_frame_interleave_supported()

OB_EXPORT bool ob_device_is_frame_interleave_supported	(	const ob_device *	device,
		ob_error **	error )

Check if the device supports the frame interleave feature.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

bool Returns true if the device supports the frame interleave feature.

Referenced by ob::Device::isFrameInterleaveSupported(), and ob_device_is_frame_interleave_supported().

ob_device_load_frame_interleave()

OB_EXPORT void ob_device_load_frame_interleave	(	ob_device *	device,
		const char *	frame_interleave_name,
		ob_error **	error )

load the frame interleave mode according to frame interleave name.

Parameters

[in]	device	The device object.
[in]	frame_interleave_name	The name should be one of the frame interleave names returned by ob_device_get_available_frame_interleave_list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob::Device::loadFrameInterleave(), and ob_device_load_frame_interleave().

ob_device_get_current_frame_interleave_name()

OB_EXPORT const char * ob_device_get_current_frame_interleave_name	(	const ob_device *	device,
		ob_error **	error )

Get current frame interleave name.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

const char* return the current frame interleave name. Returns an empty string ("") if no interleave is loaded. Returns nullptr if an error occurs.

Referenced by ob::Device::getCurrentFrameInterleaveName(), and ob_device_get_current_frame_interleave_name().

ob_device_get_available_frame_interleave_list()

OB_EXPORT ob_device_frame_interleave_list * ob_device_get_available_frame_interleave_list	(	ob_device *	device,
		ob_error **	error )

Get the available frame interleave list.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The available frame interleave list.

Referenced by ob::Device::getAvailableFrameInterleaveList(), and ob_device_get_available_frame_interleave_list().

ob_delete_frame_interleave_list()

OB_EXPORT void ob_delete_frame_interleave_list	(	ob_device_frame_interleave_list *	frame_interleave_list,
		ob_error **	error )

Delete the available frame interleave list.

Parameters

[in]	frame_interleave_list	The available frame interleave list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob_delete_frame_interleave_list(), and ob::DeviceFrameInterleaveList::~DeviceFrameInterleaveList().

ob_device_frame_interleave_list_get_count()

OB_EXPORT uint32_t ob_device_frame_interleave_list_get_count	(	ob_device_frame_interleave_list *	frame_interleave_list,
		ob_error **	error )

Get the number of frame interleave in the frame interleave list.

Parameters

[in]	frame_interleave_list	The available frame interleave list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The number of frame interleave in the frame interleave list.

Referenced by ob::DeviceFrameInterleaveList::getCount(), and ob_device_frame_interleave_list_get_count().

ob_device_frame_interleave_list_get_name()

OB_EXPORT const char * ob_device_frame_interleave_list_get_name	(	ob_device_frame_interleave_list *	frame_interleave_list,
		uint32_t	index,
		ob_error **	error )

Get the name of frame interleave in the frame interleave list.

Parameters

[in]	frame_interleave_list	The available frame interleave list.
[in]	index	The index of frame interleave in the frame interleave list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The name of frame interleave in the frame interleave list..

Referenced by ob::DeviceFrameInterleaveList::getName(), and ob_device_frame_interleave_list_get_name().

ob_device_frame_interleave_list_has_frame_interleave()

OB_EXPORT bool ob_device_frame_interleave_list_has_frame_interleave	(	ob_device_frame_interleave_list *	frame_interleave_list,
		const char *	frame_interleave_name,
		ob_error **	error )

Check if the interleave ae list has the interleave ae.

Parameters

[in]	frame_interleave_list	The available interleave ae list.
[in]	frame_interleave_name	The name of the interleave ae.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

Whether the interleave ae list has the interleave ae. If true, the interleave ae list has the interleave ae. If false, the interleave ae list does not have the interleave ae.

Referenced by ob::DeviceFrameInterleaveList::hasFrameInterleave(), and ob_device_frame_interleave_list_has_frame_interleave().

ob_device_get_available_preset_resolution_config_list()

OB_EXPORT ob_preset_resolution_config_list * ob_device_get_available_preset_resolution_config_list	(	ob_device *	device,
		ob_error **	error )

Get the available preset resolution config list.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The available frame resolution config list.

Referenced by ob::Device::getAvailablePresetResolutionConfigList(), and ob_device_get_available_preset_resolution_config_list().

ob_device_preset_resolution_config_get_count()

OB_EXPORT uint32_t ob_device_preset_resolution_config_get_count	(	ob_preset_resolution_config_list *	ob_preset_resolution_config_list,
		ob_error **	error )

Get the number of preset resolution in the preset resolution list.

Parameters

[in]	ob_preset_resolution_config_list	The available preset resolution list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The number of preset resolution in the preset resolution list.

Referenced by ob::PresetResolutionConfigList::getCount(), and ob_device_preset_resolution_config_get_count().

ob_device_preset_resolution_config_list_get_item()

OB_EXPORT OBPresetResolutionConfig ob_device_preset_resolution_config_list_get_item	(	const ob_preset_resolution_config_list *	ob_preset_resolution_config_list,
		uint32_t	index,
		ob_error **	error )

Get the preset resolution in the preset resolution list.

Parameters

[in]	ob_preset_resolution_config_list	The available preset resolution list.
[in]	index	The index of preset resolution in the preset resolution list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

The preset resolution in the preset resolution list.

Referenced by ob::PresetResolutionConfigList::getPresetResolutionRatioConfig(), and ob_device_preset_resolution_config_list_get_item().

ob_delete_preset_resolution_config_list()

OB_EXPORT void ob_delete_preset_resolution_config_list	(	ob_preset_resolution_config_list *	ob_preset_resolution_config_list,
		ob_error **	error )

Delete the available preset resolution list.

Parameters

[in]	ob_preset_resolution_config_list	The available preset resolution list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob_delete_preset_resolution_config_list(), and ob::PresetResolutionConfigList::~PresetResolutionConfigList().

ob_device_is_color_preset_supported()

OB_EXPORT bool ob_device_is_color_preset_supported	(	const ob_device *	device,
		ob_error **	error )

Check if the device supports color preset.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

bool Returns true if the device supports color preset.

Referenced by ob::Device::isColorPresetSupported(), and ob_device_is_color_preset_supported().

ob_device_get_current_color_preset_name()

OB_EXPORT const char * ob_device_get_current_color_preset_name	(	const ob_device *	device,
		ob_error **	error )

Get the current color preset name.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

const char* The current color preset name.

Referenced by ob::Device::getCurrentColorPresetName(), and ob_device_get_current_color_preset_name().

ob_device_switch_color_preset()

OB_EXPORT void ob_device_switch_color_preset	(	ob_device *	device,
		const char *	preset_name,
		ob_error **	error )

Switch the color preset by name.

Parameters

[in]	device	The device object.
[in]	preset_name	The color preset name.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob_device_switch_color_preset(), and ob::Device::switchColorPreset().

ob_device_get_color_preset_list()

OB_EXPORT ob_color_preset_list * ob_device_get_color_preset_list	(	const ob_device *	device,
		ob_error **	error )

Get the available color preset list.

Parameters

[in]	device	The device object.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

ob_color_preset_list* The color preset list.

Referenced by ob::Device::getColorPresetList(), and ob_device_get_color_preset_list().

ob_color_preset_list_get_count()

OB_EXPORT uint32_t ob_color_preset_list_get_count	(	const ob_color_preset_list *	list,
		ob_error **	error )

Get the number of color preset in the list.

Parameters

[in]	list	The color preset list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

uint32_t The number of color preset in the list.

Referenced by ob::ColorPresetList::getCount(), and ob_color_preset_list_get_count().

ob_color_preset_list_get_name()

OB_EXPORT const char * ob_color_preset_list_get_name	(	const ob_color_preset_list *	list,
		uint32_t	index,
		ob_error **	error )

Get the name of color preset at the specified index.

Parameters

[in]	list	The color preset list.
[in]	index	The index of the color preset.
[out]	error	Pointer to an error object that will be set if an error occurs.

Returns

const char* The name of the color preset.

Referenced by ob::ColorPresetList::getName(), and ob_color_preset_list_get_name().

ob_delete_color_preset_list()

OB_EXPORT void ob_delete_color_preset_list	(	ob_color_preset_list *	list,
		ob_error **	error )

Delete the color preset list.

Parameters

[in]	list	The color preset list.
[out]	error	Pointer to an error object that will be set if an error occurs.

Referenced by ob_delete_color_preset_list(), and ob::ColorPresetList::~ColorPresetList().