凯视佳工业相机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其中的一个进行调解即可，只要调解一个，其他的就KSJ_CaptureRawData(0,pData);对于黑白相机，不要调用即可，注意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其中的一个进行调解即可，只要调解一个，其他的就通过调用KSJ_PreviewPause(0,true);来暂停预览。暂停成功后可以通过(,KSJ_PreviewGetSize来获得，获得的数据可通通过调用KSJ_PreviewPause(0,false);来继续视频流，最后通过调用设置第0个采集设备的视场为0，0，1280，1024，无抽点模式：KSJ_CaptureSetFieldOfView(0,0,0,1280,1024,KSJ_SKIPNONE,KSJ_SKIPNONE);IntnWidth,通过调用KSJ_SetParam来设置KSJ_RED,KSJ_GREEN,KSJ_BLUE色彩增益。通过调用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,(通过调用KSJ_SetParam来设置KSJ_RED,KSJ_GREEN,KSJ_BLUE色彩增益。通过调用通过调用KSJ_PreviewPause(0,true);来暂停预览。暂停成功后可以通过KSJ_PreviewGetSize来获得，获得的数据可通通过调用KSJ_PreviewPause(0,false);（3.3V我们可以通过调用KSJ_APIintstdcallKSJ_SnapButtonStatus(intnChannel,设置预览的回调函数，请参考《凯视佳工业相机API函数使用说明书》中KSJ_SnapButtonStatus读取按键的状态，条件满足时此帧图像即为外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开发包支持不同类型相机以及相同类型的多台相机的同时采集和同时预览。这里所谓的同时不知真正意义上的同时，实际上是分时的。USB2.0480Mbps400Mbps已经算是高的了，还要看您主机上USB2.0主控芯片的性能，根据我们的经验，Intel845USB2.0支持较好。USB2.0USB2.0带宽，USB2.0主控芯片会以时间片轮询的方式来读取图像数据，所以多个相机连入并预览会使帧KSJ_APIintstdcallKSJ_DeviceGetInformation(INintnChannel,OUTKSJ_DEVICETYPE*pDeviceType,OUTint*pnIndex,OUTWORD*pwFirmwareVersion);nChannel=0,1,...(nDeviceNum-1)KSJApi函数来分别操作每个相机，具体当用户调用了KSJ_PreviewStart(nChannel,TRUE);之后，API开发包会将视频流显示在用户的如果插入相机，API内部会自动将用户之前的预览视场设置给相机，并自动恢复视频流，所KSJ_CaptureRawDataKSJ_CaptureRgbDataUSB连接线已经拔出，那么以上函数会返回RET_RECOVERY_FAIL，当相机再次被连入时，调用KSJ_CaptureRawDataKSJ_CaptureRgbData函数会自动对相机做恢复操作，并且按照用户之定要判断一下KSJ_CaptureRawDataKSJ_CaptureRgbData函数返回值是否为RET_SUCCESS。注意：当相机在拔出到重新连入之间，如果用户没有调用过KSJ_CaptureRawData或KSJ_CaptureRgbData函数，那么在相机被连入后，第一调用KSJ_CaptureRawData或KSJ_CaptureRgbDataRET_RECOVERY_SUCCESSKSJ_CaptureRawDataKSJ_CaptureRgbData函数调用成功，而是代表采集失败，但是恢复成功了，下一次调用KSJ_CaptureRawData或KSJ_CaptureRgbData函数才能正确返回RET_SUCCESS。注意：在相机被拔出时，调用一些与硬件进行通讯的函数会返回RET_FAIL.。比如KSJ_DeviceGetInformationKSJ_SetParam函数只有在确保相机已经正常恢复后才可调用，KSJ_DeviceGetInformationKSJ_SetParam函数内部没有恢复机制，对于采集的恢复，恢复机制只存在于KSJ_CaptureRawData或KSJ_CaptureRgbData函数两个函数中。注意：Bayer模式只针对彩色相机，黑白相机不需要进行Bayer转换。凯视佳UC130C相机使用的图像传感器的感光阵列如下：图中每一个方格代表一个像元，每一个像元只接收R,G,BBayer转换后，BGBGGRGRBGBG…转换后为24位位图格式。为了使显示图像不发生垂直翻转，我们将像元排列的第1行转换到RGB位图内存中的最后一行（这是由于WindowsGDI函数显示图像第一行实际是内存中 时，您调用KSJ_CaptureRgbDataKSJ_CaptureRgbDataExRGB位图数据，起始地址存放的是RGB位图数据的起始地址存放的是感光阵列上面的像元转换的数值，那么可以根据像元的排列情况调用位图，每个像素以B,G,R,0格式组成，每个8bit。GRGRBGBGG…RGRRGRGBGRGR…GBGBRGRGG…BGBKSJ_SetParamKSJ_FLIP1时，他所代表的是控制前端阵列从实际情况设置，比如原来为RGGB模式，翻转后为GBRG模式。UC130C_xxYx,UC130M_xxYx,UC320C_xxYx有4个IO可以提供给用户操作，用户通过调用4API函数使用说明书》。设置为输入，并读取GPIO3引脚的输入状态。//// != 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”部分。为了支持曝光与外部闪光灯同步，Flash信号有效的时刻大概是所有行同时曝光的时刻。对Blank+1280）*（480000004800000048000000个点，那么每个点所1280API函数对曝光的设置是以ms为单位的，所以需要您进行换算。（Y+256）*（X+1280）/48000000=(2048+256)*（4096+1280）/48000000=0.258048(S)=发。默认情况下，FLASH的有效宽度是tRow时间，即一行数据的时间。TSETSWtRow时间，这个是我们目前相机的默认设置时序，也是TSETRIGGER之后的Pin2：USB_5VPin3：在V1版本之后，增加了八种Bayer模式，用于将彩色相机的Raw数据转换为灰度数据，这八种模式为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模式。用户只需调KSJ_BayerSetMode来设置黑白模式，设置成功后会直接影响采集图像的比特深度，即所采集的位图会是8位的灰度位图。这点编程时需特别注意。API在V1版本之后，增加了八种Bayer模式，用于将彩色相机的Raw数据转换为灰度数据，这八种模式为KSJ_BGGR_GRAY8, KSJ_GRBG_G