大恒工业相机｜软触发保姆级使用教程（全系通用、图文流程）

前言

很多新手在使用大恒工业相机时，默认都是连续采集模式，相机一直不间断出图。但在实际项目中，我们经常需要手动控制拍照、按需采集单张图像，这个时候就需要用到软触发。

本文适用于大恒全系工业相机：水星、火星、金星等系列，所有相机软触发逻辑完全一致，无需区分型号。包含：官方软件设置、参数解释、常见报错、SDK代码实现。

一、什么是软触发？

软触发：通过软件指令（手动点击/代码指令）让相机拍摄一张图片，不需要外接信号线、不需要PLC信号。

适用场景：

• 实验室调试、静态样品拍照
• 不需要流水线、无外部传感器的场景
• 手动保存标准图、对比图
• 客户端软件 “抓拍”“截图” 功能开发
• 单帧算法测试、图像预处理验证

软触发 VS 连续采集区别

二、官方软件（GalaxyView）软触发设置步骤

下面步骤全系相机通用，操作一模一样。

1、打开相机、进入参数界面

打开大恒官方软件 GalaxyView，连接相机，打开右边【属性列表】界面。

2、修改触发模式

找到相机参数：Trigger Mode→设置为On。

（Off = 连续采集，On = 触发模式）。

3、触发源选择：软件触发

Trigger Source→选择 Software。

这一步是软触发的核心，不要选错成Line0/Line2（那是硬件外触发）。

4、手动触发拍照

开启触发后，画面会静止，此时点击软件内的【TriggerSoftware】按钮，每点击一次，相机拍摄一张图片,帧数增加1。

现象：开启触发后画面静止，属于正常，必须触发才出图。

5.软触发使用特性

相机切换到软触发模式后，相机会等待用户发送软触发命令，然后软触发命令来后开始采集图像。一般来说，相机输出的帧率会和软触发频率一致。用户使用软触发功能时，相关特性如下：
1) 当软触发频率低于当前配置的最大帧率时，实际帧率将与软触发频率保持一致；若软触发频率超过最大帧率，部分触发信号将被屏蔽，导致实际帧率低于软触发频率。
2) 触发延迟功能是指对接收到的软触发信号进行延迟处理后再触发图像帧采集，系统默认设置为不启用该功能。

三、关键参数解释（新手必看）

1、触发激活方式 Trigger Activation

软触发一般默认上升沿即可，无需修改。

2、触发延迟 Trigger Delay

单位：us，设置触发之后延迟多久曝光，静态采集一般设为0。

3、触发滤波

软触发不需要滤波，保持默认即可，滤波主要用于硬件外触发防抖。

四、代码实现软触发

1.C语言

//触发类型选择为FrameStart// FrameStart帧开始触发：一个信号一帧//FrameBurstStart帧高速连拍：可以一个信号多帧emStatus=GXSetEnumValueByString(m_hDevice,"TriggerSelector","FrameStart");//打开触发模式emStatus=GXSetEnumValueByString(m_hDevice,"TriggerMode","On");//设置触发源为SoftwareemStatus=GXSetEnumValueByString(m_hDevice,"TriggerSource","Software");//发送软触发命令emStatus=GXSetCommandValue(m_hDevice,"TriggerSoftware");

2.C++语言

//触发类型选择为FrameStart// FrameStart帧开始触发：一个信号一帧//FrameBurstStart帧高速连拍：可以一个信号多帧m_objFeatureControlPtr->GetEnumFeature("TriggerSelector")->SetValue("FrameStart");//打开触发模式m_objFeatureControlPtr->GetEnumFeature("TriggerMode")->SetValue("On");//设置触发源为Softwarem_objFeatureControlPtr->GetEnumFeature("TriggerSource")->SetValue("Software");//发送软触发命令m_objFeatureControlPtr->GetCommandFeature("TriggerSoftware")->Execute();

3.C#语言

//触发类型选择为FrameStart// FrameStart帧开始触发：一个信号一帧//FrameBurstStart帧高速连拍：可以一个信号多帧m_objIGXFeatureControl.GetEnumFeature("TriggerSelector").SetValue("FrameStart");//打开触发模式m_objIGXFeatureControl.GetEnumFeature("TriggerMode").SetValue("On");//设置触发源为Softwarem_objIGXFeatureControl.GetEnumFeature("TriggerSource").SetValue("Software");//发送软触发命令m_objIGXFeatureControl.GetCommandFeature("TriggerSoftware").Execute();

4.python语言

#创建device managerdevice_manager=gx.DeviceManager()#打开第一个相机cam=device_manager.open_device_by_index(1)#获取远端控制器remote_device_feature=cam.get_remote_device_feature_control()#设置触发模式On,触发源为软触发trigger_mode_feature=remote_device_feature.get_enum_feature("TriggerMode")trigger_mode_feature.set("On")trigger_source_feature=remote_device_feature.get_enum_feature("TriggerSource")trigger_source_feature.set("Software")# 开始采集cam.stream_on()# 发送软触发命令trigger_software_command_feature=remote_device_feature.get_command_feature("TriggerSoftware")trigger_software_command_feature.send_command()# 取图raw_image=device.data_stream[0].get_image()# 停止采集cam.stream_off()# 关闭设备cam.close_device()

逻辑非常简单：开启触发模式→选择软触发→执行软触发命令。

五、软触发常见问题汇总

1、开启触发后画面黑屏、不动？

正常现象！开启触发之后相机不再连续出图，必须手动点发送软触发命令****TriggerSoftware才会刷新图片。

2.新手避坑：为什么代码发送软触发命令报错

发送软触发命令报错一般是使用流程错误或者相机掉线了；流程错误一般有以下3种原因：

• 相机没有开采
  
• 触发模式是Off，没开触发模式；还有一种可能两种触发类型都选择成On了
  
• 触发源不是Software软触发

3、切回连续采集不生效？

把 Trigger Mode 改为 Off，相机立刻恢复实时流。

4.多次触发卡顿、丢帧？

• 代码中加 10~20ms 延时，避免指令发送过快。
• 确保线缆无损伤、带宽足够，连续采集无丢帧残帧
  

六、软触发使用建议（工程师经验总结）

1. 静态检测、人工抓拍、实验室调试优先用软触发。

2. 流水线、运动物料、自动化设备务必使用硬件外触发。

3. 软触发的频率一定不能高于GalaxyView连续稳定采集的帧率，否则会被屏蔽掉部分信号。

4. 如果频繁抓拍，建议关闭触发模式，使用连续采集。

总结

大恒全系相机软触发通用，核心三步：

1. TriggerMode = On
2. TriggerSource = Software
3. 执行 TriggerSoftware.Execute ()

软触发简单稳定、无需接线，非常适合新手调试、静态采集、二次开发抓拍。

本文收录于专栏： ✅ 大恒相机·使用操作篇
后续我会持续更新，觉得有用可以收藏+关注，持续更新大恒相机实战内容，新手少走弯路、快速入门。