-
Sapera
帮助文档
简介:
Sapera
LT
是一套用于图像采集、显示和控制的独立于硬件以外的
C
和
C++
软件
库,支持所有
DALSA
Coreco
硬件平台。它的综合功能集包括程序可移植性、
多样
化的相机控制、
灵活的显示和管理功能,
< br>以及易于使用的应用开发向导。
Sapera LT
与
Microsoft
Visual Studio C/C++
、
.Net
、
Visual Basic 6.0
和
Borland C++
Builder
兼容,
支持
Windows XP
、
2000
和
NT
平台。
一
.
Sapera++
介绍
Sapera++
是
Sapera
LT
为用户提供的
API.
Sapera++
包含两大类:基础应用类(
Basic
Classes
)和
GUI
类(
p>
GUI
Classes
)
。
1.
基础应用类:
提供了用户进行图像开
发的基本函数,
命名方式为
Sap
+类
功能名,
其结构如下图所示:
Sapera Basic Class
函数功能介绍:
?
Data
Classes
:
功能:下属多个数据类,每一个数据类管理了一种特定数据类型
下属数据类:
SapData Class
SapDataHSI Class
SapDataHSV Class
SapDataFloat Class
SapDataFPoint Class
SapDataFRGB Class
SapDataMono Class
SapDataPoint Class
SapDataRGB Class
SapDataRGBA Class
SapDataYUV Class
?
SapAcquisition
功能:控制与板卡相连接的采集设备
常用函数:
SapAcquisition::SapAcquisition
SapAcquisition::Create
SapAcquisition::Destroy
SapAcquisition::ApplyLut
SapAcquisition::GetParameter,
SapAcquisition::SetParameter
SapAcquisition::GetSignalStatus
SapAcquisition::IsSignalStatusAvailable
?
SapAcqCallbackInfo
功能:存储
SapAcquisition
类回调的内容
常用函数:
SapAcqCallbackInfo::Get
Context
SapAcqCallbackInfo::GetSignalStatus
?
SapAcqDevice
功能:由设备读、写信息,还可直
接发送、寄存事件至设备。常用于直接连接电脑的相
机(如
Gi
gE
相机)
常用函数:
SapAcqDevice::SapAcqDevice
SapAcqDevice::Create
SapAcqDevice::Destroy
SapAcqDevice::GetConfigFile,
SapAcqDevice::SetConfigFile
SapAcqDevice::UpdateFeaturesFromDevice
?
SapAcqDeviceCallbackInfo
功能:
存储
SapAcqDevice
类回调的内容
< br>
常用函数:
SapAcqDeviceCallbac
kInfo::SapAcqDeviceCallbackInfo
SapAcqDeviceCallbackInfo::GetAcqDevice
?
SapBayer
功能:
Bayer
转换操作(分为软件和硬件实现两
种)
常用函数:
SapBayer::WhiteBalance
SapBayer::EnableLut
SapBayer::GetAlign, SapBayer::SetAlign
SapBayer::GetWBGain,
SapBayer::SetWBGain
?
SapBuffer
功能:操作
bu
ffer
资源
常用函数:
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::Re
gister
事先定义)
常用函数:
SapBufferRemote::SapBufferRemote
SapBufferRemote::Create
?
SapBufferRoi
p>
功能:在已存在的
SapBuffer
对象
中创建方形
ROI
区域
常用函数:
SapBufferRoi::SapBufferRoi
SapBufferRoi::Create
?
SapBufferWithTrash Class
功能:建立称为
trash
buff
er
的附加资源。常用于实时图像处理操作中,当数据传送速
度
比处理速度快时,图象将被保存在
trash
buffer
中,直到能够稳定输出
常用函数:
SapBufferWithTrash::SapBufferWithT
rash
SapBufferWithTrash::Create
功能:操作
CAB
资源的功能,更详细
帮助见
Sapera CAB Programmer’
s
Manual
.
?
SapCab
?
SapCounter
功能:记录事件,可记录外部信号或内部信号(如硬件时钟)
常用函数:
SapCounter::SapCounter
?
SapCounterCallbackInfo
功能:存储
SapCounter
类回调的内容
常用函数:
SapCounterCallbackInfo:
:SapCounterCallbackInfo
SapCounterCallbackInfo::GetCounter
?
SapDisplay
功能:操作默认显示资源
常用函数:
SapDisplay::Create
SapDisplay::GetDC
SapDisplay::GetWidth
?
SapDsp
< br>功能:操作
DSP
资源
?
SapFeature
功能:得到
SapAcqDevice
类的特征
信息,如姓名、类型、连接模式等
使用
SapAcqDevice::GetFeatureInfo
访问
< br>
常用函数:
SapFeature::GetLoca
tion, SapFeature::SetLocation
?
SapFlatField
功能:单色图像平场校正功能
常用函
数:
SapFlatField::ComputeGain
SapFlatField::ComputeOffset
?
SapGio
< br>功能:控制输入和输出设备使之读写同步,常与
SapCounter
联合使用读取
I/O
设备的
状态
常用函数:
SapGio::AutoTrigger
SapGio::EnableCallback
?
SapGioCallbackInfo
功能:存储
SapGio
类回调的内容
< br>常用函数:
SapGioCallbackInfo::GetPinNumbe
r
?
SapGraphic
p>
功能:在图像中绘制或书写文字(首先通过
SapView::Ge
tDC
获得句柄)
常用函数:
SapGraphic::Text
?
SapLocation
功能:识别
Sapera
server/resource
对(物理设备的抽象表示)
常用函数:
SapLocation::GetResourc
eIndex
SapLocation::GetServerName
?
SapLut
功能:
管理
lookup table
(首先使用
SapAcquisition::GetLut
获得
SapLut
对象,
操作完成
LUT
后使用
<
/p>
SapAcquisition::ApplyLut
记录)
p>
常用函数:
SapLut::Arithmetic
SapLut::BinaryPattern
SapLut::Threshold
?
SapManager
功能:描述当
前系统上的
Sapera
资源,同时包括错误管理功能
常用函数:
SapManager::Get
CommandTimeout, SapManager::SetCommandTimeout
?
SapManCallbackInfo
功能:存储
SapManager
类回调的内容
常用函数:
SapManCallbackInfo::GetErro
rMessage
?
SapPerformance
功能:基准评估功能,评估一
个
buffer
所占用的时间
常用功能:
SapPerformance::GetTimeMic
ro
SapPerformance::Reset
?
SapPixPro
功能:
操作像素处理设备,
作为中间转换节点,<
/p>
允许数据由采集设备传递到下一个转换
节点
?
SapPixProParams
功能:存储
SapPixPro
类回调的内容
?
SapProcessing
功能:用于管理用户自己的
processing
?
SapProCallbackInfo
功能:存储
SapManager
类回调的内容
?
SapTransfer
功能:管理转移过程
常用函数:
SapTransfer::Create
SapTransfer::Freeze
SapTransfer::Grab
SapTransfer::Snap
SapTransfer::Wait
SapTransfer::Abort
SapTransfer::IsGrabbing
SapTransfer::GetPair
?
Specialized
Transfer Classes
功能:特别转换类(一系列从属于
SapTransfer
的类,使用户方便操作许多常用的转移
节点)
常用转换类:
SapAcqToBuf Class
SapAcqDeviceToBuf Class
SapCabToBuf Class
SapBufToBuf Class
SapAcqToCab Class
SapCabToCab Class
SapBufToCab Class
?
SapView
功能:通过
SapD
isplay
对象显示存放在
SapBuffer
中的资源,
SapView
和
SapTransfer
的同步性使得能够实时显示
buff
er
中的数据而不会出现丢失数据的情况。
常用函数:
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::GetCo
ntext
SapXferCallbackInfo::IsTrash
?
SapXferPair
功能:描述了
SapTransfer
class
的一对源与目的地
常用函
数:
SapXferPair::GetFramesPerCallback,
SapXferPair::SetFramesPerCallback
?
SapXferParams <
/p>
功能:存储
SapTransfer
类需
传递的参数信息
?
SapXferNode
功能:操作转换节点
2.
GUI
类:
提供了许多常用设置对话框,用户可根据自己的需要选用;其结构如下图所示。
Sapera
GUI
介绍
名
称
CAbortDlg
CAcqConfigDlg
CAcqDlg
CAScanDlg
CBayerOptionsDlg
CBufDlg
CCabDlg
CCompDlg
CDspDlg
CFlatFieldDlg
CGioInputDlg
CImageWnd
CLoadSaveDlg
CLScanDlg
CPixProDlg
CViewDlg
功
能
是
SapTransfer::Wait
功能的改进,允许中断后等待不确定的时间
< br>导入相机配置文件
(CCF)
,建立新的
SapAcquisition
对象,可调用
CAcqConfigDlg::
GetAcquisition
得到此文件
动态修改采集设备参数
动态修改面阵相机参数
Bayer
转换参数选择对话框
p>
改变
SapBuffer
对象的参数
动态修改
CAB
参
数
动态修改合成视频输入信号参数
选择文件导入
DSP
内存
操作平场校正
获得
p>
/
设置输出设备信息
操作图像显示窗口、滚动条、
ROI
区域等
保存
/
导入图像至
SapBuffer
对象
动态修改线阵相机参数
修改
SapPixPro
对象的参数
动态修改显示区域
-
-
-
-
-
-
-
-
-
上一篇:The_Story_of_an_Hour赏析
下一篇:premiere中英文对照