凱視佳工業(yè)相機api函數說明書彩色參數設置篇

1、凱視佳工業(yè)相機凱視佳工業(yè)相機 API 函數說明書彩色相機參數設置篇：版本：發(fā)布日期：（文檔適用相機型號等說明）本文檔適用于 MUC36C(MGYYO)、2015-5-14 2014-2015凱視佳光電設備 1凱視佳光電（）400：400-0300-601技術支持：http:/2015-5-14 2014-2015凱視佳光電設備 2. 1 參數類型41、視場( AOI Area Oferest)42、抽點（Skip）43、BIN54、(Exure)55、增益(Gain)66、水平消隱（Horizontal Bl7、垂直消隱( Vertical Bl）. 6). 78、垂直翻轉（Flip）79、水

2、平翻轉（Mirror）710、亮度（Brightness）711、對比度（Contrast）812、壞點校正813、靈敏度（Sensitive）814、Gamma 校正8二 相關函數91、KSJ_PARAM 類型92、KSJ_GetParamRange123、KSJ_SetParam134、KSJ_GetParam145、KSJ_GammaSetValue146、KSJ_GammaOn.157、KSJ_ Ex8、KSJ_ ExureTimeSet15ureTimeGet162015-5-14 2014-2015凱視佳光電設備 3凱視佳相機開發(fā)包針對黑白相機提供的標準參數設置分為：由硬件實現的功

3、能和由軟件算法實現的功能。由硬件實現的功能所增加的耗時可以忽略。而由實現的部分功能因為需要進行大量的計算，造成增加耗時，因此可能對相機速度有一定的影響。這些影響將在下面。 參數類型1、視場( AOI Area Oferest)凱視佳公司的所有型號的相機都可以設置視場，并且相機的預覽視場和視場是相互獨立的。也就是說，預覽視場可以和視場不同，方便用戶根據實際情況設置不同的視場。用戶可以通過函數 KSJ_PreviewSetFieldOfView() 和函數 預覽視場和 KSJ_CaptureSetFieldOfView()設置預覽視場和視場。KSJ_PreviewSetFieldOfViewEx(

4、)和 KSJ_CaptureSetFieldOfViewEx()則在設置視場的同時提供的功能，詳細請參考 API函數使用說明書。需要注意的是，用戶設置完視場之后，再分配內存數據之前，最好通過調用函數 KSJ_CaptureGetSize() 或者 KSJ_PreviewGetSize()重新獲取圖像或者預覽的圖像的大小，這是由于開發(fā)包會對用戶設置不合理的一些參數進行一些微調，這有可能會改變或預覽圖像的大小。同時，如果用戶設置了抽點模式也會對或預覽圖像的大小造成影響。因此為安全起見，需要用戶重新獲取圖像的大小。2、抽點（Skip）凱視佳工業(yè)相機支持抽點功能，所謂 N*N 抽點為在分辨率視場內每隔

5、 N 行或列出一行或一列。抽點功能可以實現在保證視場不變的情況下，縮小圖像的大小，從而減小數據 量 ， 一 定 程 度 上 提 高 相 機 速 度 。 可 以 通 過 在 設 置視 場（KSJ_PreviewSetFieldOfView() ）和預覽視場( KSJ_CaptureSetFieldOfView() )時通過設置參數 KSJ_ADDRESSMODE 設置抽點模式。需要注意的是：用戶設置了抽點模式之后，圖像和預覽圖像的大小就不再是單純的設置視場或預覽視場的大小，此時，用戶需要通過調用 KSJ_PreviewGetSize()或 KSJ_PreviewGetSizeEx()和 KSJ_

