DWRITE_RENDERING_MODE (Windows 8 and later) enumeration

Represents a method of rendering glyphs.

Note  This topic is about DWRITE_RENDERING_MODE in Windows 8 and later. For info on the previous version see this topic.

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 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_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 modeNew mode
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSICDWRITE_RENDERING_MODE_GDI_CLASSIC
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURALDWRITE_RENDERING_MODE_GDI_NATURAL
DWRITE_RENDERING_MODE_CLEARTYPE_NATURALDWRITE_RENDERING_MODE_CLEARTYPE_NATURAL
DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL_SYMMETRICDWRITE_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

Dwrite.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft