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

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