IDWriteFontFace::GetRecommendedRenderingMode-Methode (dwrite.h)

Artikel
02/26/2024

Bestimmt den empfohlenen Renderingmodus für die Schriftart mit der angegebenen Größe und den angegebenen Renderingparametern.

Syntax

HRESULT GetRecommendedRenderingMode(
        FLOAT                  emSize,
        FLOAT                  pixelsPerDip,
        DWRITE_MEASURING_MODE  measuringMode,
        IDWriteRenderingParams *renderingParams,
  [out] DWRITE_RENDERING_MODE  *renderingMode
);

Parameter

emSize

Typ: FLOAT

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

pixelsPerDip

Typ: FLOAT

Die Anzahl der physischen Pixel pro DIP. Wenn der DPI der Renderingoberfläche beispielsweise 96 ist, ist dieser Wert 1,0f. Wenn der DPI 120 ist, ist dieser Wert 120.0f/96.

measuringMode

Typ: DWRITE_MEASURING_MODE

Die Messmethode, die für Glyphen in der Schriftart verwendet wird. Rendererimplementierungen können verschiedene Renderingmodi für verschiedene Messmethoden auswählen, z. B.:

DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL für DWRITE_MEASURING_MODE_NATURAL
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC für DWRITE_MEASURING_MODE_GDI_CLASSIC
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL für DWRITE_MEASURING_MODE_GDI_NATURAL

renderingParams

Typ: IDWriteRenderingParams*

Ein Zeiger auf ein Objekt, das Renderingeinstellungen wie Gammastufe, erweiterter Kontrast und ClearType-Ebene enthält. Dieser Parameter ist erforderlich, wenn das Renderingparameterobjekt den Renderingmodus außer Kraft setzt.

[out] renderingMode

Typ: DWRITE_RENDERING_MODE*

Wenn diese Methode zurückgibt, enthält einen Wert, der den empfohlenen Renderingmodus angibt, der verwendet werden soll.

Rückgabewert

Typ: HRESULT

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteFontFace

Freigeben über