OrbbecSDK2 2.0.2
OrbbecSDK2: New generation Software-Development-Kit for Orbbec 3D-Sensor devices
载入中...
搜索中...
未找到
ob2camera.h
浏览该文件的文档.
1#pragma once
2
3#include "ob2types.h"
4
5#ifdef __cplusplus
6extern "C" {
7#endif
8
31
60
88
119 ob2_status_t *status);
120
154 ob2_camera_stream_profile_t target_camera_stream_profile, ob2_status_t *status);
155
195 ob2_camera_stream_profile_t target_camera_stream_profile, uint32_t index,
196 ob2_status_t *status);
231
250
279 const ob2_camera_stream_profile_t *stream_profile, ob2_status_t *status);
280
307
345void ob2_cameras_config_set_and_enable_camera_stream(ob2_cameras_config_t cameras_config_handle, ob2_camera_type_t camera_type, uint32_t width_pixels,
346 uint32_t height_pixels, uint32_t frame_rate, ob2_image_format_t format, ob2_status_t *status);
347
372
404
437
463
489
519void ob2_cameras_config_set_cameras_sync_delay_usec(ob2_cameras_config_t cameras_config_handle, uint32_t cameras_sync_delay_usec, ob2_status_t *status);
520
544
574void ob2_cameras_config_set_secondary_delay_off_primary_usec(ob2_cameras_config_t cameras_config_handle, uint32_t secondary_delay_usec, ob2_status_t *status);
575
603 ob2_status_t *status);
604
638void ob2_device_start_cameras(ob2_device_t device_handle, const ob2_cameras_config_t cameras_config_handle, ob2_status_t *status);
639
678void ob2_device_start_cameras_with_callback(ob2_device_t device_handle, const ob2_cameras_config_t cameras_config_handle, ob2_capture_cb_t cb, void *user_data,
679 ob2_status_t *status);
680
709void ob2_device_update_cameras_config(ob2_device_t device_handle, const ob2_cameras_config_t cameras_config_handle, ob2_status_t *status);
710
729
768ob2_capture_t ob2_device_get_capture(ob2_device_t device_handle, int32_t timeout_msec, ob2_status_t *status);
769
796
827
848void ob2_capture_release(ob2_capture_t capture_handle, ob2_status_t *status);
849
885
914
943
972
1002void ob2_capture_set_image(ob2_capture_t capture_handle, ob2_camera_type_t camera_type, ob2_image_t image_handle, ob2_status_t *status);
1003
1031void ob2_capture_set_color_image(ob2_capture_t capture_handle, ob2_image_t image_handle, ob2_status_t *status);
1032
1060void ob2_capture_set_depth_image(ob2_capture_t capture_handle, ob2_image_t image_handle, ob2_status_t *status);
1061
1089void ob2_capture_set_ir_image(ob2_capture_t capture_handle, ob2_image_t image_handle, ob2_status_t *status);
1090
1125ob2_image_t ob2_image_create(ob2_camera_type_t source_camera_type, ob2_image_format_t format, uint32_t width_pixels, uint32_t height_pixels,
1126 uint32_t stride_bytes, ob2_status_t *status);
1127
1174ob2_image_t ob2_image_create_from_buffer(ob2_camera_type_t source_camera_type, ob2_image_format_t format, uint32_t width_pixels, uint32_t height_pixels,
1175 uint32_t stride_bytes, uint8_t *buffer, uint32_t buffer_size, ob2_buffer_release_cb_t buffer_release_cb,
1176 void *user_data, ob2_status_t *status);
1177
1208
1229void ob2_image_release(ob2_image_t image_handle, ob2_status_t *status);
1230
1257uint8_t *ob2_image_get_buffer(ob2_image_t image_handle, ob2_status_t *status);
1258
1282uint32_t ob2_image_get_size(ob2_image_t image_handle, ob2_status_t *status);
1283
1307
1328
1349
1380
1415
1439
1462
1488
1519
1520#ifdef __cplusplus
1521}
1522#endif
void ob2_cameras_config_set_images_sync_mode(ob2_cameras_config_t cameras_config_handle, ob2_images_sync_mode_t images_sync_mode, ob2_status_t *status)
设备内多相机图像同步模式配置
ob2_camera_type_t ob2_device_get_supported_camera_type(ob2_device_t device_handle, uint32_t index, ob2_status_t *status)
获取设备内指定索引号绑定的相机类型
ob2_image_t ob2_capture_get_image(ob2_capture_t capture_handle, ob2_camera_type_t camera_type, ob2_status_t *status)
获取指定相机的图像
ob2_image_t ob2_capture_get_depth_image(ob2_capture_t capture_handle, ob2_status_t *status)
获取 Depth 相机图像
void ob2_device_start_cameras_with_callback(ob2_device_t device_handle, const ob2_cameras_config_t cameras_config_handle, ob2_capture_cb_t cb, void *user_data, ob2_status_t *status)
通过回调返回 capture 的方式启动设备内相机工作(开流)
void ob2_cameras_config_set_cameras_sync_mode(ob2_cameras_config_t cameras_config_handle, ob2_cameras_sync_mode_t sync_mode, ob2_status_t *status)
(单机内)多相机同步(同步曝光)模式配置
ob2_image_t ob2_image_create_from_buffer(ob2_camera_type_t source_camera_type, ob2_image_format_t format, uint32_t width_pixels, uint32_t height_pixels, uint32_t stride_bytes, uint8_t *buffer, uint32_t buffer_size, ob2_buffer_release_cb_t buffer_release_cb, void *user_data, ob2_status_t *status)
从指定 buffer 创建图像
void ob2_cameras_config_enable_camera_stream(ob2_cameras_config_t cameras_config_handle, ob2_camera_type_t camera_type, ob2_status_t *status)
使能相机
ob2_camera_stream_profile_t ob2_device_get_camera_stream_profile(ob2_device_t device_handle, ob2_camera_type_t camera_type, uint32_t index, ob2_status_t *status)
通过索引号获取指定相机类型的数据流配置
uint32_t ob2_image_get_width_pixels(ob2_image_t image_handle, ob2_status_t *status)
获取图像宽度
void ob2_capture_set_color_image(ob2_capture_t capture_handle, ob2_image_t image_handle, ob2_status_t *status)
设置 Color 相机的图像
void ob2_capture_reference(ob2_capture_t capture_handle, ob2_status_t *status)
增加 capture 引用计数
void ob2_cameras_config_set_cameras_sync_delay_usec(ob2_cameras_config_t cameras_config_handle, uint32_t cameras_sync_delay_usec, ob2_status_t *status)
(单机内)多相机同步延时配置,用于控制从相机在主相机图像采集后延时多长时间开始图像采集
ob2_camera_stream_profile_t ob2_device_get_alignable_camera_stream_profile(ob2_device_t device_handle, ob2_images_align_mode_t align_mode, ob2_camera_stream_profile_t target_camera_stream_profile, uint32_t index, ob2_status_t *status)
通过索引号获取支持对齐的相机数据流配置
void ob2_cameras_config_set_images_align_mode(ob2_cameras_config_t cameras_config_handle, ob2_images_align_mode_t mode, ob2_status_t *status)
图像对齐模式配置
ob2_camera_type_t ob2_image_get_source_camera_type(ob2_image_t image_handle, ob2_status_t *status)
获取图像源相机类型
void ob2_capture_set_image(ob2_capture_t capture_handle, ob2_camera_type_t camera_type, ob2_image_t image_handle, ob2_status_t *status)
设置指定相机的图像
uint8_t * ob2_image_get_buffer(ob2_image_t image_handle, ob2_status_t *status)
获取图像 buffer
void ob2_capture_set_ir_image(ob2_capture_t capture_handle, ob2_image_t image_handle, ob2_status_t *status)
设置红外相机的图像
ob2_capture_t ob2_device_get_capture(ob2_device_t device_handle, int32_t timeout_msec, ob2_status_t *status)
获取 capture
void ob2_cameras_config_set_produce_capture_policy(ob2_cameras_config_t cameras_config_handle, ob2_produce_capture_policy_t policy, ob2_status_t *status)
capture 生成策略配置
void ob2_image_reference(ob2_image_t image_handle, ob2_status_t *status)
增加图像引用计数
uint64_t ob2_image_get_system_timestamp_usec(ob2_image_t image_handle, ob2_status_t *status)
获取系统时间戳
uint32_t ob2_image_get_height_pixels(ob2_image_t image_handle, ob2_status_t *status)
获取图像高度
uint32_t ob2_device_get_alignable_camera_stream_profile_count(ob2_device_t device_handle, ob2_images_align_mode_t image_align_mode, ob2_camera_stream_profile_t target_camera_stream_profile, ob2_status_t *status)
获取支持对齐的相机数据流配置个数
ob2_image_t ob2_capture_get_color_image(ob2_capture_t capture_handle, ob2_status_t *status)
获取 Color 相机图像
uint32_t ob2_image_get_size(ob2_image_t image_handle, ob2_status_t *status)
获取图像数据大小
void ob2_cameras_config_set_secondary_delay_off_primary_usec(ob2_cameras_config_t cameras_config_handle, uint32_t secondary_delay_usec, ob2_status_t *status)
从设备延时配置
void ob2_device_update_cameras_config(ob2_device_t device_handle, const ob2_cameras_config_t cameras_config_handle, ob2_status_t *status)
更新设备相机配置
void ob2_cameras_config_release(ob2_cameras_config_t cameras_config_handle, ob2_status_t *status)
释放相机配置句柄
ob2_cameras_config_t ob2_device_create_cameras_config(ob2_device_t device_handle, ob2_status_t *status)
创建设备的相机配置
void ob2_cameras_config_set_wired_sync_mode(ob2_cameras_config_t cameras_config_handle, ob2_wired_sync_mode_t wired_sync_mode, ob2_status_t *status)
外部同步模式配置(通常是通过同步信号线输入 / 输出同步信号完成同步,所以命名为 wired_sync_mode)
void ob2_image_release(ob2_image_t image_handle, ob2_status_t *status)
释放图像
uint32_t ob2_image_get_stride_bytes(ob2_image_t image_handle, ob2_status_t *status)
获取图像行跨度
uint32_t ob2_device_get_camera_stream_profile_count(ob2_device_t device_handle, ob2_camera_type_t camera_type, ob2_status_t *status)
获取指定相机类型支持的数据流配置个数
uint8_t ob2_image_get_available_bits_for_each_pixel(ob2_image_t image_handle, ob2_status_t *status)
获取图像像素有效位数
void ob2_device_stop_cameras(ob2_device_t device_handle, ob2_status_t *status)
停止设备内相机工作(关流)
ob2_capture_t ob2_capture_create(ob2_status_t *status)
创建 capture
ob2_cameras_calibration_t ob2_device_get_cameras_calibration(ob2_device_t device_handle, const ob2_cameras_config_t cameras_config_handle, ob2_status_t *status)
获取当前配置下的相机标定参数
uint32_t ob2_device_get_supported_camera_count(ob2_device_t device_handle, ob2_status_t *status)
获取设备支持的相机个数
void ob2_capture_set_depth_image(ob2_capture_t capture_handle, ob2_image_t image_handle, ob2_status_t *status)
设置 Depth 相机的图像
void ob2_cameras_config_disable_camera_stream(ob2_cameras_config_t cameras_config_handle, ob2_camera_type_t camera_type, ob2_status_t *status)
关闭(去除使能)相机数据流
ob2_image_t ob2_capture_get_ir_image(ob2_capture_t capture_handle, ob2_status_t *status)
获取红外相机图像
ob2_image_t ob2_image_create(ob2_camera_type_t source_camera_type, ob2_image_format_t format, uint32_t width_pixels, uint32_t height_pixels, uint32_t stride_bytes, ob2_status_t *status)
创建图像
void ob2_capture_release(ob2_capture_t capture_handle, ob2_status_t *status)
释放 capture
ob2_image_format_t ob2_image_get_format(ob2_image_t image_handle, ob2_status_t *status)
获取图像格式
void ob2_cameras_config_set_and_enable_camera_stream(ob2_cameras_config_t cameras_config_handle, ob2_camera_type_t camera_type, uint32_t width_pixels, uint32_t height_pixels, uint32_t frame_rate, ob2_image_format_t format, ob2_status_t *status)
配置相机数据流并使能相机
void ob2_cameras_config_set_camera_stream_profile(ob2_cameras_config_t cameras_config_handle, ob2_camera_type_t camera_type, const ob2_camera_stream_profile_t *stream_profile, ob2_status_t *status)
设置相机数据流配置
float ob2_depth_image_get_value_scale(ob2_image_t image_handle, ob2_status_t *status)
获取深度图像数值缩放系数
uint64_t ob2_image_get_device_timestamp_usec(ob2_image_t image_handle, ob2_status_t *status)
获取设备时间戳
void ob2_device_start_cameras(ob2_device_t device_handle, const ob2_cameras_config_t cameras_config_handle, ob2_status_t *status)
启动设备内相机工作(开流)
ob2_produce_capture_policy_t
Definition: ob2types.h:679
ob2_images_align_mode_t
图像对齐模式
Definition: ob2types.h:722
ob2_camera_type_t
相机类型
Definition: ob2types.h:472
struct OB2DeviceImpl * ob2_device_t
设备句柄定义
Definition: ob2types.h:31
struct OB2ImageImpl * ob2_image_t
图像句柄定义
Definition: ob2types.h:67
struct OB2CaptureImpl * ob2_capture_t
capture 句柄定义
Definition: ob2types.h:55
ob2_images_sync_mode_t
图像同步模式,用于控制生成 capture 时如何同步不同相机的图像
Definition: ob2types.h:653
void(* ob2_buffer_release_cb_t)(uint8_t *buffer, void *user_data)
buffer 释放回调,用于用户自定义 buffer 创建 image 释放时回收内存
Definition: ob2types.h:1540
ob2_image_format_t
图像数据格式
Definition: ob2types.h:486
void(* ob2_capture_cb_t)(ob2_capture_t capture_handle, void *user_data)
Definition: ob2types.h:1531
struct OB2CamerasConfigImpl * ob2_cameras_config_t
相机配置句柄定义
Definition: ob2types.h:43
ob2_cameras_sync_mode_t
相机同步模式
Definition: ob2types.h:1462
ob2_wired_sync_mode_t
多机线连接同步模式
Definition: ob2types.h:1478
用户函数调用返回的状态结构体
Definition: ob2types.h:312