【DALSA Coreco - Sapera LT】开发步骤

Sapera初级开发步骤

一． Sapera++介绍

       Sapera++是Sapera LT为用户提供的API. Sapera++ 包含两大类：基础应用类（Basic Classes）和GUI类（GUI Classes）

1. 基础应用类：

       提供了用户进行图像开发的基本函数

       命名方式为Sap＋类功能名

       其结构如下图所示：

 

常用类： 

　　SapAcquisition：控制与板卡相连接的设备

　　SapBuffer：操作buffer

       SapBufferWith Trash：实时处理时建立trash buffer用于存放转换数据（常用于处理速度跟不上数据采集速度时）

　　SapTransfer：管理一般的传递过程

　　SapView：显示buffer中存储的内容至屏幕

　　

2. GUI类：

提供了许多常用设置对话框

用户可根据自己的需要选用；其结构如下图所示

　　常用对话框：

       CAbortDlg：等待对话框

　　CAcqConfigDlg：相机配置文件导入对话框

　　CAcqDlg：动态修改相机设置

　　CBufDlg：Buffer设置对话框

　　CLoadSaveDlg：导入与保存对话框

二． 开发步骤

1． 加载动态连接库步骤：

（1）使用Basic Classes：

　　① 在Project | Settings... | C/C++ | Preprocessor | Additional includedirectories 中加入路径C:\DALSA\Sapera\Classes\Basic；

　　②在Project|Addto Project | Files 中加入C:\DALSA\Sapera\Lib\SapClassBasic.lib 和 SapClassBasicD.lib；

　　③在 Project |Settings...| General中将SapClassBasic.lib 选为Exclude file from build； 

　　④在Project |Settings... | C/C++ | Code Generation | Use run-time library中选择choose the option MultithreadedDLL (在release模式下) or Debug Multithreaded DLL (在debug模式下) ；

　　⑤在头文件中加入SapClassBasic.h

　　

（2）使用GUI： 

　　① 在Project | Settings... | C/C++ | Preprocessor | Additional includedirectories 中加入路径C:\DALSA\Sapera\Classes\Gui；

　　②在Project|Addto Project | Files 中加入C:\DALSA\Sapera\Lib\SapClassGui.lib 和 SapClassGuiD.lib；

　　③在 Project |Settings...| General中将SapClassBasic.lib 选为Exclude file from build for Win32 Release； 

　　④ 在In Project | Settings... | C/C++ | Code Generation | Use run-timelibrary中选择choose theoption Multithreaded DLL (在release模式下) or Debug Multithreaded DLL (在debug模式下) ；

　　⑤在头文件中加入SapClassGui.h

2． 初始化与采集操作步骤：

   ①使用SapAcquisitionclass定义所需器件和相机配置文件；

   ②使用SapBufferclass（或SapBufferWithTrashClass）创建buffer来存储图像；

   ③使用SapViewclass分配显示区显示图像；

   ④使用SapTransferclass（或SpecializedTransfer Classes）进行采集；

   ⑤采集完成后释放所有资源

参考C:\DALSA\Sapera\Help\User'sManual-Acquiring Images 与Demo"GrabDemo"

3． 对buffer的操作

（1） 修改buffer大小：

参考C:\DALSA\Sapera\Help\User'sManual-Working with buffers- Reading and Writing a Buffer

（2） 子buffer的应用：

参考C:\DALSA\Sapera\Help\User'sManual- Working with buffers- Root and Child Buffers

（3） 获得buffer首地址及偏移量（常用于进行进一步图像处理）：

参考C:\DALSA\Sapera\Help\User'sManual-Working with buffers- Reading and Writing a Buffer

三． 使用帮助文档与demo

　　如须获得完整的demo与帮助文档

选择full安装

并选择全部

　　帮助文档中的SaperaLT User's Manual提供Sapera LT的全面概要介绍；Sapera++ Programmer's Manual提供Sapera++ Basic 和 GUI classes中所有函数及功能介绍

可参考其进行编程工作

　　在C:\DALSA\Sapera\Demos\Classes\VC中提供了多个开发Demo供用户参考

* Grab Demo (Dialog Box Interface 对话框)

路径：\Sapera\Demos\Classes\Vc\GrabDemo\Release\GrabDemo.exe

功能：显示了基本的采集功能

允许获得连续或单帧图像

同时调整采集参数

* Grab Demo (Single Document Interface 单文档)

路径：\Sapera\Demos\Classes\Vc\GrabDemoSDI\Release\GrabDemoSDI.exe

功能：显示了基本的采集功能

允许获得连续或单帧图像

同时调整采集参数

* Grab Demo (Multiple Document Interface 多文档)

路径：\Sapera\Demos\Classes\Vc\GrabDemoMDI\Release\GrabDemoMDI.exe

功能：显示了基本的采集功能

允许获得连续或单帧图像

同时调整采集参数；

　　　可打开多窗口来同步获得不同相机的显示图像

* Sequential Grab Demo

路径：\Sapera\Demos\Classes\Vc\SeqGrabDemo\Release\SeqGrabDemo.exe

功能：采集序列图像至内存而后显示

程序允许录制多段视频

并可存储、导入AVI文件

每一图像存储于不同buffer中

可通过对话框设置buffer大小等参数

* Bayer Demo

路径：\Sapera\Demos\Classes\Vc\BayerDemo\Release\BayerDemo.exe

功能：显示Bayer 转换功能

进行Bayer转换参数设置

* Flat-field Demo

路径：\Sapera\Demos\Classes\Vc\FlatFieldDemo\Release\FlatFieldDemo.exe

功能：显示平场校正功能

平场校正Flat FieldCorrection (FFC) 包括调整模式噪声FixedPattern Noise (FPN),像素置换 Pixel Replacement, Photo Response Non Uniformity (PRNU), 和斑点校正 Shading Correction. 

* I/O Demo

路径：\Sapera\Demos\Classes\Vc\IODemo\Release\IODemo.exe

功能：显示一般I/O设备的使用

允许监视当前输入输出状态

改变高低极性状态；允许监视输入中断并记录中断数

* GigE-Vision Camera Demo

路径：\Sapera\Demos\Classes\Vc\GigeCameraDemo\Release\GigeCameraDemo.exe

功能：怎样使用DALSAGigE Vision(tm) 相机获得图像. 可导入相机配置文件