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

  • Artigo

Desenha uma imagem para o contexto do dispositivo.

Sintaxe

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*

A imagem a ser desenhada para o contexto do dispositivo.

[in, optional] targetOffset

Tipo: const D2D1_POINT_2F*

O deslocamento no espaço de destino para o qual a imagem será renderizada. Toda a extensão lógica da imagem será renderizada para o destino correspondente. Se não for especificado, a origem de destino será (0, 0). O canto superior esquerdo da imagem será mapeado para o deslocamento de destino. Essa não será necessariamente a origem. Esse valor padrão é NULL.

[in, ref, optional] imageRectangle

Tipo: const D2D1_RECT_F

O retângulo correspondente no espaço de imagem será mapeado para as origens fornecidas ao processar a imagem. Esse valor padrão é NULL.

interpolationMode

Tipo: D2D1_INTERPOLATION_MODE

O modo de interpolação que será usado para dimensionar a imagem, se necessário.

compositeMode

Tipo: D2D1_COMPOSITE_MODE

O modo composto que será aplicado aos limites do clipe selecionado no momento. O valor padrão é D2D1_COMPOSITE_MODE_SOURCE_OVER

Retornar valor

Nenhum

Comentários

Se interpolationMode for D2D1_INTERPOLATION_MODE_HIGH_QUALITY, dimensionadores diferentes serão usados dependendo do fator de escala implícito pela transformação mundial.

Todos os retângulos inválidos acumulados em qualquer efeito desenhado por essa chamada serão descartados independentemente de qual parte do retângulo da imagem é desenhada.

Se compositeMode for D2D1_COMPOSITE_MODE_SOURCE_OVER, DrawImage usará a mistura primitiva selecionada no momento especificada por ID2D1DeviceContext::SetPrimitiveBlend. Se compositeMode não for D2D1_COMPOSITE_MODE_SOURCE_OVER, a imagem será estendida para transparente até o clipe alinhado ao eixo atual.

Se houver um retângulo de imagem e uma transformação de mundo, isso equivale a inserir um efeito clip para representar o retângulo de imagem e uma transformação de afins 2D para levar em conta a transformação do mundo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1_1.h
DLL D2d1.dll

Confira também

ID2D1Bitmap

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1Effect

ID2D1Image