IDWriteFactory3::CreateGlyphRunAnalysis-Methode (dwrite_3.h)

Artikel
08/23/2023

Erstellt ein glyph-run-analysis-Objekt, das Informationen kapselt, die DirectWrite zum Rendern einer Glyphenausführung verwendet.

Syntax

HRESULT CreateGlyphRunAnalysis(
  [in]           DWRITE_GLYPH_RUN const     *glyphRun,
  [in, optional] DWRITE_MATRIX const        *transform,
                 DWRITE_RENDERING_MODE1     renderingMode,
                 DWRITE_MEASURING_MODE      measuringMode,
                 DWRITE_GRID_FIT_MODE       gridFitMode,
                 DWRITE_TEXT_ANTIALIAS_MODE antialiasMode,
                 FLOAT                      baselineOriginX,
                 FLOAT                      baselineOriginY,
  [out]          IDWriteGlyphRunAnalysis    **glyphRunAnalysis
);

Parameter

[in] glyphRun

Typ: DWRITE_GLYPH_RUN

Eine DWRITE_GLYPH_RUN-Struktur , die die Eigenschaften der Glyphenausführung enthält.

[in, optional] transform

Typ: DWRITE_MATRIX

Eine DWRITE_MATRIX Struktur, die die optionale Transformation beschreibt, die auf Glyphen und deren Positionen angewendet werden soll.

renderingMode

Typ: DWRITE_RENDERING_MODE1

Ein DWRITE_RENDERING_MODE1 typisierter Wert, der den Renderingmodus angibt, bei dem es sich um einen der Rasterrenderingmodi handeln muss (also nicht standard und nicht Gliederung).

measuringMode

Typ: DWRITE_MEASURING_MODE

Ein DWRITE_MEASURING_MODE typisierter Wert, der die Messmethode für Glyphen in der Ausführung angibt. Diese Methode verwendet diesen Wert mit den anderen Eigenschaften, um den Renderingmodus zu bestimmen.

gridFitMode

Typ: DWRITE_GRID_FIT_MODE

Ein DWRITE_GRID_FIT_MODE typisierter Wert, der angibt, wie Glyphenumrisse ins Raster passen. Dieser Wert muss nicht standardmäßig sein.

antialiasMode

Typ: DWRITE_TEXT_ANTIALIAS_MODE

Ein DWRITE_TEXT_ANTIALIAS_MODE typisierter Wert, der den Typ der Antialiasing angibt, die für Text verwendet werden soll, wenn im Renderingmodus antialiasing aufgerufen wird.

baselineOriginX

Typ: FLOAT

Die horizontale Position des Baselineursprungs in DIPs relativ zur linken oberen Ecke des DIB.

baselineOriginY

Typ: FLOAT

Die vertikale Position des Baselineursprungs in DIPs relativ zur linken oberen Ecke des DIB.

[out] glyphRunAnalysis

Typ: IDWriteGlyphRunAnalysis**

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf eine IDWriteGlyphRunAnalysis-Schnittstelle für das neu erstellte glyph-run-analysis-Objekt empfängt.

Rückgabewert

Typ: HRESULT

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteFactory3

Freigeben über