IDWriteFactory2::TranslateColorGlyphRun-Methode (dwrite_2.h)

Artikel
09/18/2023

Diese Methode wird für eine Glyphenausführung aufgerufen, um sie in mehrere Farb-Glyphenausführungen zu übersetzen.

Syntax

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

Parameter

baselineOriginX

Typ: FLOAT

Der horizontale Baselineursprung der ursprünglichen Glyphenausführung.

baselineOriginY

Typ: FLOAT

Der vertikale Baselineursprung der ursprünglichen Glyphenausführung.

[in] glyphRun

Typ: const DWRITE_GLYPH_RUN*

Ursprüngliche glyphenausführung mit monochromen Glyphen-IDs.

[in, optional] glyphRunDescription

Typ: const DWRITE_GLYPH_RUN_DESCRIPTION*

Optionale glyphenausführungsbeschreibung.

measuringMode

Typ: DWRITE_MEASURING_MODE

Der Zum Berechnen von Glyphenpositionen verwendete Messmodus, wenn die Ausführung Farbglyphen enthält.

[in, optional] worldToDeviceTransform

Typ: const DWRITE_MATRIX*

Welttransformation multipliziert mit jeder DPI-Skalierung. Dies ist erforderlich, um Glyphenpositionen zu berechnen, wenn die Ausführung Farbsymbole enthält und der Messmodus nicht DWRITE_MEASURING_MODE_NATURAL ist. Wenn dieser Parameter NULL ist, und die Identitätstransformation angenommen wird.

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: IDWriteColorGlyphRunEnumerator**

Wenn die ursprüngliche glyphenausführung Farbglyphen enthält, empfängt dieser Parameter einen Zeiger auf eine IDWriteColorGlyphRunEnumerator-Schnittstelle . Der Client verwendet die zurückgegebene Schnittstelle, um Informationen zu Glyphenausführungen und zugehörigen Farben abzurufen, die anstelle der ursprünglichen Glyphenausführung gerendert werden sollen. Wenn die ursprüngliche Glyphenausführung keine Farbsymbole enthält, gibt diese Methode DWRITE_E_NOCOLOR zurück, und der Ausgabezeiger ist NULL.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der Code diese Methode mit einer Glyphenausführung aufruft, die keine Farbinformationen enthält, gibt die Methode DWRITE_E_NOCOLOR zurück, um der Anwendung mitzuteilen, dass sie einfach die ursprüngliche Glyphenausführung zeichnen kann. Wenn die Glyphenausführung Farbinformationen enthält, gibt die Funktion ein Objekt zurück, das durchumeriert werden kann, um Ausführungen und zugeordnete Farben verfügbar zu machen. Anschließend ruft die Anwendung DrawGlyphRun mit jeder zurückgegebenen Glyphenausführung und Vordergrundfarben auf.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8.1 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite_2.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteFactory2

Freigeben über