Operator ImageAnalyzer

Operator Library: Debugging

運算子 ImageAnalyzer 可在不觸及影像資料的情況下分析影像 Property。

此運算子會分析單張影像。若要分析影像序列,請使用運算子 ImageStatistics。

運算子 ImageAnalyzer 提供

  • 有關最後一個畫格的資料(完整畫格的數值),以及
  • 目前畫格的中間值(目前正在串流傳輸的畫格)。

運算子 ImageAnalyzer 可分析面陣掃描應用(2D)中的畫格。 您也可以將其用於分析線陣掃描應用(1D)中的資料。

該運算子提供動態讀取參數,您可以用來擷取以下相關資料:

  • 影像尺寸(寬度 x 高度)與影像大小(像素),
  • 畫格內行長度的偏差,
  • 行與行之間的時間間隔,
  • 運算子輸入的阻擋狀態(已阻擋/未阻擋)。

此外,該運算子還提供了一些用於控制運算子本身的參數。

當內部 Counter 溢位時,會在 OverflowMask 參數中設定對應的溢位位元,並且 Counter 會停止。

[重要] 執行階段測試

此 operator 旨在於執行階段測試和分析您的設計:您需要建置(合成)設計、將其載入目標硬體,並啟動實際的影像處理,然後才能使用該 operator 進行偵錯。

此 operator 並非用於 VisualApplets 內的設計模擬。

I/O Properties

Property Value
Operator Type O
Input Link I, data input
Output Link O, data output

支援的 Link 格式

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

參數

ClearMode
Type 動態寫入參數
Default ClearWithProcessStart
Range {NoClearing, ClearWithProcessStart, ClearWithProcessReset, SendClearPulse}

Operator Control:

此參數定義所有 read 參數的重設行為。

NoClearing:保留所有 read 參數的值。 ProcessEnable 與 ProcessReset 對這些值沒有影響。

ClearWithProcessStart:所有 read 參數的值僅在 ProcessEnable 的上升緣清除。

ClearWithProcessReset:所有 read 參數的值僅在 ProcessReset 的上升緣清除。

SendClearPulse:依需求清除所有 read 參數值。

FrameCountWidth
Type 靜態寫入參數
Default 24
Range [4, 63]

Operator Control:

設定參數 FrameCounter 的 Bit Width。

GapCountWidth
Type 靜態寫入參數
Default 20
Range [4, 63]

Operator Control:

設定行間隔 Counter 的 Bit Width (FrameMinLineGap, FrameMaxLineGap, CurrLineGap)。

FrameCount
Type 動態讀取參數
Default 0
Range [0, (2^FrameCountWidth) -1]

一般資訊:

計算所有以 EndOfDay 或 EndOfFrame 結尾的影像。

FramePixelCount
Type 動態讀取參數
Default 0
Range [0, (2^ (ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

最後一個畫格:

最後一個完成的畫格的大小(以像素為單位)。

FrameHeight
Type 動態讀取參數
Default 0
Range [0, (2^(ImageHeightBitwidth+4))-1]

最後一個畫格:

最後完成畫格的高度(以像素為單位)。

FrameMinWidth
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+4))-1]

最後一個畫格:

最後完成畫格中遇到的最小寬度(以像素為單位)。

FrameMaxWidth
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+4))-1]

最後一個畫格:

最後完成畫格中遇到的最大寬度(以像素為單位)。

FrameMinLineGap
Type 動態讀取參數
Default 0
Range [0, (2^GapCountWidth)-1]

最後一個畫格:

最後完成畫格中遇到的最小行間隔。在下圖顯示的範例中,FrameMinLineGap = 3。

FrameMaxLineGap
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

最後一個畫格:

在最後完成的畫格中遇到最大行間隙。在下圖顯示的範例中,FrameMaxLineGap = 4。

CurrPixelCount
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

目前畫格:

目前作用中且正在檢測的畫格中的像素計數。

CurrXPos
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+4))-1]

目前畫格:

目前作用中且正在檢測的畫格中的目前水平位置。

CurrYPos
Type 動態讀取參數
Default 0
Range [0, (2^(ImageHeightBitwidth+4))-1]

目前畫格:

目前作用中且正在檢測的畫格中的目前垂直位置。

CurrMinWidth
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+4))-1]

目前畫格:

在目前作用中且正在檢測的畫格中檢測到的最小寬度。

CurrMaxWidth
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+4))-1]

目前畫格:

在目前作用中且正在檢測的畫格中檢測到的最大寬度。

CurrLineGap
Type 動態讀取參數
Default 0
Range [0, (2^GapCountWidth)-1]

目前畫格:

目前行與前一行之間的間隙(在目前作用中且正在檢測的畫格中)。

CurrBlocked
Type 動態讀取參數
Default 0
Range [0, 1]

一般資訊:

如果設為 1:值 1 表示輸入連結目前被輸出連結阻擋。

OverflowMask
Type 動態讀取參數
Default 0
Range [0, 31]

Operator Control:

位元編碼的溢位信號。設定的位元表示下列 Counter 發生溢位:

[0] = FrameCount

[1] = PixelCount

[2] = xPos

[3] = yPos

[4] = LineGapCount。

使用範例

以下範例展示了 ImageAnalyzer 運算子的使用方式: