图漾相机——C#语言属性设置

文章目录

前言
1.示例程序说明
2.SDK API功能介绍
- 2.1 ListDevice 枚举设备
- 2.2 Open 打开相机
- 2.3 OpenDeviceByIP 通过IP打开设备
- 2.4 Close 关闭设备
- 2.5 DeviceStreamEnable 取流使能
- 2.6 DeviceStreamFormatDump 取流分辨率
- 2.7 DeviceStreamFormatConfig 取流分辨率配置
- 2.8 DeviceReadCurrentEnumData 取图当前分辨率
- 2.9 DeviceReadCalibData 读取标定参数
- 2.10 DeviceStreamOn 打开取流
- 2.11 DeviceStreamOff 关闭取流
- 2.12 DeviceStreamRead 获取帧数据
- 2.13 DeviceStreamDepthRender 解析和渲染深度图图像
- 2.14 DeviceStreamImageDecode 解析RGB图像
- 2.15 DeviceStreamIRRender 解析IR图像
- 2.16 DeviceControlLaserPowerAutoControlEnable 使能IR激光器
- 2.17 DeviceControlLaserPowerConfig 设置激光亮度
- 2.18 DeviceColorStreamIspEnable 打开RGB的ISP
- 2.19 DeviceStreamMapDepthImageToColorCoordinate 深度图对齐到彩色图
- 2.20 DeviceStreamMapRGBImageToDepthCoordinate 彩色图对齐到深度图
- 2.21 DeviceStreamDoUndistortion 做畸变校正
- 2.22 DeviceControlTriggerModeEnable 设置相机工作模式
- 2.23 DeviceControlTriggerModeSendTriggerSignal 发送软触发指令
- 2.24DeviceStreamMapDepthImageToPoint3D 深度图转点云
- 2.25 IPv4StringToInt 将字符串转换成整型
- - 2.25.1 ip设置
  - 2.25.2 netmask设置
  - 2.25.3 gateway设置
- 2.26 DevParamFromInt 设置Int变量
- 2.27 DevParamFromEnum 设置枚举变量
- 2.28 DevParamFromBool 设置Bool变量
- 2.29 DevParamFromFloat 设置Float变量
- 2.30 DeviceSetParameter 设置相机参数
- 2.31 DeviceGetParameter 获取相机参数
- - 2.31.1 Int型获取Int类型
  - 2.31.2 Enum型获取枚举类型
  - 2.31.3 Bool型获取Bool参数
  - 2.31.4 Float型获取Float参数
  - 2.31.5 Array型获取BYTEARRAY参数
  - 2.31.6 Struct(roi)型获取Struct类型
- 2.32 get_netinfo 获取网络相机信息接口
- 2.33 DeviceLoadDefaultParameters 加载相机配置文件
- 2.34 DeviceWriteDefaultParametersFromJSFile 将参数写入到相机
- 2.35 DeviceClearDefaultParameters 清除相机参数
- 2.36 DeviceHasStream 判断相机是否在取流
- 2.37 DeviceReadRectifiedRotationData
- 2.38 DeviceReadRectifiedIntrData
3.组件属性设置
3.1 Device组件
- - 3.1.1 TY_INT_PERSISTENT_IP 静态 IP 地址
  - 3.1.2 TY_INT_PERSISTENT_SUBMASK 静态 IP 子网掩码
  - 3.1.3 TY_INT_PERSISTENT_GATEWAY 静态 IP 网关
  - 3.1.4 TY_INT_PACKET_DELAY 数据传输延迟时间
  - 3.1.5 TY_INT_PACKET_SIZE 数据传输包大小
  - 3.1.6 TY_BOOL_GVSP_RESEND 网络重传
  - 3.1.7 TY_INT_ACCEPTABLE_PERCENT 接收包比例
  - 3.1.8 TY_BOOL_KEEP_ALIVE_ONOFF 状态保持开关
  - 3.1.9 TY_INT_KEEP_ALIVE_TIME 状态保持时间
  - 3.1.10 TY_ENUM_TRIGGER_POL 触发沿设置
  - 3.1.11 TY_INT_FRAME_PER_TRIGGER 触发出图数
  - 3.1.12 TY_INT_CAPTURE_TIME_US 采集时间
  - 3.1.13 TY_INT_NTP_SERVER_IP ntp服务器ip
  - 3.1.14 TY_BOOL_CMOS_SYNC 图像同步
  - 3.1.15 TY_ENUM_STREAM_ASYNC 数据流同步
  - 3.1.16 TY_ENUM_TIME_SYNC_TYPE 相机对时功能
  - 3.1.17 TY_BOOL_TIME_SYNC_READY 判断对时是否成功
  - 3.1.18 TY_ENUM_CONFIG_MODE 出图模式
- 3.2 Depth 组件
- - 3.2.1 TY_ENUM_IMAGE_MODE 深度图图像格式
  - 3.2.2 TY_FLOAT_SCALE_UNIT 设置深度图中像素值的单位
- 3.3 Color组件
- - 3.3.1 TY_INT_EXPOSURE_TIME 设置RGB曝光时间
  - 3.3.2 TY_INT_ANALOG_GAIN 设置模拟增益
  - 3.3.3 TY_INT_R_GAIN 设置R通道增益
  - 3.3.4 TY_INT_G_GAIN 设置G通道增益
  - 3.3.5 TY_INT_B_GAIN 设置B通道增益
  - 3.3.6 TY_BOOL_AUTO_GAIN 设置RGB的自动增益
  - 3.3.7 TY_BOOL_AUTO_AWB 设置RGB相机的白平衡
  - 3.3.8 TY_STRUCT_AEC_ROI 设置RGB的区域曝光
  - 3.3.9 TY_BOOL_AUTO_EXPOSURE 设置RGB的自动曝光
  - 3.3.10 TY_INT_AE_TARGET_Y 自动曝光目标亮度
- 3.4 IR和光源组件
- - 3.4.1 TY_INT_GAIN 设置IR增益
  - 3.4.2 TY_FLOAT_EXPOSURE_TIME_US 曝光时间
  - 3.4.3 TY_BOOL_LASER_AUTO_CTRL 开关激光器
  - 3.4.4 TY_INT_LASER_POWER 调节激光器亮度
  - 3.4.5 TY_BOOL_HDR 高动态范围
  - 3.4.6 TY_BYTEARRAY_HDR_PARAMETER 设置HDR参数
  - 3.4.7 TY_BOOL_IR_FLASHLIGHT 设置泛光使能
  - 3.4.8 TY_INT_IR_FLASHLIGHT_INTENSITY 设置泛光亮度值