6、CapturgetSize()2015-5-14 2014-2015凱視佳光電設備 4或 KSJ_CaptureGetSizeEx()重新獲取預覽圖像或圖像的大小，以便分配合適的內存或根據對應的參數進行正確處理。抽點的大小不是可以任意設置的，參看枚舉類型KSJ_ADDRESSMODE，凱視佳工業(yè)相機 API 函數使用說明。3、BINBin 模式只有在設置抽點功能的前提下才能設置。在凱視佳工業(yè)相機提供的開發(fā)模式中，單純的抽點是指間隔 N 行（列）讀出一行（列）。Bin 實際上是通過把鄰近的像素點的感光電荷相加來提高相機對光的響應。一般情況下，圖像傳感器支持水平（行）bin和垂直（列）bin。因此

7、，在設置了 N*N 抽點的前提下，啟用 bin 模式，可以實現將 N*N個像素點合并為一個，以此來提高相機對光的靈敏度。用戶可以通過調用函數KSJ_SetParam（）設置參數 KSJ_BIN 啟用 BIN 模式。注意：并不是所有的凱視佳工業(yè)相機都提供 BIN KSJ_UC500M_。模式功能，此模式只支持 KSJ_UC320C_X 相機型號。如用戶需要使用 BIN 功能，請X,KSJ_UC500C_凱視佳科技（X,）4、(Exure)凱視佳工業(yè)相機支持時間的設置。調整時間可以提高圖像亮度，但是過大的時間也會拖慢相機圖像的速度。如果用戶需要提高圖像亮度可以從以下幾個方面調整：調整鏡頭光圈，大光

8、圈將增大進光量，增強圖像亮度；增強光源亮度；調整圖像傳感器的增益（Gain）; 延長時間。凱視佳公司提供的相機開發(fā)包同時支持以 ms 為或者以行為設置時間。其中，時間行是相機支持的最小，即便用戶以 ms 為設置時間，在相機也會轉換為行。因此，以行為設置時間比以 ms 為更加精確。同時，以行為時間設置能設置為更小的時間，這對于需要更小時間的動態(tài)圖像的應用有很好的效果。行與 ms 之間的轉換，每個相機是不同的，轉換公式也和水平消隱和垂直消隱有關。具體轉換方式較為復雜，此處不再贅述.司。疑問請凱視佳科技（）有限公2015-5-14 2014-2015凱視佳光電設備 5用戶可以使用函數 KSJ_Set

9、Param()使用參數 KSJ_EXURE 以 ms 為設置相機時間，或者使用參數 KSJ_EXURE_LINES 以行為設置時間。除此之外，用戶可以直接使用函數 KSJ_ ExureTimeSet（）以 ms 為設置時間。KSJ_ ExureTimeGet（）獲取當前的時間（ms）。如果用戶以行為設置了時間，而想換算得到設置的時間的 ms 值(不必通過公式計算)，可以通過調用函數 KSJ_GetParam（）使用參數 KSJ_EXURE 獲取設置的ms 值。反之，亦然。5、增益(Gain)增益是圖像傳感器中的信號放大器，增大 Gain 值實際上是放大圖像傳感器對光信號的響應，有增強圖像亮度的

10、作用。 但是，Gain 值的增大不僅僅放大了對有效光信號的響應，同時也會放大對噪聲信號的響應。因此，增益的調整會影響圖像的質量（噪聲）。大致說來，Gain 越大，圖像的噪聲也會更嚴重。在噪聲可接受范圍內，可以適當提高增益。同時，不同的圖像傳感器所需要的 Gain 值不同，一般傳感器 Gain 值在 50 以內。而如 MU3E200M 等少部分相機則需要設置 Gain 到 128 或以上才能獲得正常亮度的圖像。用戶疑問請凱視佳科技（）.對于黑白相機，設置增益可以調用函數 KSJ_SetParam() 對參數 KSJ_RED 、 KSJ_GREEN、KSJ_BLUE 任意一個進行設置即可，不必設置

