一、背景知识

在设置相机参数之前，先要获取相机对象。Pylon::CTlFactory 具有一个 CreateDevice() 方法可以用来生成一个相机对象，并返回一个指向 IPylonDevice 的指针。下面的代码用来获取枚举出来的第一个相机对应的对象。

Pylon::CTlFactory& TlFactory = CTlFactory::GetInstance();DeviceInfoList_t lstDevices;TlFactory.EnumerateDevices( lstDevices );IPylonDevice * pDevice;if(!lstDevices.empty()){pDevice = TlFactory.CreateDevice(lstDevices[0]);}

上面的代码还可以简化为：

Pylon::CTlFactory& TlFactory = CTlFactory::GetInstance();IPylonDevice * pDevice = TlFactory.CreateFirstDevice();

上面 CreateFirstDevice 函数是用来生成枚举到的第一个相机的接口。我们知道传输层还分 GigE、USB等许多中，如果我们希望直接生成 GigE 接口的第一个相机接口，可以先获得GigE 传输层的接口，然后调用接口中的CreateFirstDevice函数，具体可以参考下面的代码片段：

Pylon::CTlFactory& TlFactory = CTlFactory::GetInstance();Pylon::IGigETransportLayer* pTl = static_cast<Pylon::IGigETransportLayer*> (TlFactory.CreateTl("BaslerGigE"));IPylonDevice * pDevice = pTl->CreateFirstDevice();

上一篇博客介绍了相机的参数是用 GenApi Node Maps 数据结构来体现的。这个 Node Maps 的接口类型为 GenApi::INodeMap，可以通过 IPylonDevice 的 GetTLNodeMap() 函数和 GetNodeMap() 函数来获得。顾名思义 GetTLNodeMap() 是用来获得传输层参数的，GetNodeMap() 对应的是相机本身的参数。下面是代码示例。

Pylon::CTlFactory& TlFactory = CTlFactory::GetInstance();IPylonDevice * pDevice = TlFactory.CreateFirstDevice();GenApi::INodeMap* NodeMap = pDevice->GetNodeMap();GenApi::INodeMap* TLNodeMap = pDevice->GetTLNodeMap();

那么一个相机都有哪些参数，这些参数的名称是什么呢？这就需要参考 GenICam Standard Feature Naming Convention （SFNC）了。Basler 的 USB3 的相机遵守 SFNC 2.0 标准，GigE 和 Firewire 相机只支持 1.x 版本的 SFNC。SFNC 2.0 和 SFNC 1.x 还是有不少差异的。比如相机的增益，在 SFNC 2.0 标准中是浮点型参量，名称为 “Gain”， 在 1.x 中是整数型参量，名称为 “GainRaw”。下面举个例子，我们要获取 “Gain” 这个参量的范围，并且将这个参量的值设为最大最小值的平均值。那我们的代码可以这样写：

Pylon::CTlFactory& TlFactory = CTlFactory::GetInstance();IPylonDevice * pDevice = TlFactory.CreateFirstDevice();GenApi::INodeMap* NodeMap = pDevice->GetNodeMap();GenApi::INode *pNode = pNodeMap->GetNode("Gain");GenApi::CFloatPtr gain(pNode);float gainMin = gain->GetMin();float gainMax = gain->GetMax();qDebug() << "current gain = " << gain->GetValue();gain->SetValue(gainMin + (gainMax - gainMin) / 2.0);

这里我们要注意几个地方，首先如果我们的相机不支持 Gain 这个参数，那么 pNode 将是空指针。后面的操作就会报错。第二，Gain 这个参数不一定可读可写，如果不可读 gain->GetMin() 就会报错。如果不可写，那么 gain->SetValue() 就会报错。所以我们应该用 GenApi::IsReadable() 和 GenApi::IsWritable() 来测试这个 INode 接口是否可以读写。另外还有一点需要特别注意，相机的参数都是在相机被打开后才可以读写的。如果我们知道相机是哪个传输层的，还可以有更简单的访问方式。比如我们的相机是 GigE 接口的，那么可以从 pDevice 构造一个 CBaslerGigEInstantCamera 对象，然后通过这个对象访问相机的各个属性。比如下面的代码：

Pylon::CTlFactory& TlFactory = CTlFactory::GetInstance();Pylon::IGigETransportLayer* pTl = static_cast<Pylon::IGigETransportLayer*> (TlFactory.CreateTl("BaslerGigE"));IPylonDevice * pDevice = pTl->CreateFirstDevice();CBaslerGigEInstantCamera camera(pDevice);camera.Open();qDebug() << GenApi::IsReadable(camera.GainRaw);qDebug() << "GainRaw = " << camera.GainRaw.GetValue();qDebug() << "GainRaw.GetMax() = " << camera.GainRaw.GetMax();qDebug() << GenApi::IsWritable(camera.GainRaw);camera.GainRaw = camera.GainRaw.GetMax();camera.GainRaw.SetValue(camera.GainRaw.GetMin());camera.Close();

二、具体例子

/*index = 0//设置相机的内触发 = 1//设置相机的外触发 = 2//设置相机的曝光时间 = 3//设置相机的增益 = 4//相机的频率 = 5//图片的宽度 = 6//图片的高度 = 7//灯的触发信号 */ static void SetupCamera( Pylon::CInstantCamera& camera, int index) { int i = 0; try { using namespace GenApi; INodeMap &cameraNodeMap = camera.GetNodeMap(); if(index == 0) { CEnumerationPtr ptrTriggerSel = cameraNodeMap.GetNode ("TriggerSelector"); ptrTriggerSel->FromString("FrameStart"); CEnumerationPtr ptrTrigger = cameraNodeMap.GetNode ("TriggerMode"); ptrTrigger->SetIntValue(0); } else if(index == 1) { CEnumerationPtr ptrTriggerSel = cameraNodeMap.GetNode ("TriggerSelector"); ptrTriggerSel->FromString("FrameStart"); CEnumerationPtr ptrTrigger = cameraNodeMap.GetNode ("TriggerMode"); ptrTrigger->SetIntValue(1); CEnumerationPtr ptrTriggerSource = cameraNodeMap.GetNode ("TriggerSource"); ptrTriggerSource->FromString("Line1"); } else if(index == 2) { const CFloatPtr exposureTime = cameraNodeMap.GetNode("ExposureTimeAbs"); exposureTime->SetValue(theApp.m_iExposeTime); } else if(index == 3) { const CIntegerPtr cameraGen = cameraNodeMap.GetNode("GainRaw"); cameraGen->SetValue(theApp.m_iGain); } else if(index == 4) { const CBooleanPtr frameRate = cameraNodeMap.GetNode("AcquisitionFrameRateEnable"); frameRate->SetValue(TRUE); const CFloatPtr frameRateABS = cameraNodeMap.GetNode("AcquisitionFrameRateAbs"); frameRateABS->SetValue(theApp.m_iHZ); } else if(index == 5) { const CIntegerPtr widthPic = cameraNodeMap.GetNode("Width"); widthPic->SetValue(theApp.m_Width); } else if(index == 6) { const CIntegerPtr heightPic = cameraNodeMap.GetNode("Height"); heightPic->SetValue(theApp.m_Height); } else if(index == 7) { CEnumerationPtr ptrLineSource = cameraNodeMap.GetNode ("LineSource"); ptrLineSource->SetIntValue(2); }