CBXS3D SDK · 轮廓触发控制

本组对应头文件 @defgroup DataTrigger 轮廓触发。决定每一根轮廓的采集节奏；其中激光模式与 DAC 也归在本组。

CBXS_SetDataTriggerMode

int CBXS_SetDataTriggerMode(void* handle, CBXS_DATA_TRIGGER_MODE DataTriggerMode)

设置轮廓触发模式。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 设置传感器何时触发采集一个轮廓数据。

CBXS_GetDataTriggerMode

int CBXS_GetDataTriggerMode(void* handle, CBXS_DATA_TRIGGER_MODE* pDataTriggerMode)

获取轮廓触发模式。

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

CBXS_SendSoftDataTrigger

int CBXS_SendSoftDataTrigger(void* handle)

发送一个轮廓触发软触发信号。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 仅在轮廓触发模式设为软件触发（CBXS_DTM_SOFTWARE）时使用。

CBXS_SetDataTriggerInternalFrequency

int CBXS_SetDataTriggerInternalFrequency(void* handle, float fInternalFrequencyHz)

设置内触发模式（CBXS_DTM_INTERNAL）的触发频率。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 内触发频率 × 轮廓间隔 = 物体运动速度，需与编码器/外触发保持一致。

CBXS_GetDataTriggerInternalFrequency

int CBXS_GetDataTriggerInternalFrequency(void* handle, float* pfInternalFrequencyHz)

获取当前内部触发模式的触发频率。

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

CBXS_SetDataTriggerDivider

int CBXS_SetDataTriggerDivider(void* handle, int nDataTriggerDivider)

设置轮廓触发信号分频参数（仅外部触发/编码器触发有效）。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 仅在轮廓触发模式为外部触发或编码器触发时有效。

CBXS_SetDataTriggerFilter

int CBXS_SetDataTriggerFilter(void* handle, int nDataTriggerFilter)

设置轮廓触发信号滤波（仅外部触发/编码器触发有效）。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 防止信号噪声或边沿抖动导致误触发，针对外部输入信号进行合适滤波。

CBXS_SetDataTriggerDelay

int CBXS_SetDataTriggerDelay(void* handle, int nDataTriggerDelay)

设置轮廓触发延迟（仅外部触发/编码器触发有效）。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 仅在轮廓触发模式为外部触发或编码器触发时有效。

CBXS_GetDataTriggerDivider

int CBXS_GetDataTriggerDivider(void* handle, int* pnDataTriggerDivider)

获取轮廓触发信号分频参数。

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

CBXS_GetDataTriggerFilter

int CBXS_GetDataTriggerFilter(void* handle, int* pnDataTriggerFilter)

获取轮廓触发信号滤波。

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

CBXS_GetDataTriggerDelay

int CBXS_GetDataTriggerDelay(void* handle, int* pnDataTriggerDelay)

获取轮廓触发延迟。

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

CBXS_SetDataTriggerEncoderDirection

int CBXS_SetDataTriggerEncoderDirection(void* handle, CBXS_ENCODER_DIRECTION EncoderDirection)

设置编码器触发方向（仅编码器触发有效）。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 仅在轮廓触发模式为编码器触发时有效。

CBXS_SetDataTriggerEncoderReversal

int CBXS_SetDataTriggerEncoderReversal(void* handle, unsigned int nReversal)

设置编码器反向防抖脉冲数（仅编码器触发有效）。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 仅在轮廓触发模式为编码器触发时有效。

CBXS_GetDataTriggerEncoderDirection

int CBXS_GetDataTriggerEncoderDirection(void* handle, CBXS_ENCODER_DIRECTION* pEncoderDirection)

获取编码器触发方向。

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

CBXS_GetDataTriggerEncoderReversal

int CBXS_GetDataTriggerEncoderReversal(void* handle, unsigned int* pnReversal)

获取编码器反向防抖脉冲数。

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

CBXS_SetFlashMode

int CBXS_SetFlashMode(void* handle, CBXS_FLASH_MODE FlashMode)

设置线激光工作模式。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 常开/常关/闪光三种模式，闪光模式下仅在轮廓采集时点亮激光。

CBXS_GetFlashMode

int CBXS_GetFlashMode(void* handle, CBXS_FLASH_MODE* pFlashMode)

获取线激光工作模式。

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

CBXS_SetDACValue

int CBXS_SetDACValue(void* handle, int nValue)

设置 DAC 数字量（通常用于控制激光功率）。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 通过 DAC 可软件调节激光亮度/功率。

CBXS_GetDACValue

int CBXS_GetDACValue(void* handle, int* pnValue)

获取 DAC 数字量。

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