Operator ImageSequence

Library: Memory 運算子

硬體平台的可用性
請注意,此運算子僅適用於 microEnable 4 系列(含 Pixelplant)的目標平台。

此運算子的主要特點在於,它會將一組連續的輸入影像(長度為 SequenceLength)緩衝儲存。 該序列將同時輸出。 此外,此運算子還包含一個感興趣區域(ROI)功能。

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

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

影像序列的同步輸出是透過使用具有SequenceLength列數的核來實現的。 每個核元件代表序列中的一張影像,也就是說,它對應於影像序列的編號。 例如,當序列長度為三時,輸入影像 0 將輸出至核索引 0,影像 1 輸出至核索引 1,影像 2 則輸出至核索引 2。 接著,運算子將繼續處理下一個序列,也就是說,輸入影像 3 將輸出至核索引 0,以此類推。

該運算子不會改變頻寬。 它會讓讀取與寫入的頻寬保持恆定。 然而,輸出影像的幀率為輸入幀率的1/SequenceLength。 不過,輸出影像的尺寸(因核函數之故)比單張輸入影像大 N 倍。

此運算子運作方式類似 FIFO 緩衝區。 一旦緩衝區中儲存的影像數量足夠生成一組影像序列,此運算子便會輸出該序列。 在此期間,後續的影像會儲存至緩衝區中。

透過參數XOffset、XLength、 YOffset及YLength 可定義 ROI 的大小。

[警告] 無液位控制與流量控制

該運算子未包含用於檢查填充程度的參數,亦無用於檢查溢出的參數。 此外,亦未包含 InfiniteSource 參數。該運算子始終假設其輸入為無限來源。 無法檢查該運算子是否處於溢出狀態。 有關流量控制的更多資訊,請參閱「無限來源/連接攝影機」。

Operator Restrictions

  • 不支援空影格。

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

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

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

  • 可用的 RAM 容量受到限制。 此外,由於內部實作的緣故,可用緩衝區的容量可能會小於實際的記憶體空間。 所需記憶體取決於最大影像寬度、最大影像高度以及 SequenceLength。 若最大影像寬度為 2 的冪次方,則可有效利用記憶體。 請檢查 裝置資源 以獲取更多資訊。

頻寬最佳化

流經使用 Frame Grabber RAM (DRAM) 之 operator 的理論頻寬 [bits/second] 是根據下列公式計算:

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

當 Bit Width 與 Parallelism 的乘積等於內部 RAM Port Width 時, 即可達到流經該 operator 的 最大頻寬。

[注意] 平台特定值

RAM Port Width 與 System Clock 因平台而異。如需關於您個人平台的詳細資訊,請參閱 Device Resources。

I/O Properties

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

Supported Link Format

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 序列長度 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 以取得更多資訊。

Parameters

SequenceLength
Type 靜態參數
Default 2
Range [2,取決於 RAM 容量]

此參數用以定義將併合為一序列的影像數量。 參數 SequenceLength 的值用以定義核函數的欄數。

XOffset
Type 動態/靜態讀寫參數
Default 0
Range [0, 最大影像寬度 - XLength]

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

步階大小即為 Parallelism。

XLength
Type 動態/靜態讀寫參數
Default 1024
Range [2*Parallelism, 最大圖像寬度 - XOffset]

此參數定義 ROI 的寬度。

步階大小即為 Parallelism。

YOffset
Type 動態/靜態讀寫參數
Default 0
Range [0, Max.Img Height - YLength]

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

YLength
Type 動態/靜態讀寫參數
Default 1024
Range [2, 最大影像高度 - Y 偏移量]

此參數定義 ROI 的高度。