SaperaDevelopHelpseniorWord下载.docx

1、GetParameter, SapAcquisition:SetParameterGetSignalStatusIsSignalStatusAvailable SapAcqCallbackInfo存储SapAcquisition类回调的内容SapAcqCallbackInfo:GetContext SapAcqCallbackInfo:GetSignalStatus SapAcqDevice由设备读、写信息，还可直接发送、寄存事件至设备。常用于直接连接电脑的相机（如GigE相机）SapAcqDevice:SapAcqDevice SapAcqDevice:GetConfigFile, SapA

2、cqDevice:SetConfigFileUpdateFeaturesFromDevice SapAcqDeviceCallbackInfo存储SapAcqDevice类回调的内容SapAcqDeviceCallbackInfo:SapAcqDeviceCallbackInfo SapAcqDeviceCallbackInfo:GetAcqDevice SapBayerBayer转换操作（分为软件和硬件实现两种） SapBayer:WhiteBalance SapBayer:EnableLutGetAlign, SapBayer:SetAlignGetWBGain, SapBayer:Set

3、WBGain SapBuffer操作buffer资源SapBuffer:SapBuffer SapBuffer:ClearGetParameter, SapBuffer:GetPitchGetPixelDepth, SapBuffer:SetPixelDepthGetIndex, SapBuffer:SetIndexGetCount, SapBuffer:SetCountGetFrameRate, SapBuffer:SetFrameRateNext SapBufferRemoteBuffer远程使用（需用SapBuffer:Register事先定义）SapBufferRemote:SapBu

4、fferRemote SapBufferRemote: SapBufferRoi在已存在的SapBuffer对象中创建方形ROI区域SapBufferRoi:SapBufferRoi SapBufferRoi: SapBufferWithTrash Class建立称为trash buffer的附加资源。常用于实时图像处理操作中，当数据传送速度比处理速度快时，图象将被保存在trash buffer中，直到能够稳定输出 常用函数：SapBufferWithTrash:SapBufferWithTrash SapBufferWithTrash: SapCab操作CAB资源的功能，更详细帮助见Sape

5、ra CAB Programmers Manual. SapCounter记录事件，可记录外部信号或内部信号（如硬件时钟）SapCounter:SapCounter SapCounterCallbackInfo存储SapCounter类回调的内容SapCounterCallbackInfo:SapCounterCallbackInfo SapCounterCallbackInfo:GetCounter SapDisplay操作默认显示资源SapDisplay: SapDisplay:GetDCGetWidth SapDsp操作DSP资源 SapFeature得到SapAcqDevice类的特征

6、信息，如姓名、类型、连接模式等使用SapAcqDevice:GetFeatureInfo访问SapFeature:GetLocation, SapFeature:SetLocation SapFlatField单色图像平场校正功能SapFlatField:ComputeGain SapFlatField:ComputeOffset SapGio控制输入和输出设备使之读写同步，常与SapCounter联合使用读取I/O设备的状态SapGio:AutoTrigger SapGio:EnableCallback SapGioCallbackInfo存储SapGio类回调的内容SapGioCallba

7、ckInfo:GetPinNumber SapGraphic在图像中绘制或书写文字（首先通过SapView:GetDC获得句柄） SapGraphic:Text SapLocation 识别Sapera server/resource对（物理设备的抽象表示）SapLocation:GetResourceIndex SapLocation:GetServerName SapLut管理lookup table（首先使用SapAcquisition:GetLut 获得SapLut对象，操作完成LUT后使用 SapAcquisition:ApplyLut记录）SapLut:Arithmetic Sap

8、Lut:BinaryPatternThreshold SapManager描述当前系统上的Sapera资源，同时包括错误管理功能SapManager:GetCommandTimeout, SapManager:SetCommandTimeout SapManCallbackInfo存储SapManager类回调的内容SapManCallbackInfo:GetErrorMessage SapPerformance基准评估功能，评估一个buffer所占用的时间常用功能：SapPerformance:GetTimeMicro SapPerformance:Reset SapPixPro操作像素处理

