Operator CreateBlankImage

Operator Library: Synchronization

此運算子會產生一個具有指定寬度和高度的空白二進位影像。 此運算子不需要任何輸入連結。 輸出影像的寬度和高度是透過參數 ImageWidth和ImageHeight 來指定。

該處理器將以最高可能的速度輸出空白影像。 因此,輸出速度僅受限於輸出鏈路的並行度以及後續的處理器。 若後續處理器無法 處理由CreateBlankImage 產生的資料傳輸速率,則VisualApplets 的流量控制機制將限制頻寬。

通常,此運算子用於測試實作的功能,而無需連接攝影機。 使用諸如 Coordinate_x、 Coordinate_y 以及 ImageNumber,此運算子可用於產生測試圖案。 配合運算子 ImageValve ,可控制幀率、行率或像素率。

僅當影像擷取程序未執行(即已停止)時,才能變更所產生影像的尺寸。

若為 1D 應用,則會忽略ImageHeight參數。 若為 0D 應用,則會忽略ImageWidth和ImageHeight兩者。

此運算子可輕鬆與「VisualApplets 」模擬功能搭配使用。 此運算子會自行產生模擬影像。 它作為模擬來源運作。 因此,無需在該運算子的輸出鏈路上新增模擬來源探針。

[注意] 模擬過程中的行為

該運算子在每個模擬步驟中至少輸出一個資料集。視 輸出埠當前的鏈路配置而定,此資料集為

  • 0D 模式下的一系列像素。像素數量透過參數PixelsToSimulate進行控制
  • 一維模式下的一系列線段。線段的數量透過參數LinesToSimulate進行控制
  • 2D 模式下的一系列幀。幀數透過參數FramesToSimulate進行控制

這些參數的預設值為 1。根據輸出埠當前的連結設定,僅有相關的 參數可供編輯,其餘參數則處於非活動狀態。例如,在 0D 模式下,僅有PixelsToSimulate可供編輯;而在 1D 模式下,則可編輯 LinesToSimulate與ImageWidth這兩項參數。

當在擷取過程中變更ImageHeight 或ImageWidth參數時,系統會確保影像的完整性。 在完成當前畫格的輸出後,系統將開始採用新的參數值。

I/O Properties

Property Value
Operator Type M
Output Link O,資料輸出

Supported Link Format

Link Parameter Output Link O
Bit Width 1
Arithmetic 無號數
Parallelism any
Kernel Columns 1
Kernel Rows 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format VAF_GRAY
Color Flavor FL_NONE
Max. Img Width any
Max. Img Height any

Parameters

ImageWidth
Type 動態/靜態讀寫參數
Default 1024
Range [0, 最大輸出影像寬度], 步長 = 輸出並行度

指定所產生影像的寬度。 僅當運算子的輸出影像協定設定為 VALT_IMAGE2D 或 VALT_LINE1D 時,此參數才會啟用。

ImageHeight
Type 動態/靜態讀寫參數
Default 1024
Range [1, 最大輸出影像高度]

指定所產生影像的高度。 僅當運算子的輸出影像協定設定為 VALT_IMAGE2D 時,此參數才會啟用。

待模擬的幀數
Type 靜態寫入參數
Default 1
Range [1, 2³² - 1]

若輸出連結影像協定設定為 VALT_IMAGE2D, 此參數用於指定單一模擬步驟所產生的幀數。 有關 2D 模擬的更多資訊,請參閱「模擬」。 此參數僅在輸出影像協定設定為 VALT_IMAGE2D 時,方可進行變更。

待模擬的線段數
Type 靜態寫入參數
Default 1
Range [1, 2³² - 1]

若輸出連結影像協定設定為 VALT_LINE1D, 則必須指定模擬所需的行數。 此參數用於指定模擬影像的高度。 有關 1D 模擬的更多資訊,請參閱「模擬」。 僅當輸出影像協定設定為 VALT_LINE1D 時,才可變更此參數。

需模擬的像素數
Type 靜態寫入參數
Default 1
Range [1, 2^32 - 1],步長 = 輸出並行度

若輸出連結影像協定設定為 VALT_PIXEL0D, 則必須指定模擬所需的像素流大小。 此參數用於指定模擬像素流的寬度。 有關 0D 模擬的更多資訊,請參閱「模擬」。 此參數僅在輸出影像協定設定為 VALT_LINE0D 時,方可進行變更。

Examples of Use

以下範例展示了運算子 `CreateBlankImage ` 的用法: