運算子 SampleDn

Operator Library: Base

運算子 SampleDn 會透過對輸入影像進行降取樣來縮減影像大小。 影像大小降取樣係數可以針對寬度和高度分別使用最高達 128 的任意正整數來定義。 此降取樣係數是使用參數 XSampleDown 和 YSampleDown 來定義。 輸出像素是透過對相鄰像素進行平均來計算的。

此運算子僅適用於矩形影像(即每行長度相等的影像)。 在同一張影像中具有可變行長度的影像將會導致錯誤的結果。

如果降取樣參數設定的值超過了輸入影像的寬度/高度,則產生的影像將會是空白影像。

如果實際的影像寬度/高度無法被對應的降取樣參數值整除, 運算子將會捨棄剩餘的像素。請參閱下圖以了解說明。

如果輸入影像的寬度除以 XSampleDown 不是 Parallelism 的倍數, 且小於計算出的輸出最大影像寬度,則影像行會透過附加虛擬像素來擴充, 以便產生的行長度是 Parallelism 的倍數。 所插入的虛擬像素的值未定義。

算子限制

  • 每個輸入影像的行必須具有相同的長度。因此不允許行長度不同的影像。

  • 對於彩色像素,每個顏色分量都會被單獨處理。

  • 如果實際影像寬度小於 XSampleDown,則會輸出空白影像。

  • 如果實際影像高度小於 YSampleDown,則會輸出空白影像。

I/O Properties

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

支援的 Link 格式

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 自動2
Max. Img Height any 自動3

1

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

2 3

輸出時的最大影像尺寸會根據以下公式自動決定:

參數

XSampleDown
Type static parameter
Default 1
Range [1, 128]

此參數定義了影像寬度的降取樣係數。

降取樣限制為

YSampleDown
Type static parameter
Default 1
Range [1, 128]

此參數定義了影像高度的降取樣係數。

降取樣限制為

使用範例

運算子 SampleDn 的使用方式如以下範例所示:

  • 「降取樣」

    範例 - 輸入影像經過降取樣,也就是尺寸縮小了 4x4。

  • 「3x3 下取樣」

    範例 - 未使用 SampleDn 運算子進行 3x3 因數下取樣。