Painter vTool#
Painter vTool 透過 Image 輸入接腳接收影像，並透過 Data 輸入接腳接收用於繪製的資料。這些資料由其他 vTool（例如 Texts 或 Regions）的輸出接腳資料所定義。vTool 透過 Image 輸出接腳輸出已繪製資料的影像。
下載 pylon Software Suite 以使用 Painter vTool。
運作原理#
將要新增至影像的 vTool 輸出接腳連線至 Painter vTool 的其中一個 Data 輸入接腳（例如 Barcode Reader vTool 的 Texts 輸出接腳）。您可以透過 Num Input Data Pins 參數根據需要指定 Data 輸入接腳的數量。
Painter vTool 會將以下資料繪製到影像中：
- 幾何形狀：矩形、圓形、橢圓形、線條、點和區域
- 文字：字串、整數、浮點數和布林值。選用性地，也可以繪製幾何資料、影像和轉換資料的文字表示形式。
也支援這些類型的陣列。幾何陣列會逐個元素進行繪製。除非提供相應的座標陣列，否則字串、數字或布林值的陣列將合併為一個文字區塊。
使用 Input Data Pin Selector 參數來選取要設定的 Data 接腳。繪製、顏色和文字放置均以每個接腳進行設定。如需更多詳細資料，請參閱下方的 Configuration Settings。
您可以在配方執行時使用 Features - All 窗格來測試設定。
組態設定#
- Num Input Data Pins： 指定 vTool 提供多少個 Data 輸入接腳。您最多可以新增 100 個接腳。配方執行時無法變更此參數。
- Input Data Pin Selector： 設定您要設定其設定的 Data 接腳。下方的參數適用於所選接腳，但適用於整個 vTool 的 Output Pixel Format 除外。
- Pin Description： 所選接腳的選用註解，例如用於記錄連線內容。此值僅供使用者參考，不用於繪製。
- Draw Enable： 啟用或停用所選接腳的繪製功能。
- Draw Outline Enable： 啟用或停用所選接腳上矩形、圓形、橢圓形和區域邊界框的外框繪製。
- Draw Center Enable： 啟用或停用在所選接腳上繪製矩形、圓形、橢圓形和區域邊界框的中心標記。
- ToString Enable： 啟用或停用在所選接腳上繪製幾何資料、影像和轉換資料的文字表示形式。無論此設定為何，字串、整數、浮點數和布林值始終會以文字形式繪製。
- Pen Color Red / Green / Blue / Alpha： 用於所選接腳上外框、Fill、中心標記和文字的顏色。Alpha 元件在填充區域時使用。
- Pen Width： 繪製線條的寬度。對於點而言，此值也決定所繪製標記的大小。
- Font Size： 在所選接腳上繪製的文字大小。
- Size Offset： 新增至矩形、圓形、橢圓形和區域邊界框大小的偏移量，使繪製的外框不會與興趣區重疊。
- Text Offset X / Text Offset Y： 新增至文字區域原點的偏移量。
- Text Position： 文字區域相對於線條、矩形、圓形、橢圓形或區域邊界框的原點。
- Top Left：文字區域的原點從幾何圖形的左側開始。
- Top Right：文字區域的原點從幾何圖形的右側開始。
- Bottom Left：文字區域的原點從幾何圖形下方的左側開始。
- Bottom Right：文字區域的原點從幾何圖形下方的右側開始。
- Center：文字區域的原點從幾何圖形的中心開始。
- Text Coordinate Data Pin Index：另一個 Data pin 的索引，其幾何圖形用於放置來自所選 pin 的文字。例如，使用此功能可將條碼文字放置在接收於不同 pin 上的區域或矩形旁。索引為 0 會關閉此功能，並使用所選 pin 自己的資料來決定文字位置。
- Text Box Origin： 用於書寫文字的起始角落。
- Top Left：文字書寫從左上角開始。
- Bottom Left：文字書寫從左下角開始。
- Text Format： 定義繪製文字時列印的內容。如果此參數為空，則使用資料的預設表示法。諸如
{Width},{Height},{Center_X},{Radius}的狀態，以及{_Hour_}等預留位置將被替換為資料中的值。如果您將格式從編輯器複製到參數的編輯方塊中，則支援換行字元。如需完整的預留位置清單，請選取 Text Format 並查看 Feature Documentation 窗格。 - Output Pixel Format： 繪製輸出影像的 Pixel Format。輸入影像在繪製前會先轉換為此格式。
- BGR8：彩色輸出影像
- Mono8：單色輸出影像
設定 vTool#
若要設定 Painter vTool，請在 Workbench 中按兩下它。隨即會開啟一個對話方塊，顯示所有可用的設定。或者，您也可以在 Features - All 窗格中找到相同的設定。
您可以在 pin data view 中檢視 Painter vTool 的結果。
Inputs#
Image#
直接接收來自 Camera vTool 或輸出影像之 vTool（例如 Image Format Converter vTool）的影像。
- 資料類型：Image
- 圖像格式：輸入圖像在繪製前會轉換為由 Output Pixel Format 參數（BGR8 或 Mono8）所選取的格式。
Data1#
接受任何可繪製到圖像中的資料類型。額外的 Data 輸入接腳會根據 Num Input Data Pins 參數啟用。
- 資料類型：最初為 Value。一旦建立連線，輸入 pin 就會採用所連線輸出 pin 的資料類型。
Outputs#
Image#
傳回已繪製附加內容的圖像。
- 資料類型：Image
- 圖像格式：BGR8 或 Mono8，取決於 Output Pixel Format 參數。
相關 vTools#
典型前置項目#
典型後續元件#
- 任何接受 Image 資料類型輸入的 vTool。