Operator Library: Base
運算子 SampleDn 透過對輸入影像進行降採樣來縮小影像尺寸。 影像尺寸的降採樣係數可針對寬度和高度分別定義,可使用任何正整數 (上限為 128)。 此降採樣係數是透過參數XSampleDown和YSampleDown 來定義的。 輸出像素是透過對相鄰像素進行平均運算而計算得出的。
此運算子僅在矩形圖像上才能正常運作,也就是說,圖像中的各條線段長度必須相等。 若同一張圖像中線段長度不一,將會導致錯誤結果。
若將下採樣參數設定為超過輸入影像寬度/高度的數值,則生成的影像 將會是一張空白影像。
若實際影像的寬度/高度無法被對應的降採樣參數值整除, 則該運算子將捨棄剩餘的像素。詳情請參閱下圖說明。

若輸入影像的寬度除以XSampleDown的結果並非平行處理度的倍數, 且小於計算出的輸出影像最大寬度,則會透過追加虛擬 像素 來擴展影像行, 使最終的行長成為平行處理度的倍數。 所插入的虛擬像素值未定義。
Operator Restrictions
-
每張輸入影像的行數必須相同。因此,不允許行數不一致的影像。
-
對於彩色像素,每個色彩分量都會分別進行處理。
-
若實際影像寬度小於XSampleDown,則會輸出一張空白影像。
-
若實際影像高度小於YSampleDown,則會輸出一張空白影像。
| XSampleDown | |
|---|---|
| Type | 靜態參數 |
| Default | 1 |
| Range | [1, 128] |
|
此參數用以定義影像寬度的降採樣係數。 降採樣僅限於 ![]() |
|
| YSampleDown | |
|---|---|
| Type | 靜態參數 |
| Default | 1 |
| Range | [1, 128] |
|
此參數用以定義影像高度的下採樣係數。 降採樣僅限於 ![]() |
|
以下範例展示了運算子 SampleDn 的用法:
-
範例 — 輸入影像經過降採樣,也就是說,其尺寸縮減了 4x4。
-
範例 - 在不使用 SampleDn 運算子之情況下進行 3x3 因數降取樣。








上一頁

