IDWriteFontFace::GetGdiCompatibleGlyphMetrics-Methode (dwrite.h)
Ruft Glyphenmetriken in Schriftentwurfseinheiten mit den Rückgabewerten ab, die mit dem, was GDI erzeugen würde, kompatibel sind.
Syntax
HRESULT GetGdiCompatibleGlyphMetrics(
FLOAT emSize,
FLOAT pixelsPerDip,
[in, optional] DWRITE_MATRIX const *transform,
BOOL useGdiNatural,
[in] UINT16 const *glyphIndices,
UINT32 glyphCount,
[out] DWRITE_GLYPH_METRICS *glyphMetrics,
BOOL isSideways
);
Parameter
emSize
Typ: FLOAT
Die logische Größe der Schriftart in DIP-Einheiten.
pixelsPerDip
Typ: FLOAT
Die Anzahl der physischen Pixel pro DIP.
[in, optional] transform
Typ: const DWRITE_MATRIX*
Eine optionale Transformation, die auf die Glyphen und deren Positionen angewendet wird. Diese Transformation wird nach der Skalierung angewendet, die durch den Schriftgrad und pixelsPerDip angegeben wird.
useGdiNatural
Typ: BOOL
Bei Festlegung auf FALSE sind die Metriken identisch mit den Metriken von GDI-Aliastext. Wenn sie auf TRUE festgelegt sind, sind die Metriken identisch mit den Metriken von Text, die von GDI mithilfe einer Schriftart gemessen wird, die mit CLEARTYPE_NATURAL_QUALITY erstellt wurde.
[in] glyphIndices
Typ: const UINT16*
Ein Array von Glyphenindizes, für das die Metriken berechnet werden sollen.
glyphCount
Typ: UINT32
Die Anzahl der Elemente im glyphIndices-Array .
[out] glyphMetrics
Typ: DWRITE_GLYPH_METRICS*
Ein Array von DWRITE_GLYPH_METRICS Strukturen, die von dieser Funktion ausgefüllt werden. Die Metriken befinden sich in Schriftentwurfseinheiten.
isSideways
Typ: BOOL
Ein BOOL-Wert, der angibt, ob die Schriftart in einer Seitlaufausführung verwendet wird. Dies kann sich auf die Glyphenmetriken auswirken, wenn die Schriftart über eine schräge Simulation verfügt, da sich die Seitwärtssimulation von der nicht seitlich schrägen Simulation unterscheidet.
Rückgabewert
Typ: HRESULT
Standard-HRESULT-Fehlercode. Wenn sich einer der Eingabeglyphenindizes außerhalb des gültigen Glyphenindexbereichs für die aktuelle Schriftart befindet, wird E_INVALIDARG zurückgegeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |