IDWriteFontFace3::GetRecommendedRenderingMode-Methode (dwrite_3.h)

Bestimmt den empfohlenen Textrendering- und Rasterpassmodus basierend auf Schriftart, Größe, Welttransformation und Messmodus.

Syntax

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

Parameter

[in] fontEmSize

Typ: FLOAT

Logischer Schriftgrad in DIPs.

[in] dpiX

Typ: FLOAT

Anzahl von Pixeln pro logischem Zoll in horizontaler Richtung.

[in] dpiY

Typ: FLOAT

Anzahl von Pixeln pro logischem Zoll in vertikaler Richtung.

[in, optional] transform

Typ: const DWRITE_MATRIX*

Eine DWRITE_MATRIX Struktur, die die Welttransformation beschreibt.

[in] isSideways

Typ: BOOL

Gibt an, ob die Schriftart seitlich ist. TRUE , wenn die Schriftart seitwärts ist; andernfalls FALSE.

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

[in] measuringMode

Typ: DWRITE_MEASURING_MODE

Ein DWRITE_MEASURING_MODE typisierter Wert, der die Methode angibt, die zum Messen während des Textlayouts verwendet wird. Für einen ordnungsgemäßen Glyphenabstand gibt diese Methode einen Renderingmodus zurück, der mit dem angegebenen Messmodus kompatibel ist.

[in, optional] renderingParams

Typ: IDWriteRenderingParams*

Ein Zeiger auf eine IDWriteRenderingParams-Schnittstelle für das Renderingparameterobjekt. Dieser Parameter ist für den Fall erforderlich, dass das Renderingparameterobjekt den Renderingmodus überschreibt.

[out] renderingMode

Typ: DWRITE_RENDERING_MODE1*

Ein Zeiger auf eine Variable, die einen DWRITE_RENDERING_MODE1 typisierten Wert für den empfohlenen Renderingmodus empfängt.

[out] gridFitMode

Typ: DWRITE_GRID_FIT_MODE*

Ein Zeiger auf eine Variable, die einen DWRITE_GRID_FIT_MODE typisierten Wert für den empfohlenen Rasterpassmodus empfängt.

Rückgabewert

Typ: HRESULT

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

Anforderungen

Weitere Informationen

IDWriteFontFace3