凯视佳产品文档 产品文档与技术支持

CBXS3D SDK · 起始触发控制

版本 1.0 · 更新于 2026-10-21 · 阅读 0

起始结束触发模式、信号滤波/延迟/延迟脉冲、软触发、单次采集轮廓数。

本组对应头文件 @defgroup StartTrigger 起始结束触发。决定何时开始/结束一轮采集（采集到指定轮廓数即结束本轮）。

CBXS_SetStartTriggerMode

int CBXS_SetStartTriggerMode(void* handle, CBXS_START_TRIGGER_MODE StartTriggerMode)

设置起始结束触发模式。

参数 方向 说明
StartTriggerMode in 起始结束触发模式，参考 CBXS_START_TRIGGER_MODE

返回：成功返回 CBXS_RET_SUCCESS

说明

  • 连续：采集不需要起始结束触发条件，仅按轮廓触发设置采集到「采集轮廓数」即本轮完成。
  • 上升沿/下降沿/高电平/低电平：收到对应边沿或电平后才开始轮廓采集，达到「采集轮廓数」即本轮完成。
  • 软件触发：收到软件触发信号后才开始轮廓采集。

CBXS_GetStartTriggerMode

int CBXS_GetStartTriggerMode(void* handle, CBXS_START_TRIGGER_MODE* pStartTriggerMode)

获取起始结束触发模式。

参数 方向 说明
pStartTriggerMode out 起始结束触发模式

返回：成功返回 CBXS_RET_SUCCESS；失败返回错误码

CBXS_SetStartTriggerFilter

int CBXS_SetStartTriggerFilter(void* handle, int nStartTriggerFilter)

设置开始采集信号滤波时间。

参数 方向 说明
nStartTriggerFilter in 信号滤波时间，单位：微秒

返回：成功返回 CBXS_RET_SUCCESS

说明

  • 用于滤除起始结束外触发信号的高频干扰，电平持续时间在滤波范围内视为无效。

CBXS_SetStartTriggerDelayTime

int CBXS_SetStartTriggerDelayTime(void* handle, int nStartTriggerDelayTime)

设置开始采集信号延迟时间。

参数 方向 说明
nStartTriggerDelayTime in 延迟时间，单位：微秒

返回：成功返回 CBXS_RET_SUCCESS

说明

  • 在起始结束触发信号有效后，延迟指定时间再开始轮廓触发采集。

CBXS_SetStartTriggerDelayPulse

int CBXS_SetStartTriggerDelayPulse(void* handle, int nStartTriggerDelayPulse)

设置开始采集信号延迟脉冲。

参数 方向 说明
nStartTriggerDelayPulse in 延迟脉冲，单位：个

返回：成功返回 CBXS_RET_SUCCESS

说明

  • 在起始结束触发信号有效后，先延迟设定时间，再延迟若干触发脉冲才开始采集；仅当轮廓触发为上升沿/下降沿/编码器时有效。

CBXS_GetStartTriggerFilter

int CBXS_GetStartTriggerFilter(void* handle, int* pStartTriggerFilter)

获取开始采集信号滤波时间。

参数 方向 说明
pStartTriggerFilter out 信号滤波时间，单位：微秒

返回：成功返回 CBXS_RET_SUCCESS；失败返回错误码

CBXS_GetStartTriggerDelayTime

int CBXS_GetStartTriggerDelayTime(void* handle, int* pnStartTriggerDelayTime)

获取开始采集信号延迟时间。

参数 方向 说明
pnStartTriggerDelayTime out 延迟时间，单位：微秒

返回：成功返回 CBXS_RET_SUCCESS；失败返回错误码

CBXS_GetStartTriggerDelayPulse

int CBXS_GetStartTriggerDelayPulse(void* handle, int* pnStartTriggerDelayPulse)

获取开始采集信号延迟脉冲。

参数 方向 说明
pnStartTriggerDelayPulse out 延迟脉冲，单位：个

返回：成功返回 CBXS_RET_SUCCESS；失败返回错误码

CBXS_SendSoftStartTrigger

int CBXS_SendSoftStartTrigger(void* handle)

发送一个起始触发软触发信号。

参数 方向 说明
handle in 设备句柄

返回：成功返回 CBXS_RET_SUCCESS

说明

  • 仅在起始触发模式设为软件触发（CBXS_SEM_SOFTWARE）时使用。

CBXS_SetFrameCountToCapture

int CBXS_SetFrameCountToCapture(void* handle, int nNumberOfProfiles)

设置一次起始信号最多采集的轮廓数。

参数 方向 说明
nNumberOfProfiles in 采集轮廓数

返回：成功返回 CBXS_RET_SUCCESS

说明

  • 达到该轮廓数即本轮采集完成。

CBXS_GetFrameCountToCapture

int CBXS_GetFrameCountToCapture(void* handle, int* pNumberOfProfiles)

获取一次起始信号采集的轮廓数。

参数 方向 说明
pNumberOfProfiles out 采集轮廓数

返回：成功返回 CBXS_RET_SUCCESS；失败返回错误码