WIN大恒工业相机SDK开发

已于 2023-09-06 09:27:34 修改
阅读量4.4k 收藏 64
点赞数 21
分类专栏： 大恒工业相机 文章标签： 工业相机
于 2023-08-05 20:31:03 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_35044766/article/details/132122506
版权

大恒工业相机SDK开发概览

一、开发环境搭建

1、Galaxy的安装
Galaxy_windows2023年8月版本
下载完成后对软件进行安装，切记自己的安装目录
在这里插入图片描述
安装完成后，检查自己的相机是否是网口相机，如果是网口相机则需要进行IP配置，当相机与计算及网口处于同一网段下才可以打开相机并控制相机。

IPConfig工具可以查找到所有网段的设备，通过自动配置的方式配置相机IP，此时网口必须为固定IP
复位设备 功效等同于给设备掉电上电一次，相机内程序全部重新加载
重连设备 功效等同于软件接口关闭设备，执行此操作后，允许用户重新打开设备
在这里插入图片描述
在这里插入图片描述
打开GalaxyViewer，软件中可以实现正常采集图像，表示SDK的系统环境正常。

在这里插入图片描述
在这里插入图片描述
Windows环境下当Galaxy安装完成后，会在安装目录下生成APIDll、示例程序、驱动、开发文档等
在这里插入图片描述

1、C# 环境配置（VS2019）

（1）新建一个C#控制台应用，工程》引用》右键》添加引用。点击浏览，在安装目录中选择dll
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
（2）在安装目录下》GalaxySDK》APIDll》根据工程架构不同，选择不同的dll文件，x64选择Win64，其他选择Win32
在这里插入图片描述
（3）根据目标框架不同，选择.NET3.5或者.NET4.0
在这里插入图片描述
选择项目菜单，点击属性，查看目标框架，
小于4.0版本，则使用.NET3.5大于4.0版本，则使用.NET4.0版本
在这里插入图片描述
（4）选择GxIAPINET.dll文件，点击添加，点击确定
在这里插入图片描述
在这里插入图片描述
（5）引用中显示已添加GxIAPINET后，在程序中添加using GxIAPINET
在这里插入图片描述
在这里插入图片描述
至此大恒工业相机C#的开发环境已经配置完毕

2、C++ 环境配置（VS2019）

（1）新建一个C++控制台项目
在这里插入图片描述
在这里插入图片描述
（2）打开项目菜单，选择工程属性
在这里插入图片描述
在这里插入图片描述
（3）配置头文件 选择C/C++》常规》包含附加目录
在这里插入图片描述
添加安装目录下GalaxySDK》Samples》C++SDK》inc文件夹
在这里插入图片描述
（4）配置链接器 选择链接器》常规》包含附加目录
在这里插入图片描述
查看自己的工程是x86还是x64
在这里插入图片描述
根据工程的不同，添加安装目录下GalaxySDK》Samples》C++SDK》lib》x86文件夹或者x64文件夹
在这里插入图片描述
（5）配置链接器 选择链接器》输入》附加依赖项，输入GxIAPICPPEx.lib
在这里插入图片描述
添加完链接库的名称后，再我们cpp工程中引用一下GalaxyIncludes库，就可以对我们的库进行调用了
在这里插入图片描述
至此大恒工业相机C++的开发环境已经配置完毕

3、python 环境配置（Pycharm）

（1）新建一个工程，将GalaxySDK》Samples》Python SDK中的gxipy文件夹拷贝到工程目录下
在这里插入图片描述
（2）添加PIL库，打开文件》Settings，选择Project：》Python Interpreter后，点击 + 号
在这里插入图片描述
（2）搜索pillow，选择这个库，点击Install Package进行安装
在这里插入图片描述
（3）安装numpy，搜索numpy选择这个库，点击Install Package进行安装
在这里插入图片描述
同样可以对我们的GalaxyAPI进行调用了
在这里插入图片描述
至此大恒工业相机python的开发环境已经配置完毕

二、相机二次开发流程

在这里插入图片描述
相机的初始化相关接口及功能
在这里插入图片描述

  1. IGXFactory接口类实现对全局资源的初始化
  2. IGXFactory接口类实现对所有设备的枚举
  3. IGXDeviceInfo接口类实现接收所有枚举出的设备信息

C++示例程序

IGXFactory::GetInstance().Init();//初始化
GxIAPICPP::gxdeviceinfo_vector deviceInfo; //定义设备列表
IGXFactory::GetInstance().UpdateDeviceList(1000, deviceInfo);//枚举设备
size_t num = deviceInfo.size();
std::cout <<"检测到相机" << num<<"台\n";//显示设备数量

C#示例程序

 IGXFactory.GetInstance().Init();//初始化
List<IGXDeviceInfo> deviceInfo = new List<IGXDeviceInfo>();//创建一个设备列表
IGXFactory.GetInstance().UpdateDeviceList(1000, deviceInfo);//枚举所有设备
//IGXFactory.GetInstance().UpdateAllDeviceList(1000, deviceInfo);//枚举所有设备
int num = deviceInfo.Count;//获取设备数量
Console.WriteLine("检测到相机"+num+"台");

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述4. IGXDeviceInfo接口类获取设备的类型、厂商名称、 设备展示名称、设备SN号、 IP地址、用户id、mac地址等信息
在这里插入图片描述

GX_DEVICE_CLASS_LIST deviceclass = deviceInfo[0].GetDeviceClass();//获取设备类型USB3.0、USB2.0、Gige
string vendorname = deviceInfo[0].GetVendorName();//获取设备厂商名称
string displayname = deviceInfo[0].GetDisplayName();//获取设备展示名称
string ip = deviceInfo[0].GetIP();//获取设备ip地址
string sn = deviceInfo[0].GetSN();//获取设备SN号
string userid = deviceInfo[0].GetUserID();//获取设备用户id
string mac = deviceInfo[0].GetMAC();//获取设备mac地址

Python示例程序

DeviceManager接口类实现对设备的枚举、获取设备数量信息以及通过关键字获取设备的sn号、IP地址、Mac地址、厂商名称、设备名称等信息
在这里插入图片描述
大恒相机设备控制等功能
在这里插入图片描述
2. IGXFactory接口类通过sn、ip、userid、mac等方式打开设备，获取IGXDevice设备对象

CGXDevicePointer Cam;
/通过SN打开第一台设备
Cam = IGXFactory::GetInstance().OpenDeviceBySN(sn， GX_ACCESS_EXCLUSIVE);//通过IP打开第一台设备
Cam = IGXFactory::GetInstance().penDeviceByIP(ip，GX_ACCESS_EXCLUSIVE);//通过UserID打开第一台设备
Cam = IGXFactory::GetInstance().OpenDeviceByUserID(userid, GX_ACCESS_EXCLUSIVE);
Cam = IGXFactory::GetInstance().OpenDeviceByMAC(mac，GX_ACCESS_EXCLUSIVE);//通MAC地址打开第一台设备

IGXDevice Cam = null;
//通过SN打开第一台设备
Cam = IGXFactory.GetInstance().OpenDeviceBySN(sn, GX_ACCESS_MODE.GX_ACCESS_EXCLUSIVE);//通过IP打开第一台设备
Cam = IGXFactory.GetInstance().OpenDeviceByIP(ip, GX_ACCESS_MODE.GX_ACCESS_EXCLUSIVE);//通过UserID打开第一台设备
cam = IGXFactory.GetInstance().OpenDeviceByUserID(userid,GX_ACCESS_MODE.GX_ACCESS_EXCLUSIVE)//
Cam = IGXFactory.GetInstance().OpenDeviceByMAC(mac, GX_ACCESS_MODE.GX_ACCESS_EXCLUSIVE);//通MAC地址打开第一台设备
  • GX_ACCESS_CONTROL以控制的方式打开相机
  • GX_ACCESS_EXCLUSIVE以独占的方式发开相机
  • GX_ACCESS_READONLY以只读的方式打开相机

在这里插入图片描述
在这里插入图片描述
IGXDevice接口类 获取流通到个数 获取IGXStream流通道对象获取IGXFeatureControl、GetRemoteFeatureControl 属性控制器
C++

//获取流通个数
int stream_num = Cam->GetStreamCount();
//打开第一台设备以及设备下面第一个流
CGXStreamPointer Cam_stream = Cam->OpenStream(0);
//获取远端设备属性控制器
CXFeatureControlpointer Cam RemoteControl = Cam->GetRemoteFeatureControl();
//获取本地属性控制器
CGXFeatureControlPointer Cam_Control = Cam->GetFeatureControl();
//关闭设备
Cam->Close();

C#

//获取流通道个数
uint stream_num = Cam.GetStreamCount();
//打开设备的流
IGXStream Cam_Stream = Cam.OpenStream();
//获取远端设备属性控制器
IGXFeatureControl Cam_RemoteControl = Cam.GetRemoteFeatureControl();
//获取本地属性控制器
IGXFeatureControl Cam_Control = Cam.GetFeatureControl();
//关闭设备
Cam.Close();