- 3.5 TOF相机Depth组件
- - 3.5.1 TY_ENUM_DEPTH_QUALITY 深度质量
  - 3.5.2 TY_INT_TOF_CHANNEL 调制频道
  - 3.5.3 TY_INT_TOF_MODULATION_THRESHOLD 激光调制光强
  - 3.5.4 TY_INT_TOF_ANTI_SUNLIGHT_INDEX 抗阳光指数
  - 3.5.5 TY_INT_TOF_JITTER_THRESHOLD 抖动过滤
  - 3.5.6 TY_INT_TOF_HDR_RATIO 高动态范围比
  - 3.5.7 TY_BOOL_TOF_ANTI_INTERFERENCE 抗多机干扰
  - 3.5.8 TY_INT_MAX_SPECKLE_SIZE 聚类斑点面积
  - 3.5.9 TY_INT_MAX_SPECKLE_DIFF 聚类阈值
- 3.6 PS/FM855等相机SGBM特性
- - 3.6.1 TY_INT_SGBM_DISPARITY_NUM 设置视差搜索范围
  - 3.6.2 TY_INT_SGBM_DISPARITY_OFFSET 设置开始搜索的视差值。
  - 3.6.3 TY_INT_SGBM_MATCH_WIN_HEIGHT 设置视差匹配窗口的高。
  - 3.6.4 TY_INT_SGBM_MATCH_WIN_WIDTH 设置视差匹配窗口的宽。
  - 3.6.5 TY_INT_SGBM_IMAGE_NUM 设置用于深度计算的 IR 图像数量
  - 3.6.6 TY_INT_SGBM_SEMI_PARAM_P1 设置相邻像素 (+/-1) 约束惩罚参数 P1。
  - 3.6.7 TY_INT_SGBM_SEMI_PARAM_P1_SCALE 设置相邻像素 (+/-1) 约束惩罚参数 P1_scale
  - 3.6.8 TY_INT_SGBM_SEMI_PARAM_P2 设置周围像素约束惩罚参数 P2
  - 3.6.9 TY_BOOL_SGBM_HFILTER_HALF_WIN 搜索滤波开关
  - 3.6.10 TY_INT_SGBM_UNIQUE_FACTOR 最优匹配点与次优匹配点的百分比
  - 3.6.11 TY_INT_SGBM_UNIQUE_ABSDIFF 最优匹配点与次优匹配点差值的绝对值
  - 3.6.12 TY_BOOL_SGBM_LRC 左右一致性检查开关。
  - 3.6.13 TY_INT_SGBM_LRC_DIFF
  - 3.6.14 TY_BOOL_SGBM_MEDFILTER 中值滤波开关
  - 3.6.15 TY_INT_SGBM_MEDFILTER_THRESH 中值滤波阈值
  - 3.6.16 TY_INT_SGBM_TEXTURE_THRESH 纹理滤波阈值
  - 3.6.17 TY_INT_SGBM_TEXTURE_OFFSET 纹理滤波差值
- 3.7 带泛光相机RGB属性
- - 3.7.1 TY_BOOL_RGB_FLASHLIGHT 设置RGB泛光使能
  - 3.7.2 TY_INT_RGB_FLASHLIGHT_INTENSITY 设置RGB泛光数值
- 3.8 其他新增属性
- - 3.8.1 读取有哪些温度传感器
  - 3.8.2 读取温度值
  - 3.8.3 TYSetLogLevel
4.常见问题FAQ

前言

请参考图漾官网的在线文档：
https://doc.percipio.xyz/cam/latest/getstarted/sdk-csharp-compile.html#windows-csharp-label
而如果不想配置环境，请参考预编译版本例子，下载地址：
https://doc.percipio.xyz/cam/latest/getstarted/compile.html

1.示例程序说明

示例程序存放在开发包根目录 csharp 文件夹内：
1.fetch_frame.cs：该示例在自由采集模式下采集深度图和彩色图。
2.fetch_IR.cs：该示例在自由采集模式下采集 IR 图。
3.fetch_isp.cs：该示例在软件层面对于彩色图像的 ISP 后处理，可将存在偏色的 RAW BAYER 图像处理成正常色彩空间的彩色图。
4.fetch_point3d.cs：该示例用于采集 3d 点云（未作显示），Log 信息显示点云个数和中心点云坐标（X,Y,Z）。
5.fetch_registration.cs：该示例用于采集 RGB-D 对齐图像。
6.fetch_trigger.cs：该示例用于设置相机工作在软触发模式下采集深度图。
7.offline_reconnection.cs ：该例程⽤于处理因环境不稳定等因素造成的数据连接异常，并实现相机离线重连。
8.parameter_settings.cs：该例程⽤于设置不同数据类型的参数。例程中展⽰了如何关闭 RGB AEC（布尔型参数）、设置曝光时间（整型参数），以及设置图像分辨率和格式（枚举型参数）。
而
pcammls.dll ：动态链接库。
pcammls.exp：中间⽂件。
pcammls.lib ：依赖库。
pcammls_cs.dll ：动态链接库。
注：前四个文件，均在编译后的camport _multi language/csharp_build_x64/Bin/Release 目录下。
tycam.dll：动态链接库。

如果不想编译，可下载预编译例程，链接如下：
https://gitee.com/percipioxyz/camport_multi_language_Release
在这里插入图片描述

2.SDK API功能介绍

本节主要介绍Csharp SDK中封装的一些接口。

2.1 ListDevice 枚举设备

该接口用于枚举与PC连接的所有相机。
示例如下：

DeviceInfoVector dev_list= cl.ListDevice();

2.2 Open 打开相机

该接口用于打开指定SN号的相机。
示例如下：

System.IntPtr handle =cl.Open(“207000145055”);

2.3 OpenDeviceByIP 通过IP打开设备

该接口用于打开指定p的相机。
示例如下：

System.IntPtr handle =cl.OpenDeviceByIP("192.168.6.85");

2.4 Close 关闭设备

该接口用于关闭相机
示例如下：

cl.Close(handle);

2.5 DeviceStreamEnable 取流使能

该接口用于使能数据流，如需使能Color和Depth数据流。
示例如下：

cl.DeviceStreamEnable(handle, PERCIPIO_STREAM_COLOR | PERCIPIO_STREAM_DEPTH);

2.6 DeviceStreamFormatDump 取流分辨率

该接口用于列举数据流的分辨率格式。
示例如下：

EnumEntryVector color_fmt_list = cl.DeviceStreamFormatDump(handle, PERCIPIO_STREAM_COLOR);if(color_fmt_list.Count() != 0) { Console.WriteLine(string.Format("color image format list:"));for (int i = 0; i < color_fmt_list.Count(); i++){TY_ENUM_ENTRY fmt = color_fmt_list[i];Console.WriteLine(string.Format("\t{0} -size[{1}x{2}]\t-\t desc:{3}", i, cl.Width(fmt), cl.Height(fmt), fmt.getDesc()));}}