9、设备，作为中间转换节点，允许数据由采集设备传递到下一个转换节点 SapPixProParams存储SapPixPro类回调的内容 SapProcessing用于管理用户自己的processing SapProCallbackInfo SapTransfer管理转移过程SapTransfer: SapTransfer:FreezeGrabSnapWaitAbortIsGrabbingGetPair Specialized Transfer Classes特别转换类（一系列从属于SapTransfer的类，使用户方便操作许多常用的转移节点）常用转换类：SapAcqToBuf Class SapAc

10、qDeviceToBuf Class SapCabToBuf Class SapBufToBuf Class SapAcqToCab Class SapCabToCab Class SapBufToCab Class SapView通过SapDisplay对象显示存放在SapBuffer中的资源，SapView和SapTransfer的同步性使得能够实时显示buffer中的数据而不会出现丢失数据的情况。SapView:SapViewShow SapView:GetDisplay, SapView:SetDisplayOnHScrollOnMoveOnPaint SapViewCallbackI

11、nfo存储SapView类回调的内容 SapXferCallbackInfo存储SapTransfer类回调的内容（一帧图像转移完成后自动调用XferCallback）SapXferCallbackInfo:GetContext SapXferCallbackInfo:IsTrash SapXferPair描述了SapTransfer class的一对源与目的地SapXferPair:GetFramesPerCallback, SapXferPair:SetFramesPerCallback SapXferParams存储SapTransfer类需传递的参数信息 SapXferNode操作转换

12、节点2. GUI类：提供了许多常用设置对话框，用户可根据自己的需要选用；其结构如下图所示。Sapera GUI介绍名 称功 能CAbortDlg是SapTransfer:Wait 功能的改进，允许中断后等待不确定的时间CAcqConfigDlg导入相机配置文件（CCF），建立新的SapAcquisition 对象，可调用CAcqConfigDlg: GetAcquisition 得到此文件CAcqDlg动态修改采集设备参数CAScanDlg动态修改面阵相机参数CBayerOptionsDlgBayer转换参数选择对话框CBufDlg改变SapBuffer对象的参数CCabDlg动态修改CAB参

13、数CCompDlg动态修改合成视频输入信号参数CDspDlg选择文件导入DSP内存CFlatFieldDlg操作平场校正CGioInputDlg获得/设置输出设备信息CImageWnd操作图像显示窗口、滚动条、ROI区域等CLoadSaveDlg保存/导入图像至SapBuffer对象CLScanDlg动态修改线阵相机参数CPixProDlg修改SapPixPro对象的参数CViewDlg动态修改显示区域二例程介绍1. examples 介绍SaperaExamplesClassesSapExamples.dsw （for Visual C+ 6.0）SaperaExamplesClassesS

14、apExamples_2003.sln （for Visual Studio .NET 2003）SaperaExamplesClassesSapExamples_2005.sln （for Visual Studio 2005）SaperaExamplesClassesSapExamples.bpg （for Borland C+ Builder） FileLoadCPP 演示由磁盘加载图片至buffer并显示。Buffer根据图像文件格式进行创建。能够加载多种类型的图像文件（如monochrome, RGB, or YUV）。此例使用Sapera C+ API。 FileLoadMFC 与

15、FileLoadCPP Example功能一致，但使用了Sapera+ GUI浏览文件夹。 GrabCPP由选定相机采集图像至buffer中并显示。Buffer根据相机设置进行创建，任何相机（CameraLink或GigE相机）都能适用。 GrabLut 保存、载入lookup-table至硬件过程hardware processing engine，并将图像进行所选Lut的处理并显示。 GrabMFC 与GrabCPP Example功能一致，但使用了Sapera+ GUI。与GrabCPP功能一致，但使用GUI Sapera+类，通过对话框选择板卡与相机。 ColorSplit显示怎样分裂

16、和融合彩色图像至单色部分。如载入一RGB图像，将之分为3个单色部分，而后分别对单色部分进行图像处理，处理后融合为RGB图像进行输出。 FindGigECamera 检测所有已连接的GigE相机名称、序列号、服务名等，通过改变代码，可实现改变相机名称的功能。 GigECameraLut由已选择的GigE相机采集图像至内存，并显示怎样使能、保存和载入lookup-table至硬件hardware processing engine，并显示经过所选Lut变换后的图像。 GigECameraEvents 使用CorAcqDevice列出所有可用设备 GigEAutoWhiteBalance 使用Cor

17、AcqDevice在GigE彩色相机中应用自动白平衡，可更改buffer设置并存储原始设置，并给出怎样通过已选择的GigE相机采集、保存图像并显示。2. Demos介绍SaperaDemosClassesVcSapDemos.dsw （for Visual C+ 6.0）SaperaDemosClassesVcSapDemos_2003.sln （for Visual Studio .NET 2003）SaperaDemosClassesVcSapDemos_2005.sln （for Visual Studio 2005）SaperaDemosClassesVcSapDemos.bpg （f

18、or Borland C+ Builder） Grab Demo （Dialog Box Interface 对话框）路径：SaperaDemosClassesVcGrabDemoReleaseGrabDemo.exe显示了基本的采集功能，允许获得连续或单帧图像，同时调整采集参数 Grab Demo （Single Document Interface 单文档）SaperaDemosClassesVcGrabDemoSDIReleaseGrabDemoSDI.exe Grab Demo （Multiple Document Interface 多文档）SaperaDemosClassesVcG

19、rabDemoMDIReleaseGrabDemoMDI.exe显示了基本的采集功能，允许获得连续或单帧图像，同时调整采集参数；可打开多窗口来同步获得不同相机的显示图像 Sequential Grab DemoSaperaDemosClassesVcSeqGrabDemoReleaseSeqGrabDemo.exe采集序列图像至内存而后显示，程序允许录制多段视频，并可存储、导入AVI文件。每一图像存储于不同buffer中，可通过对话框设置buffer大小等参数。 Bayer DemoSaperaDemosClassesVcBayerDemoReleaseBayerDemo.exe显示Bayer

20、 转换功能，进行Bayer转换参数设置。 Flat-field DemoSaperaDemosClassesVcFlatFieldDemoReleaseFlatFieldDemo.exe显示平场校正功能。平场校正Flat Field Correction （FFC） 包括调整模式噪声Fixed Pattern Noise （FPN）,像素置换 Pixel Replacement, Photo Response Non Uniformity （PRNU）, 和斑点校正 Shading Correction. I/O DemoSaperaDemosClassesVcIODemoReleaseIOD

21、emo.exe显示一般I/O设备的使用，允许监视当前输入输出状态，改变高低极性状态；允许监视输入中断并记录中断数。 GigE-Vision Camera DemoSaperaDemosClassesVcGigeCameraDemoReleaseGigeCameraDemo.exe怎样使用DALSA GigE Vision 相机获得图像. 可导入相机配置文件 3. ActiveX控件SaperaDemosActiveXVb6SapActiveXDemos.vbg （for Visual Basic 6.0）SaperaDemosActiveX.NETSapActiveXDemos_2003.sl

22、n （for Visual Studio .NET 2003）SaperaDemosActiveX.NETSapActiveXDemos_2005.sln （for Visual Studio 2005）SaperaDemosActiveXDelphiSapActiveXDemos.bpg （for Borland Delphi 7）对ActiveX控件的使用操作详见Sapera LT ActiveX Controls Manual常用操作 编程步骤介绍一、 加载动态连接库步骤：1. 使用Basic Classes： 在Project | Settings | C/C+ | Preproces

23、sor | Additional include directories 中加入路径C:DALSASaperaClassesBasic；在Project|Add to Project | Files 中加入C:DALSASaperaLibSapClassBasic.lib 和 SapClassBasicD.lib；在 Project | Settings| General中将SapClassBasic.lib 选为Exclude file from build； 在Project | Settings | C/C+ | Code Generation | Use run-time librar

24、y中选择choose the option Multithreaded DLL （在release模式下） or Debug Multithreaded DLL （在debug模式下） ；在头文件中加入SapClassBasic.h。2. 使用GUI：DALSASaperaClassesGui；DALSASaperaLibSapClassGui.lib 和 SapClassGuiD.lib；在 Project | Settings| General中将SapClassBasic.lib 选为Exclude file from build for Win32 Release； 在In Project | Settings | C/C+ | Code Generation | Use run-time library中选择choose the option