Metodo IDWriteFactory4::TranslateColorGlyphRun (dwrite_3.h)

Articolo
08/23/2023

Converte l'esecuzione di un glifo in una sequenza di esecuzioni di glifi di colore, di cui è possibile eseguire il rendering per produrre una rappresentazione di colore dell'esecuzione originale di "base".

Sintassi

HRESULT TranslateColorGlyphRun(
                 D2D1_POINT_2F                      baselineOrigin,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_GLYPH_IMAGE_FORMATS         desiredGlyphImageFormats,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldAndDpiTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator1    **colorLayers
);

Parametri

baselineOrigin

Tipo: D2D1_POINT_2F

L'origine orizzontale e verticale del glifo di base viene eseguita in coordinate di pre-trasformazione.

[in] glyphRun

Tipo: DWRITE_GLYPH_RUN

Puntatore all'esecuzione originale del glifo "base".

[in, optional] glyphRunDescription

Tipo: DWRITE_GLYPH_RUN_DESCRIPTION

Descrizione dell'esecuzione del glifo facoltativa.

desiredGlyphImageFormats

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

I dati in cui vengono formattate le esecuzioni devono essere suddivisi.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Modalità di misurazione, necessaria per calcolare le origini di ogni glifo.

[in, optional] worldAndDpiTransform

Tipo: DWRITE_MATRIX

Matrice che converte dallo spazio delle coordinate del client alle coordinate del dispositivo (pixel), ovvero la trasformazione globale moltiplicata per qualsiasi ridimensionamento DPI.

colorPaletteIndex

Tipo: UINT32

Indice in base zero della tavolozza dei colori da utilizzare. Gli indici validi sono inferiori al numero di tavolozze nel tipo di carattere, come restituito da IDWriteFontFace2::GetColorPaletteCount.

[out] colorLayers

Tipo: IDWriteColorGlyphRunEnumerator1**

Se la funzione ha esito positivo, riceve un puntatore a un oggetto enumeratore che può essere usato per ottenere l'esecuzione del glifo di colore. Se l'esecuzione di base non ha glifi di colore, il puntatore di output è NULL e il metodo restituisce DWRITE_E_NOCOLOR.

Valore restituito

Tipo: HRESULT

Restituisce DWRITE_E_NOCOLOR se il tipo di carattere non contiene informazioni sul colore, l'esecuzione del glifo non contiene glifi di colore o l'indice della tavolozza colori specificato non è compreso nell'intervallo. In questo caso, il client deve eseguire il rendering dell'esecuzione originale del glifo. In caso contrario, restituisce un codice di errore HRESULT standard.

Commenti

La chiamata a IDWriteFactory2::TranslateColorGlyphRun equivale alla chiamata di IDWriteFactory4::TranslateColorGlyph con i formati seguenti specificati: DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	dwrite_3.h
Libreria	Dwrite.lib

Vedi anche

IDWriteFactory4

Condividi tramite