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++。
代码绝对是运行不起来的,毕竟我是一个采集卡都没见过的人,纸上谈兵罢了哈哈哈
标签:触发,MC,C#,抓取,surface,笔记,图像,采集卡,channel 来源: https://www.cnblogs.com/Fish0403/p/15451010.html