Operator SampleDn

Operator Library: Base

運算子 SampleDn 透過對輸入影像進行降採樣來縮小影像尺寸。 影像尺寸的降採樣係數可針對寬度和高度分別定義,可使用任何正整數 (上限為 128)。 此降採樣係數是透過參數XSampleDown和YSampleDown 來定義的。 輸出像素是透過對相鄰像素進行平均運算而計算得出的。

此運算子僅在矩形圖像上才能正常運作,也就是說,圖像中的各條線段長度必須相等。 若同一張圖像中線段長度不一,將會導致錯誤結果。

若將下採樣參數設定為超過輸入影像寬度/高度的數值,則生成的影像 將會是一張空白影像。

若實際影像的寬度/高度無法被對應的降採樣參數值整除, 則該運算子將捨棄剩餘的像素。詳情請參閱下圖說明。

若輸入影像的寬度除以XSampleDown的結果並非平行處理度的倍數, 且小於計算出的輸出影像最大寬度,則會透過追加虛擬 像素 來擴展影像行, 使最終的行長成為平行處理度的倍數。 所插入的虛擬像素值未定義。

Operator Restrictions

  • 每張輸入影像的行數必須相同。因此,不允許行數不一致的影像。

  • 對於彩色像素,每個色彩分量都會分別進行處理。

  • 若實際影像寬度小於XSampleDown,則會輸出一張空白影像。

  • 若實際影像高度小於YSampleDown,則會輸出一張空白影像。

I/O Properties

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

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 64]1 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 auto2
Max. Img Height any auto3

1

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

2 3

The maximum image dimension at the output is automatically determined according to the following formulas:

Parameters

XSampleDown
Type 靜態參數
Default 1
Range [1, 128]

此參數用以定義影像寬度的降採樣係數。

降採樣僅限於

YSampleDown
Type 靜態參數
Default 1
Range [1, 128]

此參數用以定義影像高度的下採樣係數。

降採樣僅限於

Examples of Use

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

  • 「降采樣」

    範例 — 輸入影像經過降採樣,也就是說,其尺寸縮減了 4x4。

  • 'Downsampling 3x3'

    範例 - 在不使用 SampleDn 運算子之情況下進行 3x3 因數降取樣。