小目标检测(1)——大恒(DaHeng)相机操作与控制编程

本文介绍了如何使用大恒相机的SDK进行程序开发,包括相机的初始化和反初始化、设备枚举、开关设备操作,详细讲解了属性控制、图像采集(采单帧和回调采集)以及图像处理的过程。同时提到了回调函数的实现和设备事件的获取。文章还涉及了CINI库的使用,并提供了一个样例程序来综合运用上述功能。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

引言

  • 在做老师的横向项目时,需要用大恒相机,需要将他的相机控制接入写的程序中,但是对于他的SDK并不了解,所以就好好看了他的SDK文件,并按照他的开发手册写了一个小的demo。

正文

相关开发库的介绍

  • 在使用别人的代码过程中,有很多库自己都看不懂,这里做一下记录
  • GxIAPICPPEx.dll:封装过后的通用并且统一的编程接口
  • IGXFactory:初始化接口库,枚举设备,打开设备
  • IGXDevice:设备对象,以此对象为入口进行属性控制、图像采集,获取相机事件等。
  • IGXStream:流对象,从IGXDevice获得,专门负责图像采集相关职能。
  • IGXFeatureControl:属性控制对象,分别从IGXDevice和IGXStream获得属性控制对象,
  • IImageData:回调采集和采单帧的图像结构体,包括采集输出结果:图像buffer和图像信息等,还自带图像格式转换、图像增强的功能
  • GXBitmap:负责图像的显示和存储功能,具体见示例程序

在这里插入图片描述

编程准备

  • 首先需要下载安装对应设备的SDK文件,具体链接,相关SDK软件下载
  • 这里是结合VS 2022进行打开,如何配置库,如何指定,相关的头文件。
  • 在编程之前,需要配置好指定的项目文件
    • 配置好所需要引用的头文件,Galaxyincludes.h头文件
    • 设置需要引用的库文件,GxlAPICPPEx.lib库文件
配置引用头文件GalaxyIncludes.h
  • 这里安装了SDK的话,需要指定你所运行的项目的配置文件,这里有两种写法,正常来说应该把对应的SDK复制在项目所在的文件里,这样项目的可移植性就比较强。但是我这里已经在工控机上进行 配置了,就直接写了绝对路径。
    在这里插入图片描述
配置lib文件
  • 这里必须配置GxIAPICPPEx.lib静态库文件,这个库是大恒相机对外编程的统一接口。接受一个新的项目文件,一般来说,配置文件里面有,但是属性里面没有配置,踩过坑之后发现需要重新配置。

  • 找到GxlAPICPPEx.lib的路径
    在这里插入图片描述

  • 设置相关的配置文件

在这里插入图片描述

  • 指定对应目录下方的静态库

在这里插入图片描述

具体编程过程

  • 当前章节,主要是涉及到如何调用相关的开发库,对相机进行初始化,并对相机进行控制,同时保存对应的图片。
  • 具体操作如下
    • 初始化获取相关的资源, 反初始化释放所有的资源
    • 枚举设备,获取所有资源
    • 开关设备
初始化和反初始化
  • 在调用GxlAPICPPEx.lib之前,相机必须要进行初始化,初始化是通过IGXFactory进行初始化的。
#include <iostream>
#include "IGXFactory.h"
#include "GalaxyException.h"

using namespace std;

int main()
{
    try {
        // 初始化相机实例
        IGXFactory::GetInstance().Init();
    }
    catch (CGalaxyException&e) {
        cout << "error code " << e.GetErrorCode() << endl;
        cout << "error description" << e.what() << endl;
    }
   


    std::cout << "Hello World!\n";
}
  • 在初始化中遇到CGalaxyException找不到标识符的问题,解决办法如下,在vs中找到异常,会跳转到GXSmartPtr.h头文件中,添加#include “GalaxyException.h”,具体如下

在这里插入图片描述

  • 加上这句之后,后续就没有运行问题了,运行截图如下
    在这里插入图片描述

  • 在调用相机的进程退出之后,必须要进行反初始化,释放GxlAPICPPEx库函数调用的所有资源。

// DahengCameraStart.cpp : 此文件包含 "main" 函数。程序执行将在此处开始并结束。
// 基础应用

#include <iostream>
#include "IGXFactory.h"
#include "GalaxyException.h"

using namespace std;

int main()
{
    try {
        // 初始化相机实例
        IGXFactory::GetInstance().Init();
        // 相机的反初始化,释放所有占有的资源
        IGXFactory::GetInstance().Uninit();
    }
    catch (CGalaxyException&e) {
        cout << "error code " << e.GetErrorCode() << endl;
        cout << "error description" << e.what() << endl;
    }
   


    std::cout << "Hello World!\n";
}
枚举设备
  • 用户通过枚举设备来获取当前计算机中,可以使用的设备,并进行相关的调用
  • 用户通过调用 IGXFactory::GetInstance().UpdateDeviceList 枚举当前所有可用设备,获取一个设备信息列表,列表类型为 GxIAPICPP::gxdeviceinfo_vector。
  • 具体代码如下
int main()
{
    try {
        // 初始化相机实例
        IGXFactory::GetInstance().Init();

        // 使用GxIAPICPP列表类保存相关的信息
        GxIAPICPP::gxdeviceinfo_vector  vectorDeviceInfo;
        // 第一个参数是扫描的时长,第二个参数是将获取的信息保存到对应的列表中
        IGXFactory::GetInstance().UpdateDeviceList(10000,vectorDeviceInfo);
        cout << "the camera num:" << vectorDeviceInfo.size() << endl;
        for (int i = 0; i < vectorDeviceInfo.size(); i++) {
            cout << vectorDeviceInfo[i].GetVendorName() << endl;
            cout << vectorDeviceInfo[i].GetModelName() << endl;
        }


        // 相机的反初始化,释放所有占有的资源
        IGXFactory::GetInstance().Uninit();
    }
    catch (CGalaxyException&e) {
        cout << "error code " << e.GetErrorCode() << endl;
        cout << "error description" << e.what() << endl;
    }
   


    std::cout << "Hello World!\n";
}
开关设备
  • 控制设备关闭或者打开,由于这里使用的是ME2P-1230-23U3M/C相机,是通过USB3.0接口进行控制,并不是千兆网相机,所以MAC地址和IP地址都是空的,

在这里插入图片描述

  • 控制相机关闭打开总共有四种方式
      1. SN 为设备序列号。
      1. UserID 为用户自定义名称(不支持 UserID 的设备此项为空字符串)。
      1. MAC 为设备 MAC 地址(非千兆网相机此项为空字符串)。
      1. IP 为设备 IP 地址(非千兆网相机此项为空字符串)。
  • 打开对应函数的对应函数接口是
    • IGXFactory::GetInstance().OpenDeviceBySN
    • IGXFactory::GetInstance().OpenDeviceByUserID
    • IGXFactory::GetInstance().OpenDeviceByMAC
    • IGXFactory::GetInstance().OpenDeviceByIP
  • 关闭对应相机的函数如下
//关闭设备之后不允许再调用 IDevice 以及设备的 IFeatureControl、IStream 的所有接口
objDevicePtr->Close();
  • 最终的代码,我手上还没有相机,老师就给我代码让我先看一下,这里参考的是官方的参考手册代码
GxIAPICPP::gxdeviceinfo_vector vectorDeviceInfo;
IGXFactory::GetInstance().UpdateDeviceList(1000, vectorDeviceInfo);
if (vectorDeviceInfo.size()> 0)
{
//打开链表中的第一个设备
CGXDevicePointerobjDevicePtr;
GxIAPICPP::gxstringstrSN = vectorDeviceInfo[0].GetSN();
GxIAPICPP::gxstringstrUserID = vectorDeviceInfo[0].GetUserID();
GxIAPICPP::gxstringstrMAC = vectorDeviceInfo[0].GetMAC();
GxIAPICPP::gxstringstrIP = vectorDeviceInfo[0].GetIP();
//用户也可以直接指定打开的设备信息,下面代码中使用的信息为伪造信息,用户以实际设备为准
//GxIAPICPP::gxstring strSN = "GA0140100002";
//GxIAPICPP::gxstring strUserID = "MyUserName";
//GxIAPICPP::gxstring strMAC = "A1-0B-32-7C-6F-81";
//GxIAPICPP::gxstring strIP = "192.168.0.100";
objDevicePtr = IGXFactory::GetInstance().OpenDeviceBySN(strSN, GX_ACCESS_EXCLUSIVE);
//objDevicePtr = IGXFactory::GetInstance().OpenDeviceByUserID(strUserID, 
//GX_ACCESS_EXCLUSIVE);
//objDevicePtr = IGXFactory::GetInstance().OpenDeviceByMAC(strMAC, 
//GX_ACCESS_EXCLUSIVE);
//objDevicePtr = IGXFactory::GetInstance().OpenDeviceByIP(strIP, 
//GX_ACCESS_EXCLUSIVE);
}

属性控制

  • 这部分东西比较琐碎,并且不是重点,就简单写一下
属性控制器种类
  • 主要是通过IGXFeatureControl进行属性控制,分别是有两类控制对象,分别是设备Device和流Stream
      1. IGXFeatureControl IGXDevice::GetRemoteFeatureControl //包含主要设备信息,比如宽高、曝光增益等,一般用户主要使用此属性控制器即可
      1. IGXFeatureControl IGXDevice::GetFeatureControl //包含一些本地属性,不同类型的设备具备的功能也不一样。
      1. IGXFeatureControl IGXStream::GetFeatureControl //流对象属性控制器,关于采集控制和采集数据统计的属性访问控制器

图像采集控制和图像处理

  • 所有和图像采集和控制的相关接口都在CGXStreamPointer指定的对象上,获取和打开流对象的方法是通过这个流对象来获得,但是这个流对象是通过设备对象获得,设备对象打开之后返回的就是流对象,具体如下,更详细的在上一节
objDevicePtr = IGXFactory::GetInstance().OpenDeviceBySN(strSN, GX_ACCESS_EXCLUSIVE);
  • 基本操作,是枚举并获取对应的设备,然后获取设备对应的流,然后打开流才能进行图片采集。

获取设备之后,需要打开设备对象的流OpenStream,具体代码如下

uint32_t_t nStreamNum = objDevicePtr->GetStreamCount();
if (nStreamNum > 0)
{
CGXStreamPointer objStreamPtr = objDevicePtr->OpenStream(0);
//流对象控制或者采集
//当用户不使用流对象的时候,需要将其关闭
objStreamPtr->Close();
}
采单帧
  • 用户开启流对象采集,并且给设备发送采集命令,就而可以调用GetImage接口采集单帧
  • 具体流程如下
    • 打开流通道
    • 发送采集命令
    • 开始采集,采单帧
    • 获取图片并进行处理
    • 停采
    • 关闭流通道
  • 注意:不适用高清相机的快速采集
// 打开对应设备对应的流
CGXStreamPointer objStreamPtr = objDevicePtr->OpenStream();

// 开启流通道的采集命令
objStreamPtr->StartGrab();

//给设备发送采集命令,进行开采
CGXFeatureControlPointer objFeatureControlPtr = objDevicePtr->GetRemoteFeatureControl();
objFeatureControlPtr ->GetCommandFeature("AcquisitionStart")->Execute();

//采单帧
CImageDataPointer objImageDataPtr;

objImageDataPtr = objStreamPtr->GetImage(500);//超时时间使用 500ms,用户可以自行设定
if (objImageDataPtr->GetStatus() == GX_FRAME_STATUS_SUCCESS)
{
//采图成功而且是完整帧,可以进行图像处理 ...
}
//停采
objFeatureControlPtr->GetCommandFeature("AcquisitionStop")->Execute();
objStreamPtr->StopGrab();
//关闭流通道
objStreamPtr->Close();



回调采集
  • 回调采集:当图片已经可以获取,或者当目标已经就位的时候,会自动调用一个函数,来处理存储对应的图片。很符合我们的应用场景。
  • 在大恒摄像中的回调处理虚基类是ICaptureEventHandler,如果要实现对应的回调采集,需要继承并实现虚基类