11、三個參數值。而對于彩色相機則需要同時設置 KSJ_RED、KSJ_GREEN、KSJ_BLUE 三個參數值，之后還需要進行白平衡校正，才能得到正確的圖像色彩。關于白平衡校正，請參考凱視佳公司提供的相關技術文檔。6、水平消隱（Horizontal Bl）水平消隱是相機的圖像傳感器每完成一行，開始下一行的時間間隔?？梢允褂煤瘮?KSJ_SetParam()中的參數 KSJ_ HORIZONTALBL這個一般用戶不需要調整。調整水平消隱。注意：2015-5-14 2014-2015凱視佳光電設備 67、垂直消隱( Vertical Bl)與水平消隱類似，垂直消隱指的是圖像傳感器完成當前像素的，到下一

12、個像素曝光開始的時間間隔，可用于微調幀速，在適當的設置后，幀速會有所提高。通過函數 KSJ_SetParam（）及參數 KSJ_VERTICALBL可以調整垂直消隱。8、垂直翻轉（Flip）通過調用函數 KSJ_SetParam（）和參數 KSJ_FLIP 可以對圖像沿 X 軸垂直（上下）翻轉。此操作將同時影響預覽圖像和圖像。并且當使用彩色相機進行翻轉操作時，相機的 Bayer 模式也需要進行對應的改變，具體請參考 Bayer 模式說明。黑白相機無需考慮Bayer 模式。垂直翻轉操作是由相機硬件實現，不會影響相機的速度。9、水平翻轉（Mirror）通過調用函數 KSJ_SetParam（）和參

13、數 KSJ_MIRROR 可以對圖像沿 Y 軸水平（左右）翻轉。此操作將同時影響預覽圖像和圖像。并且當使用彩色相機進行鏡像操作時，相機的 Bayer 模式也需要進行對應的改變，具體請參考 Bayer 模式說明。黑白相機無需考慮Bayer 模式。水平翻轉操作是由相機硬件實現，不會影響相機的速度。10、亮度（Brightness）調整圖像亮度，通過函數 KSJ_SetParam（）和參數 KSJ_BRIGHTNESS 。通過KSJ_GetParam()獲取當前的對比度值?；蛘咭部梢灾苯油ㄟ^函數 KSJ_ProsBrightnessSet() 和 KSJ_ ProsBrightnessGet() 直

14、接設置和獲取對比度參數值?？梢酝ㄟ^函數KSJ_ProsBrightnessGetRange ()獲取亮度的設置范圍。2015-5-14 2014-2015凱視佳光電設備 711、對比度（Contrast）調整圖像對比度，通過函數 KSJ_SetParam() 和參數 KSJ_CONTRAST 。通過 KSJ_GetParam()獲取當前的對比度值?；蛘咭部梢灾苯油ㄟ^函數 KSJ_ProsContrastSet()和 KSJ_ProsContrastGet() 直接設 置和獲取對比 度參數值。可 以通過函數 KSJ_ProsContrastGetRange()獲取對比度的設置范圍。12、壞點校正

15、由于圖像傳感器本身的工作特點，圖像壞點的出現無法避免，用戶可以調用函數KSJ_BixelCorrectionSet（）設置開啟壞點校正功能。該功能由硬件實現，對相機幀速沒有任何影響。同時，也可以調用函數 KSJ_BixelCorrectionGet（）獲取是否已經開啟了壞點校正功能。需要注意的是，壞點校正功能只對部分幀存相機有效，如*（MRYY），*（MGYY）。壞點校正功能由 FPGA 硬件實現，對相機速度不影響。13、靈敏度（Sensitive）該參數僅支持幀存相機。用戶可以通過函數 KSJ_ SensitivitySetMode（）設置靈敏度。使用函數 KSJ_ SensitivityG

