DWRITE_RENDERING_MODE (Windows 8 and later) enumeration
Represents a method of rendering glyphs.
Syntax
enum DWRITE_RENDERING_MODE {
DWRITE_RENDERING_MODE_DEFAULT,
DWRITE_RENDERING_MODE_ALIASED,
DWRITE_RENDERING_MODE_GDI_CLASSIC,
DWRITE_RENDERING_MODE_GDI_NATURAL,
DWRITE_RENDERING_MODE_NATURAL,
DWRITE_RENDERING_MODE_NATURAL_SYMMETRIC,
DWRITE_RENDERING_MODE_OUTLINE
};
Constants
- DWRITE_RENDERING_MODE_DEFAULT
-
Specifies that the rendering mode is determined automatically, based on the font and size.
- DWRITE_RENDERING_MODE_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_MODE_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_MODE_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_MODE_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_MODE_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_MODE_OUTLINE
-
Specifies that rendering should bypass the rasterizer and use the outlines directly. This is typically used at very large sizes.
ClearType modes
Starting in Windows 8, the ClearType modes are obsolete, but are kept as aliases to avoid breaking existing code. The DWRITE_TEXT_ANTIALIAS_MODE determines whether antialiasing is ClearType or grayscale.
| Old mode | New mode |
|---|---|
| DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC | DWRITE_RENDERING_MODE_GDI_CLASSIC |
| DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL | DWRITE_RENDERING_MODE_GDI_NATURAL |
| DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL | DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL |
| DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL_SYMMETRIC | DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL_SYMMETRIC |
Requirements
|
Minimum supported client |
Windows 8 and Platform Update for Windows 7 [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | Windows Store apps] |
|
Minimum supported phone |
Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps] |
|
Header |
|