在这里插入图片描述
Python
DeviceManager接口类通过序号、sn、ip、userid、mac等方式打开设备，获取Device设备对象

# 通过索引序号打开设备
cam = device_manager.open_device_by_index(1)
# 通过SN号打开设备
cam = device_manager.open_device_by_sn(sn)
#通过ip地址开设备
cam = device_manager.open_device_by_ip(_ip)
# 通过mac地址打开设备
cam = device_manager .open_device_by_mac(mac)
# 通过user id打开设备
cam = device_manager.open_device_by_user_id(user_id)

Device接口类设置触发模式、曝光、增益、获取流通道个数、打开流通道、获取流通道对象、关闭设备

# set continuous acquisition
cam.TriggerMode.set(gx .GxSwitchEntry .0FF)
# set exposure
cam.ExposureTime.set(10000)
# set gain
cam.Gain.set(10.0)
stream_num = cam.get_stream_channel_num()
# start data acquisition
cam.stream_on()
cam_stream = cam.data_stream[0]
cam.close_device()

在这里插入图片描述
IGXStream、DataStream 接口对象注册、注销回调采集函数。
C++

//注册回调采集
pCaptureEventHandler = new CSampleCaptureEventHandler();
Cam_stream->RegisterCaptureCallback(pCaptureEventHandler，NULL);
//注销回调采集
Cam_stream->UnregisterCaptureCallback();

C#

//注册回调采集
Cam_Stream.RegisterCaptureCallback(Cam,OnFrameCallbackFun)
//注销回调采集
Cam_Stream.UnregisterCaptureCallback();

python

#注册采集回调函数
cam_stream.register_capture_callback(capture_callback)
# 注销采集回调函数
cam_stream.unregister_capture_caltback()

IGXStream、DataStream 接口对象进行单帧采集
C++

//单采集
CImageDataPointer image = Cam_stream->GetImage(2000);//超时ms

C#

//单采集
IImageData image = Cam_Stream.GetImage(2000);//超时ms

Python

# 单帧采集
raw_image = cam_stream.get_image()

三、相机相机属性参数配置

相机属性的数据类型

  • IIntFeature IGXFeatureControl::GetIntFeature 整型
  • IFloatFeature IGXFeatureControl::GetFloatFeature 浮点型
  • IBoolFeature IGXFeatureControl::GetBoolFeature 布尔型
  • IEnumFeature IGXFeatureControl::GetEnumFeature 枚举型
  • IStringFeature IGXFeatureControl::GetStringFeature 字符串
  • ICommandFeature IGXFeatureControl::GetCommandFeature 命令类型
  • IRegisterFeature IGXFeatureControl::GetRegisterFeature 寄存器类型
    在这里插入图片描述
    在这里插入图片描述
    在这里插入图片描述当不知道该属性可以被写入时，可通过IsReadable()和IsWritable()方法进行查询如：
bool bIsReadable = cam_control.IsReadable("ExposureTime");
if (bIsReadable)
	cam_control.GetFloatFeature("ExposureTime").GetValue():
else
	MessageBox.Show("此属性不可读");
bool bIsWriteable = cam_control.IsWritable("Gain");
if (bIswriteable)
	cam_control.GetFloatFeature("Gain").SetValue(6);
else
	MessageBox.Show("此属性不可写"):

对于int类型和float类的属性，可以获取该参数可设置的最大值、最小值、步进值，而float类型还可以获取参数的单位

cam_control.GetIntFeature("width").GetInc();
cam_control.GetIntFeature("width").GetMin();
cam control.GetIntFeature("width").GetMax();
cam_control.GetFloatFeature("ExposureTime").GetMin();
cam_control.GetFloatFeature("ExposureTime").GetUnit()
cam_control.GetFloatFeature("ExposureTime").GetInc();

对于枚举类型的参数，可以获取该参数的枚举项列表

List<string> m_enum = cam_control.GetEnumFeature("AutoExposure").GetEnumEntryList();

对于字符串类型的参数，可以获取该参数的最大支持写入长度

long maxlength = cam_control.GetStringFeature("DeviceUserID").GetStringMaxLength();

四、图像采集

单帧采集

采集前必须先调用 StartGrab 开启流通道的采集，然后再给设备发送开采命令，否则开采命令无效

