CBXS3D SDK · 数据结构与枚举 - 凯视佳产品文档

本页汇总 CBXS_CameraParams.h 中定义的结构体、枚举；字段含义均取自头文件原注释。

结构体

CBXS_GEN_DEVICE_INFO

GEN（网口）设备信息，位于 CBXS_DEVICE_INFO::SpecialInfo。

类型	字段	说明
`bool`	`bDHCP`	是否为 DHCP 模式（否时为静态 IP）
`unsigned char[4]`	`CurrentIp`	设备 IP 地址
`unsigned char[4]`	`CurrentSubnetMask`	子网掩码
`unsigned char[4]`	`DefaultGateway`	默认网关
`unsigned char[6]`	`DeviceMacAddress`	MAC 地址
`unsigned int[4]`	`nReserved`	预留

CBXS_DEVICE_INFO

设备信息（枚举列表中的单台设备）。

类型	字段	说明
`unsigned short`	`nMajorVer`	主要版本
`unsigned short`	`nMinorVer`	次要版本
`unsigned int`	`nType`	类型
`char[64]`	`chManufacturerName`	制造商名称
`char[64]`	`chModelName`	型号名称
`char[64]`	`chDeviceVersion`	设备版本
`char[64]`	`chUserDefinedName`	用户自定义名字
`char[64]`	`chSerialNumber`	唯一序列号
`union`	`SpecialInfo`	按类型解析：`stGENInfo`（GEN 设备）

CBXS_DEVICE_INFO_LIST

设备列表，CBXS_EnumDevices 的输出。

类型	字段	说明
`unsigned int`	`nDeviceNum`	在线设备数量
`CBXS_DEVICE_INFO*[256]`	`pDeviceInfo`	设备信息指针数组，最多支持 256 台

CBXS_DATA_PARAM

单帧数据信息参数，位于 CaptureData::param。

类型	字段	说明
`unsigned short`	`usWidth`	图像的宽
`unsigned short`	`usHeight`	图像的高
`int`	`nDataFormat`	当前帧的 DataFormat
`unsigned long`	`ulIOStatus`	IO 状态
`unsigned long long`	`ullTimesTamp`	时间戳；为 0 表示无效帧（通知一次 Start 结束）
`unsigned long long`	`ullFrameID`	相机上电后所有帧计数；相邻两帧不连续表示硬件 FrameBuffer 丢帧
`unsigned long long`	`ullLostFrameNum`	连续两帧之间的丢帧计数
`unsigned long long`	`ullFrameTriggerCnt`	开始采集后的帧触发计数（含起始触发有效与无效）
`unsigned long long`	`ullStratTriggerValid`	开始采集后的起始触发有效计数；相邻两帧该值变化表示新一次起始开始
`unsigned long long`	`ullStratTriggerLoss`	开始采集后的起始触发信号丢失数

CaptureData

CBXS_CaptureData 返回的结构体，按当前数据格式选用对应指针。

类型	字段	说明
`CBXS_DATA_PARAM`	`param`	当前帧的数据信息（详见 `CBXS_DATA_PARAM`）
`unsigned char*`	`pImage`	当前帧原始图像指针，长度 = usWidth*usHeight；数据格式为 DF_POINT 或 DF_PI 时为空
`unsigned short*`	`pPoint`	当前帧光条点坐标指针，长度 = usWidth；该值除以 16 为该列点的图像坐标，0 表示空点；数据格式为 DF_IMAGE 时为空
`unsigned char*`	`pIndensity`	当前帧亮度数据指针，长度 = usWidth；数据格式为 DF_IMAGE 或 DF_POINT 时为空

枚举

CBXS_MULTI_PEAK_MODE

一列像素出现多个光条时的选取原则。

枚举值	值	说明
`CBXS_MPM_BEST`	0	最优最亮的光条
`CBXS_MPM_FIRST`	1	提取到的第一个光条
`CBXS_MPM_LAST`	2	提取到的最后一个光条

CBXS_START_TRIGGER_MODE

起始结束触发模式（何时开始一轮采集）。

枚举值	值	说明
`CBXS_STM_CONTINUE`	0	Start 信号始终有效
`CBXS_SEM_RISING_EDGE`	1	上升沿
`CBXS_SEM_FALLING_EDGE`	2	下降沿
`CBXS_SEM_HIGHLEVEL`	3	高电平有效
`CBXS_SEM_LOWLEVEL`	4	低电平有效
`CBXS_SEM_SOFTWARE`	5	软件触发

CBXS_DATA_TRIGGER_MODE

轮廓触发模式（每根轮廓的采集节奏）。

枚举值	值	说明
`CBXS_DTM_FREE_RUN`	0	自由触发：以最大速度自动采集
`CBXS_DTM_INTERNAL`	1	内触发：按内触发频率采集
`CBXS_DTM_RISING_EDGE`	2	外部触发：上升沿
`CBXS_DTM_FALLING_EDGE`	3	外部触发：下降沿
`CBXS_DTM_ENCODER`	4	编码器触发：按外部编码器信号采集
`CBXS_DTM_SOFTWARE`	5	软件触发

CBXS_ENCODER_DIRECTION

编码器触发方向。

枚举值	值	说明
`CBXS_ED_FORWARD`	0	正向：编码器正向脉冲触发采集
`CBXS_ED_BACKWARD`	1	反向：编码器反向脉冲触发采集
`CBXS_ED_BOTH`	2	双向：正反向脉冲都触发采集

CBXS_FLASH_MODE

线激光工作模式。

枚举值	值	说明
`CBXS_FM_NORMAL_OPEN`	0	常开：激光一直亮
`CBXS_FM_NORMAL_CLOSE`	1	常关：激光一直不亮
`CBXS_FM_FLASH`	2	闪光灯：仅轮廓采集时点亮激光

CBXS_DATA_FORMAT

3D 图像数据格式，决定 CaptureData 中哪些指针有效。

枚举值	值	说明
`CBXS_DF_IMAGE`	0	原图
`CBXS_DF_IMAGE_PI`	1	原图 + 光条点 + 亮度
`CBXS_DF_POINT`	2	仅光条点
`CBXS_DF_PI`	3	光条点 + 亮度

XS3D SDK 不提供回调类型（与 KSJXS 不同），取数统一通过 CBXS_CaptureData 主动采集。
完整字段说明以 CBXS_CameraParams.h 为准。

结构体