IDWriteFactory4::TranslateColorGlyphRun-Methode (dwrite_3.h)

Artikel
08/23/2023

Übersetzt eine Glyphenausführung in eine Sequenz von Farbglyphenausführungen, die gerendert werden kann, um eine Farbdarstellung der ursprünglichen "Basis"-Ausführung zu erzeugen.

Syntax

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

Parameter

baselineOrigin

Typ: D2D1_POINT_2F

Der horizontale und vertikale Ursprung der Basisglyphe wird in Vortransformationskoordinaten ausgeführt.

[in] glyphRun

Typ: DWRITE_GLYPH_RUN

Zeiger auf die ursprüngliche "Basis"-Glyphenausführung.

[in, optional] glyphRunDescription

Typ: DWRITE_GLYPH_RUN_DESCRIPTION

Optionale glyphenausführungsbeschreibung.

desiredGlyphImageFormats

Typ: DWRITE_GLYPH_IMAGE_FORMATS

In welche Datenformate die Ausführungen aufgeteilt werden sollen.

measuringMode

Typ: DWRITE_MEASURING_MODE

Messmodus, der zum Berechnen der Ursprünge jeder Glyphe erforderlich ist.

[in, optional] worldAndDpiTransform

Typ: DWRITE_MATRIX

Matrixkonvertierung aus dem Koordinatenbereich des Clients in Gerätekoordinaten (Pixel), d. h. die Welttransformation multipliziert mit einer beliebigen DPI-Skalierung.

colorPaletteIndex

Typ: UINT32

Nullbasierter Index der zu verwendenden Farbpalette. Gültige Indizes sind kleiner als die Anzahl der Paletten in der Schriftart, wie von IDWriteFontFace2::GetColorPaletteCount zurückgegeben.

[out] colorLayers

Typ: IDWriteColorGlyphRunEnumerator1**

Wenn die Funktion erfolgreich ist, empfängt einen Zeiger auf ein Enumeratorobjekt, das zum Abrufen der Farbglyphenausführungen verwendet werden kann. Wenn die Basisausführung keine Farbglyphen aufweist, ist der Ausgabezeiger NULL, und die Methode gibt DWRITE_E_NOCOLOR zurück.

Rückgabewert

Typ: HRESULT

Gibt DWRITE_E_NOCOLOR zurück, wenn die Schriftart keine Farbinformationen enthält, die Glyphenausführung keine Farbsymbole enthält oder der angegebene Farbpalettenindex außerhalb des Bereichs liegt. In diesem Fall sollte der Client die ursprüngliche Glyphenausführung rendern. Gibt andernfalls einen HRESULT-Standardfehlercode zurück.

Hinweise

Das Aufrufen von IDWriteFactory2::TranslateColorGlyphRun entspricht dem Aufrufen der IDWriteFactory4::TranslateColorGlyph-Ausführung mit den folgenden angegebenen Formaten: DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

Anforderungen


Zielplattform	Windows
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib

Weitere Informationen

IDWriteFactory4

Freigeben über