凱視佳工業(yè)相機(jī)api編程入門指南

關(guān)于Bayer關(guān)于GPIO 外接擴(kuò)展接口說(shuō) （適用設(shè)置第0個(gè)采集設(shè)備的視場(chǎng)為0，0，1280，1024，無(wú)抽點(diǎn)模式：KSJ_CaptureSetFieldOfView(0,0,0,1280,1024,KSJ_SKIPNONE,KSJ_SKIPNONE);IntnWidth,KSJ_SetParam(KSJ_RED,nRedValue);來(lái)設(shè)置增益，注意對(duì)于黑白相機(jī)，隨便選取KSJ_REDKSJ_GREENKSJ_BLUE其中的一個(gè)進(jìn)行調(diào)解即可，只要調(diào)解一個(gè)，其他的就KSJ_CaptureRawData(0,pData);對(duì)于黑白相機(jī)，不要調(diào)用即可，注意nBitCount8。設(shè)置第0個(gè)采集設(shè)備的視場(chǎng)為0，0，1280，1024，無(wú)抽點(diǎn)模式：KSJ_PreviewSetFieldOfView(0,0,0,1280,1024,KSJ_SKIPNONE,KSJ_SKIPNONE);IntnWidth,(KSJ_SetParam(KSJ_RED,nRedValue);來(lái)設(shè)置增益，注意對(duì)于黑白相機(jī)，隨便選取KSJ_REDKSJ_GREENKSJ_BLUE其中的一個(gè)進(jìn)行調(diào)解即可，只要調(diào)解一個(gè)，其他的就通過(guò)調(diào)用KSJ_PreviewPause(0,true);來(lái)暫停預(yù)覽。暫停成功后可以通過(guò)(,KSJ_PreviewGetSize來(lái)獲得，獲得的數(shù)據(jù)可通通過(guò)調(diào)用KSJ_PreviewPause(0,false);來(lái)繼續(xù)視頻流，最后通過(guò)調(diào)用設(shè)置第0個(gè)采集設(shè)備的視場(chǎng)為0，0，1280，1024，無(wú)抽點(diǎn)模式：KSJ_CaptureSetFieldOfView(0,0,0,1280,1024,KSJ_SKIPNONE,KSJ_SKIPNONE);IntnWidth,通過(guò)調(diào)用KSJ_SetParam來(lái)設(shè)置KSJ_RED,KSJ_GREEN,KSJ_BLUE色彩增益。通過(guò)調(diào)用Unsignedchar*pData=(unsignedchar*)malloc(nWidth*nHeight*3即可，注意nBitCount24。設(shè)置第0個(gè)采集設(shè)備的視場(chǎng)為0，0，1280，1024，無(wú)抽點(diǎn)模式：KSJ_PreviewSetFieldOfView(0,0,0,1280,1024,KSJ_SKIPNONE,KSJ_SKIPNONE);IntnWidth,(通過(guò)調(diào)用KSJ_SetParam來(lái)設(shè)置KSJ_RED,KSJ_GREEN,KSJ_BLUE色彩增益。通過(guò)調(diào)用通過(guò)調(diào)用KSJ_PreviewPause(0,true);來(lái)暫停預(yù)覽。暫停成功后可以通過(guò)KSJ_PreviewGetSize來(lái)獲得，獲得的數(shù)據(jù)可通通過(guò)調(diào)用KSJ_PreviewPause(0,false);（3.3V我們可以通過(guò)調(diào)用KSJ_APIintstdcallKSJ_SnapButtonStatus(intnChannel,設(shè)置預(yù)覽的回調(diào)函數(shù)，請(qǐng)參考《凱視佳工業(yè)相機(jī)API函數(shù)使用說(shuō)明書》中KSJ_SnapButtonStatus讀取按鍵的狀態(tài)，條件滿足時(shí)此幀圖像即為外staticKSJ_SNAPBUTTONSTATUS PrvSnapButtonStatus=KSJ_UP; intCMyWnd::PreviewCallback(unsignedchar*pImageData,intnWidth,intnHeight,int{//KSJ_SnapButtonStatus(m_nDeviceIndex,&CurSnapButtonStatus); Buf[256]={‘\0’};_stprintf(Buf,_T("SnapButton:%s\n"),CurSnapButtonStatus==KSJ_UP?_T("UP")//if(CurSnapButtonStatus==KSJ_DOWN&&PrvSnapButtonStatus==KSJ_UP)KSJ_HelperSaveToBmp(pImageData,nWidth,nHeight,nBitCount,"c:\\snap.bmp");}//SetTimer(1,1000,NULL//{If(nIDEvent!=1 //KSJ_SnapButtonStatus(m_nDeviceIndex,&CurSnapButtonStatus); _stprintf(Buf,_T("SnapButton:%s"),CurSnapButtonStatus==KSJ_UP?_T("UP")//{intnWidth,//// *pImageData=newBYTE[nWidth*nHeight*//////delete }}USB2.0SDK開發(fā)包支持不同類型相機(jī)以及相同類型的多臺(tái)相機(jī)的同時(shí)采集和同時(shí)預(yù)覽。這里所謂的同時(shí)不知真正意義上的同時(shí)，實(shí)際上是分時(shí)的。USB2.0480Mbps400Mbps已經(jīng)算是高的了，還要看您主機(jī)上USB2.0主控芯片的性能，根據(jù)我們的經(jīng)驗(yàn)，Intel845USB2.0支持較好。USB2.0USB2.0帶寬，USB2.0主控芯片會(huì)以時(shí)間片輪詢的方式來(lái)讀取圖像數(shù)據(jù)，所以多個(gè)相機(jī)連入并預(yù)覽會(huì)使幀KSJ_APIintstdcallKSJ_DeviceGetInformation(INintnChannel,OUTKSJ_DEVICETYPE*pDeviceType,OUTint*pnIndex,OUTWORD*pwFirmwareVersion);nChannel=0,1,...(nDeviceNum-1)KSJApi函數(shù)來(lái)分別操作每個(gè)相機(jī)，具體當(dāng)用戶調(diào)用了KSJ_PreviewStart(nChannel,TRUE);之后，API開發(fā)包會(huì)將視頻流顯示在用戶的如果插入相機(jī)，API內(nèi)部會(huì)自動(dòng)將用戶之前的預(yù)覽視場(chǎng)設(shè)置給相機(jī)，并自動(dòng)恢復(fù)視頻流，所KSJ_CaptureRawDataKSJ_CaptureRgbDataUSB連接線已經(jīng)拔出，那么以上函數(shù)會(huì)返回RET_RECOVERY_FAIL，當(dāng)相機(jī)再次被連入時(shí)，調(diào)用KSJ_CaptureRawDataKSJ_CaptureRgbData函數(shù)會(huì)自動(dòng)對(duì)相機(jī)做恢復(fù)操作，并且按照用戶之定要判斷一下KSJ_CaptureRawDataKSJ_CaptureRgbData函數(shù)返回值是否為RET_SUCCESS。注意：當(dāng)相機(jī)在拔出到重新連入之間，如果用戶沒有調(diào)用過(guò)KSJ_CaptureRawData或KSJ_CaptureRgbData函數(shù)，那么在相機(jī)被連入后，第一調(diào)用KSJ_CaptureRawData或KSJ_CaptureRgbDataRET_RECOVERY_SUCCESSKSJ_CaptureRawDataKSJ_CaptureRgbData函數(shù)調(diào)用成功，而是代表采集失敗，但是恢復(fù)成功了，下一次調(diào)用KSJ_CaptureRawData或KSJ_CaptureRgbData函數(shù)才能正確返回RET_SUCCESS。注意：在相機(jī)被拔出時(shí)，調(diào)用一些與硬件進(jìn)行通訊的函數(shù)會(huì)返回RET_FAIL.。比如KSJ_DeviceGetInformationKSJ_SetParam函數(shù)只有在確保相機(jī)已經(jīng)正?；謴?fù)后才可調(diào)用，KSJ_DeviceGetInformationKSJ_SetParam函數(shù)內(nèi)部沒有恢復(fù)機(jī)制，對(duì)于采集的恢復(fù)，恢復(fù)機(jī)制只存在于KSJ_CaptureRawData或KSJ_CaptureRgbData函數(shù)兩個(gè)函數(shù)中。注意：Bayer模式只針對(duì)彩色相機(jī)，黑白相機(jī)不需要進(jìn)行Bayer轉(zhuǎn)換。凱視佳UC130C相機(jī)使用的圖像傳感器的感光陣列如下：圖中每一個(gè)方格代表一個(gè)像元，每一個(gè)像元只接收R,G,BBayer轉(zhuǎn)換后，BGBGGRGRBGBG…轉(zhuǎn)換后為24位位圖格式。為了使顯示圖像不發(fā)生垂直翻轉(zhuǎn)，我們將像元排列的第1行轉(zhuǎn)換到RGB位圖內(nèi)存中的最后一行（這是由于WindowsGDI函數(shù)顯示圖像第一行實(shí)際是內(nèi)存中 時(shí)，您調(diào)用KSJ_CaptureRgbDataKSJ_CaptureRgbDataExRGB位圖數(shù)據(jù)，起始地址存放的是RGB位圖數(shù)據(jù)的起始地址存放的是感光陣列上面的像元轉(zhuǎn)換的數(shù)值，那么可以根據(jù)像元的排列情況調(diào)用位圖，每個(gè)像素以B,G,R,0格式組成，每個(gè)8bit。GRGRBGBGG…RGRRGRGBGRGR…GBGBRGRGG…BGBKSJ_SetParamKSJ_FLIP1時(shí)，他所代表的是控制前端陣列從實(shí)際情況設(shè)置，比如原來(lái)為RGGB模式，翻轉(zhuǎn)后為GBRG模式。UC130C_xxYx,UC130M_xxYx,UC320C_xxYx有4個(gè)IO可以提供給用戶操作，用戶通過(guò)調(diào)用4API函數(shù)使用說(shuō)明書》。設(shè)置為輸入，并讀取GPIO3引腳的輸入狀態(tài)。//// != 123456789:Pin2（USB_5VPC的USB接口取+5V200mA。Pin3（USB_GND：PC的USB接口和攝像機(jī)電路板引出地。Pin（SAPPin5（GPIO1）,Pin6（GPIO0）,Pin7（GPIO3）,Pin8（GPIO2）:4位GPIO口，可通過(guò)軟件IO都通過(guò)上拉電阻接于+3.3VGPIO的讀寫說(shuō)明請(qǐng)參考本文“關(guān)于GPIO的操作說(shuō)明”部分。P9（X，Pin（RXD ,,123456789:Pin2（USB_5VPin3（USB_GND：PC的USB接口和攝像機(jī)電路板引出地。Pin（SAP6位GPIOIO都通過(guò)上拉電阻接于+3.3V。關(guān)于GPIO的讀寫說(shuō)明請(qǐng)參考本文“關(guān)于GPIO的操作說(shuō)明”部分。擴(kuò)展接口說(shuō)明2”部分。為了支持曝光與外部閃光燈同步，F(xiàn)lash信號(hào)有效的時(shí)刻大概是所有行同時(shí)曝光的時(shí)刻。對(duì)Blank+1280）*（480000004800000048000000個(gè)點(diǎn)，那么每個(gè)點(diǎn)所1280API函數(shù)對(duì)曝光的設(shè)置是以ms為單位的，所以需要您進(jìn)行換算。（Y+256）*（X+1280）/48000000=(2048+256)*（4096+1280）/48000000=0.258048(S)=發(fā)。默認(rèn)情況下，F(xiàn)LASH的有效寬度是tRow時(shí)間，即一行數(shù)據(jù)的時(shí)間。TSETSWtRow時(shí)間，這個(gè)是我們目前相機(jī)的默認(rèn)設(shè)置時(shí)序，也是TSETRIGGER之后的Pin2：USB_5VPin3：在V1版本之后，增加了八種Bayer模式，用于將彩色相機(jī)的Raw數(shù)據(jù)轉(zhuǎn)換為灰度數(shù)據(jù)，這八種模式為KSJ_BGGR_GRAY8, KSJ_GRBG_GRAY8,KSJ_RGGB_GRAY8,KSJ_GBRG_GRAY8,KSJ_BGGR_GRAY8_FLIP,KSJ_GRBG_GRAY8_FLIP,KSJ_RGGB_GRAY8_FLIP,KSJ_GBRG_GRAY8_FLIPBayer模式。用戶只需調(diào)KSJ_BayerSetMode來(lái)設(shè)置黑白模式，設(shè)置成功后會(huì)直接影響采集圖像的比特深度，即所采集的位圖會(huì)是8位的灰度位圖。這點(diǎn)編程時(shí)需特別注意。API在V1版本之后，增加了八種Bayer模式，用于將彩色相機(jī)的Raw數(shù)據(jù)轉(zhuǎn)換為灰度數(shù)據(jù)，這八種模式為KSJ_BGGR_GRAY8, KSJ_GRBG_G