ParametrizeCamera_LineScanIOSettings.cpp

线阵相机IO设置

该示例程序演示如何通过 MV_CC_SetEnumValue() 配置线阵相机帧触发和行触发相关节点IO。

/*
* 这个示例演示了线阵相机帧触发和行触发相关节点IO的配置,部分节点的设置需要搭配采集卡和设备的ScanMode。
* This sample shows how to modify FrameBurstStart and LineStart mode of the linear camera.
*/


#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <pthread.h>
#include <string.h>
#include "MvCameraControl.h"

bool g_bExit = false;

bool CheckFeatureNodeAccess(void* hHandle, const char* pNodeName);

// ch:等待按键输入 | en:Wait for key press
void PressEnterToExit(void)
{
    int c;
    while ( (c = getchar()) != '\n' && c != EOF );
    fprintf( stderr, "\nPress enter to exit.\n");
    while( getchar() != '\n');
}

bool PrintDeviceInfo(MV_CC_DEVICE_INFO* pstMVDevInfo)
{
    if (NULL == pstMVDevInfo)
    {
        printf("The Pointer of pstMVDevInfo is NULL!\n");
        return false;
    }
    if (pstMVDevInfo->nTLayerType == MV_GIGE_DEVICE)
    {
        int nIp1 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0xff000000) >> 24);
        int nIp2 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x00ff0000) >> 16);
        int nIp3 = ((pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x0000ff00) >> 8);
        int nIp4 = (pstMVDevInfo->SpecialInfo.stGigEInfo.nCurrentIp & 0x000000ff);

        // ch:打印当前相机ip和用户自定义名字 | en:print current ip and user defined name
        printf("CurrentIp: %d.%d.%d.%d\n" , nIp1, nIp2, nIp3, nIp4);
        printf("UserDefinedName: %s\n\n" , pstMVDevInfo->SpecialInfo.stGigEInfo.chUserDefinedName);
    }
    else if (pstMVDevInfo->nTLayerType == MV_USB_DEVICE)
    {
        printf("UserDefinedName: %s\n", pstMVDevInfo->SpecialInfo.stUsb3VInfo.chUserDefinedName);
        printf("Serial Number: %s\n", pstMVDevInfo->SpecialInfo.stUsb3VInfo.chSerialNumber);
        printf("Device Number: %d\n\n", pstMVDevInfo->SpecialInfo.stUsb3VInfo.nDeviceNumber);
    }
    else if (pstMVDevInfo->nTLayerType == MV_GENTL_GIGE_DEVICE)
    {
        printf("UserDefinedName: %s\n", pstMVDevInfo->SpecialInfo.stGigEInfo.chUserDefinedName);
        printf("Serial Number: %s\n", pstMVDevInfo->SpecialInfo.stGigEInfo.chSerialNumber);
        printf("Model Name: %s\n\n", pstMVDevInfo->SpecialInfo.stGigEInfo.chModelName);
    }
    else if (pstMVDevInfo->nTLayerType == MV_GENTL_CAMERALINK_DEVICE)
    {
        printf("UserDefinedName: %s\n", pstMVDevInfo->SpecialInfo.stCMLInfo.chUserDefinedName);
        printf("Serial Number: %s\n", pstMVDevInfo->SpecialInfo.stCMLInfo.chSerialNumber);
        printf("Model Name: %s\n\n", pstMVDevInfo->SpecialInfo.stCMLInfo.chModelName);
    }
    else if (pstMVDevInfo->nTLayerType == MV_GENTL_CXP_DEVICE)
    {
        printf("UserDefinedName: %s\n", pstMVDevInfo->SpecialInfo.stCXPInfo.chUserDefinedName);
        printf("Serial Number: %s\n", pstMVDevInfo->SpecialInfo.stCXPInfo.chSerialNumber);
        printf("Model Name: %s\n\n", pstMVDevInfo->SpecialInfo.stCXPInfo.chModelName);
    }
    else if (pstMVDevInfo->nTLayerType == MV_GENTL_XOF_DEVICE)
    {
        printf("UserDefinedName: %s\n", pstMVDevInfo->SpecialInfo.stXoFInfo.chUserDefinedName);
        printf("Serial Number: %s\n", pstMVDevInfo->SpecialInfo.stXoFInfo.chSerialNumber);
        printf("Model Name: %s\n\n", pstMVDevInfo->SpecialInfo.stXoFInfo.chModelName);
    }
    else
    {
        printf("Not support.\n");
    }

    return true;
}


void __stdcall ImageCallbackEx2(MV_FRAME_OUT* pstFrame, void *pUser, bool bAutoFree)
{
    if (pstFrame)
    {
        printf("Get One Frame: Width[%d], Height[%d], nFrameNum[%d]\n", 
            pstFrame->stFrameInfo.nExtendWidth, pstFrame->stFrameInfo.nExtendHeight, pstFrame->stFrameInfo.nFrameNum);

        if (false == bAutoFree &&
            NULL != pUser) //非自动释放模式，需要手动释放资源
        {
            MV_CC_FreeImageBuffer(pUser, pstFrame);
        }
    }
}

int main()
{
    int nRet = MV_OK;
    void* handle = NULL;

    do 
    {
        // ch:初始化SDK | en:Initialize SDK
        nRet = MV_CC_Initialize();
        if (MV_OK != nRet)
        {
            printf("Initialize SDK fail! nRet [0x%x]\n", nRet);
            break;
        }

        // ch:枚举设备 | en:Enum device
        MV_CC_DEVICE_INFO_LIST stDeviceList;
        memset(&stDeviceList, 0, sizeof(MV_CC_DEVICE_INFO_LIST));
        nRet = MV_CC_EnumDevices(MV_GIGE_DEVICE | MV_USB_DEVICE | MV_GENTL_CAMERALINK_DEVICE | MV_GENTL_CXP_DEVICE | MV_GENTL_XOF_DEVICE, &stDeviceList);
        if (MV_OK != nRet)
        {
            printf("Enum Devices fail! nRet [0x%x]\n", nRet);
            break;
        }

        if (stDeviceList.nDeviceNum > 0)
        {
            for (unsigned int i = 0; i < stDeviceList.nDeviceNum; i++)
            {
                printf("[device %d]:\n", i);
                MV_CC_DEVICE_INFO* pDeviceInfo = stDeviceList.pDeviceInfo[i];
                if (NULL == pDeviceInfo)
                {
                    break;
                } 
                PrintDeviceInfo(pDeviceInfo);            
            }  
        } 
        else
        {
            printf("Find No Devices!\n");
            break;
        }

        printf("Please Input camera index(0-%d):", stDeviceList.nDeviceNum-1);
        unsigned int nIndex = 0;
        scanf("%d", &nIndex);

        if (nIndex >= stDeviceList.nDeviceNum)
        {
            printf("Input error!\n");
            break;
        }

        // ch:选择设备并创建句柄 | en:Select device and create handle
        nRet = MV_CC_CreateHandle(&handle, stDeviceList.pDeviceInfo[nIndex]);
        if (MV_OK != nRet)
        {
            printf("Create Handle fail! nRet [0x%x]\n", nRet);
            break;
        }

        // ch:打开设备 | en:Open device
        nRet = MV_CC_OpenDevice(handle);
        if (MV_OK != nRet)
        {
            printf("Open Device fail! nRet [0x%x]\n", nRet);
            break;
        }

        // ch:̽探测网络最佳包大小(只对GigE相机有效) | en:Detection network optimal package size(It only works for the GigE camera)
        if (stDeviceList.pDeviceInfo[nIndex]->nTLayerType == MV_GIGE_DEVICE)
        {
            int nPacketSize = MV_CC_GetOptimalPacketSize(handle);
            if (nPacketSize > 0)
            {
                nRet = MV_CC_SetIntValueEx(handle,"GevSCPSPacketSize",nPacketSize);
                if(nRet != MV_OK)
                {
                    printf("Warning: Set Packet Size fail nRet [0x%x]!\n", nRet);
                }
            }
            else
            {
                printf("Warning: Get Packet Size fail nRet [0x%x]!\n", nPacketSize);
            }
        }

        printf("Please Input trigger selector index(0-1): 0-FrameTrigger, 1-LineTrigger\n");
        unsigned int nTriggerSelector = 0;
        scanf("%d", &nTriggerSelector);

        if (nTriggerSelector == 0)
        {
            // ch:设置ScanMode为FrameScan| en:Set ScanMode to FrameScan
            nRet = MV_CC_SetEnumValueByString(handle,"ScanMode", "FrameScan");
            if (nRet == MV_OK)
            {
                printf("Set Frame Scan Mode\n");
            }

            // ch: 判断FrameTriggerControl是否可读 | en: Check if FrameTriggerControl is readable
            if (CheckFeatureNodeAccess(handle, "FrameTriggerControl"))
            {
                // ch:设置触发模式为on | en:Set trigger mode as on
                nRet = MV_CC_SetBoolValue(handle, "FrameTriggerMode", true);
                if (MV_OK != nRet)
                {
                    printf("Set Frame Trigger Mode fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置触发源为Line0 | en:Set trigger source as Line0
                nRet = MV_CC_SetEnumValue(handle, "FrameTriggerSource", 0);
                if (MV_OK != nRet)
                {
                    printf("Set Frame Trigger source fail! nRet [0x%x]\n", nRet);
                    break;
                }
            }
            else
            {
                // ch:设置触发选项为FrameBurstStart | en:Set trigger selector as FrameBurstStart
                nRet = MV_CC_SetEnumValue(handle, "TriggerSelector", 6);
                if (MV_OK != nRet)
                {
                    printf("Set Trigger Selector fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置触发模式为on | en:Set trigger mode as on
                nRet = MV_CC_SetEnumValue(handle, "TriggerMode", 1);
                if (MV_OK != nRet)
                {
                    printf("Set Trigger Mode fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置触发源为Line0 | en:Set trigger source as Line0
                nRet = MV_CC_SetEnumValue(handle, "TriggerSource", 0);
                if (MV_OK != nRet)
                {
                    printf("Set Trigger source fail! nRet [0x%x]\n", nRet);
                    break;
                }
            }
        }
        else if (nTriggerSelector == 1)
        {
            // ch: 判断LineTriggerControl是否可读 | en: Check if LineTriggerControl is readable
            if (CheckFeatureNodeAccess(handle, "LineTriggerControl"))
            {
                // ch:设置触发模式为on | en:Set trigger mode as on
                nRet = MV_CC_SetBoolValue(handle, "LineTriggerMode", true);
                if (MV_OK != nRet)
                {
                    printf("Set Line Trigger Mode fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置触发源为EncoderModuleOut | en:Set trigger source as EncoderModuleOut
                nRet = MV_CC_SetEnumValue(handle, "LineTriggerSource", 6);
                if (MV_OK != nRet)
                {
                    printf("Set  Line Trigger source fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置编码器选项为Encoder0 | en:Set encoder selector as Encoder0
                nRet = MV_CC_SetEnumValue(handle, "EncoderSelector", 0);
                if (MV_OK != nRet)
                {
                    printf("Set encoder selector fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置编码器数据源A为Line1 | en:Set encoder source A as Line1
                nRet = MV_CC_SetEnumValue(handle, "EncoderSourceA", 1);
                if (MV_OK != nRet)
                {
                    printf("Set encoder sourceA fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置编码器数据源B为Line3 | en:Set encoder source B as Line3
                nRet = MV_CC_SetEnumValue(handle, "EncoderSourceB", 3);
                if (MV_OK != nRet)
                {
                    printf("Set encoder sourceB fail! nRet [0x%x]\n", nRet);
                    break;
                }
            }
            else
            {
                // ch:设置触发选项为LineStart | en:Set trigger selector as LineStart
                nRet = MV_CC_SetEnumValue(handle, "TriggerSelector", 9);
                if (MV_OK != nRet)
                {
                    printf("Set Trigger Selector fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置触发模式为on | en:Set trigger mode as on
                nRet = MV_CC_SetEnumValue(handle, "TriggerMode", 1);
                if (MV_OK != nRet)
                {
                    printf("Set Trigger Mode fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置触发源为EncoderModuleOut | en:Set trigger source as EncoderModuleOut
                nRet = MV_CC_SetEnumValue(handle, "TriggerSource", 6);
                if (MV_OK != nRet)
                {
                    printf("Set Trigger source fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置编码器选项为Encoder0 | en:Set encoder selector as Encoder0
                nRet = MV_CC_SetEnumValue(handle, "EncoderSelector", 0);
                if (MV_OK != nRet)
                {
                    printf("Set encoder selector fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置编码器数据源A为Line1 | en:Set encoder source A as Line1
                nRet = MV_CC_SetEnumValue(handle, "EncoderSourceA", 1);
                if (MV_OK != nRet)
                {
                    printf("Set encoder sourceA fail! nRet [0x%x]\n", nRet);
                    break;
                }

                // ch:设置编码器数据源B为Line3 | en:Set encoder source B as Line3
                nRet = MV_CC_SetEnumValue(handle, "EncoderSourceB", 3);
                if (MV_OK != nRet)
                {
                    printf("Set encoder sourceB fail! nRet [0x%x]\n", nRet);
                    break;
                }
            }
        }
        else
        {
            printf("Input error!\n");
            break;
        }

        // ch:注册抓图回调 | en:Register image callback
        nRet = MV_CC_RegisterImageCallBackEx2(handle, ImageCallbackEx2, handle, true);
        if (MV_OK != nRet)
        {
            printf("Register Image CallBack fail! nRet [0x%x]\n", nRet);
            break;
        }

        // ch:开始取流 | en:Start grab image
        nRet = MV_CC_StartGrabbing(handle);
        if (MV_OK != nRet)
        {
            printf("Start Grabbing fail! nRet [0x%x]\n", nRet);
            break;
        }

        PressEnterToExit();
        // ch:ֹͣ停止取流 | en:Stop grab image
        nRet = MV_CC_StopGrabbing(handle);
        if (MV_OK != nRet)
        {
            printf("Stop Grabbing fail! nRet [0x%x]\n", nRet);
            break;
        }

        // ch:注销抓图回调 | en:Unregister image callback
        nRet = MV_CC_RegisterImageCallBackEx2(handle, NULL, NULL, true);
        if (MV_OK != nRet)
        {
            printf("Unregister Image CallBack fail! nRet [0x%x]\n", nRet);
            break;
        }

        // ch:关闭设备 | Close device
        nRet = MV_CC_CloseDevice(handle);
        if (MV_OK != nRet)
        {
            printf("ClosDevice fail! nRet [0x%x]\n", nRet);
            break;
        }

        // ch:销毁句柄 | Destroy handle
        nRet = MV_CC_DestroyHandle(handle);
        if (MV_OK != nRet)
        {
            printf("Destroy Handle fail! nRet [0x%x]\n", nRet);
            break;
        }
        handle = NULL;
    } while (0);
 
    if (handle != NULL)
    {
        MV_CC_DestroyHandle(handle);
        handle = NULL;
    }
    

    // ch:反初始化SDK | en:Finalize SDK
    MV_CC_Finalize();

    return 0;
}


//ch: 检查属性节点的访问模式 | en: Check the access mode of the feature node
bool CheckFeatureNodeAccess(void* hHandle, const char* pNodeName)
{
    if (NULL == pNodeName|| NULL == hHandle)
    {
        return false;
    }

    MV_XML_AccessMode nMode;
    unsigned int nRet = MV_XML_GetNodeAccessMode(hHandle, pNodeName, &nMode);
    if (nRet != MV_OK)
    {
        return false;
    }

    if (nMode == AM_WO || nMode == AM_RO || nMode == AM_RW)
    {
        return true;
    }
    else
    {
        return false;
    }
}