IDWriteFontFace::GetGdiCompatibleGlyphMetrics-Methode

Abrufen von Glyphenmetriken in Schriftentwurfseinheiten mit den Rückgabewerten, die mit dem von GDI erzeugten Wert kompatibel sind.

Syntax

virtual HRESULT GetGdiCompatibleGlyphMetrics(
                       FLOAT                emSize,
                       FLOAT                pixelsPerDip,
  [in, optional] const DWRITE_MATRIX        *transform,
                       BOOL                 useGdiNatural,
  [in]           const UINT16               *glyphIndices,
                       UINT32               glyphCount,
  [out]                DWRITE_GLYPH_METRICS *glyphMetrics,
                       BOOL                 isSideways = FALSE
) = 0;

Parameter

emSize

Typ: FLOAT

Der ogische Schriftgrad der Schriftart in DIP-Einheiten.

pixelsPerDip

Typ: FLOAT

Die Anzahl der physischen Pixel pro DIP.

transformieren [ in, optional]

Typ: const DWRITE _ MATRIX *

Eine optionale Transformation, die auf die Glyphen und ihre Positionen angewendet wird. Diese Transformation wird nach der Skalierung angewendet, die durch den Schriftgrad und pixelsPerDip angegeben wird.

useGdiNatural

Typ: BOOL

Wenn false festgelegt ist, sind die Metriken mit den Metriken des GDI-Aliastexts identisch. Wenn diese Eigenschaft auf TRUE festgelegt ist, sind die Metriken identisch mit den Metriken von Text, der von GDI mithilfe einer Schriftart gemessen wird, die mit CLEARTYPE NATURAL QUALITY erstellt _ _ wurde.

glyphIndices [ In]

Typ: const UINT16 *

Ein Array von Glyphenindizes, für die die Metriken berechnet werden.

glyphCount

Typ: UINT32

Die Anzahl der Elemente im glyphIndices-Array.

glyphMetrics [ out]

Typ: METRIKEN _ DES DWRITE-GLYPHEN _*

Ein Array von _ DWRITE-GLYPH-METRIKstrukturen, _ die von dieser Funktion gefüllt werden. Die Metriken befinden sich in Schriftentwurfseinheiten.

isSideways

Typ: BOOL

Ein BOOL-Wert, der angibt, ob die Schriftart in einer seitwärts ausgeführten Ausführung verwendet wird. Dies kann sich auf die Glyphenmetriken auswirken, wenn die Schriftart über eine schräge Simulation verfügt, da sich die schräge Simulation seitwärts von der nicht seitlichen schrägen Simulation unterscheidet.

Rückgabewert

Typ: HRESULT

HRESULT-Standardfehlercode. Wenn einer der Eingabe-Glyphenindizes außerhalb des gültigen Glyphenindexbereichs für das aktuelle Schriftartgesicht liegt, wird E _ INVALIDARG zurückgegeben.

Anforderungen

Anforderung Wert
Bibliothek
Dwrite.lib
DLL
Dwrite.dll

Siehe auch

IDWriteFontFace

IDWriteFontFace