C#笔记关于采集卡

周更！节日快乐！

1. 参数

1.1 CAM file

CAM file是文件扩展名为.cam的可读ASCII文件，包含了参数列表，比如：AcquisitionMode，TrigMode等。通过McSetParamStr方法将Camfile加载到通道：

McSetParamStr(MyChannelMyChannel, MC_CamFile , "VCC VCC-870A_P15RA");

1.2 channel

通道是摄像头、帧捕获器和主机PC内存之间的采集路径。通道由三部分组成：

1. 负责图像捕获的相机。
2. 帧捕获器负责图像的采集和传输。
3. 用于在主机PC中存储图像的内存缓冲区。

通道可以被设置为以下四种状态之一：

Name	Meaning
Orphan	没有与之关联的抓取器。因此不可能立即获取图像。但是通道存在，其所有参数都可以自由设置或获取。
Idle	当通道处于空闲状态时，它有一个与之关联的抓取器。因此，可以立即进行图像采集。在此状态下，MultiCam可能会自动将抓取器资源重新分配给另一个通道。
Ready	当通道处于就绪状态时，它有一个与之关联的抓取器。因此，可以立即进行图像采集。在此状态下，MultiCam无法自动将抓取器资源重新分配给另一个通道。
Active	当通道处于活动状态时，它有一个与其相关联的抓取器，并执行图像采集序列。在此状态下，MultiCam无法自动将抓取器资源重新分配给另一个通道。

代码示例：

1.3 surface

surface是一个缓冲区，用户应用程序可以在其中找到要分析的采集图像。内存缓冲区由称为surface的MultiCam对象表示。surface可以由Multicam自动创建，也可以由用户手动创建。抓取器通过DMA机制自动将采集的图像传输到目标surface。通道可以有一个或多个surface（默认为4）。根据surface的数量，定义了单缓冲和多缓冲。

Surface state	Meaning
FREE	自由表面能够无条件地从抓取器接收图像数据。
FILLING	目前正在从抓取器接收图像数据，或准备接收数据。一个cluster中应该都有一个FILLING状态的Surface。
FILLED	已完成从抓取器接收图像数据，已准备好进行处理。
PROCESSING	PROCESSING状态的Surface正在被处理器处理。
RESERVED	从标准状态转换机制中删除。

代码示例：

一组surface称为cluster，一个通道只能有一个cluster。cluster的状态有OFF，READY（在获取图像但没有surface处于PROCESSING），BUSY（有surface处于PROCESSING），UNAVAILABLE（不能获取图像）

Single Buffering

Dual Buffering

Triple Buffering

1.4 Multicam Signaling

信号是由通道生成的与用户应用程序交互的事件。

Frame Trigger Violation
Start Exposure	该信号在帧曝光条件开始时发出。
End Exposure	该信号在帧曝光条件结束时发出。
Surface Filled	当目标cluster的Surface 进入Filled状态时，会发出此信号。
Surface Processing	当目标cluster的Surface 进入Processing状态时，会发出此信号。
Cluster Unavailable
Acquisition failure (**)
Start of Acquisition Sequence
End of Acquisition Sequence
End of Channel Activity

有三种机制可以访问它们：

1. 涉及在出现预定义信号时自动调用的用户编写的函数。（callback）
2. 允许线程等待预定义信号出现的专用机制。
3. 涉及标准Windows等待函数的用户定义机制。

使用callback的步骤：

1. 默认情况下，禁用所有信号。SignalEnable参数用于设置它。

2. 注册回调函数

3. 在回调函数中，使用包含触发事件信息的PMCSIGNALINFO捕获事件。

示例：

1.5 Trigger

触发事件由TrigMode和NextTrigMode参数进行设置。

1.5.1 初始触发事件：

连续：将ChannelState设为Active后立即启动，NextTrigMode为REPEAT
硬触发
软触发：将ForceTrig参数设置为TRIG
结合触发

1.5.2 触发事件的结束

可以通过EndTrigMode结束采集阶段：
1）帧、页或行计数器到期时，采集序列自动终止。（AUTO）
2）当检测到硬件端触发线的有效转换时，采集序列终止（HARD）
或者通过BreakEffect参数直接终止channel的活动状态：

1）在slice/phase/sequence结束后再停止采集（FINISH）