class CSampleCaptureEventHandler : public ICaptureEventHandler
{
	public:
	void DoOnImageCaptured(CImageDataPointer& objImageDataPointer, void* pUserParam)
	{
	if (objImageDataPointer->GetStatus() == GX_FRAME_STATUS_SUCCESS)
		{
			//图像获取为完整帧,可以读取图像宽、高、数据格式等
			uint64_t nWidth = objImageDataPointer->GetWidth();
			uint64_t nHeight = objImageDataPointer->GetHeight();
			GX_PIXEL_FORMAT_ENTRY emPixelFormat =
			objImageDataPointer->GetPixelFormat();
			//其他图像信息的获取参见 IImageData 接口定义
		}
	}
};
  • 定义完自己的回调处理程序之后,需要将对应的函数注册到回调采集函数中
// 打开设备的输入流
CGXStreamPointer objStreamPtr = objDevicePtr->OpenStream(0);

//注册采集回调函数,注意第一个参数是用户私有参数,用户可以传入任何 object 对象,也可以是 null
//用户私有参数在回调函数内部还原使用,如果不使用私有参数,可以传入 null
// 创建一个自己定义的回调函数的实例对象
ICaptureEventHandler* pCaptureEventHandler = new CSampleCaptureEventHandler();
// 将对应的实例采集对象注册到回调采集函数中
objStreamPtr->RegisterCaptureCallback(pCaptureEventHandler,NULL);

//开启流通道采集
objStreamPtr->StartGrab();
//给设备发送开采命令
CGXFeatureControlPointer objFeatureControlPtr =
objDevicePtr->GetRemoteFeatureControl();
objFeatureControlPtr->GetCommandFeature("AcquisitionStart")->Execute();
//回调采集过程,参见回调函数

//停采、注销采集回调函数
objFeatureControlPtr->GetCommandFeature("AcquisitionStop")->Execute();
objStreamPtr->StopGrab();
objStreamPtr->UnregisterCaptureCallback();
delete pCaptureEventHandler;
pCaptureEventHandler = NULL;
//关闭流通道
objStreamPtr->Close();

图像处理
  • 在大恒相机的图片处理中,可以实现如下功能

    • 图像格式转换:将任何数据转成指定获取的8位有效数字或者是RGB的24位
    • 图像效果增强:可以实现对图片的坏点矫正、锐化、对比度、亮度等图像效果增强的操作
  • 具体的实现方式有两种

  • 设置调试的配置文件,然后直接进行调试

//通过设备对象构建图像处理配置对象
CImageProcessConfigPointer objImageProcessConfigPtr = objDevicePtr->CreateImageProcessConfig();
//objImageDataPtr 可以是采集回调函数传入的还可以是 GetImage 获取的
void*pRGB24Processed = NULL;
//返回结果就是经过图像效果增强之后的 RGB24 格式的数据
pRGB24Processed = objIBaseData>ImageProcess(objImageProcessConfigPtr);
  • 调用语句进行微调
//通过设备对象构建图像处理配置对象
CImageProcessConfigPointer objImageProcessConfigPtr =
objDevicePtr->CreateImageProcessConfig();
//objImageProcessConfigPtr 对象在构建的时候会初始化默认配置参数,用户可以选择对配置
//参数进行微调,如下:
objImageProcessConfigPtr->SetValidBit(GX_BIT_0_7);
//选择有效数据位 0~7
objImageProcessConfigPtr->EnableDefectivePixelCorrect(true);//使能坏点校正功能
objImageProcessConfigPtr->EnableSharpen(true);//使能锐化
objImageProcessConfigPtr->SetSharpenParam(1);//设置锐化强度因子 1
objImageProcessConfigPtr->SetContrastParam(0);//设置对比度调节参数
objImageProcessConfigPtr->SetGammaParam(1);//设置 Gamma 系数
objImageProcessConfigPtr->SetLightnessParam(0);//设置亮度调节参数
objImageProcessConfigPtr->EnableDenoise(true);//使能降噪开关(黑白相机不支持)
流对象属性控制
  • 我们是通过流对象来控制设备进行图片采集的,也是通过流对象来控制相机采集相关的属性和统计信息
  • 对于流属性的控制,主要是通过IGXStream进行控制的
