Metodo IDWriteFactory2::TranslateColorGlyphRun (dwrite_2.h)

Questo metodo viene chiamato su un glifo eseguito per convertirlo in più esecuzioni di glifi di colore.

Sintassi

HRESULT TranslateColorGlyphRun(
                 FLOAT                              baselineOriginX,
                 FLOAT                              baselineOriginY,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldToDeviceTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator     **colorLayers
);

Parametri

baselineOriginX

Tipo: FLOAT

Origine della linea di base orizzontale dell'esecuzione del glifo originale.

baselineOriginY

Tipo: FLOAT

Origine della baseline verticale dell'esecuzione del glifo originale.

[in] glyphRun

Tipo: const DWRITE_GLYPH_RUN*

Esecuzione del glifo originale contenente ID glifi monocromatici.

[in, optional] glyphRunDescription

Tipo: const DWRITE_GLYPH_RUN_DESCRIPTION*

Descrizione facoltativa dell'esecuzione del glifo.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Modalità di misurazione utilizzata per calcolare le posizioni del glifo se l'esecuzione contiene glifi di colore.

[in, optional] worldToDeviceTransform

Tipo: const DWRITE_MATRIX*

Trasformazione mondiale moltiplicata per qualsiasi ridimensionamento DPI. Questa operazione è necessaria per calcolare le posizioni del glifo se l'esecuzione contiene glifi di colore e la modalità di misurazione non è DWRITE_MEASURING_MODE_NATURAL. Se questo parametro è NULL e si presuppone la trasformazione identity.

colorPaletteIndex

Tipo: UINT32

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

[out] colorLayers

Tipo: IDWriteColorGlyphRunEnumerator**

Se l'esecuzione del glifo originale contiene glifi di colore, questo parametro riceve un puntatore a un'interfaccia IDWriteColorGlyphRunEnumerator . Il client usa l'interfaccia restituita per ottenere informazioni sulle esecuzioni del glifo e sui colori associati per eseguire il rendering anziché sull'esecuzione originale del glifo. Se l'esecuzione del glifo originale non contiene glifi di colore, questo metodo restituisce DWRITE_E_NOCOLOR e il puntatore di output è NULL.

Valore restituito

Tipo: HRESULT

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

Commenti

Se il codice chiama questo metodo con un'esecuzione glifo che non contiene informazioni sul colore, il metodo restituisce DWRITE_E_NOCOLOR per informare l'applicazione che può solo disegnare l'esecuzione del glifo originale. Se l'esecuzione del glifo contiene informazioni sul colore, la funzione restituisce un oggetto che può essere enumerato attraverso per esporre esecuzioni e colori associati. L'applicazione chiama quindi DrawGlyphRun con ogni esecuzione del glifo restituito e colori di primo piano.

Requisiti

Vedi anche

IDWriteFactory2