2.7 DeviceStreamFormatConfig 取流分辨率配置

该接口用于配置数据流的分辨率，可与DeviceStreamFormatDump联合使用。
示例如下：

cl.DeviceStreamFormatConfig(handle, PERCIPIO_STREAM_COLOR, color_fmt_list[0]);

表示配置列表中的第一个分辨率。

2.8 DeviceReadCurrentEnumData 取图当前分辨率

该接口用于读取当前数据流所用的分辨率
示例如下：

TY_ENUM_ENTRY color_enum_desc = new TY_ENUM_ENTRY();
cl.DeviceReadCurrentEnumData(handle, PERCIPIO_STREAM_COLOR, color_enum_desc);
Console.WriteLine($"current color image mode   {color_enum_desc.getDesc()}");

2.9 DeviceReadCalibData 读取标定参数

该接口用于读取数据流的标定参数。
示例如下：

PercipioCalibData color_calib_data   = cl.DeviceReadCalibData(handle, PERCIPIO_STREAM_COLOR);
int color_calib_width  = color_calib_data.Width();
int color_calib_height = color_calib_data.Height();
CalibDataVector color_calib_intr   = color_calib_data.Intrinsic();
CalibDataVector color_calib_extr   = color_calib_data.Extrinsic();
CalibDataVector color_calib_dis    = color_calib_data.Distortion();

2.10 DeviceStreamOn 打开取流

开启数据流，类似于C++中TYStartCapture接口。
示例如下：

cl.DeviceStreamOn(handle);

2.11 DeviceStreamOff 关闭取流

关闭数据流，类似于C++中TYStopCapture接口。
示例如下：

cl.DeviceStreamOff(handle) ;

2.12 DeviceStreamRead 获取帧数据

读取相机的传送的数据，类似于C++中TYFetchFrame接口。
示例如下：

FrameVector frames = cl.DeviceStreamRead(handle, 5000);

2.13 DeviceStreamDepthRender 解析和渲染深度图图像

该接口用于解析和渲染深度图像。
示例如下：

image_data depth = new image_data();
cl.DeviceStreamDepthRender(frames[i], depth);
IntPtr pt = depth.buffer.getCPtr();
Bitmap bmp_depth = new Bitmap(depth.width, depth.height, depth.width * 3, PixelFormat.Format24bppRgb, pt);
pictureBox1.Image = (Image)(new Bitmap(bmp_depth, new Size(640, 480))).Clone();

2.14 DeviceStreamImageDecode 解析RGB图像

该接口用于解析RGB图像。
示例如下：

image_data bgr = new image_data();
cl.DeviceStreamImageDecode(frames[i], bgr);
IntPtr pt = bgr.buffer.getCPtr();
Bitmap bmp_color = new Bitmap(bgr.width, bgr.height, bgr.width * 3, PixelFormat.Format24bppRgb, pt);
pictureBox2.Image = (Image)(new Bitmap(bmp_color, new Size(640, 480))).Clone();

2.15 DeviceStreamIRRender 解析IR图像

该接口用于解析ir图像。
示例如下：

image_data rightIR = new image_data();
cl.DeviceStreamIRRender(frames[i], rightIR);
IntPtr pt = rightIR.buffer.getCPtr();
Bitmap rightIR_BMP = new Bitmap(rightIR.width, rightIR.height, 3*rightIR.width, PixelFormat.Format24bppRgb, pt);
pictureBox2.Image = (Image)(new Bitmap(rightIR_BMP, new Size(640, 480))).Clone();

2.16 DeviceControlLaserPowerAutoControlEnable 使能IR激光器

该接口用于使能/失能 **TY_BOOL_LASER_AUTO_CTRL**属性，用于需要分析ir散斑图时，点亮激光器。
示例如下：

cl.DeviceControlLaserPowerAutoControlEnable(handle, false);

2.17 DeviceControlLaserPowerConfig 设置激光亮度

该接口用于调整激光器亮度。
示例如下：

cl.DeviceControlLaserPowerConfig(handle, 80);

2.18 DeviceColorStreamIspEnable 打开RGB的ISP

该接口用于打开/关闭软件isp。
示例如下：

cl.DeviceColorStreamIspEnable(handle, true);

2.19 DeviceStreamMapDepthImageToColorCoordinate 深度图对齐到彩色图

该接口用于将深度图坐标映射到彩色图，可参考fetch_registration_cs*。
示例如下：
SDK3.6.51此接口有变化，若SDK版本低于3.6.51，以下代码不可用。

cl.DeviceStreamMapDepthImageToColorCoordinate(depth_calib,depth,scale_unit,color_calib,undsitortion_color.width,undsitortion_color.height,registration_depth);

2.20 DeviceStreamMapRGBImageToDepthCoordinate 彩色图对齐到深度图

该接口用于将彩色图坐标映射到深度图。
示例如下：

cl.DeviceStreamMapRGBImageToDepthCoordinate(depth_calib,depth,scale_unit,color_calib, undsitortion_color, registration_color);

SDK3.6.66新增接口。

2.21 DeviceStreamDoUndistortion 做畸变校正

该接口用于对图像做畸变校正，可参考fetch_registration_cs。
示例如下：

cl.DeviceStreamDoUndistortion(color_calib, color, undsitortion_color);

2.22 DeviceControlTriggerModeEnable 设置相机工作模式