//objGXStream 为通过 IGXDevice::OpenStream 获取到的 CGXStreamPointer 对象
CGXFeatureControlPointer objStreamFeatureControlPtr = objGXStream->GetFeatureControl();
//查看采集统计信息
//buffer 不足导致丢帧数
objStreamFeatureControlPtr->GetIntFeature("StreamLostFrameCount")->GetValue();
//接收的残帧个数
objStreamFeatureControlPtr->GetIntFeature("StreamIncompleteFrameCount")->GetValue();
//接收到的包数
objStreamFeatureControlPtr->GetIntFeature("StreamDeliveredPacketCount")->GetValue();
//重传包个数
objStreamFeatureControlPtr->GetIntFeature("StreamResendPacketCount")->GetValue();
//设置采集配置参数
//设置块超时时间 200ms
objStreamFeatureControlPtr->GetIntFeature("BlockTimeout")->SetValue(200);
  • 通过改变流对象属性中“StreamBufferHandlingMode”可以设置 Buffer 的处理模式,Buffer 处理模式目前支持三种
    • 1)OldestFirst:默认值。图像缓冲区遵守先进先出的原则,所有的缓冲区全部填满后,新的图像数据会被丢弃,直到用户完成已经填满图像数据的缓冲区处理。典型应用场景是,要求接收到相机采集的每帧图像,不丢帧。该模式实现不丢帧,还需要图像数据的传输与处理的速度尽量快(至少小于帧周期)。
    • 2)OldestFirstOverwrite:同样遵守先进先出的原则。与 OldestFirst 模式的区别是,当所有的缓冲区全部填满后,SDK 将主动丢弃缓冲区中时间戳最旧的一帧图像缓冲区,用于接收新的图像数据。典型的应用成绩是,不要求接收相机采集的每帧图像,应用环境下图像传输与处理速度较慢。
    • 3)NewestOnly:该模式下用户拿到的始终是 SDK 接收到的最新图。SDK 每接收到一帧新的图像数据,就会主动丢弃旧时间戳的图像,因此当用户图像处理不及时或者速度较慢时,就会出现丢帧。该模式主要应用场合是,对图像采集与显示实时性要求比较高,且不要求接收到相机采集的每帧图像。但是受相机的采集帧率和内部缓存,以及传输速度、用户使用场景的限制,SDK 接收的最新图与相机最新曝光的图像可能有延迟。

获取设备事件

  • 在回调函数中,可以获取设备发生的具体事件,并进行相关的处理。可以获取的五类事件如下

在这里插入图片描述

  • 获取设备事件之后,指定对应的回调函数,然后在进行注册,相关设备事件发生之后,会自动调用相关的处理函数

  • 下述代码是定义了设备发生曝光事件的处理函数

classCSampleFeatureEventHandler : public IFeatureEventHandler
{
	public:void DoOnFeatureEvent(
		constGxIAPICPP::gxstring& strFeatureName, void* pUserParam)
	{
		cout <<"发生曝光结束事件!"<<endl;
		//pUserParam 是用户注册回调函数的时候传入的 ,此处将其还原用来获取事件数据
		CGXFeatureControlPointer* pObjFeatureControlPtr =(CGXFeatureControlPointer*)pUserParam;
		//获取曝光结束事件时间戳
		(*pObjFeatureControlPtr)->GetIntFeature("EventExposureEndTimestamp")->GetValue();
		//获取曝光结束事件帧 ID
		(*pObjFeatureControlPtr)->GetIntFeature("EventExposureEndFrameID")->GetValue();
	}
};
  • 下述代码为具体的注册回调函数
