Operator ImageNumber

Operator Library: Base

運算子 ImageNumber 會提供輸入連結中當前影像在輸出連結中的索引。 因此,輸入端的每個像素都會被替換為該影像的索引,也就是影像編號。 實際的輸入像素值並不會被使用。 此運算子的作用如同一個計數器,每當輸入出現新影像時,該計數器便會遞增一次。 該計數器會在流程開始時(「多重流程」)或達到最大值後被重置。 第一張影像的索引為 0。

計數器的計數範圍可透過變更輸出連結 O 的位元寬度來定義。 若計數器達到最大值,將重新從零開始計數 = 循環條件。 例如,輸出位元寬度為 8 位元時,計數器值將介於 0 至 255 之間。

若使用SingleShot 參數,當發生迴圈溢出時,計數器將不會重置。 計數器數值輸出將維持在最大值。 因此,對於 8 位元影像計數器而言,其計數器數值將維持在最大值 255。

此運算子通常會與運算子 RemoveImage 運算子,以移除序列中的前 N 張圖片。

Operator Restrictions

  • 此運算子支援空白影像。 此運算子會統計這些空白影像的數量。 然而,針對空白影像,輸出端無法提供計數器數值,因為空白幀的輸出內容 不含任何像素。 在接下來的第一個非空白影像之後,輸出連結將提供正確的計數器數值。

I/O Properties

Property Value
Operator Type O
Input Link I,資料輸入
Output Link O,資料輸出

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 64]1 [1, 64]
Arithmetic {unsigned, signed} 無號數
Parallelism any as I
Kernel Columns any 1
Kernel Rows any 1
Img Protocol VALT_IMAGE2D as I
Color Format any VAF_GRAY
Color Flavor any FL_NONE
Max. Img Width any as I
Max. Img Height any as I

1

輸入 Bit Width 的範圍為 [1, 64]。 對於有號輸入,範圍為 [2, 64]。 對於無號彩色輸入,範圍為 [3, 63],而對於有號彩色,範圍則為 [6, 63]。

Parameters

SingleShot
Type 靜態參數
Default OFF
Range {OFF, ON}

此參數用於控制計數器循環條件。 當設定為「OFF」時,計數器將隨著每張處理過的影像無限循環計數, 也就是說,當達到由輸出鏈結位元寬度所定義的最大可能計數器值時,計數器將發生循環。

當設定為「開啟」時,計數器會持續計數,直到達到最大可能值為止。 計數器將在達到最大值時停止計數。

Examples of Use

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