Sapera LT帮助文档 中文版.docx
- 文档编号:25361840
- 上传时间:2023-06-07
- 格式:DOCX
- 页数:19
- 大小:52.62KB
Sapera LT帮助文档 中文版.docx
《Sapera LT帮助文档 中文版.docx》由会员分享,可在线阅读,更多相关《Sapera LT帮助文档 中文版.docx(19页珍藏版)》请在冰豆网上搜索。
SaperaLT帮助文档中文版
Sapera帮助文档
简介:
SaperaLT是一套用于图像采集、显示和控制的独立于硬件以外的C和C++软件库,支持所有DALSACoreco硬件平台。
它的综合功能集包括程序可移植性、多样化的相机控制、灵活的显示和管理功能,以及易于使用的应用开发向导。
SaperaLT与MicrosoftVisualStudioC/C++、.Net、VisualBasic6.0和BorlandC++Builder兼容,支持WindowsXP、2000和NT平台。
一.Sapera++介绍
Sapera++是SaperaLT为用户提供的API.Sapera++包含两大类:
基础应用类(BasicClasses)和GUI类(GUIClasses)。
1.基础应用类:
提供了用户进行图像开发的基本函数,命名方式为Sap+类功能名,其结构如下图所示:
SaperaBasicClass函数功能介绍:
●DataClasses:
功能:
下属多个数据类,每一个数据类管理了一种特定数据类型
下属数据类:
SapDataClass
SapDataHSIClass
SapDataHSVClass
SapDataFloatClass
SapDataFPointClass
SapDataFRGBClass
SapDataMonoClass
SapDataPointClass
SapDataRGBClass
SapDataRGBAClass
SapDataYUVClass
●SapAcquisition
功能:
控制与板卡相连接的采集设备
常用函数:
SapAcquisition:
:
SapAcquisition
SapAcquisition:
:
Create
SapAcquisition:
:
Destroy
SapAcquisition:
:
ApplyLut
SapAcquisition:
:
GetParameter,
SapAcquisition:
:
SetParameter
SapAcquisition:
:
GetSignalStatus
SapAcquisition:
:
IsSignalStatusAvailable
●SapAcqCallbackInfo
功能:
存储SapAcquisition类回调的内容
常用函数:
SapAcqCallbackInfo:
:
GetContext
SapAcqCallbackInfo:
:
GetSignalStatus
●SapAcqDevice
功能:
由设备读、写信息,还可直接发送、寄存事件至设备。
常用于直接连接电脑的相机(如GigE相机)
常用函数:
SapAcqDevice:
:
SapAcqDevice
SapAcqDevice:
:
Create
SapAcqDevice:
:
Destroy
SapAcqDevice:
:
GetConfigFile,SapAcqDevice:
:
SetConfigFile
SapAcqDevice:
:
UpdateFeaturesFromDevice
●SapAcqDeviceCallbackInfo
功能:
存储SapAcqDevice类回调的内容
常用函数:
SapAcqDeviceCallbackInfo:
:
SapAcqDeviceCallbackInfo
SapAcqDeviceCallbackInfo:
:
GetAcqDevice
●SapBayer
功能:
Bayer转换操作(分为软件和硬件实现两种)
常用函数:
SapBayer:
:
WhiteBalance
SapBayer:
:
EnableLut
SapBayer:
:
GetAlign,SapBayer:
:
SetAlign
SapBayer:
:
GetWBGain,SapBayer:
:
SetWBGain
●SapBuffer
功能:
操作buffer资源
常用函数:
SapBuffer:
:
SapBuffer
SapBuffer:
:
Create
SapBuffer:
:
Clear
SapBuffer:
:
Destroy
SapBuffer:
:
GetParameter,SapBuffer:
:
SetParameter
SapBuffer:
:
GetPitch
SapBuffer:
:
GetPixelDepth,SapBuffer:
:
SetPixelDepth
SapBuffer:
:
GetIndex,SapBuffer:
:
SetIndex
SapBuffer:
:
GetCount,SapBuffer:
:
SetCount
SapBuffer:
:
GetFrameRate,SapBuffer:
:
SetFrameRate
SapBuffer:
:
Next
●SapBufferRemote
功能:
Buffer远程使用(需用SapBuffer:
:
Register事先定义)
常用函数:
SapBufferRemote:
:
SapBufferRemote
SapBufferRemote:
:
Create
●SapBufferRoi
功能:
在已存在的SapBuffer对象中创建方形ROI区域
常用函数:
SapBufferRoi:
:
SapBufferRoi
SapBufferRoi:
:
Create
●SapBufferWithTrashClass
功能:
建立称为trashbuffer的附加资源。
常用于实时图像处理操作中,当数据传送速度比处理速度快时,图象将被保存在trashbuffer中,直到能够稳定输出
常用函数:
SapBufferWithTrash:
:
SapBufferWithTrash
SapBufferWithTrash:
:
Create
●SapCab
功能:
操作CAB资源的功能,更详细帮助见SaperaCABProgrammer’sManual.
●SapCounter
功能:
记录事件,可记录外部信号或内部信号(如硬件时钟)
常用函数:
SapCounter:
:
SapCounter
●SapCounterCallbackInfo
功能:
存储SapCounter类回调的内容
常用函数:
SapCounterCallbackInfo:
:
SapCounterCallbackInfo
SapCounterCallbackInfo:
:
GetCounter
●SapDisplay
功能:
操作默认显示资源
常用函数:
SapDisplay:
:
Create
SapDisplay:
:
GetDC
SapDisplay:
:
GetWidth
●SapDsp
功能:
操作DSP资源
●SapFeature
功能:
得到SapAcqDevice类的特征信息,如姓名、类型、连接模式等
使用SapAcqDevice:
:
GetFeatureInfo访问
常用函数:
SapFeature:
:
GetLocation,SapFeature:
:
SetLocation
●SapFlatField
功能:
单色图像平场校正功能
常用函数:
SapFlatField:
:
ComputeGain
SapFlatField:
:
ComputeOffset
●SapGio
功能:
控制输入和输出设备使之读写同步,常与SapCounter联合使用读取I/O设备的状态
常用函数:
SapGio:
:
AutoTrigger
SapGio:
:
EnableCallback
●SapGioCallbackInfo
功能:
存储SapGio类回调的内容
常用函数:
SapGioCallbackInfo:
:
GetPinNumber
●SapGraphic
功能:
在图像中绘制或书写文字(首先通过SapView:
:
GetDC获得句柄)
常用函数:
SapGraphic:
:
Text
●SapLocation
功能:
识别Saperaserver/resource对(物理设备的抽象表示)
常用函数:
SapLocation:
:
GetResourceIndex
SapLocation:
:
GetServerName
●SapLut
功能:
管理lookuptable(首先使用SapAcquisition:
:
GetLut获得SapLut对象,操作完成LUT后使用SapAcquisition:
:
ApplyLut记录)
常用函数:
SapLut:
:
Arithmetic
SapLut:
:
BinaryPattern
SapLut:
:
Threshold
●SapManager
功能:
描述当前系统上的Sapera资源,同时包括错误管理功能
常用函数:
SapManager:
:
GetCommandTimeout,SapManager:
:
SetCommandTimeout
●SapManCallbackInfo
功能:
存储SapManager类回调的内容
常用函数:
SapManCallbackInfo:
:
GetErrorMessage
●SapPerformance
功能:
基准评估功能,评估一个buffer所占用的时间
常用功能:
SapPerformance:
:
GetTimeMicro
SapPerformance:
:
Reset
●SapPixPro
功能:
操作像素处理设备,作为中间转换节点,允许数据由采集设备传递到下一个转换节点
●SapPixProParams
功能:
存储SapPixPro类回调的内容
●SapProcessing
功能:
用于管理用户自己的processing
●SapProCallbackInfo
功能:
存储SapManager类回调的内容
●SapTransfer
功能:
管理转移过程
常用函数:
SapTransfer:
:
Create
SapTransfer:
:
Freeze
SapTransfer:
:
Grab
SapTransfer:
:
Snap
SapTransfer:
:
Wait
SapTransfer:
:
Abort
SapTransfer:
:
IsGrabbing
SapTransfer:
:
GetPair
●SpecializedTransferClasses
功能:
特别转换类(一系列从属于SapTransfer的类,使用户方便操作许多常用的转移节点)
常用转换类:
SapAcqToBufClass
SapAcqDeviceToBufClass
SapCabToBufClass
SapBufToBufClass
SapAcqToCabClass
SapCabToCabClass
SapBufToCabClass
●SapView
功能:
通过SapDisplay对象显示存放在SapBuffer中的资源,SapView和SapTransfer的同步性使得能够实时显示buffer中的数据而不会出现丢失数据的情况。
常用函数:
SapView:
:
SapView
SapView:
:
Show
SapView:
:
Create
SapView:
:
Destroy
SapView:
:
GetDC
SapView:
:
GetDisplay,SapView:
:
SetDisplay
SapView:
:
OnHScroll
SapView:
:
OnMove
SapView:
:
OnPaint
●SapViewCallbackInfo
功能:
存储SapView类回调的内容
●SapXferCallbackInfo
功能:
存储SapTransfer类回调的内容(一帧图像转移完成后自动调用XferCallback)
常用函数:
SapXferCallbackInfo:
:
GetContext
SapXferCallbackInfo:
:
IsTrash
●SapXferPair
功能:
描述了SapTransferclass的一对源与目的地
常用函数:
SapXferPair:
:
GetFramesPerCallback,SapXferPair:
:
SetFramesPerCallback
●SapXferParams
功能:
存储SapTransfer类需传递的参数信息
●SapXferNode
功能:
操作转换节点
2.GUI类:
提供了许多常用设置对话框,用户可根据自己的需要选用;其结构如下图所示。
SaperaGUI介绍
名称
功能
CAbortDlg
是SapTransfer:
:
Wait功能的改进,允许中断后等待不确定的时间
CAcqConfigDlg
导入相机配置文件(CCF),建立新的SapAcquisition对象,可调用CAcqConfigDlg:
:
GetAcquisition得到此文件
CAcqDlg
动态修改采集设备参数
CAScanDlg
动态修改面阵相机参数
CBayerOptionsDlg
Bayer转换参数选择对话框
CBufDlg
改变SapBuffer对象的参数
CCabDlg
动态修改CAB参数
CCompDlg
动态修改合成视频输入信号参数
CDspDlg
选择文件导入DSP内存
CFlatFieldDlg
操作平场校正
CGioInputDlg
获得/设置输出设备信息
CImageWnd
操作图像显示窗口、滚动条、ROI区域等
CLoadSaveDlg
保存/导入图像至SapBuffer对象
CLScanDlg
动态修改线阵相机参数
CPixProDlg
修改SapPixPro对象的参数
CViewDlg
动态修改显示区域
二.例程介绍
1.examples介绍
Sapera\Examples\Classes\SapExamples.dsw(forVisualC++6.0)
Sapera\Examples\Classes\SapExamples_2003.sln(forVisualStudio.NET2003)
Sapera\Examples\Classes\SapExamples_2005.sln(forVisualStudio2005)
Sapera\Examples\Classes\SapExamples.bpg(forBorlandC++Builder)
●FileLoadCPP
功能:
演示由磁盘加载图片至buffer并显示。
Buffer根据图像文件格式进行创建。
能够加载多种类型的图像文件(如monochrome,RGB,orYUV)。
此例使用SaperaC++API。
●FileLoadMFC
功能:
与FileLoadCPPExample功能一致,但使用了Sapera++GUI浏览文件夹。
●GrabCPP
功能:
由选定相机采集图像至buffer中并显示。
Buffer根据相机设置进行创建,任何相机(CameraLink或GigE相机)都能适用。
此例使用SaperaC++API。
●GrabLut
功能:
保存、载入lookup-table至硬件过程hardwareprocessingengine,并将图像进行所选Lut的处理并显示。
●GrabMFC
功能:
与GrabCPPExample功能一致,但使用了Sapera++GUI。
●GrabMFC
功能:
与GrabCPP功能一致,但使用GUISapera++类,通过对话框选择板卡与相机。
●ColorSplit
功能:
显示怎样分裂和融合彩色图像至单色部分。
如载入一RGB图像,将之分为3个单色部分,而后分别对单色部分进行图像处理,处理后融合为RGB图像进行输出。
●FindGigECamera
功能:
检测所有已连接的GigE相机名称、序列号、服务名等,通过改变代码,可实现改变相机名称的功能。
●GigECameraLut
功能:
由已选择的GigE相机采集图像至内存,并显示怎样使能、保存和载入lookup-table至硬件hardwareprocessingengine,并显示经过所选Lut变换后的图像。
●GigECameraEvents
功能:
使用CorAcqDevice列出所有可用设备
●GigEAutoWhiteBalance
功能:
使用CorAcqDevice在GigE彩色相机中应用自动白平衡,可更改buffer设置并存储原始设置,并给出怎样通过已选择的GigE相机采集、保存图像并显示。
2.Demos介绍
Sapera\Demos\Classes\Vc\SapDemos.dsw(forVisualC++6.0)
Sapera\Demos\Classes\Vc\SapDemos_2003.sln(forVisualStudio.NET2003)
Sapera\Demos\Classes\Vc\SapDemos_2005.sln(forVisualStudio2005)
Sapera\Demos\Classes\Vc\SapDemos.bpg(forBorlandC++Builder)
●GrabDemo(DialogBoxInterface对话框)
路径:
\Sapera\Demos\Classes\Vc\GrabDemo\Release\GrabDemo.exe
功能:
显示了基本的采集功能,允许获得连续或单帧图像,同时调整采集参数
●GrabDemo(SingleDocumentInterface单文档)
路径:
\Sapera\Demos\Classes\Vc\GrabDemoSDI\Release\GrabDemoSDI.exe
功能:
显示了基本的采集功能,允许获得连续或单帧图像,同时调整采集参数
●GrabDemo(MultipleDocumentInterface多文档)
路径:
\Sapera\Demos\Classes\Vc\GrabDemoMDI\Release\GrabDemoMDI.exe
功能:
显示了基本的采集功能,允许获得连续或单帧图像,同时调整采集参数;
可打开多窗口来同步获得不同相机的显示图像
●SequentialGrabDemo
路径:
\Sapera\Demos\Classes\Vc\SeqGrabDemo\Release\SeqGrabDemo.exe
功能:
采集序列图像至内存而后显示,程序允许录制多段视频,并可存储、导入AVI文件。
每一图像存储于不同buffer中,可通过对话框设置buffer大小等参数。
●BayerDemo
路径:
\Sapera\Demos\Classes\Vc\BayerDemo\Release\BayerDemo.exe
功能:
显示Bayer转换功能,进行Bayer转换参数设置。
●Flat-fieldDemo
路径:
\Sapera\Demos\Classes\Vc\FlatFieldDemo\Release\FlatFieldDemo.exe
功能:
显示平场校正功能。
平场校正FlatFieldCorrection(FFC)包括调整模式噪声FixedPatternNoise(FPN),像素置换PixelReplacement,PhotoResponseNonUniformity(PRNU),和斑点校正ShadingCorrection.
●I/ODemo
路径:
\Sapera\Demos\Classes\Vc\IODemo\Release\IODemo.exe
功能:
显示一般I/O设备的使用,允许监视当前输入输出状态,改变高低极性状态;允许监视输入中断并记录中断数。
●GigE-VisionCameraDemo
路径:
\Sapera\Demos\Classes\Vc\GigeCameraDemo\Release\GigeCameraDemo.exe
功能:
怎样使用DALSAGigEVision™相机获得图像.可导入相机配置文件
3.ActiveX控件
Sapera\Demos\ActiveX\Vb6\SapActiveXDemos.vbg(forVisualBasic6.0)
Sapera\Demos\ActiveX\.NET\SapActiveXDemos_2003.sln(forVisualStudio.NET2003)
Sapera\Demos\ActiveX\.NET\SapActiveXDemos_2005.sln(forVisualStudio2005)
Sapera\Demos\ActiveX\Delphi\SapActiveXDemos.bpg(forBorlandDelphi7)
对ActiveX控件的使用操作详见SaperaLTActiveXControlsManual
常用操作编程步骤介绍
一、加载动态连接库步骤:
1.使用BasicClasses:
①在Project|Settings…|C/C++|Preprocessor|Additionalincludedirectories中加入路径C:
\DALSA\Sapera\Classes\Basic;
②在Project|AddtoProject|Files中加入C:
\DALSA\Sapera\Lib\SapClassBasic.lib和SapClassBasicD.lib;
③在Project|Settings…|General中将SapClassBasic.lib选为Excludefilefrombuild;
④在Project|Settings…|C/C++|CodeGeneration|Userun-timelibrary中选择choosetheoptionMultithreadedDLL(在release模式下)orDebugMultithreadedDLL(在debug模式下);
⑤在头文件中加入SapClassBasic.h。
2.使用GUI:
①在Project|Settings…|C/C++|Preprocessor|Additionalincludedirectories中加入路径C:
\DALSA\Sapera\Classes\Gui;
②在Project|AddtoProject|Files中加入C:
\DALSA\Sapera\Lib\SapClassGui.lib和SapClassGuiD.lib;
③在Project|Settings…|General中将SapClassBasic.lib选为ExcludefilefrombuildforWin32Release;
④在InProject|Settings…|C/C++|CodeGeneration|Userun-timelibrary中选择choosetheoptionMultithreadedDLL(在release模式下)orDebugMultithreadedDLL(在debug
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Sapera LT帮助文档 中文版 LT 帮助 文档
![提示](https://static.bdocx.com/images/bang_tan.gif)