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 ClassSapDataHSI ClassSapDataHSV ClassSapDataFloat ClassSapDataFPoint ClassSapDataFRGB ClassSapDataMono ClassSapDataPoint ClassSapDataRGB ClassSapDataRGBA ClassSapDataYUV Class●SapAcquisition功能：控制与板卡相连接的采集设备常用函数：SapAcquisition::SapAcquisitionSapAcquisition::CreateSapAcquisition::DestroySapAcquisition::ApplyLutSapAcquisition::GetParameter,SapAcquisition::SetParameterSapAcquisition::GetSignalStatusSapAcquisition::IsSignalStatusAvailable●SapAcqCallbackInfo功能：存储SapAcquisition类回调的内容常用函数：SapAcqCallbackInfo::GetContextSapAcqCallbackInfo::GetSignalStatus●SapAcqDevice功能：由设备读、写信息，还可直接发送、寄存事件至设备。

常用于直接连接电脑的相机（如GigE相机）常用函数：SapAcqDevice::SapAcqDeviceSapAcqDevice::CreateSapAcqDevice::DestroySapAcqDevice::GetConfigFile, SapAcqDevice::SetConfigFileSapAcqDevice::UpdateFeaturesFromDevice●SapAcqDeviceCallbackInfo功能：存储SapAcqDevice类回调的内容常用函数：SapAcqDeviceCallbackInfo::SapAcqDeviceCallbackInfoSapAcqDeviceCallbackInfo::GetAcqDevice●SapBayer功能：Bayer转换操作（分为软件和硬件实现两种）常用函数：SapBayer::WhiteBalanceSapBayer::EnableLutSapBayer::GetAlign, SapBayer::SetAlignSapBayer::GetWBGain, SapBayer::SetWBGain●SapBuffer功能：操作buffer资源常用函数：SapBuffer::SapBufferSapBuffer::CreateSapBuffer::ClearSapBuffer::DestroySapBuffer::GetParameter, SapBuffer::SetParameterSapBuffer::GetPitchSapBuffer::GetPixelDepth, SapBuffer::SetPixelDepthSapBuffer::GetIndex, SapBuffer::SetIndexSapBuffer::GetCount, SapBuffer::SetCountSapBuffer::GetFrameRate, SapBuffer::SetFrameRateSapBuffer::Next●SapBufferRemote功能：Buffer远程使用（需用SapBuffer::Register事先定义）常用函数：SapBufferRemote::SapBufferRemoteSapBufferRemote::Create●SapBufferRoi功能：在已存在的SapBuffer对象中创建方形ROI区域常用函数：SapBufferRoi::SapBufferRoiSapBufferRoi::Create●SapBufferWithTrash Class功能：建立称为trash buffer的附加资源。

常用于实时图像处理操作中，当数据传送速度比处理速度快时，图象将被保存在trash buffer中，直到能够稳定输出常用函数：SapBufferWithTrash::SapBufferWithTrashSapBufferWithTrash::Create●SapCab功能：操作CAB资源的功能，更详细帮助见Sapera CAB Programmer’s Manual.●SapCounter功能：记录事件，可记录外部信号或内部信号（如硬件时钟）常用函数：SapCounter::SapCounter●SapCounterCallbackInfo功能：存储SapCounter类回调的内容常用函数：SapCounterCallbackInfo::SapCounterCallbackInfoSapCounterCallbackInfo::GetCounter●SapDisplay功能：操作默认显示资源常用函数：SapDisplay::CreateSapDisplay::GetDCSapDisplay::GetWidth●SapDsp功能：操作DSP资源●SapFeature功能：得到SapAcqDevice类的特征信息，如姓名、类型、连接模式等使用SapAcqDevice::GetFeatureInfo访问常用函数：SapFeature::GetLocation, SapFeature::SetLocation●SapFlatField功能：单色图像平场校正功能常用函数：SapFlatField::ComputeGainSapFlatField::ComputeOffset●SapGio功能：控制输入和输出设备使之读写同步，常与SapCounter联合使用读取I/O设备的状态常用函数：SapGio::AutoTriggerSapGio::EnableCallback●SapGioCallbackInfo功能：存储SapGio类回调的内容常用函数：SapGioCallbackInfo::GetPinNumber●SapGraphic功能：在图像中绘制或书写文字（首先通过SapView::GetDC获得句柄）常用函数：SapGraphic::Text●SapLocation功能：识别Sapera server/resource对（物理设备的抽象表示）常用函数：SapLocation::GetResourceIndexSapLocation::GetServerName●SapLut功能：管理lookup table（首先使用SapAcquisition::GetLut 获得SapLut对象，操作完成LUT后使用SapAcquisition::ApplyLut记录）常用函数：SapLut::ArithmeticSapLut::BinaryPatternSapLut::Threshold●SapManager功能：描述当前系统上的Sapera资源，同时包括错误管理功能常用函数：SapManager::GetCommandTimeout, SapManager::SetCommandTimeout●SapManCallbackInfo功能：存储SapManager类回调的内容常用函数：SapManCallbackInfo::GetErrorMessage●SapPerformance功能：基准评估功能，评估一个buffer所占用的时间常用功能：SapPerformance::GetTimeMicroSapPerformance::Reset●SapPixPro功能：操作像素处理设备，作为中间转换节点，允许数据由采集设备传递到下一个转换节点●SapPixProParams功能：存储SapPixPro类回调的内容●SapProcessing功能：用于管理用户自己的processing●SapProCallbackInfo功能：存储SapManager类回调的内容●SapTransfer功能：管理转移过程常用函数：SapTransfer::CreateSapTransfer::FreezeSapTransfer::GrabSapTransfer::SnapSapTransfer::WaitSapTransfer::AbortSapTransfer::IsGrabbingSapTransfer::GetPair●Specialized Transfer Classes功能：特别转换类（一系列从属于SapTransfer的类，使用户方便操作许多常用的转移节点）常用转换类：SapAcqToBuf ClassSapAcqDeviceToBuf ClassSapCabToBuf ClassSapBufToBuf ClassSapAcqToCab ClassSapCabToCab ClassSapBufToCab Class●SapView功能：通过SapDisplay对象显示存放在SapBuffer中的资源，SapView和SapTransfer 的同步性使得能够实时显示buffer中的数据而不会出现丢失数据的情况。

常用函数：SapView::SapViewSapView::ShowSapView::CreateSapView::DestroySapView::GetDCSapView::GetDisplay, SapView::SetDisplaySapView::OnHScrollSapView::OnMoveSapView::OnPaint●SapViewCallbackInfo功能：存储SapView类回调的内容●SapXferCallbackInfo功能：存储SapTransfer类回调的内容（一帧图像转移完成后自动调用XferCallback）常用函数：SapXferCallbackInfo::GetContextSapXferCallbackInfo::IsTrash●SapXferPair功能：描述了SapTransfer class的一对源与目的地常用函数：SapXferPair::GetFramesPerCallback, SapXferPair::SetFramesPerCallback●SapXferParams功能：存储SapTransfer类需传递的参数信息●SapXferNode功能：操作转换节点2.GUI类：提供了许多常用设置对话框，用户可根据自己的需要选用；其结构如下图所示。