16、etMode 獲取當前相機的靈敏度。所謂靈敏度是相機對光線的感光靈敏度。14、Gamma 校正函數 KSJ_GammaOn（）可以開啟或者關閉 Gamma 校正。通過函數 KSJ_GammaSetValue()設置 Gamma 參數值。Gamma 參數范圍為-9-9. 也可以通過函數 KSJ_GetParamRange()獲取參數的可設置范圍。當參數設置為0時，圖像將不會改變。二相關函數1、KSJ_PARAM 類型相機參數的枚舉類型enum KSJ_PARAM2015-5-14 2014-2015凱視佳光電設備 8KSJ_EXURE = 0, KSJ_RED, KSJ_GREEN, KSJ_B

17、LUE, KSJ_GAMMA,KSJ_PREVIEW_COLUMNSTART, KSJ_PREVIEW_ROWSTART, KSJ_CAPTURE_COLUMNSTART,KSJ_CAPTURE_ROWSTART,KSJ_HORIZONTALBL KSJ_VERTICALBL KSJ_FLIP,KSJ_BIN, KSJ_MIRROR, KSJ_CONTRAST, KSJ_BRIGHTNESS,KSJ_VGAGAIN,KSJ_CLLEVEL,KSJ_CDSGAIN, KSJ_RED_SHIFT, KSJ_GREEN_SHIFT, KSJ_BLUE_SHIFT,PANDING,KSJ_EXURE_

18、LINES,KSJ_SATURATION, KSJ_TRIGGERDELAY, KSJ_STROBEDELAY,KSJ_TRIGGER_MODE,2015-5-14 2014-2015凱視佳光電設備 9KSJ_TRIGGER_METHOD;參數說明：KSJ_EXURE相機，此值已毫秒為，目前只能為整數，用戶如需精確到微妙級，請與凱視佳聯系。KSJ_RED相機紅增益KSJ_GREEN相機綠增益KSJ_PREVIEW_COLUMNSTART預覽視場的水平起始像素點KSJ_PREVIEW_ROWSTART預覽視場的垂直起始行KSJ_CAPTURE_COLUMNSTART視場的水平起始像素點KSJ_C

19、APTURE_ROWSTART視場的垂直起始行KSJ_ HORIZONTALBL水平消隱（這個用戶一般不必調節(jié)）KSJ_VERTICALBL垂直消隱（可用于微調幀速，在適當的設置后，幀速會有所提高）KSJ_FLIP對原始數據進行垂直翻轉，這個操作由硬件進行操作，請參考凱視佳工業(yè)相機 API編程入門指南.V1.4中關于 Bayer 模式的說明部分。KSJ_SetParam 中的 nValue 參數為 0 表示不使用原始數據不翻轉，為 1 表示原始數據翻轉。KSJ_BIN2015-5-1410 2014-2015 凱視佳光電設備是否加入 Bin 模式，此模式只對 KSJ_SKIP2,KSJ_SKI

20、P4 兩種抽點模式有作用。此模式只支持 KSJ_UC320C_X,KSJ_UC500C_X, KSJ_UC500M_X 相機型號。KSJ_SetParam 中的 nValue 參數為 0 表示不使用 BIN 模式，為 1 表示使用 BIN 模式。KSJ_MIRROR此功能支持 UC500C,UC500M，UC900C,UC1000C,UD140C,UD140M,UC36C,UC36M。對原始數據進行水平翻轉，這個操作由硬件進行操作(UD140C,UD140M 通過作，會降低預覽幀速)，所以不會影響任何效率。注意，水平翻轉后，Bayer 模式需要進行相應的設置，比如 UC500C 在正常設置下，

21、Bayer 排列格式為 GRBG 模式，水平翻轉后，Bayer 模式需設置為 RGGB。這些設置開發(fā)包不做處理，需用戶自行調用。另外他的設置不會影響白平衡區(qū)域和區(qū)域在圖像上的位置。KSJ_CONTRAST對比度KSJ_BRIGHTNESS亮度KSJ_VGAGAINUD140C,UD140M 支持，調節(jié) VGA 增益。KSJ_CLLEVELUD140C,UD140M 支持，調節(jié)鉗位電平KSJ_CDSGAINUD140C,UD140M 支持，調節(jié) CDS 增益。KSJ_RED_SHIFT（彩色相機有效）處理，顏色校正算法，紅偏移，必須先開啟 KSJ_CC_SHIFTRGB 色彩校正功能，此設置才能

22、有效，參考 KSJ_ColorCorrectSet 函數說明。KSJ_GREEN_SHIFT（彩色相機有效）處理，顏色校正算法，綠偏移，必須先開啟 KSJ_CC_SHIFTRGB 色彩校正功能，此設置才能有效，參考 KSJ_ColorCorrectSet 函數說明。KSJ_BLUE_SHIFT（彩色相機有效）處理，顏色校正算法，蘭偏移，必須先開啟 KSJ_CC_SHIFTRGB 色彩校正功能，此2015-5-1411 2014-2015 凱視佳光電設備設置才能有效，參考 KSJ_ColorCorrectSet 函數說明。PANDINGUC36C,UC36M 支持，是否開啟壓縮擴展功能，類似背光

23、補償，能有效增大動態(tài)范圍。KSJ_EXURE_LINES行數KSJ_SATURATION（彩色相機有效）飽和度KSJ_TRIGGERDELAY外觸發(fā)延時KSJ_STROBEDELAY閃光燈延時(暫不支持)KSJ_TRIGGER_MODE觸發(fā)模式KSJ_TRIGGER_METHOD觸發(fā)信號方式2、KSJ_GetParamRangeKSJ_API stdcall KSJ_GetParamRange( INnChannel, IN KSJ_PARaram,OUT*pnMinValue, OUT*pnMaxValue );說明：獲取參數的設置范圍。由于 KSJApi 開發(fā)包支持全系列凱視佳的相機產品，

24、針對不同型號的相機，參數的設置范圍不同。用戶可以通過調用此函數獲得相關信息。參數nChannel設備索引（從 0 開始，最大索引數為:連接到主機的設備數目減一）。Param指定的參數（參考 KSJ_PARAM 定義）pnMinValue2015-5-1412 2014-2015 凱視佳光電設備取得指定參數設置的最小值pnMaxValue取得指定參數設置的最大值返回值參考返回狀態(tài)碼（KSJCode.H）3、KSJ_SetParam設置相機參數KSJ_API stdcall KSJ_SetParam( INnChannel, IN KSJ_PARaram,INnValue );參數nChannel

25、設備索引（從 0 開始，最大索引數為:連接到主機的設備數目減一）。Param要設置的相機參數（參考 KSJ_PARAM 的定義）。nValue參數設置的值。（設置范圍請參考 KSJ_GetParamRange 函數）。返回值參考返回狀態(tài)碼（KSJCode.H）4、KSJ_GetParam獲取相機參數KSJ_API stdcall KSJ_GetParam( INnChannel, IN KSJ_PARaram,OUT*pnValue );參數nChannel設備索引（從 0 開始，最大索引數為:連接到主機的設備數目減一）。2015-5-1413 2014-2015 凱視佳光電設備Param要獲

26、取的相機參數（參考 KSJ_PARAM 的定義）。pnValue函數返回時，參數值會寫入此地址。返回值參考返回狀態(tài)碼（KSJCode.H）5、KSJ_GammaSetValue設置 Gamma 值以產生 Gamma 表 stdcall KSJ_GammaSetValue(KSJ_APInChannel,nValue );參數nChannel設備索引（從 0 開始，最大索引數為:連接到主機的設備數目減一）。nValue需要設定的 Gamma 值，目前的調節(jié)范圍可以通過 KSJ_GetParamRange 獲得（-9-9）。返回值參考返回狀態(tài)碼（KSJCode.H）說明當 nValue 設置為 0 時，實際是沒有進行 Gamma 校正的。6、KSJ_GammaOn打開或關閉 Gamm