Método ID2D1DeviceContext::D rawImage(ID2D1Image*,D2D1_POINT_2F,constD2D1_RECT_F&,D2D1_INTERPOLATION_MODE,D2D1_COMPOSITE_MODE) (d2d1_1.h)

Artículo
01/10/2024

Dibuja una imagen en el contexto del dispositivo.

Sintaxis

void DrawImage(
  [in]                ID2D1Image              *image,
  [in, optional]      D2D1_POINT_2F           targetOffset,
  [in, ref, optional] const D2D1_RECT_F &     imageRectangle,
                      D2D1_INTERPOLATION_MODE interpolationMode,
                      D2D1_COMPOSITE_MODE     compositeMode
);

Parámetros

[in] image

Tipo: ID2D1Image*

Imagen que se va a dibujar en el contexto del dispositivo.

[in, optional] targetOffset

Tipo: const D2D1_POINT_2F*

Desplazamiento en el espacio de destino en el que se representará la imagen. Toda la extensión lógica de la imagen se representará en el destino correspondiente. Si no se especifica, el origen de destino será (0, 0). La esquina superior izquierda de la imagen se asignará al desplazamiento de destino. Esto no será necesariamente el origen. Este valor predeterminado es NULL.

[in, ref, optional] imageRectangle

Tipo: const D2D1_RECT_F

El rectángulo correspondiente del espacio de imagen se asignará a los orígenes especificados al procesar la imagen. Este valor predeterminado es NULL.

interpolationMode

Tipo: D2D1_INTERPOLATION_MODE

Modo de interpolación que se usará para escalar la imagen si es necesario.

compositeMode

Tipo: D2D1_COMPOSITE_MODE

Modo compuesto que se aplicará a los límites del clip seleccionado actualmente. El valor predeterminado es D2D1_COMPOSITE_MODE_SOURCE_OVER

Valor devuelto

None

Observaciones

Si interpolationMode es D2D1_INTERPOLATION_MODE_HIGH_QUALITY, se usarán diferentes escaladores en función del factor de escala implícito en la transformación mundial.

Los rectángulos no válidos acumulados en cualquier efecto dibujado por esta llamada se descartarán independientemente de la parte del rectángulo de imagen dibujada.

Si compositeMode está D2D1_COMPOSITE_MODE_SOURCE_OVER, DrawImage usará la combinación primitiva seleccionada actualmente especificada por ID2D1DeviceContext::SetPrimitiveBlend. Si compositeMode no está D2D1_COMPOSITE_MODE_SOURCE_OVER, la imagen se extenderá para que sea transparente hasta el clip alineado con el eje actual.

Si hay un rectángulo de imagen y una transformación de mundo, esto equivale a insertar un efecto de clip para representar el rectángulo de imagen y una transformación afín 2D para tener en cuenta la transformación del mundo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1_1.h
Archivo DLL	D2d1.dll

Consulte también