DWRITE_RENDERING_MODE1 enumeration (dwrite_3.h)

  • Article

Specifies how glyphs are rendered.

Syntax

typedef enum DWRITE_RENDERING_MODE1 {
  DWRITE_RENDERING_MODE1_DEFAULT,
  DWRITE_RENDERING_MODE1_ALIASED,
  DWRITE_RENDERING_MODE1_GDI_CLASSIC,
  DWRITE_RENDERING_MODE1_GDI_NATURAL,
  DWRITE_RENDERING_MODE1_NATURAL,
  DWRITE_RENDERING_MODE1_NATURAL_SYMMETRIC,
  DWRITE_RENDERING_MODE1_OUTLINE,
  DWRITE_RENDERING_MODE1_NATURAL_SYMMETRIC_DOWNSAMPLED
} ;

Constants

 
DWRITE_RENDERING_MODE1_DEFAULT
Specifies that the rendering mode is determined automatically, based on the font and size.
DWRITE_RENDERING_MODE1_ALIASED
Specifies that no anti-aliasing is performed. Each pixel is either set to the foreground color of the text or retains the color of the background.
DWRITE_RENDERING_MODE1_GDI_CLASSIC
Specifies that antialiasing is performed in the horizontal direction and the appearance of glyphs is layout-compatible with GDI using CLEARTYPE_QUALITY.
Use DWRITE_MEASURING_MODE_GDI_CLASSIC to get glyph advances. The antialiasing may be either ClearType or grayscale depending on the text antialiasing mode.
DWRITE_RENDERING_MODE1_GDI_NATURAL
Specifies that antialiasing is performed in the horizontal direction and the appearance of glyphs is layout-compatible with GDI using CLEARTYPE_NATURAL_QUALITY.
Glyph advances are close to the font design advances, but are still rounded to whole pixels. Use DWRITE_MEASURING_MODE_GDI_NATURAL to get glyph advances.
The antialiasing may be either ClearType or grayscale depending on the text antialiasing mode.
DWRITE_RENDERING_MODE1_NATURAL
Specifies that antialiasing is performed in the horizontal direction. This rendering mode allows glyphs to be positioned with subpixel precision and
is therefore suitable for natural (i.e., resolution-independent) layout.
The antialiasing may be either ClearType or grayscale depending on the text antialiasing mode.
DWRITE_RENDERING_MODE1_NATURAL_SYMMETRIC
Similar to natural mode except that antialiasing is performed in both the horizontal and vertical directions.
This is typically used at larger sizes to make curves and diagonal lines look smoother.
The antialiasing may be either ClearType or grayscale depending on the text antialiasing mode.
DWRITE_RENDERING_MODE1_OUTLINE
Specifies that rendering should bypass the rasterizer and use the outlines directly. This is typically used at very large sizes.
DWRITE_RENDERING_MODE1_NATURAL_SYMMETRIC_DOWNSAMPLED
Similar to natural symmetric mode except that when possible, text should be rasterized in a downsampled form.

Requirements

Requirement Value
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Header dwrite_3.h