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

Articolo
01/10/2024

Disegna un'immagine nel contesto di dispositivo.

Sintassi

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

Parametri

[in] image

Tipo: ID2D1Image*

Immagine da disegnare nel contesto del dispositivo.

[in, optional] targetOffset

Tipo: const D2D1_POINT_2F*

Offset nello spazio di destinazione a cui verrà eseguito il rendering dell'immagine. Verrà eseguito il rendering dell'intera estensione logica dell'immagine nella destinazione corrispondente. Se non specificato, l'origine di destinazione sarà (0, 0). L'angolo superiore sinistro dell'immagine verrà mappato all'offset di destinazione. Questo non sarà necessariamente l'origine. Questo valore predefinito è NULL.

[in, ref, optional] imageRectangle

Tipo: const D2D1_RECT_F

Il rettangolo corrispondente nello spazio immagine verrà mappato alle origini date durante l'elaborazione dell'immagine. Questo valore predefinito è NULL.

interpolationMode

Tipo: D2D1_INTERPOLATION_MODE

Modalità di interpolazione che verrà usata per ridimensionare l'immagine, se necessario.

compositeMode

Tipo: D2D1_COMPOSITE_MODE

Modalità composita che verrà applicata ai limiti della clip attualmente selezionata. Il valore predefinito è D2D1_COMPOSITE_MODE_SOURCE_OVER

Valore restituito

nessuno

Osservazioni

Se interpolationMode è D2D1_INTERPOLATION_MODE_HIGH_QUALITY, verranno usati scaler diversi a seconda del fattore di scala implicito dalla trasformazione globale.

Tutti i rettangoli non validi accumulati su qualsiasi effetto disegnato da questa chiamata verranno eliminati indipendentemente dalla parte del rettangolo dell'immagine.

Se compositeMode è D2D1_COMPOSITE_MODE_SOURCE_OVER, DrawImage userà la fusione primitiva attualmente selezionata specificata da ID2D1DeviceContext::SetPrimitiveBlend. Se compositeMode non è D2D1_COMPOSITE_MODE_SOURCE_OVER, l'immagine verrà estesa fino alla clip allineata all'asse corrente.

Se è presente un rettangolo immagine e una trasformazione globale, questo equivale all'inserimento di un effetto clip per rappresentare il rettangolo dell'immagine e una trasformazione affine 2D da prendere in considerazione la trasformazione del mondo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1_1.h
DLL	D2d1.dll