Compartir a través de

DML_RESAMPLE2_OPERATOR_DESC structure (directml.h)

  • Artículo

Realiza un nuevo muestreo de los elementos del origen al tensor de destino mediante los factores de escala para calcular el tamaño del tensor de destino. Puede usar un modo de interpolación lineal o de vecino más próximo. El operador admite la interpolación entre varias dimensiones, no solo 2D. Por lo tanto, puede mantener el mismo tamaño espacial, pero interpolar entre canales o en lotes. La relación entre las coordenadas de entrada y salida es la siguiente:

OutputTensorX = (InputTensorX + InputPixelOffset) * Scale + OutputPixelOffset

Importante

Esta API está disponible como parte del paquete redistribuible independiente DirectML (consulte la versión 1.9 y versiones posteriores de Microsoft.AI.DirectML). Consulte también el historial de versiones de DirectML.

Sintaxis

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

Miembros

InputTensor

Tipo: const DML_TENSOR_DESC*

Tensor que contiene los datos de entrada.

OutputTensor

Tipo: const DML_TENSOR_DESC*

El tensor en el que escribir los datos de salida.

InterpolationMode

Tipo: DML_INTERPOLATION_MODE

Este campo determina el tipo de interpolación que se usa para elegir píxeles de salida.

  • DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR. Usa el algoritmo vecino más próximo, que elige el elemento de entrada más cercano al desplazamiento de píxel correspondiente para cada elemento de salida.

  • DML_INTERPOLATION_MODE_LINEAR. Usa el algoritmo de interpolación lineal, que calcula el elemento de salida calculando la media ponderada de los dos elementos de entrada vecinos más cercanos por dimensión. Se admite un nuevo muestreo hasta cuatro dimensiones (cuadrilineal), donde la media ponderada se calcula en un total de dieciséis elementos de entrada para cada elemento de salida.

RoundingDirection

Tipo: DML_AXIS_DIRECTION

Dirección a lo largo de la que se redondea cada eje cuando se asignan coordenadas fraccionarias a píxeles de entrada. Dado que la interpolación bilineal interpola las coordenadas fraccionarias de todos modos, esto afecta solo a DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR.

  • DML_AXIS_DIRECTION_INCREASING. Coordenadas fraccionarias redondeadas hacia el aumento de los valores del eje (MULTIPLO.SUPERIOR).

  • DML_AXIS_DIRECTION_DECREASING. Coordenadas fraccionales redondeadas hacia valores de eje decrecientes (MULTIPLO.INFERIOR).

DimensionCount

Tipo: UINT

Número de elementos de las matrices Scales, InputPixelOffsets y OutputPixelOffsets. Este valor debe coincidir con el recuento de dimensiones de InputTensor y OutputTensor.

Scales

Tipo: _Field_size_(DimensionCount) const FLOAT*

Las escalas que se aplicarán al volver a muestrear la entrada, donde las escalas > 1 escalan verticalmente la imagen y las escalas < 1 reducen verticalmente la imagen de esa dimensión. Tenga en cuenta que las escalas no necesitan ser exactamente OutputSize / InputSize. Si la entrada después del escalado es mayor que el límite de salida, la recortamos al tamaño de salida. Por otro lado, si la entrada después del escalado es menor que el límite de salida, se fijan los bordes de salida.

InputPixelOffsets

Tipo: _Field_size_(DimensionCount) const FLOAT*

Desplazamientos que se aplicarán a los píxeles de entrada antes de volver a muestrear. Cuando este valor es 0, se usa la esquina superior izquierda del píxel en lugar de su centro, que normalmente no dará el resultado esperado. Para volver a implementar la imagen mediante el centro de los píxeles y para obtener el mismo comportamiento que DML_RESAMPLE_OPERATOR_DESC, este valor debe ser 0,5.

OutputPixelOffsets

Tipo: _Field_size_(DimensionCount) const FLOAT*

Desplazamientos que se aplicarán a los píxeles de salida después de volver a muestrear. Cuando este valor es 0, se usa la esquina superior izquierda del píxel en lugar de su centro, que normalmente no dará el resultado esperado. Para volver a muestrear la imagen mediante el centro de los píxeles y para obtener el mismo comportamiento que DML_RESAMPLE_OPERATOR_DESC, este valor debe ser -0,5.

Comentarios

Este operador es equivalente a DML_RESAMPLE1_OPERATOR_DESC cuando InterpolationMode está establecido en DML_INTERPOLATION_MODE_LINEAR; o cuando InterpolationMode está establecido en DML_INTERPOLATION_MODE_NEAREST_NEIGHBOR y RoundingDirection en DML_AXIS_DIRECTION_DECREASING, y el valor de OutputPixelOffsets se ajusta con un -0,5 adicional.

Disponibilidad

Este operador se introdujo en DML_FEATURE_LEVEL_5_1.

Restricciones de tensor

InputTensor y OutputTensor deben tener los mismos DataType y DimensionCount.

Compatibilidad del tensor

DML_FEATURE_LEVEL_6_2 y versiones posteriores

Tensor Clase Recuentos de dimensiones admitidos Tipos de datos admitidos
InputTensor Entrada De 1 a 4 FLOAT32, FLOAT16, INT8, UINT8
OutputTensor Output De 1 a 4 FLOAT32, FLOAT16, INT8, UINT8

DML_FEATURE_LEVEL_5_1 y versiones posteriores

Tensor Clase Recuentos de dimensiones admitidos Tipos de datos admitidos
InputTensor Entrada De 1 a 4 FLOAT32, FLOAT16
OutputTensor Output De 1 a 4 FLOAT32, FLOAT16

Requisitos

   
Encabezado directml.h