Metodo ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,ID2D1BitmapRenderTarget**) (d2d1.h)

Crea una destinazione di rendering bitmap da usare durante il disegno intermedio su schermo esterno compatibile con la destinazione di rendering corrente.

Sintassi

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

Parametri

desiredSize

Tipo: [in] D2D1_SIZE_F

Dimensioni desiderate della nuova destinazione di rendering (in pixel indipendenti dal dispositivo), se deve essere diversa dalla destinazione di rendering originale. Per altre informazioni, vedere la sezione Osservazioni.

desiredPixelSize

Tipo: [in] D2D1_SIZE_U

Dimensioni desiderate della nuova destinazione di rendering in pixel se deve essere diversa dalla destinazione di rendering originale. Per altre informazioni, vedere la sezione Osservazioni.

bitmapRenderTarget

Tipo: [out] ID2D1BitmapRenderTarget**

Quando questo metodo restituisce, contiene un puntatore a un puntatore a una nuova destinazione di rendering bitmap. Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le dimensioni dei pixel e la DPI della nuova destinazione di rendering possono essere modificate specificando i valori per desiredSize o desiredPixelSize.

• Se desiredSize è specificato ma desiredPixelSize non è, le dimensioni dei pixel vengono calcolate dalle dimensioni desiderate usando la DPI di destinazione padre. Se l'oggetto desiredSize esegue il mapping a una dimensione integer-pixel, il valore DPI della destinazione di rendering compatibile corrisponde alla DPI della destinazione padre. Se desiredSize esegue il mapping a dimensioni frazionarie, le dimensioni dei pixel sono arrotondate all'intero più vicino e il valore DPI per la destinazione di rendering compatibile è leggermente superiore al valore DPI della destinazione di rendering padre. In tutti i casi, la coordinata (desiredSize.width, desiredSize.height) viene mappata all'angolo inferiore destro della destinazione di rendering compatibile.
• Se l'oggetto desiredPixelSize è specificato e desiredSize non è, il valore DPI della nuova destinazione di rendering è uguale alla destinazione di rendering originale.
• Se si specificano sia desiredSize che desiredPixelSize , viene calcolato il valore DPI della nuova destinazione di rendering per tenere conto della differenza nella scala.
• Se non si specificano desiderateSize o desiredPixelSize , le nuove dimensioni di destinazione di rendering e DPI corrispondono alla destinazione di rendering originale.

La destinazione di rendering bitmap creata da questo metodo non è compatibile con GDI.

Requisiti

Vedi anche

ID2D1RenderTarget