Operator CreateBlankImage

Operator Library: Synchronization

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

該算子將以可能的最大速度輸出空白影像。 因此，輸出速度僅受限於輸出連接 Parallelism 以及後續算子。 如果後續算子無法處理 CreateBlankImage 所產生的資料速率，VisualApplets 流量控制將會限制頻寬。

通常，此算子用於測試實作的功能，而無需連接相機。 透過使用諸如 Coordinate_x、 Coordinate_y 和 ImageNumber 等算子，該算子可用於產生 Test Patterns。 結合算子 ImageValve，可以控制影格率、行率或像素率。

所產生影像的影像尺寸只能在未執行擷取（即停止）時進行變更。

在 1D 應用程式的情況下，會忽略 ImageHeight 參數。 在 0D 應用程式的情況下，ImageWidth 和 ImageHeight 皆會被忽略。

該算子可以輕鬆搭配 VisualApplets 模擬使用。 該算子本身會產生模擬影像。 它作為模擬來源運作。 因此，不需要在算子的輸出連接上新增模擬來源探針。

[備註] 模擬期間的行為

每個模擬步驟中，算子至少會輸出一個資料集。根據輸出連接埠目前的連接組態， 此資料集為

  • 0D 模式下的一系列像素。像素數量透過參數 PixelsToSimulate 控制
  • 1D 模式下的一系列行。行數透過參數 LinesToSimulate 控制
  • 2D 模式下的一系列影格。影格數透過參數 FramesToSimulate 控制

這些參數的預設值為 1。根據輸出連接埠目前的連接組態，僅有相關的 參數可編輯，其他則為非使用中。亦即，對於 0D，僅 PixelsToSimulate 可編輯，而對於 1D，參數 LinesToSimulate 和 ImageWidth 可編輯。

當在擷取過程中變更參數 ImageHeight 或 ImageWidth 時，算子可保證影像完整性。 在完成目前影格輸出後，算子將開始使用新的參數值。

I/O Properties

Property Value
Operator Type M
Output Link O, data output

支援的 Link 格式

Link Parameter Output Link O
Bit Width 1
Arithmetic unsigned
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

參數

ImageWidth
Type dynamic/static read/write parameter
Default 1024
Range [0, 最大輸出影像寬度]，步長 = 輸出 Parallelism

指定所產生影像的寬度。 只有在算子的輸出影像協定設為 VALT_IMAGE2D 或 VALT_LINE1D 時，此參數才會啟用。

ImageHeight
Type dynamic/static read/write parameter
Default 1024
Range [1, Maximum Output Image Height]

指定所產生影像的高度。 只有在算子的輸出影像協定設為 VALT_IMAGE2D 時，此參數才會啟用。

FramesToSimulate
Type 靜態寫入參數
Default 1
Range [1, 2^32 - 1]

如果輸出連接影像協定設為 VALT_IMAGE2D， 此參數會指定為單一模擬步驟所產生的影格數。 有關 2D 模擬的更多資訊，請參閱 'Simulation'。 只有在輸出影像協定設為 VALT_IMAGE2D 時，才能變更此參數。

LinesToSimulate
Type 靜態寫入參數
Default 1
Range [1, 2^32 - 1]

如果輸出連接影像協定設為 VALT_LINE1D， 則必須指定模擬的行數。 此參數用於指定模擬影像高度。 有關 1D 模擬的更多資訊，請參閱 'Simulation'。 只有在輸出影像協定設為 VALT_LINE1D 時，才能變更此參數。

PixelsToSimulate
Type 靜態寫入參數
Default 1
Range [1, 2^32 - 1]，步長 = 輸出 Parallelism

如果輸出連接影像協定設為 VALT_PIXEL0D， 則必須指定模擬的像素串流大小。 此參數用於指定模擬像素串流寬度。 有關 0D 模擬的更多資訊，請參閱 'Simulation'。 只有在輸出影像協定設為 VALT_LINE0D 時，才能變更此參數。

使用範例

以下範例顯示了算子 CreateBlankImage 的使用方式：

  上一頁     上一層     下一頁  
內容 頂端 首頁