DML_RESAMPLE3_OPERATOR_DESC結構 （directml.h）

使用縮放因數來計算目的地張量大小，將來源的專案重新取樣至目的地張量，並適當地反調整。 您可以使用線性或最接近的鄰近插補模式。 運算符支援跨多個維度的插補，而不只是 2D。 因此，您可以保留相同的空間大小，但跨通道或批次插補。 輸入與輸出座標之間的關聯性如下：

OutputTensorX = (InputTensorX + InputPixelOffset) * Scale + OutputPixelOffset

語法

struct DML_RESAMPLE3_OPERATOR_DESC
{
    const DML_TENSOR_DESC* InputTensor;
    const DML_TENSOR_DESC* OutputTensor;
    DML_INTERPOLATION_MODE InterpolationMode;
    DML_AXIS_DIRECTION RoundingDirection;
    UINT DimensionCount;
    _Field_size_(DimensionCount) const FLOAT* Scales;
    _Field_size_(DimensionCount) const FLOAT* InputPixelOffsets;
    _Field_size_(DimensionCount) const FLOAT* OutputPixelOffsets;
    BOOL Antialiased;
};

成員

InputTensor

類型： const DML_TENSOR_DESC*

包含輸入數據的張量。

OutputTensor

類型： const DML_TENSOR_DESC*

要寫入輸出數據的張量。

InterpolationMode

類型： DML_INTERPOLATION_MODE

此欄位會決定用來選擇輸出圖元的插補類型。

• DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR。 使用 最接近的鄰近 演算法，它會為每個輸出元素選擇最接近對應圖元位移的輸入元素。

• DML_INTERPOLATION_MODE_LINEAR。 使用 線性插補 演算法，其會計算每個維度兩個最接近鄰近輸入元素的加權平均值，以計算輸出元素。 重新取樣最多可支援四個維度（四邊線），其中加權平均值會計算每個輸出元素的16個輸入元素總計。

RoundingDirection

類型： DML_AXIS_DIRECTION

將小數座標對應回輸入圖元時，要沿著每個軸四捨五入的方向。 由於雙向內插補插補點反正會插補小數點座標，因此這隻會影響 DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR。

• DML_AXIS_DIRECTION_INCREASING。 將小數點座標四捨五入，以增加座標軸值（ceil）。

• DML_AXIS_DIRECTION_DECREASING。 將小數點座標四捨五入，以遞減軸值（floor）。

DimensionCount

類型： UINT

Scales、InputPixelOffsets 和 OutputPixelOffsets 陣列中的元素數目。 此值必須符合 InputTensor 和 OutputTensor 的維度計數。

Scales

類型：_Field_size_（DimensionCount） const FLOAT*

重新取樣輸入時要套用的縮放比例，其中縮放 > 1 相應增加影像，並將該維度的影像相應縮小 < 1。 請注意，調整不需要完全 OutputSize / InputSize。 如果調整后的輸入大於輸出系結，則我們會將其裁剪為輸出大小。 另一方面，如果縮放后的輸入小於輸出系結，則會限制輸出邊緣。

InputPixelOffsets

類型：_Field_size_（DimensionCount） const FLOAT*

重新取樣之前要套用至輸入圖元的位移。 當此值為 0 時，會使用圖元的左上角，而不是其中心，這通常不會提供預期的結果。 若要使用圖元中心重新取樣影像，並取得與 DML_RESAMPLE_OPERATOR_DESC相同的行為，這個值必須是0.5。

OutputPixelOffsets

類型：_Field_size_（DimensionCount） const FLOAT*

重新取樣之後要套用至輸出圖元的位移。 當此值為 0 時，會使用圖元的左上角，而不是其中心，這通常不會提供預期的結果。 若要使用圖元中心重新取樣影像，並取得與 DML_RESAMPLE_OPERATOR_DESC相同的行為，這個值必須是 -0.5。

Antialiased

類型： BOOL

反鋸齒功能是藉由 max(1, 1 / scale)因數來延展重新取樣篩選來達成，這表示在縮小取樣時，更多的輸入圖元對輸出圖元造成影響。

當此旗標設定為 TRUE，並假設有下列條件時，就會發生這種情況：

• InterpolationMode 已 DML_INTERPOLATION_MODE_LINEAR
• 1/小數位數 > 2

然後，當降級時，這個運算符會使用反鋸齒篩選。

言論

當 Antialiased 為 false時，這個運算子相當於 DML_RESAMPLE2_OPERATOR_DESC。

可用性

此運算子是在 DML_FEATURE_LEVEL_6_4 中引進的。

Tensor 條件約束

InputTensor 和 OutputTensor 必須具有相同 的 DataType 和 DimensionCount。

Tensor 支援

要求