Adaptive Vision Library AVL 库结构和数据类型
方案 此 PPT 中我们将解释 : AVL 库结构 页眉 名字空间 数据类型 ATL 类型 AVL 类型
AVL 库结构
页眉 Adaptive Vision Library AVL.h STD.h Genicam.h ThirdPartySdk.h Adaptive Vision Library Lite( 精简版 ) AVL_Lite.h STD_Lite.h ThirdPartySdk_Lite.h 5
名字空间 atl ATL 表示 Adaptive Template Library( 自适应模板库 ) 适用于处理数组 字符串与可选值的几数据类型 非常相似于 C++ 标准模板库, 不过 提供与 Adaptive Vision Studio 数据类型的兼容性 avl 主要名字空间 包括所有图像分析算法 硬件界面等 avs 包含 C++ 代码生成器所需与对登录操作所需的函数 不建议直接使用 6
变换器 变换器将 AVL 库与其他常见数据库之间进行变换使得容易 为了访问入变换器, 请使用如下页眉之一 : AVL_Euresys.h AVL_MFC.h AVL_MvAcquire.h AVL_OpenCV.h AVL_Pylon.h AVL_QT.h AVL_SynView.h AVL_Winapi.h 文件位于 include/avlconverters 目录里 7
8 数据类型
ATL 数据类型 Array<T>/Array2D<T> String Optional<T>/Conditional<T> Dummy<T> Error 9
ATL atl::array<t> 严格符合 std::vector 它作为随机存取序列容器, 扩张时使用自动内存重新分配 与 std::vector 不同,Array 支持现实内存所有权, 也所有平台上具有固定内存代表 atl::array2d<t> 代表普通的二维数组 10
ATL atl::string 此类存储关于宽字符之动态分配序列的信息 为了提高二进制兼容性,Windows 和 Linux 系统上均使用同样的代表 (UTF-16) const wchar16*cstr16() 以 UTF-16 编码返回空终止的 String const char*cstr8() 以 UTF-8 编码返回空终止的 String 11
ATL atl::optional<t> 此类型提供代表可选函数输入 ( 要用和不要用的输入都带 ) 的一致方式 它带 atl::nil 特别值 ( 也称为 Auto ) 实例 : 大部分图像处理函数带 inroi 输入 用户要指定感兴趣区域的话, 应该传递 Region 对象 但用户要处理整体图像的话, 应该传递 atl::nil 12 avl::thresholdtoregion(outrgb, atl::nil, 100, atl::nil, 0, region); void ThresholdToRegion ( const avl::image& inimage, atl::optional<const avl::region&> inroi, atl::optional<float> inminvalue, atl::optional<float> inmaxvalue, float inhysteresis, avl::region& outregion );
ATL atl::conditional<t> 此类型允许代表无效或未知结果 atl::nil 特别值通常看为 未检测到 / 未找到 目标与多种旧式返回 -1 值或空值 C 函数的相同 atl::conditional<int> result; avl::parseinteger("test1", avl::numbersystembase::base_10, result); if (result!= atl::nil) // 结果有效的话 printf(" 有效整数 "); else printf(" 无效整数 "); 13
ATL Conditional 与 Optional AVL 中, 两类均有同样的意思 这些类型与 Adaptive Vision Studio 所生成编码兼容 Optional<T> 适用于函数输入 ( 可选的输入 ) Conditional<T> 适用于函数输出 ( 条件的输出 ) 14
ATL atl::dummy<t> 此类用于创建应该传递到未用函数输出的临时对象 ( 该输出不是最后一时, 此类才必须使用 ) avl::testimage(avl::testimageid::lena, outrgb, atl::dummy<avl::image>().get()); 方便 dummy() 宏也被定义 : avl::testimage(avl::testimageid::lena, outrgb, atl::dummy<avl::image>().get()); 15
ATL ATL 中的异常 atl::error 基准异常类 atl::domainerror 例如向函数提供无效参数的时候 atl::runtimeerror 例如内存不足的时候 atl::ioerror 例如发生沟通误差或缺乏文件的时候 atl::systemerror 例如缺乏相机驱动程序的时候 atl::licenseerror 例如缺乏许可证的时候 atl::assertionerror 由 Assert 函数出现 16
AVL 数据类型 Image Region 17
AVL Image avl::image 数据类型存储关于尺寸 像素格式与原始像素值的信息 1 到 4 通道 (X Y Z W) 都可有 支持下面的像素类型 : sint8 uint8 sint16 uint16 sint16 real uint8=unsignedinteger( 无符号整数 ), 每像素 8 位 18
AVL Image 图像的像素数据储存于连续内存缓冲器 最初进入缓冲器的是左上角像素 第 K 行地址等于 k pitch, 其中 pitch 标为连续行之间的位元组距离 由于行填充, 可能区别于 pixel_size width 最大尺寸为 65535 x 65535 像素 填充 X Y Z X Y Z P P P 19 图像行为宽度 x 3 + 填充
AVL Image 图像参数 int Width() int Height() int Pitch() PlainType Type() int Depth() 图像宽度 图像高度 返回连续行之间的位元组距离 返回像素组成部分的类型 返回通道数 20
AVL Image void* Data () 对图像数据缓冲器返回指针 T* RowBegin<T>(int i) 对图像行里第一元素返回指针 T* RowEnd<T>(int i) 对图像行里最后元素之后第一的那一返回指针 T* Ptr<T>(int x, int y) 对位于指定坐标的元素返回指针 T& Value<T>(int i) 许可访问位于指定坐标的像素值 for (int y = 0; y < image.height(); ++y) { atl::uint8* ptr = image.rowbegin<atl::uint8> (y); const atl::uint8* end = image.rowend<atl::uint8> (y); 21 } while (ptr!= end) { *ptr = 255; ptr++; }
AVL Region 区域是二进制图像的被优化代表 由其 FrameWidth FrameHeight 以及行程长度编码的像素序列,PointRun(x y length), 定义 22
AVL Region 区域用于找出对应于图像里一些对象或地区的像素集 评注 : 区域里连接组成部分称为斑点 最大区域框架尺寸为 65535 x 65535 可以以阈值函数将图像手动转换为区域 大部分图像处理操作具有可选 inroi 输入, 标为 Region 23
AVL Region 要求 区域的被压缩代表是游程编码的序列 必须以 Y 和 X 坐标 ( 按此顺序 ) 来排序游程编码 必须确保不相重叠 不应该超过区域框架的尺寸 : [0..FrameWidth-1, 0..FrameHeight-1] 不允许创建可融合为单一游程变慢的游程变慢 24 class PointRun { public: atl::uint16 x, y; atl::uint16 length;
25 AVL Region
AVL 数据类型 Point2D X Y Box X Y Width Height Rectangle2D Origin Angle Width Height Segment2D Point1 Point2 Line2D Ax + By + C = 0 Circle2D Center Radius Arc2D Center Radius StartAngle SweepAngle Vector2D DeltaX DeltaY 26
AVL Point2D Point2D 代表笛卡尔系统中二维点 如果需要基于整数的代替, 应该使用 Location 27
AVL Path 代表 Point2D 类型二维点的开或闭顺序 28
AVL Histogram 直方图基本上是整数数组, 但它因为包含一些有用方法和元信息, 所以作为对储存关于数值次数 ( 例如图像像素值的次数 ) 的信息非常好用的数据结构 29
AVL Profile 剖面表示单一变量之连续实际函数的离散逼近 用法的例子为图像截面的分析 (1D 测量 ) 带 X 与 Y 偏移浮点值的序列 剖面还包含为实际单位使用的 xoffset 与 xscale 实际 X = xscale * i + xoffset 其中的 i 表示剖面元素的索引 30
AVL 数据类型 Surface Point3DGrid Point3D Box3D Sphere3D Segment3D Circle3D Line3D Plane3D 等 以高度图来代表的点云 以三维点之二维数组来代表的点云 X Y Z X Y Z XLength Ylength ZLength Center Radius Point1 Point2 31
AVL 数据类型 Surface 以高度图来代表的三维点云,Z 坐标的网格 它具有等距的 X 与 Y 坐标 不同点的 X 与 Y 坐标值创建等差数列 支持下面的点类型 :sint8 uint8 sint16 uint16 sint16 real 为了降低内存使用率, 用户可以变化点格式 32
AVL 数据类型 Point3DGrid 以三维点二维数组来代表的三维点云 点值不必按任何顺序而排序 仅仅可以执行 float 点类型 大部分应用程序中, 不建议直接使用此类型 为了达到最高性能, 请以 ArrangePoint3DArray 函数将 Point3DGrid 转换为 Surface 33
谢谢! Adaptive Vision Sp. z o.o. Bojkowska 35A, 44-100 Gliwice, POLAND 电话 : +48 32 461 2330 www.adaptive-vision.com 34 Centrum Edukacji i Biznesu Nowe Gliwice ul. Bojkowska 35A, Gliwice