安裝控件
該控件工具是基於邁德威視相機 SDK 開發的，可兼容邁德威視所有型號的相機，包括 USB2.0 和 USB3.0 以及 GigE 和智能相機，安裝控件前，需要先安裝邁德威視標準的相機安裝包(MindVision Camera PlatformSetup(x.x.x.x))，然後手動複製以下幾個文件進行 VisionPro 的控件安裝。（注意：該控件基於 VisionPro8.3 版本開發，其他版本的 visionpro 可能存在不兼容的問題，如需幫助請聯繫我司技術支持人員）：
1. MindvisionCameraTool.dll，複製到康耐視的安裝路徑 Cognex\VisionPro\bin 下。
2. MindvisionCameraTool.ico，複製到康耐視的安裝路徑 Cognex\VisionPro\bin 下。
3. MindvisionCameraTool.vtt，複製到康耐視的安裝路徑 Cognex\VisionPro\bin\Templates\Tools 下。
使用控件
加載工具
完成控件的安裝後，打開 VisionPro QuickBuild，進入作業編輯器，如下圖所示，點擊工具列表按鈕後，可以在彈出的列表框裡看到 MindvisionCameraTool 工具了。拖動工具即可加入的規則列表中
工具功能介紹
1. 控件工具可以有 3 種方式初始化相機，具體方式，由輸入型參數 InitMethod 決定，InitMethod 為 int32 類型，具體功能如下：
⚫ InitMethod 為 0 時（默認），初始化找到的第一個相機。
⚫ InitMethod 為 1 時，按照 CameraName 參數指定的名字初始化相機。
⚫ InitMethod 為 2 時，按照 CameraSn 指定的序列號初始化相機。
2. 控件工具的輸出參數有 3 個，分別是 CameraHandle，OutputImageGrey8 和 OutputImageRgb24 ，3 個
參數的作用如下
⚫ CameraHandle,相機初始化後的句柄。有多個相機時，句柄各不一樣。只讀型變量，不要手動給它賦值，
否則會引起錯誤。未連接相機時，該變量為 0 ，連接成功後，該變量為大於 0 的整數。
⚫ OutputImageGrey8,為康耐視的 8 位灰度格式的圖像，該工具每運行一次，成功採集的到圖像後，
OutputImageGrey8 會自動更新。
⚫ OutputImageRgb24，為康耐視的 24 位彩色格式的圖像，該工具每運行一次，成功採集得到圖像後，OutputImageGrey8 會自動更新。
注意，如果使用邁德威視黑白相機時，請使用 OutputImageGrey8， 只有 OutputImageGrey8 會更
新圖像， OutputImageRgb24 會 始終為空 ； 反之如果 時 使 用 邁德威視 彩 色 相 機 時 ， 請 使 用
OutputImageRgb24，只有 OutputImageRgb24 會更新圖像，OutputImageGrey8 會始終為空。
如下圖所示，請根據使用的相機，選擇合適的圖像輸出。
3. 控件工具的輸入參數解釋
圖 4 控件中的輸入參數(AnalogGain、AutoExposure 等)，是和圖 5 界面上的操作對應的，具體意義如下：
⚫ AnalogGain，int32 類型，模擬增益。對應於圖 5 中的”增益”參數。調節增益可以改變相機亮度，但是增益越大，噪聲會越大。增益的調節不影響幀率。
⚫ AutoExposure ，bool 類型，對應圖 5 中，曝光設置下的模式，自動和手動。為 true 時，使能自動曝光模式，AnalogGain 和 ExposureTime 會根據環境亮度自動調整；為 false 時，禁止自動曝光，由用戶輸入的 AnalogGain 和 ExposureTime 決定相機圖像亮度。默認為 false，即手動設置曝光模式。
⚫ CameraName，string 類型，指示相機名稱，可讀寫，如果要按名稱初始化指定的相機，必須事先改賦值，否則會導致初始化失敗；如果不是按名稱初始化相機，則該變量不需要賦值，相機初始化後，
該變量會顯示相機的名稱。對應圖 5 中的相機列表裡的相機名。
⚫ CameraSn，string 類型，指示相機序列號，可讀寫，如果要按序列號初始化指定的相機，必須事先改改變量賦值，否則會導致初始化失敗；如果不是按序列號初始化相機，則該變量不需要賦值，相機初始化後，該變量會顯示相機的序列號。在圖 5 中沒有體現出來。
⚫ CameraTriggerMode，int32 類型，對應圖 5 中的採集模式。為 0 時，相機處於連續採集模式，無論該工具是否被執行，會在後臺一直採集並更新圖像；為 1 時，為軟觸發採圖模式，只有該工具在執行一次的時候，才會去給相機發指令，重新採集一張圖像；為 2 時，為硬觸發採圖模式
⚫ ExposureTime，double 類型，相機的曝光時間，對圖 5 中的“曝光時間”，單位為微秒，支持小數。曝光時間越大，相機圖像亮度越高，反之越暗。注意，曝光時間越大，如果時拍運動物體，會有嚴重的拖影，並且曝光時間和幀率成反比，曝光時間越長，幀率越低，採集圖像需要的時間越長。
⚫ InitMethod , int32 類型，相機初始化的方式。默認為 0 。表示自動初始化掃描到的第一個相機。為 1時，按照 CameraName 指定的相機名進行初始化；為 2 時按照 CameraSn 指定的序列號進行初始化。
⚫ OutputIo0Mode，int32 類型，默認為 0，該值可以設定 6pin 航空接頭上閃光燈 IO 的模式，為 0 時，設置該 IO 用作閃光燈，STR+和 STR-功能；為 1 時，設置該 IO 為 OUTPUT0 的 GPIO 模式。
⚫ OutpuIo0State，int32 類型，默認為 0。只有當 OutputIo0Mode 為 1 時，可以通過 OutpuIo0State
來設置 OUTPUT0 這個 GPIO 的輸出狀態。0，和 1 分別表示關閉和導通 STR+ 、STR-的功能。
採集圖像
黑白相機，採集的圖像會在 OutputImageGrey8 裡更新，如圖 6 所示:
彩色相機，採集的圖像，會在 OutputImageRgb24 裡更新，如圖 7 所示。
參數存檔說明
工具自帶的輸入型參數如下圖所示：
⚫ 參與序工具列化保存的參數有OutIO0State 、OutIO0Mode。
⚫ 其餘參數均不參與序列化保存，而是通過我們SDK自動保存在電腦上的配置文件，會自動記錄上一次關閉相機時的參數。
該工具是基於我們相機 SDK 開發的，所以，相機的配置參數，是可以通過其它軟件來調整，調整以後保存，再用 Visionpro 裡的 mindvision 工具打開相機後，會自動加載修改過的參數，參數配置文件在邁德威視軟件的安裝路徑下的 Camera/Configs 文件夾裡，如下圖所示：
可以通過桌面上的演示軟件，來調整相機的各種參數，包括圖像尺寸、曝光、增益、gamma、對比度等等。
同時使用 2 個相機的配置方法
如果要同時使用 2 個或者 2 個以上的相機進行工作，為了易於區分，建立固定的對應關係，我們建議使用相機的自定義名稱或者序列號來進行綁定操作。
使用自定義相機名稱來綁定和初始化相機
首先，使用我們自帶的演示軟件，修改相機名字。按以下流程進行：
1. 打開演示軟件，可以掃描到多個相機。
2. 分別打開每個相機，在彈出的界面中，對著圖像區域點鼠標右鍵，選擇 相機配置，如圖 11 所示：
3. 在設備信息欄目下，修改相機自定義名稱。
4. 修改後，相機需要重新上電後新的自定義名稱才能生效。自定義名稱是寫入相機內部的，設置成功後，該相機無論接到哪個電腦上，名字都會是設定好的自定義名稱。
5. 關閉我們的演示軟件，打開 visionpro 的 QuickBuild，然後進行如下設置：
6. 在 CogToolBlock1 中新增 2 個 int32 類型的參數，起名為 InitMethod1 和 InitMethod2，都賦值為 1，表示按名稱進行初始化，再新增 2 個 string 參數，起名為 Name1 和 Name2,分別賦值為 Camera1 和 Camera2(請將 Camera1 和 Camera2 替換為您自己設定的相機名)。然後分別進行數據連接操作，如圖 14 所示：
7. 經過以上步驟，就成功的建立了相機的唯一對應關係，不受相機上電順序以及端口的影響而改變。兩個相機可同時工作，界面如下圖所示：
使用序列號來綁定和初始化相機
相機的序列號是唯一的，並且是不可以修改的，可以通過我們提供的工具事先讀出來，再進行綁定操作。
1. 使用下圖中的工具，得到相機的序列號。
2. 關閉我們的演示軟件，打開 visionpro 的 QuickBuild，然後圖 13 中一樣的設置。
3. 在 CogToolBlock1 中新增 2 個 int32 類型的參數，起名為 InitMethod1 和 InitMethod2，都賦值為 2，表示按名稱進行初始化，再新增 2 個 string 參數，起名為 Sn1 和 Sn2,分別賦值為 xxxxx 和 yyyyy(請將 xxxxx 和yyyyy 替換為您使用的 2 個相機的實際的序列號)。然後分別進行數據連接操作，如圖 17 所示，至此就完成了按序列號初始化指定相機的操作。
問題與反饋
目前，該工具只加入了部分相機參數，並沒有把所有可調節的參數映射到工具的輸入參數上，其它參數的調節，需要通過我們的演示軟件進行，調節後再保存。如果需要新增某參數到該工具裡直接調節，可以聯繫我們的技術支持進行修改。