//objDevicePtr 为 CGXDevicePointer 设备对象,设备已经打开
//设备事件属性在远端设备属性控制器上,首先应该获取远端设备属性控制器
CGXFeatureControlPointer objFeatureControlPtr =
objDevicePtr->GetRemoteFeatureControl();
//选择事件源
objFeatureControlPtr->GetEnumFeature("EventSelector")->SetValue(
"ExposureEnd");
//使能事件
objFeatureControlPtr->GetEnumFeature(
"EventNotification")->SetValue("On");
//注册事件回调函数,注意参数三是用户私有参数,用户可以传入任何指针
//此处我们演示传入属性控制器指针,因为稍后会在回调函数内部使用此对象获取曝光结束事
//件数据信息
//此私有参数在回调函数内部可以被还原供用户使用 ,如果用户不使用私有参数,可以简单的将
//此参数设置为 NULL
GX_FEATURE_CALLBACK_HANDLE hEventHandle = NULL;
IFeatureEventHandler* pFeatureEventHandler =
new CSampleFeatureEventHandler();
hEventHandle = objFeatureControlPtr->RegisterFeatureCallback(
"EventExposureEnd",pFeatureEventHandler,&objFeatureControlPtr);
//开启流通道采集
objStreamPtr->StartGrab();
//给设备发送开采命令
objFeatureControlPtr->GetCommandFeature("AcquisitionStart")->Execute();

//发送开采命令,相机开始曝光输出图像,当曝光结束的时候会产生曝光结束事件,此时就会
//激活回调 OnFeatureCallback 接口
//接收曝光结束事件,见 OnFeatureCallback
//发送停采命令
objFeatureControlPtr->GetCommandFeature("AcquisitionStop")->Execute();
objStreamPtr->StopGrab();
//注销事件
objFeatureControlPtr->UnregisterFeatureCallback(objEventHandle);
delete pFeatureEventHandler;
pFeatureEventHandler = NULL;
获取掉线事件通知
  • 这个和回调采集的道理是一样,发生了掉线事件之后,会自动调用这些函数进行反馈
    在这里插入图片描述
  • 将自己定义的回调函数进行注册的代码

在这里插入图片描述

  • 这个比较特殊,如果要关闭设备,需要提前注销事件

在这里插入图片描述

样例程序分析

  • 当前这部分用来展示一个完整的控制台程序,实现了三个功能,分别是
    • 注册掉线设备:定义设备掉线的处理方案
    • 注册远端设备事件:定义远端设备发生发生某个事件之后的处理方案
    • 注册采集回调事件:定义图片采集之后的处理事件
#include "stdafx.h"
#include <isostream>

// 这里需要提前配置好工程头文件,这个头文件基本上包含了所有的头文件,加上这个了就不需要在二次调用了
#include "GalaxyIncludes.h"

// 用户定义掉线的处理事件,设备掉线会自动调用的程序
// 需要继承并实现虚基类:IDeviceOfflineEventHandler
class CSampleDeivceOfflineEventHandler:public IDeviceOfflineEventHandler{
public:
	// pUserParam用户传入的参数
	void DoOnDeviceOfflineEvent(void *pUserParam){
		cout<<"设备已经掉线了,请注意处理"<<endl;
	}
}

// 用户定义属性更新事件的处理函数,当属性发生改变时,自动调用该函数
// 需要继承并实现虚基类
class CSampleCaptureEventHandler:Public ICaptureEventHandler{
public:
	void DoOnFeatureEvent(const GxIAPICPP:gxstring &strFeatureName,void *pUserParam){
		cout<<"收到曝光事件"<<endl;
	}

}

// 用户定义回调采集函数的具体实现,当回调采集事件发生时,自动调用该函数
// 需要继承实现虚基类
class CSampleCaptureHandler : public ICaptureEventHandler{

public:
	void DoOnImageCapture(CImageDataPointer &objImageDataPointer,void * pUserParam){
		cout<<"收到一帧图像 !"<<endl;
		cout<<"ImageInfo: "<<objImageDataPointer->GetStatus() <<endl;
		cout<<"ImageInfo: "<<objImageDataPointer->GetWidth() <<endl;
		cout<<"ImageInfo: "<<objImageDataPointer->GetHeight() <<endl;
		cout<<"ImageInfo: "<<objImageDataPointer->GetPayloadSize() <<endl;
	}
}

