Freigeben über


IDWriteFontFace::GetRecommendedRenderingMode-Methode (dwrite.h)

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.:

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