`该接口用于设置相机的工作模式。·
示例如下：

cl.DeviceControlTriggerModeEnable(handle, 1);

0代表 TY_TRIGGER_MODE_OFF，
1代表 TY_TRIGGER_MODE_SLAVE。

2.23 DeviceControlTriggerModeSendTriggerSignal 发送软触发指令

该接口用于给相机发送软触发命令，类似于C++中TYSendSoftTrigger。
示例如下：

cl.DeviceControlTriggerModeSendTriggerSignal(handle);

2.24DeviceStreamMapDepthImageToPoint3D 深度图转点云

该接口用于将深度图转换成点云数据，可参fetch_point3d_cs。
示例如下：

cl.DeviceStreamMapDepthImageToPoint3D(image, depth_calib_data, f_depth_scale, p3d_list);

2.25 IPv4StringToInt 将字符串转换成整型

该接口可以将字符串转换成整型，应用于相机的ip设置。

但是因为没有TYForceDeviceIP接口，所以只把参数写入了相机，不会立刻更新，需要重启相机才可以生效。

2.25.1 ip设置

int ip = cl.IPv4StringToInt("0.0.0.0");
DevParam param = cl.DevParamFromInt(ip);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_IP, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_IP);
int read_param_m = read_param.toInt();
Console.WriteLine($"{read_param_m}");

2.25.2 netmask设置

int netmask = cl.IPv4StringToInt("0.0.0.0");
DevParam param1 = cl.DevParamFromInt(netmask);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_SUBMASK, param1);
DevParam read_param1 = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_SUBMASK);
int read_param_m1 = read_param1.toInt();
Console.WriteLine($"{read_param_m1}");

2.25.3 gateway设置

int gateway = cl.IPv4StringToInt("0.0.0.0");
DevParam param2 = cl.DevParamFromInt(gateway);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_GATEWAY, param2);
DevParam read_param2 = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_GATEWAY);
int read_param_m2 = read_param2.toInt();
Console.WriteLine($"{read_param_m2}");

2.26 DevParamFromInt 设置Int变量

该接口用于定义Int类型的变量，变量数据类型：int。
示例如下：

DevParam param =  cl.DevParamFromInt(4096);

2.27 DevParamFromEnum 设置枚举变量

该接口用于定义Enum类型的变量，变量数据类型：uint。
示例如下：

DevParam param =  cl.DevParamFromEnum(TY_DEPTH_QUALITY_BASIC);

2.28 DevParamFromBool 设置Bool变量

该接口用于定义Bool型变量，用于设置Bool类型的feature。
示例如下：

DevParam param =  cl.DevParamFromBool(true);

2.29 DevParamFromFloat 设置Float变量

该接口用于定义Float型变量，用于设置Float类型的feature。
示例如下：

DevParam param = cl.DevParamFromFloat(2.2f);

2.30 DeviceSetParameter 设置相机参数

该接口用于设置相机参数，可以设置Int、Enum、Bool、Float、Array型参数。

2.31 DeviceGetParameter 获取相机参数

该接口用于读取相机参数，可以读取Int、Enum、Bool、Float、Array型参数。
DeviceSetParameter与DeviceGetParameter的示例代码如下：

2.31.1 Int型获取Int类型

DevParam param = cl.DevParamFromInt(1088);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_EXPOSURE_TIME, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_EXPOSURE_TIME);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

2.31.2 Enum型获取枚举类型

DevParam param = cl.DevParamFromEnum(TY_TIME_SYNC_TYPE_HOST);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TIME_SYNC_TYPE, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TIME_SYNC_TYPE);
uint m_read_param = read_param.toEnum();
Console.WriteLine($"current value {m_read_param}");
EnumEntryVector m_read_param2 = read_param.eList();
for (int i = 0; i < m_read_param2.Count(); i++){Console.WriteLine($"{ m_read_param2[i].value}");
}

2.31.3 Bool型获取Bool参数

DevParam param = cl.DevParamFromBool(false);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_EXPOSURE, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_EXPOSURE);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

2.31.4 Float型获取Float参数

DevParam param = cl.DevParamFromFloat(0.0125f);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_FLOAT_SCALE_UNIT, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_FLOAT_SCALE_UNIT);
float m_read_param = read_param.toFloat();
Console.WriteLine($"current value {m_read_param}");
float min = read_param.fMin();
float max = read_param.fMax();
float inc = read_param.fInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

2.31.5 Array型获取BYTEARRAY参数

ByteArrayVector array = new ByteArrayVector { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 11, 0, 0, 0, 14, 0, 0, 0 };DevParam arr = cl.DevParamFromByteArray(array);cl.DeviceSetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_BYTEARRAY_HDR_PARAMETER,arr);DevParam hdr_arry = cl.DeviceGetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_BYTEARRAY_HDR_PARAMETER);ByteArrayVector hdr_arry_1 = hdr_arry.toByteArray();for (int i = 0; i < hdr_arry_1.Count(); i++){Console.Write($",{hdr_arry_1[i]}");}

2.31.6 Struct(roi)型获取Struct类型

PercipioAecROI roi = new PercipioAecROI(0, 0, 640, 480);
DevParam param = cl.DevParamFromPercipioAecROI(roi);cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_STRUCT_AEC_ROI, param);DevParam readParam = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_STRUCT_AEC_ROI);
ArrayVector mReadParam = readParam.toArray();
Console.WriteLine("aec roi: " + string.Join(",", mReadParam));

2.32 get_netinfo 获取网络相机信息接口

该接口可用于获取打开的网络相机的设备信息，如ip、mac、netmask、gateway。
ip的获取示例如下：

handle = cl.Open(dev_list[select].id);
Console.WriteLine("ip {0}", dev_list[select].get_netinfo().ip());

2.33 DeviceLoadDefaultParameters 加载相机配置文件

该接口用于加载相机的配置文件（custom_block.bin文件中保存的相机参数json文件）。

int err = cl.DeviceLoadDefaultParameters(handle);if (err != TY_STATUS_OK)Console.WriteLine(string.Format("Load default parameters fail: {0}!", err));elseConsole.WriteLine(string.Format("Load default parameters successful!"));

支持加载的参数类型有Int、Float、Enum、Bool、和BYTEARRAY。

2.34 DeviceWriteDefaultParametersFromJSFile 将参数写入到相机

该接口用于将本地json文件中保存的参数内容写入相机custom_block.bin文件。

string filePath = @"C:\Users\G\Desktop\1.json";
cl.DeviceWriteDefaultParametersFromJSFile(handle, filePath);

2.35 DeviceClearDefaultParameters 清除相机参数

用于清除相机内存中的内容。

cl.DeviceClearDefaultParameters(handle);

2.36 DeviceHasStream 判断相机是否在取流

该接口用于判断相机是否具有特定的数据流，返回值为bool型。
示例：判断相机是否具有color数据流。

bool has_stream = false;
has_stream = cl.DeviceHasStream(handle, PERCIPIO_STREAM_IR_RIGHT);
Console.WriteLine($"has right ir  {has_stream}");

2.37 DeviceReadRectifiedRotationData

该接口用于读取V相机的IR rotation。
示例：读取IR rotation数据

PercipioRectifyRotaData LEFTIR_rot_data = cl.DeviceReadRectifiedRotationData(handle, PERCIPIO_STREAM_IR_LEFT);
CalibDataVector LEFTIR_r_data = LEFTIR_rot_data.Data();
Console.WriteLine(string.Format(":IR_rot_data"));
dump_calib_data(LEFTIR_r_data, 3, 3);

2.38 DeviceReadRectifiedIntrData

该接口用于读取V相机的IR rectified intrinsic。

PercipioRectifyIntrData LEFTIR_int_data = cl.DeviceReadRectifiedIntrData(handle, PERCIPIO_STREAM_IR_LEFT);
CalibDataVector LEFTIR_i_data = LEFTIR_int_data.Data();
Console.WriteLine(string.Format(":IR_ntrinsic _data"));
dump_calib_data(LEFTIR_i_data, 3, 3);

3.组件属性设置

3.1 Device组件

3.1.1 TY_INT_PERSISTENT_IP 静态 IP 地址

int ip = cl.IPv4StringToInt("0.0.0.0");
DevParam param = cl.DevParamFromInt(ip);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_IP, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_IP);
int read_param_m = read_param.toInt();
Console.WriteLine($"{read_param_m}");

3.1.2 TY_INT_PERSISTENT_SUBMASK 静态 IP 子网掩码

int netmask = cl.IPv4StringToInt("0.0.0.0");
DevParam param1 = cl.DevParamFromInt(netmask);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_SUBMASK, param1);
DevParam read_param1 = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_SUBMASK);
int read_param_m1 = read_param1.toInt();
Console.WriteLine($"{read_param_m1}");

3.1.3 TY_INT_PERSISTENT_GATEWAY 静态 IP 网关

int gateway = cl.IPv4StringToInt("0.0.0.0");
DevParam param2 = cl.DevParamFromInt(gateway);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_GATEWAY, param2);
DevParam read_param2 = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PERSISTENT_GATEWAY);
int read_param_m2 = read_param2.toInt();
Console.WriteLine($"{read_param_m2}");

3.1.4 TY_INT_PACKET_DELAY 数据传输延迟时间

原理说明：Packet_Delay包延迟时间，是增加一张图像帧头和帧尾之间，Block id与Block id之间的时间间隔，通过增加Block id时间间隔，适当牺牲帧率，来降低对实时带宽的要求，保证相机在网络较差的环境也能取到图。
在这里插入图片描述

DevParam param = cl.DevParamFromInt(0);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PACKET_DELAY, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PACKET_DELAY);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.1.5 TY_INT_PACKET_SIZE 数据传输包大小

DevParam param = cl.DevParamFromInt(1500);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PACKET_SIZE, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_PACKET_SIZE);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.1.6 TY_BOOL_GVSP_RESEND 网络重传

设置相机网络重传指令，网络较差时防止丢包。

DevParam param = cl.DevParamFromBool(false);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_BOOL_GVSP_RESEND, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_BOOL_GVSP_RESEND);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.1.7 TY_INT_ACCEPTABLE_PERCENT 接收包比例

通过设置接收包比例，正常情况下，相机输出的行数在帧超时时间内达到设置的图像高度(Height参数)，输出一帧图像。

若相机输出的行数在帧超时时间内未达到设置的图像高度(Height参数)，则SDK按照实际高度输出该图像(设定的出图比例)。

DevParam param = cl.DevParamFromInt(90);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_ACCEPTABLE_PERCENT, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_ACCEPTABLE_PERCENT);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.1.8 TY_BOOL_KEEP_ALIVE_ONOFF 状态保持开关

DevParam param = cl.DevParamFromBool(false);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_BOOL_KEEP_ALIVE_ONOFF, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_BOOL_KEEP_ALIVE_ONOFF);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.1.9 TY_INT_KEEP_ALIVE_TIME 状态保持时间

DevParam param = cl.DevParamFromInt(3000);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_KEEP_ALIVE_TIMEOUT, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_KEEP_ALIVE_TIMEOUT);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.1.10 TY_ENUM_TRIGGER_POL 触发沿设置

 DevParam param = cl.DevParamFromEnum(TY_TRIGGER_POL_FALLINGEDGE);cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TRIGGER_POL, param);DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TRIGGER_POL);uint m_read_param = read_param.toEnum();Console.WriteLine($"current value {m_read_param}");EnumEntryVector m_read_param2 = read_param.eList();for (int i = 0; i < m_read_param2.Count(); i++){Console.WriteLine($"{ m_read_param2[i].value}");}

3.1.11 TY_INT_FRAME_PER_TRIGGER 触发出图数

该功能可以设置相机在接收到一次软触发/硬触发后的出图数量，相机默认接收一次信号后只出一帧图像，此功能不建议使用。

DevParam param = cl.DevParamFromInt(5);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_FRAME_PER_TRIGGER, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_FRAME_PER_TRIGGER);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
EnumEntryVector m_read_param2 = read_param.eList();
for (int i = 0; i < m_read_param2.Count(); i++)
{
Console.WriteLine($"{ m_read_param2[i].value}");
}

3.1.12 TY_INT_CAPTURE_TIME_US 采集时间

DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_CAPTURE_TIME_US);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");

3.1.13 TY_INT_NTP_SERVER_IP ntp服务器ip

ntp服务器ip

int ip = cl.IPv4StringToInt("0.0.0.0");
DevParam param = cl.DevParamFromInt(ip);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_NTP_SERVER_IP, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_INT_NTP_SERVER_IP);
int read_param_m = read_param.toInt();
Console.WriteLine($"{read_param_m}");

3.1.14 TY_BOOL_CMOS_SYNC 图像同步

DevParam param = cl.DevParamFromBool(false);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_BOOL_CMOS_SYNC, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_BOOL_CMOS_SYNC);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

使用FM851-E2相机，对比开启和关闭TY_BOOL_CMOS_SYNC后，深度图像的帧率, TY_BOOL_CMOS_SYNC =false时帧率比TY_BOOL_CMOS_SYNC = true时高。

3.1.15 TY_ENUM_STREAM_ASYNC 数据流同步

DevParam param = cl.DevParamFromEnumt(TY_STREAM_ASYNC_ALL);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_STREAM_ASYNC, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_STREAM_ASYNC);
uint m_read_param = read_param.toEnum();
Console.WriteLine($"current value {m_read_param}");
EnumEntryVector m_read_param2 = read_param.eList();
for (int i = 0; i < m_read_param2.Count(); i++)
{
Console.WriteLine($"{ m_read_param2[i].value}");
}

3.1.16 TY_ENUM_TIME_SYNC_TYPE 相机对时功能

DevParam param = cl.DevParamFromEnum(TY_TIME_SYNC_TYPE_HOST);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TIME_SYNC_TYPE, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TIME_SYNC_TYPE);
uint m_read_param = read_param.toEnum();
Console.WriteLine($"current value {m_read_param}");
EnumEntryVector m_read_param2 = read_param.eList();
for (int i = 0; i < m_read_param2.Count(); i++){
Console.WriteLine($"{ m_read_param2[i].value}");
}

3.1.17 TY_BOOL_TIME_SYNC_READY 判断对时是否成功

DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_BOOL_TIME_SYNC_READY);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.1.18 TY_ENUM_CONFIG_MODE 出图模式

V系列相机预设的参数，不同模式下相机的精度不同

DevParam param = cl.DevParamFromEnum(TY_CONFIG_MODE_PRESET0);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_CONFIG_MODE, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_CONFIG_MODE);
uint m_read_param = read_param.toEnum();
Console.WriteLine($"current value {m_read_param}");
EnumEntryVector m_read_param2 = read_param.eList();
for (int i = 0; i < m_read_param2.Count(); i++)
{
Console.WriteLine($"{ m_read_param2[i].value}");
}

3.2 Depth 组件

3.2.1 TY_ENUM_IMAGE_MODE 深度图图像格式

DevParam param = cl.DevParamFromEnum(TY_PIXEL_FORMAT_DEPTH16 | TY_RESOLUTION_MODE_1280x960);cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_ENUM_IMAGE_MODE, param);DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_ENUM_IMAGE_MODE);uint m_read_param = read_param.toEnum();Console.WriteLine($"current value {m_read_param}");EnumEntryVector m_read_param2 = read_param.eList();for (int i = 0; i < m_read_param2.Count(); i++){Console.WriteLine($"description {m_read_param2[i].description}, value { m_read_param2[i].value} ");}

3.2.2 TY_FLOAT_SCALE_UNIT 设置深度图中像素值的单位

深度数据可表示最大值 = 65536 * scale unit。
设定值越小，深度计算的精度越高，但设定值过小可能会导致深度计算出现误差。

DevParam param = cl.DevParamFromFloat(0.0125f);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_FLOAT_SCALE_UNIT, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_FLOAT_SCALE_UNIT);
float m_read_param = read_param.toFloat();
Console.WriteLine($"current value {m_read_param}");
float min = read_param.fMin();
float max = read_param.fMax();
float inc = read_param.fInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.3 Color组件

3.3.1 TY_INT_EXPOSURE_TIME 设置RGB曝光时间

设置RGB相机的曝光时间，该功能可调控图像传感器的曝光时间，从而影响图像的亮度与清晰度。

DevParam param = cl.DevParamFromInt(500);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_EXPOSURE_TIME, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_EXPOSURE_TIME);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.3.2 TY_INT_ANALOG_GAIN 设置模拟增益

该参数可调控图像传感器的模拟增益，优化图像质量，平衡亮度与细节，减少不必要的噪声。

DevParam param = cl.DevParamFromInt(1);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_ANALOG_GAIN, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_ANALOG_GAIN);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.3.3 TY_INT_R_GAIN 设置R通道增益

r gain 设定值越大，彩色图像越红。

DevParam param = cl.DevParamFromInt(1);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_R_GAIN, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_R_GAIN);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.3.4 TY_INT_G_GAIN 设置G通道增益

g gain 设定值越大，彩色图像越绿。

DevParam param = cl.DevParamFromInt(1);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_G_GAIN, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_G_GAIN);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.3.5 TY_INT_B_GAIN 设置B通道增益

b gain 设定值越大，彩色图像越蓝。

DevParam param = cl.DevParamFromInt(1);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_B_GAIN, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_B_GAIN);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

设置 r、g、b 三个通道的增益，需先关闭 RgbAWB （自动白平衡）功能，否则自动白平衡功能会与手动设置的 r、g、b 通道增益冲突，影响图像效果。

3.3.6 TY_BOOL_AUTO_GAIN 设置RGB的自动增益

设置RGB相机的自动增益

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_GAIN, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_GAIN);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.3.7 TY_BOOL_AUTO_AWB 设置RGB相机的白平衡

设置RGB相机的自动白平衡，该功能可用于校正由不同光源引起的色彩偏差，提高图像的真实性和色彩准确度。

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_AWB, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_AWB);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.3.8 TY_STRUCT_AEC_ROI 设置RGB的区域曝光

该功能可以根据图像中感兴趣区域的亮度，自动调整图像曝光时间和增益，实现更好的图像效果。

PercipioAecROI roi = new PercipioAecROI(0, 0, 640, 480);
DevParam param1 = cl.DevParamFromPercipioAecROI(roi);cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_STRUCT_AEC_ROI, param1);DevParam readParam = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_STRUCT_AEC_ROI);
ArrayVector mReadParam = readParam.toArray();
Console.WriteLine("aec roi: " + string.Join(",", mReadParam));

3.3.9 TY_BOOL_AUTO_EXPOSURE 设置RGB的自动曝光

设置RGB相机的自动曝光属性，该功能可以根据图像亮度动态调整彩色图像曝光时间和增益，从而避免图像过曝或欠曝。

DevParam param = cl.DevParamFromBool(false);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_EXPOSURE, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_BOOL_AUTO_EXPOSURE);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.3.10 TY_INT_AE_TARGET_Y 自动曝光目标亮度

该功能通过设定图像的理想亮度水平，以优化高对比度场景下的彩色图像效果。
根据彩色图实时调整 AETargetLuminance ，设定值越大，图像亮度越高。

DevParam param = cl.DevParamFromInt(200);
cl.DeviceSetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_AE_TARGET_Y, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_RGB_CAM, TY_INT_AE_TARGET_Y);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.4 IR和光源组件

3.4.1 TY_INT_GAIN 设置IR增益

该部分参数可调控图像传感器的增益，优化图像质量，平衡亮度与细节，减少不必要的噪声。

DevParam param = cl.DevParamFromInt(500);
cl.DeviceSetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_INT_GAIN, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_INT_GAIN);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

同时调节 Left IR 和 Right IR 的 gain、analog gain参数，以确保生成的深度图效果良好。

3.4.2 TY_FLOAT_EXPOSURE_TIME_US 曝光时间

该功能可调控图像传感器的曝光时间，从而影响图像的亮度与清晰度。

DevParam param2 = cl.DevParamFromFloat(1088);
int error2 = cl.DeviceSetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_FLOAT_EXPOSURE_TIME_US, param2);
DevParam read_param2 = cl.DeviceGetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_FLOAT_EXPOSURE_TIME_US);
float m_read_param2 = read_param2.toFloat();
Console.WriteLine($"current value {m_read_param2}");
float min2 = read_param2.fMin();
float max2 = read_param2.fMax();
float inc2 = read_param2.fInc();
Console.WriteLine($"min ：{min2},max：{max2},inc：{inc2}");

同时调节 Left IR 和 Right IR 的 exposure time 参数，以确保生成的深度图效果良好。

3.4.3 TY_BOOL_LASER_AUTO_CTRL 开关激光器

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_LASER, TY_BOOL_LASER_AUTO_CTRL, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_LASER, TY_BOOL_LASER_AUTO_CTRL);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.4.4 TY_INT_LASER_POWER 调节激光器亮度

DevParam param = cl.DevParamFromInt(1);
cl.DeviceSetParameter(handle, TY_COMPONENT_LASER, TY_INT_LASER_POWER, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_LASER, TY_INT_LASER_POWER);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.4.5 TY_BOOL_HDR 高动态范围

该功能用于优化高对比度场景的深度成像效果，设置完 HDR 参数后需要调节 Left/Right IR 的曝光时间，以获得成像效果最佳的深度图。

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_IR_CAM_LEFT,TY_BOOL_HDR, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_BOOL_HDR);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.4.6 TY_BYTEARRAY_HDR_PARAMETER 设置HDR参数

ByteArrayVector array = new ByteArrayVector { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 11, 0, 0, 0, 14, 0, 0, 0 };
DevParam arr = cl.DevParamFromByteArray(array);
cl.DeviceSetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_BYTEARRAY_HDR_PARAMETER,arr);
DevParam hdr_arry = cl.DeviceGetParameter(handle, TY_COMPONENT_IR_CAM_LEFT, TY_BYTEARRAY_HDR_PARAMETER);
ByteArrayVector hdr_arry_1 = hdr_arry.toByteArray();
for (int i = 0; i < hdr_arry_1.Count(); i++){Console.Write($",{hdr_arry_1[i]}");}

3.4.7 TY_BOOL_IR_FLASHLIGHT 设置泛光使能

该功能用于辅助相机在线动态标定。

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_LASER, TY_BOOL_IR_FLASHLIGHT, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_LASER, TY_BOOL_IR_FLASHLIGHT);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.4.8 TY_INT_IR_FLASHLIGHT_INTENSITY 设置泛光亮度值

DevParam param = cl.DevParamFromInt(0);
cl.DeviceSetParameter(handle, TY_COMPONENT_LASER, TY_INT_IR_FLASHLIGHT_INTENSITY, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_LASER, TY_INT_IR_FLASHLIGHT_INTENSITY);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.5 TOF相机Depth组件

3.5.1 TY_ENUM_DEPTH_QUALITY 深度质量

该功能用于设置相机输出的深度图质量，为适应不同应用的需求。
basic：深度值抖动幅度大，输出帧率高。
medium：深度值抖动幅度中等，输出帧率中等。
high：深度值抖动幅度小，输出帧率低。
注：有的TOF相机不支持basic模式，有的不支持high模式，具体以相机实际参数为准。

DevParam param = cl.DevParamFromEnum(TY_DEPTH_QUALITY_HIGH);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_ENUM_DEPTH_QUALITY, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_ENUM_DEPTH_QUALITY);
uint m_read_param = read_param.toEnum();
Console.WriteLine($"current value {m_read_param}");
EnumEntryVector m_read_param2 = read_param.eList();
for (int i = 0; i < m_read_param2.Count(); i++)
{
Console.WriteLine($"{ m_read_param2[i].value}");
}

3.5.2 TY_INT_TOF_CHANNEL 调制频道

该功能用于设置 ToF 深度相机调制频道。不同调制频道的调制频率不同，互不干扰。

DevParam param = cl.DevParamFromInt(5);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_CHANNEL, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_CHANNEL);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.5.3 TY_INT_TOF_MODULATION_THRESHOLD 激光调制光强

该功能用于设置 ToF 深度相机接收激光调制光强的阈值，小于此阈值的像素点不参与计算深度，即像素点的深度值赋值为 0。

DevParam param = cl.DevParamFromInt(5);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_MODULATION_THRESHOLD, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_MODULATION_THRESHOLD);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.5.4 TY_INT_TOF_ANTI_SUNLIGHT_INDEX 抗阳光指数

该功能用于优化 ToF 相机在阳光下的深度成像效果。
若在室内场景或阳光较弱时，建议将该指数设置为0；在室外场景或有一定阳光时，设置为1或2。

DevParam param = cl.DevParamFromInt(2);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_ANTI_SUNLIGHT_INDEX, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_ANTI_SUNLIGHT_INDEX);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.5.5 TY_INT_TOF_JITTER_THRESHOLD 抖动过滤

该功能用于设置 ToF 深度相机的抖动过滤阈值。阈值设置值越大，深度图边缘抖动的深度数据过滤得越少。

DevParam param = cl.DevParamFromInt(1);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_JITTER_THRESHOLD, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_JITTER_THRESHOLD);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.5.6 TY_INT_TOF_HDR_RATIO 高动态范围比

该功能用于优化高对比度场景的深度成像效果。
注：目前仅TM430/TM421相机支持此功能，设置为1，默认不生效。

DevParam param = cl.DevParamFromInt(1);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_HDR_RATIO, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_TOF_HDR_RATIO);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
nt min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.5.7 TY_BOOL_TOF_ANTI_INTERFERENCE 抗多机干扰

该功能用于过滤多台相机共存于同一场景中并且在同一调制频道（ToF Channel），由于信号相互干扰引发的异常深度值。

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_TOF_ANTI_INTERFERENCE, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_TOF_ANTI_INTERFERENCE);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.5.8 TY_INT_MAX_SPECKLE_SIZE 聚类斑点面积

聚类斑点面积小于 Max speckle size 面积阈值的聚类斑点会被滤除。
面积阈值设置越大，滤除的聚类斑点越多。

DevParam param = cl.DevParamFromInt(200);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_MAX_SPECKLE_SIZE, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_MAX_SPECKLE_SIZE);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.5.9 TY_INT_MAX_SPECKLE_DIFF 聚类阈值

邻像素的深度差值小于 Max speckle diff 聚类阈值，则该相邻像素属于同一个聚类斑点
聚类阈值设置越大，相邻像素属于同一聚类斑点越多。

DevParam param = cl.DevParamFromInt(200);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_MAX_SPECKLE_DIFF, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_MAX_SPECKLE_DIFF);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6 PS/FM855等相机SGBM特性

在这里插入图片描述

3.6.1 TY_INT_SGBM_DISPARITY_NUM 设置视差搜索范围

设定值越大，相机 Z 方向的测量范围越大，但算力会增加。建议设置成 16 的整数倍。

DevParam param = cl.DevParamFromInt(3);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_DISPARITY_NUM, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_DISPARITY_NUM);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.2 TY_INT_SGBM_DISPARITY_OFFSET 设置开始搜索的视差值。

DevParam param = cl.DevParamFromInt(3);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_DISPARITY_OFFSET, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_DISPARITY_OFFSET);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

深度范围减小， disparityNum大概率减小。
深度范围远端往相机端缩进， disparityOffset变大，反之亦反。

3.6.3 TY_INT_SGBM_MATCH_WIN_HEIGHT 设置视差匹配窗口的高。

设定值必须为奇数。

DevParam param = cl.DevParamFromInt(3);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_MATCH_WIN_HEIGHT, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_MATCH_WIN_HEIGHT);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.4 TY_INT_SGBM_MATCH_WIN_WIDTH 设置视差匹配窗口的宽。

设定值必须为奇数。

DevParam param = cl.DevParamFromInt(5);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_MATCH_WIN_WIDTH, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_MATCH_WIN_WIDTH);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

视差匹配窗口（match window height * match window width）越大，深度图更加平滑，但是精度会降低。
视差匹配窗口越小，深度图显示更多细节，但是出现错误匹配的几率越大。

3.6.5 TY_INT_SGBM_IMAGE_NUM 设置用于深度计算的 IR 图像数量

设定值越大，输出深度图像质量越好，帧率越小。

DevParam param = cl.DevParamFromInt(3);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_IMAGE_NUM, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_IMAGE_NUM);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.6 TY_INT_SGBM_SEMI_PARAM_P1 设置相邻像素 (+/-1) 约束惩罚参数 P1。

设定值越大，深度图越平滑。

DevParam param = cl.DevParamFromInt(10000);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_SEMI_PARAM_P1, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_SEMI_PARAM_P1);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.7 TY_INT_SGBM_SEMI_PARAM_P1_SCALE 设置相邻像素 (+/-1) 约束惩罚参数 P1_scale

设定值越小，深度图越平滑。

DevParam param = cl.DevParamFromInt(5);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_SEMI_PARAM_P1_SCALE, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_SEMI_PARAM_P1_SCALE);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.8 TY_INT_SGBM_SEMI_PARAM_P2 设置周围像素约束惩罚参数 P2

设定值越大，深度图越平滑。P2 > P1。
该参数可以有效地处理纹理丰富区域，减少误匹配的数量。

DevParam param = cl.DevParamFromInt(0);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_SEMI_PARAM_P2, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_SEMI_PARAM_P2);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.9 TY_BOOL_SGBM_HFILTER_HALF_WIN 搜索滤波开关

用于进一步优化深度图，去除噪声和不连续性，对物体边缘点云更友好。

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_SGBM_HFILTER_HALF_WIN, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_SGBM_HFILTER_HALF_WIN);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.6.10 TY_INT_SGBM_UNIQUE_FACTOR 最优匹配点与次优匹配点的百分比

设定值越大，匹配代价越唯一，错误匹配点过滤掉的越多

DevParam param = cl.DevParamFromInt(511);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_UNIQUE_FACTOR, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_UNIQUE_FACTOR);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.11 TY_INT_SGBM_UNIQUE_ABSDIFF 最优匹配点与次优匹配点差值的绝对值

设定值越大，匹配代价越唯一，错误匹配点过滤掉的越多

DevParam param = cl.DevParamFromInt(10000);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_UNIQUE_ABSDIFF, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_UNIQUE_ABSDIFF);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.12 TY_BOOL_SGBM_LRC 左右一致性检查开关。

max LRC diff 设定值越小，匹配结果越可靠。

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_SGBM_LRC, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_SGBM_LRC);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.6.13 TY_INT_SGBM_LRC_DIFF

DevParam param = cl.DevParamFromInt(5);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_LRC_DIFF, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_LRC_DIFF);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.14 TY_BOOL_SGBM_MEDFILTER 中值滤波开关

用于消除孤立的噪声点，同时尽可能地保留图像的边缘信息。

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_SGBM_MEDFILTER, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_BOOL_SGBM_MEDFILTER);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.6.15 TY_INT_SGBM_MEDFILTER_THRESH 中值滤波阈值

median filter thresh 设定值越大，过滤的噪点越多，但也可能会导致深度图的细节信息丢失。

DevParam param = cl.DevParamFromInt(5);
cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_MEDFILTER_THRESH, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_MEDFILTER_THRESH);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.6.16 TY_INT_SGBM_TEXTURE_THRESH 纹理滤波阈值

  DevParam param = cl.DevParamFromInt(1088);int error = cl.DeviceSetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_TEXTURE_THRESH, param);DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_TEXTURE_THRESH);int m_read_param = read_param.toInt();int min = read_param.mMin();int max = read_param.mMax();int inc = read_param.mInc();Console.WriteLine($"min ：{min},max：{max},inc：{inc}+++++{m_read_param}");

3.6.17 TY_INT_SGBM_TEXTURE_OFFSET 纹理滤波差值

DevParam read_param1 = cl.DeviceGetParameter(handle, TY_COMPONENT_DEPTH_CAM, TY_INT_SGBM_TEXTURE_OFFSET);
int m_read_param1 = read_param1.toInt();
int min1 = read_param1.mMin();
int max1 = read_param1.mMax();
int inc1 = read_param1.mInc();
Console.WriteLine($"min ：{min1},max：{max1},inc：{inc1}++++++++++{m_read_param1}");

运行上报[error] The feature is not writable. 改属性仅可读。

3.7 带泛光相机RGB属性

3.7.1 TY_BOOL_RGB_FLASHLIGHT 设置RGB泛光使能

DevParam param = cl.DevParamFromBool(true);
cl.DeviceSetParameter(handle, TY_COMPONENT_LASER, TY_BOOL_RGB_FLASHLIGHT, param);
DevParam status = cl.DeviceGetParameter(handle, TY_COMPONENT_LASER, TY_BOOL_RGB_FLASHLIGHT);
bool m_status = status.toBool();
Console.WriteLine($"current value {m_status}");

3.7.2 TY_INT_RGB_FLASHLIGHT_INTENSITY 设置RGB泛光数值

DevParam param = cl.DevParamFromInt(0);
cl.DeviceSetParameter(handle, TY_COMPONENT_LASER, TY_INT_RGB_FLASHLIGHT_INTENSITY, param);
DevParam read_param = cl.DeviceGetParameter(handle, TY_COMPONENT_LASER, TY_INT_RGB_FLASHLIGHT_INTENSITY);
int m_read_param = read_param.toInt();
Console.WriteLine($"current value {m_read_param}");
int min = read_param.mMin();
int max = read_param.mMax();
int inc = read_param.mInc();
Console.WriteLine($"min ：{min},max：{max},inc：{inc}");

3.8 其他新增属性

3.8.1 读取有哪些温度传感器

 DevParam param5 = cl.DevParamFromEnum(TY_TEMPERATURE_LEFT);int error5 = cl.DeviceSetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TEMPERATURE_ID, param5);

3.8.2 读取温度值

 DevParam read_param5 = cl.DeviceGetParameter(handle, TY_COMPONENT_DEVICE, TY_ENUM_TEMPERATURE_ID);uint m_read_param5 = read_param5.toEnum();Console.WriteLine($"current value {m_read_param5}");EnumEntryVector l_read_param5 = read_param5.eList();for (int i = 0; i < l_read_param5.Count(); i++){float tmp= cl.DeviceControlReadTemperature(handle, l_read_param5[i].value);Console.WriteLine(string.Format("{0}={1}",l_read_param5[i].description,tmp)); 
}

3.8.3 TYSetLogLevel

TYSetLogLevel(5);
// 控制台输出的日志信息，设置Log等级详情：TY_LOG_LEVEL_VERBOSE = 1,
TY_LOG_LEVEL_DEBUG = 2,
// TY_LOG_LEVEL_INFO = 3,
TY_LOG_LEVEL_WARNING = 4,
// TY_LOG_LEVEL_ERROR = 5,
TY_LOG_LEVEL_NEVER = 9,