// main函数需要注册掉线事件、属性变动事件以及采集回调事件
int main(int argc,_TCHAR* argv[]){

	//定义事件回调的指针
	IDeviceOfflineEventHandler* pDeviceOfflineEventHandler = NULL;//<掉线事件回调对象
	IFeatureEventHandler* pFeatureEventHandler = NULL;//<远端设备事件回调对象
	ICaptureEventHandler* pCaptureEventHandler = NULL;//<采集回调对象

	// 初始化库,才能调用相关的功能
	IGXFactory::GetInstance().Init()

	try
	{
		do
		{
			//枚举设备
			gxdeviceinfo_vector vectorDeviceInfo;
			IGXFactory::GetInstance().UpdateDeviceList(1000, vectorDeviceInfo);
			if (0 == vectorDeviceInfo.size())
			{
				cout<<"无可用设备!"<<endl;
				break;
			}
			//打开第一台设备以及设备下面第一个流
			CGXDevicePointer ObjDevicePtr = IGXFactory::GetInstance().OpenDeviceBySN(vectorDeviceInfo[0].GetSN(),GX_ACCESS_EXCLUSIVE);
			CGXStreamPointer ObjStreamPtr = ObjDevicePtr->OpenStream(0);
			//获取远端设备属性控制器
			CGXFeatureControlPointer ObjFeatureControlPtr =
			ObjDevicePtr->GetRemoteFeatureControl();
			//获取流层属性控制器
			CGXFeatureControlPointer objStreamFeatureControlPtr =
			ObjStreamPtr->GetFeatureControl();
			//设置 Buffer 处理模式
			objStreamFeatureControlPtr->GetEnumFeature("StreamBufferHandlingMode")->SetValue("OldestFirst");
			
			//注册设备掉线事件(目前只有千兆网系列相机支持此事件通知 )
			GX_DEVICE_OFFLINE_CALLBACK_HANDLE hDeviceOffline = NULL;
			pDeviceOfflineEventHandler =new CSampleDeviceOfflineEventHandler();
			hDeviceOffline = ObjDevicePtr->RegisterDeviceOfflineCallback(pDeviceOfflineEventHandler, NULL);

			//设置曝光时间(示例中写死 us,只是示例,并不代表真正可工作参数)
			//ObjFeatureControlPtr->GetFloatFeature("ExposureTime")->SetValue(50);
			//注册远端设备事件:曝光结束事件(目前只有千兆网系列相机支持曝光结束事件 )
			//选择事件源
			ObjFeatureControlPtr->GetEnumFeature("EventSelector")->SetValue("ExposureEnd");
			//使能事件
			ObjFeatureControlPtr->GetEnumFeature("EventNotification")->SetValue("On");
			GX_FEATURE_CALLBACK_HANDLE hFeatureEvent = NULL;
			pFeatureEventHandler = new CSampleFeatureEventHandler();
			hFeatureEvent = ObjFeatureControlPtr->RegisterFeatureCallback(
				"EventExposureEnd", pFeatureEventHandler, NULL);
			
			//注册回调采集
			pCaptureEventHandler = new CSampleCaptureEventHandler();
			ObjStreamPtr->RegisterCaptureCallback(pCaptureEventHandler,NULL);
			
			//发送开采命令
			ObjStreamPtr->StartGrab();
			ObjFeatureControlPtr->GetCommandFeature("AcquisitionStart")->Execute();

			//此时开采成功,控制台打印信息,直到输入任意键继续
			getchar();
			
			//发送停采命令
			ObjFeatureControlPtr->GetCommandFeature("AcquisitionStop")->Execute();
			ObjStreamPtr->StopGrab();

			//注销采集回调
			ObjStreamPtr->UnregisterCaptureCallback();

			//注销远端设备事件
			ObjFeatureControlPtr->UnregisterFeatureCallback(hFeatureEvent);

			//注销设备掉线事件
			ObjDevicePtr->UnregisterDeviceOfflineCallback(hDeviceOffline);
			
			//释放资源
			ObjStreamPtr->Close();
			ObjDevicePtr->Close();
		} while (0);
	}
	catch(CGalaxyException&e)
	{
		cout<<"错误码: "<<e.GetErrorCode() <<endl;
		cout<<"错误描述信息 : "<<e.what() <<endl;
	}
	catch(std::exception&e)
	{
		cout<<"错误描述信息 : "<<e.what() <<endl;
	}
	
	//反初始化库
	IGXFactory::GetInstance().Uninit();

	//销毁事件回调指针
	if (NULL != pCaptureEventHandler)
	{
		delete pCaptureEventHandler;
		pCaptureEventHandler = NULL;
	}
	if (NULL != pDeviceOfflineEventHandler)
	{
		delete pDeviceOfflineEventHandler;
		pDeviceOfflineEventHandler = NULL;
	}
	if (NULL != pFeatureEventHandler)
	{
		delete pFeatureEventHandler;
		pFeatureEventHandler = NULL;
	}
	return 0;
}

