Metodo ID2D1DeviceContext4::GetColorBitmapGlyphImage (d2d1_3.h)

Recupera un'immagine del glifo bitmap del colore dalla cache del glifo di colore. Se la cache non contiene già la risorsa richiesta, verrà creata. Questo metodo può essere usato per estendere la durata di un'immagine glifo anche dopo l'eliminazione dalla cache del glifo di colore.

Sintassi

HRESULT GetColorBitmapGlyphImage(
                 DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
                 D2D1_POINT_2F              glyphOrigin,
  [in]           IDWriteFontFace            *fontFace,
                 FLOAT                      fontEmSize,
                 UINT16                     glyphIndex,
                 BOOL                       isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F    *worldTransform,
                 FLOAT                      dpiX,
                 FLOAT                      dpiY,
  [out]          D2D1_MATRIX_3X2_F          *glyphTransform,
  [out]          ID2D1Image                 **glyphImage
);

Parametri

glyphImageFormat

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

Formato per l'immagine del glifo. Se non sono presenti dati di immagine nel formato richiesto per il glifo richiesto, questo metodo restituirà un errore.

glyphOrigin

Tipo: D2D1_POINT_2F

Origine del glifo.

[in] fontFace

Tipo: IDWriteFontFace*

Riferimento a un viso di carattere che contiene il tipo di viso del tipo di carattere, i riferimenti di file appropriati, i dati di identificazione del viso e vari dati di tipo carattere, ad esempio metriche, nomi e contorni del glifo.

fontEmSize

Tipo: FLOAT

Le dimensioni del carattere specificate influiscono sulla scelta della bitmap da usare dal tipo di carattere. Influisce anche sul glifo di outputTransform, causandone la corretta scalabilità.

glyphIndex

Tipo: UINT16

Indice del glifo.

isSideways

Tipo: BOOL

Se true, specifica che i glifi vengono ruotati a 90 gradi verso sinistra e metriche verticali vengono usati. La scrittura verticale viene ottenuta specificando isSideways come true e ruotando l'intera esecuzione a 90 gradi a destra tramite una trasformazione ruota.

[in, optional] worldTransform

Tipo: const D2D1_MATRIX_3X2_F*

Trasformazione da applicare all'immagine. Questa trasformazione di input influisce sulla scelta della bitmap da usare dal tipo di carattere. È inoltre fattoriato nel glifo di outputTransform.

dpiX

Tipo: FLOAT

Punti per pollice lungo l'asse x.

dpiY

Tipo: FLOAT

Punti per pollice lungo l'asse y.

[out] glyphTransform

Tipo: D2D1_MATRIX_3X2_F*

Trasformazione di output, che trasforma dallo spazio del glifo allo stesso spazio di output del mondoTransform. Ciò include l'input glyphOrigin, l'offset del glifo dal glifoOrigin e qualsiasi altra trasformazione necessaria.

[out] glyphImage

Tipo: ID2D1Image**

Al completamento contiene l'immagine del glifo recuperata.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce un codice di esito positivo o di errore HRESULT.

Requisiti

Vedi anche

ID2D1DeviceContext4