//单采集
Cam_Stream.StartGrab();
Cam_RemoteControl.GetCommandFeature("AcquisitionStart").Execute();
IImageData image = Cam_Stream.GetImage(1000);//超时ms
if (image.Getstatus() == GX_FRAME_STATUS_LIST.GX FRAME_STATUS_SUCCESS)
{
//获取到完整帧图像进行图像处理
image.Destroy();
}

回调采集

采集图像必须先注册回调采集函数，再调用 StartGrab 开启流通道采集、再给设备发送开采命令

//注册回调采集
Cam_Stream.RegisterCaptureCallback(Cam, OnFrameCallbackFun):
Cam_Stream.StartGrab();
Cam_RemoteControl.GetCommandFeature("AcquisitionStart").Execute();

回调函数

public static void OnFrameCallbackFun(object obj, IFrameData objIFrameData)
{
//用户私有参数 obi，用户在注册回调函数的时候传入了设备对象，在回调函数内部可以将此
//参数还原为用户私有参数
  IGXDevice objIGXDevice = obj as IGXDevice;
  if (objIFrameData.Getstatus() == GX_FRAME_STATUS_LIST.GX FRAME_STATUS_SUCCESS)
  {
    UInt64 nwidth = objIFrameData.Getwidth();
    UInt64 nHeight = objiFrameData.GetHeight();
    GX_PIXEL_FORMATENTRY emPixelFormat = objIFrameData.GetPixelFormat();
  }
}

回调采集图像的数据类型为IFrameData，单帧采集的数据类型为IImageData，两者的区别为IImageData类多了一个**Destroy()**方法
在这里插入图片描述

注意事项

千兆网相机心跳包

在程序正常运行时、相机和PC之间会有心跳检测信号保证相机处在连线状态。
在这里插入图片描述
当程序在Debug时，程序在单步调试时PC无法给发送心跳包、因此当停留时间超过心跳检测超时时间，则会出现设备掉线情况。

通常将心跳检测时间设置的大一些解决这种情况

打开设备后，没有执行关闭设备程序，退出了程序，再次调用相机时，会出现设备无法打开的情况。
在这里插入图片描述
使用Ipconfig中的复位设备，将设备状态重置

HDR相机

HDR相机中参数与其他相机的参数有冲突现象，因此在使用HDR相机时，直接参考HDR相机例程
在这里插入图片描述
当HDR相机开启HDR模式后，其他例程在相机初始话曝光等参数时，会出现错误。最好运行HDR专用例程。

PS：哈，终于写完了，累死，其他品牌的相机用到再说
有问题可以加QQ群：907873019

【大恒工业相机SDK开发C#版】相机初始化，采集第一张图像

未来超低端科技研究所
关注
  • 21
    点赞
  • 踩
  • 64
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 1
    评论