补充:项目中常用库函数

CINI库
  • 介绍:专门用来处理INI文件的C++库,INI是一种简单的数据存储格式,用于存储应用程序的配置信息
  • 主要特性
    • 读取和写入INI文件:CINI库提供了函数来读取和写入INI文件。这使得你可以在你的程序中方便地使用INI文件来存储和检索配置信息。
    • 支持多种数据类型:CINI库支持多种数据类型,包括整数、浮点数、字符串等。这使得你可以在INI文件中存储各种类型的数据。
    • 错误处理:CINI库提供了错误处理机制,可以帮助你检测和处理可能出现的错误。
    • 跨平台:CINI库可以在多种操作系统上使用,包括Windows、Linux等。

总结

  • 目前没有设备,就不看他的说明文档了,等我手里 有具体的相机了,再继续开始写一些控制相机的基础代码了,这里直接去看老师给的代码了, 不往外放了。
### 大恒相机MER-302-37GM规格参数 图像推出的水星(MERCURY)系列工业相机以其紧凑的设计和高性能著称。具体到型号MER-302-37GM/C,这款相机采用了1/3英寸CCD感光芯片,具备高分辨率、高清晰度、高精度以及低噪声的特点[^1]。 #### 主要技术指标 - **传感器类型**: 1/3英寸CCD - **像素数**: 30万(VGA) - **帧率**: 最高达每秒37帧@全分辨率模式下 - **接口标准**: Gigabit Ethernet (GigE Vision兼容),确保快速稳定的图像传输性能 - **物理尺寸**: 小巧轻便设计,仅29mm×29mm×29mm小适合空间受限的应用场景 - **工作温度范围**: 支持宽温操作,在极端条件下仍可保持良好表现 - **防护特性**: 提供线缆锁紧装置,增强连接稳定性;支持多种安装方式适应不同需求 ### 配置使用指南 为了成功配置并使用该款相机,建议按照如下指导进行: #### 安装准备阶段 确保硬件正确无误地接入计算机系统,并确认电源供应正常——当一切就绪时,应该能看到设备上的黄色LED指示灯点亮表示已通电待命状态[^4]。 #### 开发环境搭建 如果计划基于Visual Studio 2015平台结合OpenCV库来进行编程,则需先完成相应IDE版本的安装及第三方依赖项设置过程[^2]。 #### SDK初始化调用 利用官方提供的软件开发工具包(SDK),可以实现对相机的各项功能控制,比如调整曝光时间、增益系数等参数设定。通常情况下,开发者会参照随附文档中的API手册来编写应用程序逻辑部分[^3]。 ```cpp // C++ 示例代码片段展示如何打开摄像头并抓取一帧画面 #include "daheng_camera_sdk.h" int main() { CameraPtr pCam; try { // 初始化相机实例对象 pCam = Camera::GetInstance(); // 打开指定索引位置处的目标设备 pCam->OpenDeviceByIndex(0); // 设置某些必要的属性值... pCam->SetProperty("ExposureTime", 1000); // 千分之一秒 // 获取单张静态照片作为测试样本输出 Image image = pCam->GrabOneImage(); // 关闭资源释放句柄 pCam->CloseDevice(); } catch (...) { std::cerr << "Error occurred during camera operation." << std::endl; } return 0; } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值