系列文章目录
GenICam标准（一）—— 概述
GenIcam标准（二）—— GenApi 模块 – 配置相机
文章目录
- 系列文章目录
- 1、简介
- 2、照相机描述文件的基本结构
- 3、 节点、接口和抽象特征
- 参考
1、简介
GenApi 模块解决如何去配置相机的问题。主要的思路是，让相机生产厂商为他们的相机提供机器可以识别的产品说明。这些相机描述文件（camera description files）包含所有需要的信息，用以自动地把相机的属性（features）和其寄存器（registers）相对应。
相机的 Gain 属性是一个典型的例子，假设用户想令 Gain=42 ，利用 GenICam ，通用的软件可以读相机的描述文件并发现，要把 Gain 属性设成 42 意味着向地址为 0x0815 的寄存器写入值 0x2A 。其他要做的工作可能是检查相机是否提供 Gain 属性，并检查要写入的值是否在 Gain 的允许范围内。
请注意，给相机添加新的属性仅仅意味着扩展相机的描述文件，就可以对所有符合 GenICam 标准的程序立即生效。
图 2 显示了配置照相机所涉及的图层。
请注意，本文档中的 GenApi 部分只处理照相机描述文件。它旨在帮助 GenICam 用户理解 GenApi 模块背后的关键思想，并使人们能够编写他们自己的相机描述文件。GenApi 参考实现附带了一个参考手册，展示了最终用户如何使用 GenApi 模块，即使不深入了解本节中介绍的概念。
2、照相机描述文件的基本结构
该摄像机是通过在一个包含一组节点的 XML 文件上进行描述的，每个节点都有一个类型和一个唯一的名称。节点可以相互链接，每个连接都起着一定的作用。图 3 显示了一个非常简单的图形符号示例。节点显示为标记为 “type::name” 的气泡标签，链接显示为标记为角色名称的箭头。
有两个特殊的节点：
- 根节点，可以遍历节点图
- 设备节点，提供到传输层连接。
图 3 由一个简单的配置文件构造而成的图的拓扑结构
图 3 中的增益节点（Gain）为 IntReg 类型，它允许从寄存器中提取一个整数。从根节点上看，这是照相机的一个特性。因此，根节点包含一个名为 pFeature 的链接，它引用了增益节点（Gain）。要读取和写入增益寄存器，增益节点需要访问照相机端口，因此它包含一个到设备节点的链接。该链接被命名为 pPort ，并引用了设备节点。
增益节点（Gain）包含在大端模式下提取两个字节无符号整数所需的所有信息。完整的相机描述文件如下：
<?xml version="1.0" encoding="utf-8"?>
<RegisterDescription
ModelName="Example01"
VendorName="Test"
ToolTip="Example 01 from the GenApi standard"
StandardNameSpace="None"
SchemaMajorVersion="1"
SchemaMinorVersion="1"
SchemaSubMinorVersion="0"
MajorVersion="1"
MinorVersion="0"
SubMinorVersion="0"
ProductGuid="1F3C6A72-7842-4edd-9130-E2E90A2058BA"
VersionGuid="7645D2A1-A41E-4ac6-B486-1531FB7BECE6"
xmlns="http://www.genicam.org/GenApi/Version_1_1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.genicam.org/GenApi/Version_1_1
http://www.genicam.org/GenApi/GenApiSchema_Version_1_1.xsd">
<Category Name="Root">
<ToolTip>Entry for traversing the node graph</ToolTip>
<pFeature>Gain</pFeature>
</Category>
<IntReg Name="Gain">
<ToolTip>Access node for the camera's Gain feature</ToolTip>
<Address>0x0815</Address>
<Length>2</Length>
<AccessMode>RW</AccessMode>
<pPort>Device</pPort>
<Sign>Unsigned</Sign>
<Endianess>BigEndian</Endianess>
</IntReg>
<Port Name="Device">
<ToolTip> Port node giving access to the camera</ToolTip>
</Port>
</RegisterDescription>
<?xml> 节点是一个处理元素，提供有关文件编码的提示，并且总是这样的。
<RegisterDescription> 元素是封装摄像机所有节点的最外层括号。相机由模型名称（ModelName）和 VenderName 属性标识标识。
每个节点都有一个可选的 <ToolTip> 元素，其中包含一个简短的描述。增益节点（Gain）有一些依赖于其 IntReg 类型的附加元素，并告诉我们，例如，寄存器的地址或它的长度。其默认值为空字符串。
通常，一个实现将为每个节点创建一个软件对象，并根据 XML 文件中描述的逻辑链接将这些对象链接在一起。这些节点既可以通过它们的（唯一的）名称来检索，也可以通过从根节点开始遍历节点图来找到。一旦用户有了一个指向节点的指针，他就可以通过节点对象的编程接口访问该特性。
XML 文件的语法是在由模式位置属性给出的 XML 模式中定义的。该模式是该标准的一部分。本文解释了 GenICam 的思想和总体结构。模式及其嵌入的参考文档描述了正式的细节。如果有疑问，模式的内容将覆盖此文本的内容。
文件位置 http://www.genicam.org/GenApi/GenApiSchema_Version_1_1.xsd 对于相机配置文件是必需的，但可以在运行时被重写。
3、 节点、接口和抽象特征
参考
GenIcam标准（一）
GenIcam标准（二）
GenIcam标准（三）
GenIcam标准（四）
GenIcam标准（五）
GenIcam标准（六）
GenIcam标准介绍
GenIcam标准（一）
GenIcam标准（二）
GenIcam标准（三）
GenIcam标准（四）
GenIcam标准（五）
GenIcam标准（六）
☆
