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

KSJAPI SDK · 参数与曝光增益

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

通用参数读写（KSJ_PARAM）、曝光时间、线阵区段黑电平。

本组接口来自 KSJApiBase.h。通用参数统一走 KSJ_SetParam / KSJ_GetParam，
第二参数为 KSJ_PARAM 枚举；设置前务必先读 KSJ_GetParamRange 确认取值范围。

函数一览

函数 说明
KSJ_GetParamRange 获取指定参数的取值范围。
KSJ_SetParam 设置相机参数值。
KSJ_GetParam 获取相机参数值。
KSJ_ExposureTimeSet 设置曝光时间（单位：毫秒）。
KSJ_ExposureTimeGet 获取曝光时间（单位：毫秒）。
KSJ_GetSegmentNum 取得相机的区段数目（仅线阵相机有效）。
KSJ_GetBlackLevelRange 获取指定区段黑电平范围（仅线阵相机有效）。
KSJ_SetBlackLevel 设置某区段黑电平值（仅线阵相机有效）。
KSJ_GetBlackLevel 获取某区段黑电平值（仅线阵相机有效）。
KSJ_ProcessSaturationSet 设置图像饱和度（-128~128；0 = 不调整，软件执行）。
KSJ_ProcessContrastSet 设置图像对比度（-128~128）。
KSJ_ProcessBrightnessSet 设置图像亮度（-128~128）。
KSJ_GammaSetValue 设置 Gamma（-9~9）。

关键函数详解

KSJ_GetParamRange

int __stdcall KSJ_GetParamRange(int nIndex, KSJ_PARAM Param, int* pnMinValue, int* pnMaxValue);

获取指定参数的取值范围。

参数 方向 说明
nIndex in 相机索引
Param in 参数枚举（KSJ_PARAM）
pnMinValue out 最小值
pnMaxValue out 最大值

返回：成功返回 RET_SUCCESS(1)；失败返回错误码

说明

  • 设置参数前建议先调用本函数取得范围，避免越界返回 RET_PARAMERROR。

KSJ_ExposureTimeSet

int __stdcall KSJ_ExposureTimeSet(int nIndex, float fExposureTimeMs);

设置曝光时间（单位：毫秒）。

参数 方向 说明
nIndex in 相机索引
fExposureTimeMs in 曝光时间，单位毫秒

返回：成功返回 RET_SUCCESS(1)；失败返回错误码（见错误码章节）