Sapera帮助文档
简介：Sapera LT 是一套用于图像采集、显示和控制的独立于硬件以外的 C 和 C++ 软件
库，支持所有 DALSA Coreco 硬件平台。它的综合功能集包括程序可移植性、多样化的相机控制、灵活的显示和管理功能，以及易于使用的应用开发向导。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类（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::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
? SapBufferWithTrash Class
功能：建立称为trash buffer的附加资源。常用于实时图像处理操作中，当数据传送速
度比处理速度快时，图象将被保存在trash buffer中，直到能够稳定输出 常用函数：SapBufferWithTrash::SapBufferWithTrash 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
功能：操作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
功能：识别Sapera server/resource对（物理设备的抽象表示） 常用函数：SapLocation::GetResourceIndex SapLocation::GetServerName
? SapLut
功能：管理lookup table（首先使用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
? Specialized Transfer Classes
功能：特别转换类（一系列从属于SapTransfer的类，使用户方便操作许多常用的转移
节点）
常用转换类：SapAcqToBuf Class
SapAcqDeviceToBuf Class SapCabToBuf Class SapBufToBuf Class SapAcqToCab Class SapCabToCab Class SapBufToCab Class
? 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
功能：描述了SapTransfer class的一对源与目的地
常用函数：SapXferPair::GetFramesPerCallback, SapXferPair::SetFramesPerCallback
? SapXferParams
功能：存储SapTransfer类需传递的参数信息
? SapXferNode
功能：操作转换节点