专栏目录
C# winform 大恒和海康相机sdk二次开发
04-23
增加了海康的sdk 修复了点自己使用过程中遇到的小bug 增加了相机当前帧率获取和采集图片张数获取
Python SDK_大恒sdk_大恒相机水星系列_
10-03
主要通过大恒 MER-500-14GM进行的二次开发
鸿蒙南向开发实战：相机开发
最新发布
shudaoshanQAQ的博客
04-26 819
相机是OpenHarmony多媒体进程提供的服务之一..........
大恒工业相机（水星2.0）利用SDK读取图像的程序
03-31
配置好相关文件 可以在VS里直接运行 里面还用到了opencv的一些函数
大恒相机SDK开发，可执行并将数据格式转化成halcon对象
03-09
大恒相机SDK开发，可执行并将数据格式转化成halcon对象
winfrom大恒工业相机SDK二次开发、C#联合halcon开发
susan的博客
12-18 1610
winfrom大恒工业相机SDK二次开发、C#联合halcon开发
大恒水星相机SDK（实时采集）基于QT与C++
畵颜卿
08-25 2185
根据自己相机能获取到的图像数据进行赋值，具体是写什么去官网查看自己相机的参数，我的相机的原始数据是Mono8的一个灰度图。m_bisOpen就是设置按钮的状态了，如果成功打开设备UI上面的按钮就不能再按钮了，所以要如果成功打开了就设置为不可用，后面的其他程序也是一个道理。在缓存队列里面我们是先进先出的原则，这样做无论在什么时候对采集进行停止还是关闭设备，都不会因为没有来得及显示图片而进行内存管理错误，来不及显示的图片就暂时放在了队列里面，保证了程序的安全与稳定。这里是部分代码块的讲解，后是会有完整代码的。
Halcon12.0结合vs2010进行大恒相机SDK二次开发
德赛法的博客
04-01 8458
一 功能实时显示通过调用halcon函数处理后的图像二前期相机大恒MER-500-7UM，系统win7-64位，编程环境vs2010，软件halcon12.0，基础开发为大恒自带样例SDK包（C:\Program Files\Daheng Imavision\MER-Series\Samples\VC SDK\src\GxSingleCamMono）三 方法先说总体思想，直接在SDK开发基础上增...
USB3 不显示大恒相机驱动（设备管理器可以发现但是软件中发现不了）
m0_56265052的博客
08-26 3164
GalaxyView 不显示相机驱动
大恒相机程序
07-20
基于MFC的大恒相机驱动程序，包含了相机的打开，图像采集和保存等操作！
关于工业相机编程调用SDK二次开发的一些步骤流程
热门推荐
Jack_Sarah的博客
04-18 2万+
网上找的一些资料，整理了一下，留着仔细看一看。内容纲要：1.工业相机编程模型和流程2.工业相机SDK接口使用总结3.Basler Pylon工业相机SDK的使用4.Pylon 以实时图像采集讲解PylonC SDK使用流程5.关于使用维视工业相机 SDK 采集图像的问题6.工业相机SDK之opencv二次开发1.工业相机编程模型和流程不同的工业相机提供不同的编程接口(SDK)，尽管不同接口不同相机...
大恒相机驱动及资料C++ C
11-23
GxIAPICPP.dll库是基于面向对象思想封装的通用并且统一的编程接口，适用于大恒MER、MARS等系列相机。 下面介绍主要工作模块以及主要功能职责见表1-1：
MFC项目，大恒图像类封装，Opencv结合使用
11-08
MFC项目，大恒图像类封装，Opencv结合使用，外触发和软触发
Basler工业相机SDK sample
08-01
资源中是官网的Basler工业相机二次开发的SDK，内有c,c++,c#三个版本
Galaxy_Windows_CN_32bits64bits.rar
01-02
大恒水星系列Windows驱动
基于Qt大恒工业相机二次开发demo-C++
03-27
基于Qt大恒工业相机二次开发demo-C++，重写的CGXBitmap类，移植性强
大恒工业相机开发说明文档
08-18
内容：主要对大恒相机开发进行必要函数和参数说明 人群：大恒图像工业相机开发初学者 场景：软件开发
常用的工业相机及SDK
$firecat利白的代码足迹$
04-02 4493
Basler相机 Basler pylon相机软件套装是一款包含易于使用的SDK、驱动程序和工具的软件套装，您可通过Windows、Linux PC或Mac来操作任何一款Basler相机。pylon采用最新GenICam技术，可无限制访问最新型号的相机并使用相关功能。 https://www.baslerweb.com/cn/ https://www.baslerweb.com/cn/sales-...
搭建大恒相机开发环境
zxpcus的博客
03-28 3237
大家好，这里是石侃侃的博客；这篇文章记录了我在使用大恒相机搭建开发环境时候遇到的一些问题和解决方案；有任何问题请在评论区留言。first:LINK:fatal error LNK1123: 转换到 COFF 期间失败: 文件无效或损坏原文地址：http://yacare.iteye.com/blog/2010049错误描述：1&gt;正在编译资源...1&gt;正在编译资源清单...1&gt;正在...
大恒相机sdk二次开发
05-13
大恒相机SDK是一款用于控制大恒相机的软件开发工具包，提供了一系列的接口和函数，可以实现对大恒相机的控制、图像采集、数据传输等功能。如果您想进行二次开发，可以按照以下步骤进行： 1.下载并安装大恒相机SDK，获取SDK的开发文档和示例程序。 2.根据您的需求，选择合适的编程语言和开发环境。大恒相机SDK支持多种编程语言，如C++、C#、VB等。同时，也提供了多种开发环境支持，如Visual Studio、Qt、Matlab等。 3.根据开发文档和示例程序，学习大恒相机SDK的使用方法和接口函数。根据您的需求，编写程序代码，实现相机控制、图像采集、数据传输等功能。 4.进行调试和测试，确保程序正常运行。如果出现问题，可以参考开发文档和示例程序，或者联系大恒相机的技术支持团队，寻求帮助。 5.将程序部署到实际应用中，进行实际测试和使用。 需要注意的是，在进行大恒相机SDK的二次开发过程中，需要对相机的硬件结构和性能有一定的了解，以便更好地实现相机控制和数据采集等功能。同时，也需要注意相机的稳定性和安全性，确保程序正常运行和数据的安全性。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

未来超低端科技研究所

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值