IDWriteFontFace1::GetGdiCompatibleGlyphAdvances-Methode (dwrite_1.h)

Artikel
08/23/2023

Gibt die pixelbündigen Fortschritte für eine Sequenz von Glyphen zurück.

Syntax

HRESULT GetGdiCompatibleGlyphAdvances(
                 FLOAT               emSize,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
                 BOOL                isSideways,
                 UINT32              glyphCount,
  [in]           UINT16 const        *glyphIndices,
  [out]          INT32               *glyphAdvances
);

Parameter

emSize

Typ: FLOAT

Logische Größe der Schriftart in DIP-Einheiten. Ein DIP ("geräteunabhängiges Pixel") entspricht 1/96 Zoll.

pixelsPerDip

Typ: FLOAT

Anzahl physischer Pixel pro DIP. Wenn der DPI-Wert der Renderingoberfläche beispielsweise 96 beträgt, ist dieser Wert 1,0f. Wenn der DPI-Wert 120 beträgt, ist dieser Wert 120,0f/96.

[in, optional] transform

Typ: const DWRITE_MATRIX*

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 FALSE sind die Metriken mit GDI-Aliastext (DWRITE_MEASURING_MODE_GDI_CLASSIC) identisch. Bei TRUE sind die Metriken identisch mit denen, die von GDI mithilfe einer Schriftart mit CLEARTYPE_NATURAL_QUALITY (DWRITE_MEASURING_MODE_GDI_NATURAL) gemessen werden.

isSideways

Typ: BOOL

Rufen Sie die vertikalen Fortschritte der Glyphe anstelle von horizontalen Fortschritten ab.

glyphCount

Typ: UINT32

Gesamt-Glyphen, für die Anpassungen abgerufen werden sollen.

[in] glyphIndices

Typ: const UINT16*

Ein Array von Glyphen-IDs zum Abrufen von Fortschritten.

[out] glyphAdvances

Typ: const INT32*

Die zurückgegebenen Fortschritte in den Schriftentwurfseinheiten für jede Glyphe.

Rückgabewert

Typ: HRESULT

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

Hinweise

Dies entspricht dem Aufrufen von GetGdiCompatibleGlyphMetrics und der Verwendung nur der erweiterten Breite und Höhe.

Wie GetGdiCompatibleGlyphMetrics befinden sich diese in Entwurfseinheiten, was bedeutet, dass sie von DWRITE_FONT_METRICS::d esignUnitsPerEm herunterskaliert werden müssen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite_1.h
Bibliothek	Dwrite_1.lib
DLL	Dwrite_1.dll

Weitere Informationen

IDWriteFontFace1

Freigeben über