2）立刻停止（ABORT）

1.6 Acquisition Mode

VIDEO模式用于从标准区域扫描摄像机记录多个视频序列。ActivityLength指定通道活动周期内的序列数。
SNAPSHOT模式用于从区域扫描相机获取快照图像。唯一序列能够在信道活动周期内获取SeqLength_Fr帧。
PAGE模式用于从线扫描相机获取离散对象的图像。每一页由连续的行组成；页面长度（以行表示）由PageLength\u Ln指定。单个序列能够在通道活动周期内获取SeqLength_Pg页面。

WEB模式用于从线扫描相机获取连续对象（如网络）的图像。在信道活动周期内，可使用单个序列获取连续行的SeqLength_。序列被划分为连续的相位，每个相位获取PageLength\u Ln行。如果SeqLength_Ln不是PageLength_Ln的倍数，则在最后阶段会部分填充surface。序列和第一采集阶段根据触发模式启动。后续采集阶段自动启动，无任何线路损耗。BreakEffect指定用户中断时的行为。

1.7 Exception

异常通过异常代码或Windows异常进行管理。ErrorHandling参数设置错误管理行为，有4个可能的值。

None 没有异常时为MC_OK或者0，有异常时函数会返回MCSTATUS类型的值。

MSGBOX 没有异常时为MC_OK或者0，有异常会显示对话框
Exception
MSGException

2. Demo

2.1 打开driver

// Open MultiCam driver

MC.OpenDriver();

2.2 创建channel

// Create a channel and associate it with the first connector on the first board

MC.Create("CHANNEL", out channel);

MC.SetParam(channel, "DriverIndex", 0);

2.3 相机参数设置

// Choose the CAM file

MC.SetParam(channel, "CamFile", "1000m_P50RG");

// Choose the camera expose duration

MC.SetParam(channel, "Expose_us", 20000);

// Choose the pixel color format

MC.SetParam(channel, "ColorFormat", "Y8");

2.4 触发模式更改

//Set the acquisition mode to Snapshot

MC.SetParam(channel, "AcquisitionMode", "SNAPSHOT");

// Choose the way the first acquisition is triggered

MC.SetParam(channel, "TrigMode", "COMBINED");

// Choose the triggering mode for subsequent acquisitions

MC.SetParam(channel, "NextTrigMode", "COMBINED");

2.5 事件触发

2.5.1 注册回调函数

// Register the callback function

 multiCamCallback = new MC.CALLBACK(MultiCamCallback);

MC.RegisterCallback(channel, multiCamCallback, channel);

2.5.2 开启信号

// Enable the signals corresponding to the callback functions

MC.SetParam(channel, MC.SignalEnable + MC.SIG_SURFACE_PROCESSING, "ON");

MC.SetParam(channel, MC.SignalEnable + MC.SIG_ACQUISITION_FAILURE, "ON");

2.5.3 判断接收到的信号

如果接收到的是MC.SIG_SURFACE_PROCESSING，调用ProcessingCallback获取图片的数据，将图片数据转换为bitmap。如果接收到的是MC.SIG_ACQUISITION_FAILURE，调用AcqFailureCallback输出"Acquisition Failure"。

private void MultiCamCallback(ref MC.SIGNALINFO signalInfo)

        {

            switch(signalInfo.Signal)

            {

                case MC.SIG_SURFACE_PROCESSING:

                    ProcessingCallback(signalInfo);

                    break;

                case MC.SIG_ACQUISITION_FAILURE:

                    AcqFailureCallback(signalInfo);

                    break;

                default:

                    throw new Euresys.MultiCamException("Unknown signal");

            }

        }

2.6 channel状态置为READY

// Prepare the channel in order to minimize the acquisition sequence startup latency

MC.SetParam(channel, "ChannelState", "READY");

3. 测试程序的编写

触发模式就用默认的连续触发。

将camfile的加载显示在界面上。

Demo界面只有Go和stop还有状态条，增加按钮打开/关闭相机和开始/停止采集。

曝光开始事件触发，帧开始count++；surface_processing事件触发，采图count++；获取失败事件触发，丢失帧count++。

代码绝对是运行不起来的，毕竟我是一个采集卡都没见过的人，纸上谈兵罢了哈哈哈