Freigeben über

IDWriteFontFace::GetGdiCompatibleGlyphMetrics-Methode (dwrite.h)

  • Artikel

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

Weitere Informationen

IDWriteFontFace