Image Loading vTool#

透過 Image Loading vTool，您可以從磁碟載入影像檔案，並將其作為其他 vTool 的輸入。

Image Loading vTool 會透過其 output pins 輸出有關已載入影像的資訊。

下載 pylon Software Suite 即可使用 Image Loading vTool。

運作原理#

透過此 vTool，您可以指定電腦上包含影像檔案的目錄。

根據設定，該目錄中的部分或所有影像檔案將會被載入，並透過 Image output pin 輸出。

您還可以指定輸出影像的頻率（即幀率）和順序，使 vTool 的運作方式基本上如同相機裝置。

支援的檔案類型#

BMP
JPG
PNG
TIF

設定 vTool#

若要設定 Image Loading vTool：

在 vTool Settings 區域的 Recipe Management 窗格中，按一下 Open Settings 或按兩下該 vTool。
隨即會開啟 Image Loading 對話方塊。
在 Source 區域中，輸入包含您影像檔案的目錄路徑。或者，按一下 … 按鈕來瀏覽檔案。
vTool 將會搜尋所有 supported file types 的影像。子目錄將會被忽略。

資訊

您也可以指定包含檔案名稱的完整路徑，例如 c:\images\test.png。

這可讓您載入單一影像。請注意，這只有在文字方塊中輸入完整路徑時才可行，使用 … 按鈕則無法做到。
在 Settings 區域中，依需求指定下列設定：
- Sort by: 指定是否要依字母順序（A-Z 或 Z-A）或隨機順序載入目錄中的影像。
- Number of images: 要載入的影像數量。最大數量為 99999999 張影像。
  根據預設，vTool 會載入目錄中找到的所有影像。如果您變更此設定，則只會輸出依字母順序排列的前 n 張影像（或隨機選擇的 n 張影像）。
- Frames per second: 在配方執行時每秒輸出的影像數量。最大數量為每秒 500 幀。
- Number of runs： 指定影像輸出的重複次數。例如，如果您的目錄包含 10 張影像且您將執行次數設為 3，則 vTool 將輸出 30 張影像。數值範圍為 1–999999999。
- Run continuously while recipe is running： 若選取此項，影像輸出將無限期重複。Number of runs 選項將無法使用。
- Save absolute image source path： 若選取此項，資料夾路徑將會以絕對路徑儲存於 recipe 中。
在 Output 區域中，檢查顯示的資訊並確保設定符合您的需求。

範例#

假設指定的目錄包含三個影像檔案：

bar.bmp
baz.png
foo.jpg

您指定了以下設定：

Sort by： Z-A
Number of images： 2
Frames per second： 1
Number of runs： 5
Run continuously while recipe is running： False

現在，在 recipe 執行時，vTool 會每秒輸出一個影像，在 baz.png 和 foo.jpg 之間交替，並在 10 張影像（2 張影像 x 5 次執行）後停止。

Outputs#

Image#

傳回載入的影像。輸出影像可供任何接受影像作為輸入的 vTool 使用。

資料類型：Image
影像格式：彩色或單色影像（根據輸入影像而定）

ImagePath#

傳回目前輸出影像的完整路徑，包含檔名。

資料類型：String

RunCount#

傳回目前的執行次數。例如，如果 vTool 目前是第三次輸出影像，則 RunCount 會傳回 3。數值範圍為 1 到 2⁶⁴ - 1。達到最大執行次數時，計數會從 1 重新開始。

Data type: Integer