Freigeben über

IDWriteFontFace1::GetRecommendedRenderingMode-Methode (dwrite_1.h)

  • Artikel

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

Syntax

HRESULT GetRecommendedRenderingMode(
                 FLOAT                    fontEmSize,
                 FLOAT                    dpiX,
                 FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
                 BOOL                     isSideways,
                 DWRITE_OUTLINE_THRESHOLD outlineThreshold,
                 DWRITE_MEASURING_MODE    measuringMode,
  [out]          DWRITE_RENDERING_MODE    *renderingMode
);

Parameter

fontEmSize

Typ: FLOAT

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

dpiX

Typ: FLOAT

Die Anzahl der physischen Pixel pro DIP in einer horizontalen Position. 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.

dpiY

Typ: FLOAT

Die Anzahl der physischen Pixel pro DIP in einer vertikalen Position. 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.

[in, optional] transform

Typ: const DWRITE_MATRIX*

Gibt die Welttransformation an.

isSideways

Typ: BOOL

Ob die Glyphen im Lauf seitwärts sind oder nicht.

outlineThreshold

Typ: DWRITE_OUTLINE_THRESHOLD

Ein DWRITE_OUTLINE_THRESHOLD typisierter Wert, der die Qualität des Gliederungsrenderings des Grafiksystems angibt, wirkt sich auf den Größenschwellenwert aus, ab dem das Gliederungsrendering verwendet wird.

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

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

Hinweise

Diese Methode sollte verwendet werden, um den tatsächlichen Renderingmodus in Fällen zu bestimmen, in denen der Renderingmodus des Renderingparams-Objekts DWRITE_RENDERING_MODE_DEFAULT ist.

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_1.h
Bibliothek Dwrite_1.lib
DLL Dwrite_1.dll

Weitere Informationen

IDWriteFontFace1