structure DML_RESAMPLE2_OPERATOR_DESC (directml.h)

Rééchantillonne les éléments de la source vers le capteur de destination, en utilisant les facteurs d’échelle pour calculer la taille du capteur de destination. Vous pouvez utiliser un mode d’interpolation linéaire ou voisin le plus proche. L’opérateur prend en charge l’interpolation entre plusieurs dimensions, pas seulement 2D. Vous pouvez donc conserver la même taille spatiale, mais interpoler entre les canaux ou les lots. La relation entre les coordonnées d’entrée et de sortie est la suivante :

OutputTensorX = (InputTensorX + InputPixelOffset) * Scale + OutputPixelOffset

Syntaxe

struct DML_RESAMPLE2_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;
};

Membres

InputTensor

Type : const DML_TENSOR_DESC*

Capteur contenant les données d’entrée.

OutputTensor

Type : const DML_TENSOR_DESC*

Le capteur dans lequel écrire les données de sortie.

InterpolationMode

Type : DML_INTERPOLATION_MODE

Ce champ détermine le type d’interpolation utilisé pour choisir les pixels de sortie.

• DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR. Utilise l’algorithme voisin le plus proche , qui choisit l’élément d’entrée le plus proche du décalage de pixel correspondant pour chaque élément de sortie.

• DML_INTERPOLATION_MODE_LINEAR. Utilise l’algorithme d’interpolation linéaire , qui calcule l’élément de sortie en calculant la moyenne pondérée des deux éléments d’entrée voisins les plus proches par dimension. Le rééchantillonnage est pris en charge jusqu’à quatre dimensions (quadriligne), où la moyenne pondérée est calculée sur un total de seize éléments d’entrée pour chaque élément de sortie.

RoundingDirection

Type : DML_AXIS_DIRECTION

Direction à arrondir le long de chaque axe lors du mappage des coordonnées fractionnaires vers les pixels d’entrée. Étant donné que l’interpolation biligne interpole les coordonnées fractionnaires de toute façon, cela affecte uniquement DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR.

• DML_AXIS_DIRECTION_INCREASING. Arrondir les coordonnées fractionnelles vers l’augmentation des valeurs d’axe (ceil).

• DML_AXIS_DIRECTION_DECREASING. Arrondir les coordonnées fractionnelles vers les valeurs d’axe décroissantes (plancher).

DimensionCount

Type : UINT

Nombre d’éléments dans les tableaux Scales, InputPixelOffsets et OutputPixelOffsets . Cette valeur doit correspondre au nombre de dimensions d’InputTensor et OutputTensor.

Scales

Type : _Field_size_(DimensionCount) const FLOAT*

Les échelles à appliquer lors de la rééchantillonnage de l’entrée, où la mise à l’échelle > 1 scale-up de l’image et la mise à l’échelle < 1 scale-down de l’image pour cette dimension. Notez que les échelles n’ont pas besoin d’être exactement OutputSize / InputSize. Si l’entrée après la mise à l’échelle est supérieure à la limite de sortie, nous la rognez à la taille de sortie. En revanche, si l’entrée après la mise à l’échelle est inférieure à la limite de sortie, les arêtes de sortie sont limitées.

InputPixelOffsets

Type : _Field_size_(DimensionCount) const FLOAT*

Décalages à appliquer aux pixels d’entrée avant le rééchantillonnage. Lorsque cette valeur est 0, le coin supérieur gauche du pixel est utilisé au lieu de son centre, ce qui ne donne généralement pas le résultat attendu. Pour rééchantillonner l’image à l’aide du centre des pixels et obtenir le même comportement que DML_RESAMPLE_OPERATOR_DESC, cette valeur doit être 0,5.

OutputPixelOffsets

Type : _Field_size_(DimensionCount) const FLOAT*

Décalages à appliquer aux pixels de sortie après le rééchantillonnage. Lorsque cette valeur est 0, le coin supérieur gauche du pixel est utilisé au lieu de son centre, ce qui ne donne généralement pas le résultat attendu. Pour rééchantillonner l’image à l’aide du centre des pixels et obtenir le même comportement que DML_RESAMPLE_OPERATOR_DESC, cette valeur doit être -0,5.

Remarques

Cet opérateur équivaut à DML_RESAMPLE1_OPERATOR_DESC lorsque InterpolationMode est défini sur DML_INTERPOLATION_MODE_LINEAR ; ou lorsque InterpolationMode est défini sur DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR, et roundingDirection sur DML_AXIS_DIRECTION_DECREASING, et les outputPixelOffsets sont ajustés à -0,5 supplémentaire.

Disponibilité

Cet opérateur a été introduit dans DML_FEATURE_LEVEL_5_1.

Contraintes Tensor

InputTensor et OutputTensor doivent avoir le même DataType et DimensionCount.

Prise en charge de Tensor

DML_FEATURE_LEVEL_6_2 et versions ultérieures

DML_FEATURE_LEVEL_5_1 et versions ultérieures

Spécifications