CBXS3D SDK · 参数设置

本组对应头文件 @defgroup Param。获取类接口建议在设置前先查询，避免越界导致 CBXS_RET_PARAMERROR。

CBXS_SetExposureTime

int CBXS_SetExposureTime(void* handle, float fExpTimeMS)

设置曝光值。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 曝光是感光元件开始感光到快门关闭的时间。曝光越大图像越亮，但采集时间变长、帧率下降。

CBXS_GetExposureTime

int CBXS_GetExposureTime(void* handle, float* pfExpTimeMS)

获取当前曝光值。

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

CBXS_SetGain

int CBXS_SetGain(void* handle, int nGain)

设置设备增益。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 对感光信号放大：增益越大图像越亮，但噪声同步放大，不宜设置过高。

CBXS_GetGain

int CBXS_GetGain(void* handle, int* pnGain)

获取当前增益。

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

CBXS_SetMirror

int CBXS_SetMirror(void* handle, bool bMirror)

设置图像水平镜像。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 镜像只在采集前设置有效。

CBXS_GetMirror

int CBXS_GetMirror(void* handle, bool* pbMirror)

获取图像水平镜像状态。

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

CBXS_SetFlip

int CBXS_SetFlip(void* handle, bool bFlip)

设置图像垂直翻转。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 翻转只在采集前设置有效。

CBXS_GetFlip

int CBXS_GetFlip(void* handle, bool* pbFlip)

获取图像垂直翻转状态。

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

CBXS_SetBlackLevel

int CBXS_SetBlackLevel(void* handle, int nIndex, int nValue)

设置黑平衡。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 黑平衡用于消除暗电流/偏置，提升低反射目标对比度。

CBXS_GetBlackLevel

int CBXS_GetBlackLevel(void* handle, int nIndex, int* pnValue)

获取黑平衡。

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

CBXS_SaveParamToFile

int CBXS_SaveParamToFile(void* handle, char* pszFile)

将当前设备参数保存到文件。

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

CBXS_LoadParamFromFile

int CBXS_LoadParamFromFile(void* handle, char* pszFile)

用参数文件设置当前设备。

返回：成功返回 CBXS_RET_SUCCESS

说明

• 须在设备打开并已 CBXS_Initial 初始化之后调用。