Operator Histogram

Operator Library: Accumulator

此運算子會根據輸入影像I計算 亮度直方圖,並將結果輸出至 O。視 AutoSync參數的選項而定,直方圖會針對每 一行或每幀進行計算。 輸出並非結果的可視化呈現,而是一組 直方圖數值的清單。

  • AutoSync= EoF 會針對整個 幀產生高度為 1 的直方圖影像。
  • AutoSync= EoL 會產生與輸入影像高度相同的直方圖影像,也就是說, 會針對每條輸入影像行分別計算直方圖。

直方圖本身由 2^(InputBitWidth) 個元素組成。每個 元素代表各色調值的像素數。直方圖 輸出中的第一個像素,代表色調值為零的像素數。

直方圖 運算子會使用內部記憶體來儲存直方圖的中間結果。每當該 運算子處於忙碌狀態時,輸入便會被阻塞,以防止新資料送入。以下 情況會導致輸入被阻塞:

  • 輸入幀或輸入行的處理: 在處理輸入 幀或輸入行時,該裝置會將中間 直方圖結果儲存於其內部記憶體中。當輸入幀 (AutoSync= EoF)或輸入行 (AutoSync = EoL)處理完畢時,便會讀取內部 記憶體將被讀取以取得最終的直方圖資料。在讀出階段, 輸入訊號將被阻斷。因此,小型輸入影像以及基於單線的直方圖 輸出(AutoSync= EoL)會顯著降低 輸入頻寬。

  • 系統啟動或重置後的初始化: 在系統 啟動或重置後,內部記憶體將被初始化為全零。 在此初始化過程中,操作員處於忙碌狀態,且輸入功能 將被暫停,以確保不會接收任何新資料。

I/O Properties

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

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 16] auto1
Arithmetic 無號數 as I
Parallelism any as I
Kernel Columns 1 as I
Kernel Rows 1 as I
Img Protocol VALT_IMAGE2D as I
Color Format VAF_GRAY as I
Color Flavor FL_NONE as I
Max. Img Width any auto2
Max. Img Height any auto3

1

輸出位元寬度取決於「最大影像尺寸」連結的屬性 以及「AutoSync」參數的設定。

當 AutoSync = EoF 時,輸出位元寬度為

當 AutoSync = EoL 時,輸出位元寬度為

輸出 Bit Width 不得超過 64 Bit。

2

輸出影像的寬度由輸入位元寬度決定。輸入影像中每個 可能的像素值,皆由 輸出影像的像素所呈現。

3

當參數 AutoSync = EoF 時,輸出影像的高度為 1。當 參數 AutoSync = EoL 時,輸出影像的高度等於輸入 影像的高度。

Parameters

自動同步
Type 靜態參數
Default EoL
Range {EoL, EoF}

此參數用於選擇是否每行輸出直方圖(設定 EoL),或是每幀輸出直方圖(設定 EoF)。請注意此參數對輸出 位元寬度的影響。輸出位元寬度不得超過 64 位元。

Examples of Use

The use of operator Histogram is shown in the following examples: