Qt之设置BASLER相机参数

一、背景知识

在设置相机参数之前，先要获取相机对象。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);  
}