FlyCapture2使用说明文档.docx
FlyCap2使用说明硬件要求a)OS：WindowXP/73g4位,Ubuntu8.04/10.04b）数据线：1394线二、接口定义PinGPIO功能I100Input3.3V+2IOlOutput无源光隔离3102可定义Input或者OUIPUt3.3V+4103可定义Input或者OUtPUt3.3V+5GND电源划1,102地，103Ml6GND100,ICH地7Vext+12v电源供电接入8TBD（待定）3.3V输出输出信号接法如下图:GPIO1(Opto-IsolatedOutput)CircuitThefigurebelowshowstheschematicfortheopto-isolatedoutputcircuit.Themaximumcurrentallowedthroughtheopto-isolatedoutputcircuitis25mA.虚线左半部分为相机内部电路，右半部分是外部电路，需要在7和6之间加入上拉电压和负载电阻。为机器植入眼睛和大脑!ImplantEyesandBrainsinMachines三、 软件安装及连接a）软件（WindoWS版）安装前，要求电脑预装.NetFramework,推荐安装.NetFramework3.5。b）为避免软件冲突，建议卸载其他网口相机驱动，并确认网卡驱动为原版驱动。c）推荐安装软件版本为FlyCapture2.1.3.5,下载链接：http:ViSiOd）安装过程中需要进行选择的界面见下图：图中选择IwilluseFirewarecamereaso四、 软件使用1. 打开开始一程序-PointGreyResearchFIyCaptureZ-FlyCap2即可找到相机CdmerdLHt(1C4tmerd&tH)CameraInformationsr>8auaXskfrf*cIPAidrettStfialK>Ur36213682Ze2由YaKITOSSCGldIolI(M3IB>dlZbr2Z-G三X>-50SSCVnr:PoinC0ry*a,ckS«at«r:SMyCX62SAQC3*24*2O<8OCD)B*loti24<x2O<8Xatrfac:<h<EHsSpe«4:S16OOraH*SzUrJn»，CPCIV*HOCVrtic1.32FirwiarVerxiosk.0.103.0FirwrarBvil4TiTSJg282002:482011Dirirer:CitfFtllrDriver(Ndtjn)-2.3.37GigIEInformationGi0Vrtia:1.2Ua«rMiUa-<5iG三-U>r01XSL皿I:Ucal.OV.3si>；00200040.4Z8DXILUn.2:Ml>：/rw.p¾<ry.<«/CfS.0V.3mlUCMmOOiOgD:8:OrzA11M11o.o.ms*bMt.g：2W2W2400tkWS3夕0.00.0XfCMeQn11jAnly«rc«IFfrthConfigureSelected是参数选择，C)K确认进入采集。b)常规连接i.参数控制界面CtfnerdSetthgsStandard Video ModwOirtomVkteoMxlwOmera WormationCaners RegbterSTrM / StrobeAdvanced Qmera SetthjsHgh Dynacrtc Relo&wnt*FramBftZferDMaFshSrJtcmtrfoemettanBus TopobgyHe>StwrtCa*ra Absolute HodtBrightrmn E Npotuie Shdipnett Hue SatUIduon GdMld l Focut Zom PanTikShuttaGainamena(eW B (Rcd W B (Blue) PoweiTempeiatteeO-QO-O0QQQQ-Q- SJ331.2K9805C136 49T，国1) mmmm00ff Om FhW Shutter,Gain,FrameRate默认自动调节，手动调节前，勾选掉AUtO选项。CameraSettgSPinDirectionControlTri(<r/SlrobControlTriggerControlTriggerDelayStandardWdcoMdcsIjEnbl/4itbltri(CustomWdeoModesEntbl/disabledl*yCameraInfcnnMionCameraRegistersT11jerStrobeAdvancedCameroSettngsHhDynarhcRma1.ockUpTabbPvSr0TriggerSource6(I00OGPIOI©GFIO2©OTO3OTriggerPolarity©Lov5KBChBintri(<4rdoIWO.OOOOOsThisasusuallyonlySedQ。AaniiallySetp>ns”input*itutUin<Xtricc«rdelay.0.000:GPIO0：叶In©OutSoftwareTriQQerFireSoft*rTriGPIO1:DIft<®OutGPIO2:DlnOutGPIO3:DIOutFremeDufferDaUFtehStrobeControlGPIO0nbl4SystemInformationBusTopdoqyHebZSupport：strobforthispin*)K<hDelay)LvDuration:)00Pol*riGPIO1Znobl«strobforthispin1.WtjK岫D.1,yL1.ovDuration：)Ol告丽mblestrobforthispinPOiSFKgDUyOOlI>)LveDuratiMk:).01>GPIO3HIo27mblstrob«forthispinPoltri"0IooO.同.)LevDur“iM>00使用输出信号时按上图设置，如果使用触发信号，需要再勾选上Enable/disabletrigger。Carrera5edisStandardVideoModesCustomVideoModesCameraInforcnabonCameraRegistersTrigger/StrobeAdvancedCttTIeraSettingsIRa*Bftyaroutput(OBlyforY8andT16)r2Iirrorimae(horizontalflip)Y16EndiannessOBigendianC11DC1394DCAIlT16o©Littleendian(jGR-specificY16i»EmbeddedImageInformationbelectthetrae-三pectcinforr>tiontonbdddintK«AdvancedCameraSettingsHght>amicRange1.ookUpTatteDisplayTestPattern©Pattern1©Pattern2Vone11TimestwpIGinIShutterBritnessSeleCtUIFrameBufferDataFlashMemoryChannelsChaimel:SystemInformationBusTopologyHelp/SuppcrtMOtqSavichannelre2SaVeIIRestorerExposurePWhitblnc4FremecounterbtrooeDnnAUtORangeControlProperty:ExposureHin:256UnseleclAlHo:GigEPacketResend0EnablepacketresendTimeout6s):NaxpacketstorezerISWeLoadI保存参数设置时，选择Channe11,点击save,恢复出厂设置时，选择DefaUlt,点击ReStore。c)更新firmware打开开始一程序-PointGreyResearchFlyCapture2-Utilities-UpdatorGUIZ打开需要更新的fhnware,点击Update即可。五、 SDK开发3) FlyCaptureZ介绍FlyCapture2是PointGrey公司相机配套的软件开发包。软件支持MicrosoftWindows(XPvistawin7x64x86)>LinuxUbuntu,并且支持AetiVeX,DirectShow,TWAINAPISo开发包包括： 设备驱动(forwindows) 二次开发工具(SDK) 多种示例程序及源代码FlyCapture2特点如下: 提供完整易用的用于采集、处理、保存和显示的链接库 提供标准的C/C+/.NET接口，方便相机与其他设备兼容和结合 使用DMA减少请求的延迟和处理时间 支持多线程编程 提供控制相机的完整API 提供VisualC+6.0和ViSUalStudio2005示例程序及源代码注：FIyCaPtUreSDK必须配合FlyC叩ture自带的驱动使用，不支持第三方的驱动程序。b)系统要求(软件)Windows WindowsXP,WindowsVistaorWindows7 MSVisualStudio6.0SP5);or MSVisualStudio2005SPI(tocompileandrunexamplecodeonWindowsXP64-bit) MSVisualStudio2005SPlandSPlUpdateforVista(tocompileandrunexamplecodeonWindowsVistaorWindows7)1.inux Ubuntu8.04 gtkmm-2.4-devandIibgtkmm-2.4-devdependenciestocompileandrungraphicaluserinterface(GUI)-basedexamplecode,suchasHyCap2.Consoleapplicationsdonotrequirethesepackages.Theselibrariesareusuallypre-installed.c)FlyCapture2C+APIClass介绍AVIOptionAVl文件选项AVIRecorder用于将图片记录保存为AVlBusManager用于获取相机的GUlD（相机标识符）Camera相机类，用于对相机的连接、采集、参数和功能的设置（原理上都是通过寄存器设置完成），适用于1394和USB接口相机CameraBase相机的通用接口类，Camera和GigECamera类的集合CameraControIDIg图形化控制相机的参数的GTKmmDlgCameraInfo相机信息类CameraSeIectionDIg图形化选择相机的GTKmmDlgCameraStats相机诊断信息ConfigROM相机配置ROMDCAMFormats相机支持的视频格式，GetAVaiIabIeFOrmatS。的返回值EmbeddedImageInfo所有可用图像参数属性EmbeddedImageInfoProperty单独某一个参数属性Error大多数函数的返回类型FC2Config相机配置类FC2Version当前库版本类Format7ImageSettings自定义图像格式配置类Format7Info自定义图像格式信息类Format7PacketInfo自动以图像格式数据包信息类GigECamera网口相机类GigEConfig网口相机配置类GigEImageSettings网Il相机图像设置类GigEImageSettingsInfo网口相机图像信息类GigEProperty网口相机参数类GigEStreamChanneI网口相机数据流信息类HostAdapterStats主机网络适配器信息类Image用于从相机取出图像数据，以及不同图像格式之间转换和保存图片到当地硬盘ImageMetadata与图像有关的相机参数类（shutter,gain等）ImageStatistics图像统计信息类（颜色通道，灰度均值等）IPAddressIPv4地址类JPEGOptionJPEG存储操作类JPG2OptionJPEG2000存储操作类LUTData相机查找表信息类MACAddressMAC地址类PGMOptionPGM存储操作类PGRGuid相机标识符PNGOptionPNG存储操作类PPMOptionPPM存储操作类Property相机详细参数类（用于读取或设置相机参数）PropertyInfo相机参数有关信息类StrobeControI相机闪光灯信号控制类StrobeInfo相机闪光灯信号信息类SystemInfo系统信息类TIFFOptionTIFF存储操作类TimeStamp时间戳信息类TopoIogyNode用于将所有连接到一台电脑上的相机组成一个树形拓扑结构TriggerMode相机触发模式类TriggerModeInfo相机触发设置信息类Utilities用于获取系统信息（系统版本、内存等）VideoModes单个相机图像格式信息类d）FIyCaptureZ简单开发步骤1 .加载动态链接库和头文件需要包含的文件：FlyCapture2include下所有头文件（C文件夹下是C语言需要的头文件，FCl文件夹下是FlyCapture旧版本头文件）FiyCapture2libFIyCaPtUre2.1ibFlyCapture2libFlyCapture2GUI.lib在ProjectSettingsLinkObjectIibrarj,modules中加入IFlyCaPtUre2.libHyCapture2GUI.lib（release和debug模式下都需要添加）在ProjectSettingsCC+CodeGenerationXUserun-timelibrary中选择choosetheoptionMultithreadedDLL（在release模式下）orDebugMultithreadedDLL（在debug模式下）；2 .一般开发步骤1394和USb相机：获取总线上相机个数和indexBusManagerbusMgr;总线信息unsignedintnumCameras;error=busMgr.GetNumOfCameras（fenumCameras）;获取总线上所有相机信息获取某一个相机GUlDPGRGuidguid;error=busMgr.GetCameraFromIndex（i,&guid）;获取第i个相机的GUID连接相机Cameracam;/相机类error=cam.Connect（feguid）;连接相机设置回调、开始采集void SDKCallBackCImage *p, const void* pp) (UserCalIBack(p->GetData();Ierror = cam.StartCapture(SDKCallBack);更改参数(读写ShUtter)Property Shutter(SHUTTER);error = cam.GetProperty(&shutter);shutter.abs Value = 0.2;shutter.absControl = TRUE;ShutteEautoManualMode = FALSE;shutter.onePush = FALSE;shutter.onff = TRUE;shutter.present = TRUE;error = cam. S etProperty(&sh utter);保存图片Image rawimage;error = cam.RetrieveBuffer( &rawlmage );error = raw Image.Con vert( PIXEL_FORMATchar filename512;回调函数定义举例获取图像数据指针开始采集，允许没有回调函数参数属性类,确定参数类型，详见 SDK help » 如果改 gain ,则 SHUTTER 替换为 GAIN获取相机shutter/shutter 值改为 0.2s采用绝对值输入关闭自动，手动设置shutter关闭 OnePUSh/shutter 有效写入设置好的shutter原始数据接收原始数据BGRU, &convertedlmage);/转换成需要的格式文件名sprintf(filename,"%u-%d.bmp",camInfo.serialNumber,imageCount);error=convertedImage.Save(filename);/保存图片停止采集、断开连接error=cam.StopCapture();error=cam.DisconnectO;网口相机：(初始化和相机参数设置略有不同)获取总线上相机个数和indexBusManagerbusMgr;CameraInfocamlnfo128;unsignedintnumCamlnfo=128;error=BusManager:DiscoverGigECameras(caminfo,&numCamInfb);可省略unsignedintnumCameras;error=busMgr.GetNumOfCameras(<fenumCameras);获取某一个相机GUlDPGRGuidguid;error=busMgr.GetCameraFromIndex(i,&guid);连接相机GigECameracam;error=cam.Connect(&guid);其余步骤同上，具体不同函数调用见GigECamera和Camera类说明
