SampleDn

Operator Library: Base

SampleDn オペレーターは、入力画像のダウンサンプリングによって画像サイズを縮小します。 画像サイズのダウンサンプリングファクターは、128 までの任意の正の整数を使用して、幅および高さごとに個別に定義できます。 このダウンサンプリングファクターは、パラメーター XSampleDown および YSampleDown を使用して定義されます。 出力ピクセルは、結合されたピクセルを平均化して計算されます。

このオペレーターは、長方形の画像、つまり各ラインの長さが等しい画像でのみ正常に機能します。 同じ画像内でラインの長さが可変である画像は、誤った結果につながります。

ダウンサンプリングパラメーターに入力画像の幅/高さを超える値が設定されている場合、結果の画像は空の画像になります。

実際の画像の幅/高さが対応するダウンサンプリングパラメーター値で割り切れない場合、 オペレーターは残りのピクセルを破棄します。詳細については、次の図を参照してください。

入力画像の幅を XSampleDown で割った値が Parallelism の倍数ではなく、かつ出力の計算された最大画像幅よりも小さい場合、 結果のラインの長さが Parallelism の倍数になるように、ダミーピクセルを追加して画像ラインが拡張されます。 挿入されたダミーピクセルの値は未定義です。

Operator Restrictions

  • 各入力画像のラインは同じ長くなければなりません。したがって、ライン長が異なる画像は許可されません。

  • カラーピクセルの場合、各カラーコンポーネントは個別に処理されます。

  • 実際の画像の幅が XSampleDown 未満の場合、空の画像が出力されます。

  • 実際の画像の高さが YSampleDown 未満の場合、空の画像が出力されます。

I/O Property

Property 値
オペレータータイプ P
Input Link I, data input
Output Link O, data output

サポートされているリンクフォーマット

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

出力での最大画像ディメンションは、次の式に従って自動的に決定されます。

パラメーター

XSampleDown
タイプ static パラメータ
Default 1
範囲 [1, 128]

このパラメーターは、画像幅のダウンサンプリングファクターを定義します。

ダウンサンプリングの制限は

YSampleDown
タイプ static パラメータ
Default 1
範囲 [1, 128]

このパラメーターは、画像高さのダウンサンプリングファクターを定義します。

ダウンサンプリングの制限は

使用例

SampleDn オペレーターの使用法を次の例に示します。

  • 「Downsampling」

    例 - 入力画像がダウンサンプリングされ、つまりサイズが 4x4 に縮小されます。

  • 3x3ダウンサンプリング

    例 - オペレーター SampleDnを使用せずに3x3の係数でダウンサンプリングします。