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

• 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

Weitere Informationen

IDWriteFontFace