Operator ImageSequence

Operator Library: Memory

硬體平台的可用性
請注意,此 operator 僅適用於 microEnable 4 系列(包含 PixelPlant)的目標平台。

此運算子的主要特點是會緩衝一連串 SequenceLength 個連續的輸入影像。 此序列將會同時輸出。 此外,還包含了感興趣區域 (ROI) 功能。

此運算子會在 Frame Grabber RAM (DRAM) 中緩衝影像串流。 需要一個類型為 RAM 的 VisualApplets 資源 (請參閱 'Allocation of Device Resources')。

有關 operator 延遲的資訊,請參閱 表 46「Library Memory 中各 operator 的個別延遲」。

影像序列的同时输出是通过使用一个包含 SequenceLength 列的 kernel 来执行的。 每个 kernel 组件代表序列中的一张影像,即对应于影像序列编号。 例如,當序列長度為三時,輸入影像 0 將輸出於 kernel 索引 0,影像 1 輸出於 kernel 索引 1,影像 2 輸出於 kernel 索引 2。 接下來,運算子會繼續處理下一個序列,亦即輸入影像 3 將輸出於 kernel 索引 0,以此類推。

此運算子不會改變頻寬。 它保持讀取和寫入的頻寬常數。 然而,輸出影像的幀率為輸入端幀率的 1/SequenceLength。 不過,輸出影像(由於 kernel 的關係)會比單一輸入影像大 N 倍。

此運算子的運作方式如同 FIFO 緩衝區。 一旦緩衝了足夠產生序列的影像,運算子就會輸出該序列。 在此期間,接下來的影像會儲存於緩衝區中。

使用參數 XOffset、XLength、 YOffset 和 YLength 可以定義 ROI 大小。

[警告] 無 Filllevel 與流量控制

此運算子不包含檢查 fill level 的參數,也沒有檢查溢位(overflow)的參數。 此外,也不包含 InfiniteSource 參數。此運算子在其輸入端一律假設為無限來源。 無法檢查運算子是否處於溢位狀態。 請參閱 'Infinite Sources / Connecting Cameras' 以取得更多關於流量控制的資訊。

算子限制

  • 不支援空白畫面。

  • 不支援具有不同行長度的影像。

  • 序列的所有輸入影像必須具有相同的寬度和高度。 否則運算子的行為將未定義。

  • 允許的最小輸入影像寬度為 XOffset + XLength,最小輸入影像高度為 YOffset + YLength。

  • 使用的 RAM 大小是有限的。 此外,由於內部實作,可用緩衝區可能會小於實體空間。 所需的 memory 與最大影像寬度、最大影像高度以及 SequenceLength 有關。 如果最大影像寬度是 2 的冪次方值,memory 的使用效率會更高。 請檢查 Device Resources 以取得更多資訊。

頻寬最佳化

通過使用 Frame Grabber RAM (DRAM) 之運算子的理論頻寬 [位元/秒],是根據下列公式計算:

然而,由於 DRAM 效率的關係,實際頻寬總是小於理論頻寬。

當 Bit Width 和 Parallelism 的乘積等於內部 RAM Port Width 時,即達到通過運算子的 maximum bandwidth。

[備註] 平台特定值

RAM Port Width 和 System Clock 是平台特定的。有關您個別平台的詳細資訊,請參閱 Device Resources。

I/O Properties

Property Value
Operator Type M
Input Link I,影像資料輸入
Output Link O,資料輸入

支援的 Link 格式

Link Parameter Input Link I Output Link O
Bit Width [1, 64]12 as I
Arithmetic {unsigned, signed} as I
Parallelism any3 as I
Kernel Columns 1 SequenceLength as I
Kernel Rows 1 as I
Img Protocol VALT_IMAGE2D as I
Color Format any as I
Color Flavor any as I
Max. Img Width 65535 as I
Max. Img Height any as I

1

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

2 3

Bit width 與 Parallelism 的乘積不得超過原生 RAM 資料寬度。 請查看 Device Resources 以取得更多資訊。

參數

SequenceLength
Type static parameter
Default 2
Range [2, 視 RAM 大小而定]

此參數定義要串連成序列的影像數量。 參數 SequenceLength 的值定義了 kernel 的欄數。

XOffset
Type dynamic/static read/write parameter
Default 0
Range [0, Max.Img Width - XLength]

此參數定義 ROI 左上角的 x 座標。

步進大小即為 Parallelism。

XLength
Type dynamic/static read/write parameter
Default 1024
Range [2*Parallelism, Max.Img Width - XOffset]

此參數定義 ROI 的寬度。

步進大小即為 Parallelism。

YOffset
Type dynamic/static read/write parameter
Default 0
Range [0, Max.Img Height - YLength]

此參數定義 ROI 左上角的 y 座標。

YLength
Type dynamic/static read/write parameter
Default 1024
Range [2, Max.Img Height - YOffset]

此參數定義 ROI 的高度。