TextRenderingHint enumeration (gdiplusenums.h)
The TextRenderingHint enumeration specifies the process used to render text. The process affects the quality of the text.
Syntax
typedef enum TextRenderingHint {
TextRenderingHintSystemDefault = 0,
TextRenderingHintSingleBitPerPixelGridFit,
TextRenderingHintSingleBitPerPixel,
TextRenderingHintAntiAliasGridFit,
TextRenderingHintAntiAlias,
TextRenderingHintClearTypeGridFit
} ;
Constants
TextRenderingHintSystemDefaultValue: 0 Specifies that a character is drawn using the currently selected system font smoothing mode (also called a rendering hint). |
TextRenderingHintSingleBitPerPixelGridFitSpecifies that a character is drawn using its glyph bitmap and hinting to improve character appearance on stems and curvature. |
TextRenderingHintSingleBitPerPixelSpecifies that a character is drawn using its glyph bitmap and no hinting. This results in better performance at the expense of quality. |
TextRenderingHintAntiAliasGridFitSpecifies that a character is drawn using its antialiased glyph bitmap and hinting. This results in much better quality due to antialiasing at a higher performance cost. |
TextRenderingHintAntiAliasSpecifies that a character is drawn using its antialiased glyph bitmap and no hinting. Stem width differences may be noticeable because hinting is turned off. |
TextRenderingHintClearTypeGridFitSpecifies that a character is drawn using its glyph ClearType bitmap and hinting. This type of text rendering cannot be used along with CompositingModeSourceCopy. Windows XP and Windows Server 2003 and later versions of Windows only: ClearType rendering is supported only on Windows XP and Windows Server 2003 and later versions of Windows. Therefore, TextRenderingHintClearTypeGridFit is ignored on other operating systems even though GDI+ is supported on those operating systems. |
Remarks
The quality associated with each process varies according to the circumstances. TextRenderingHintClearTypeGridFit provides the best quality for most LCD monitors and relatively small font sizes. TextRenderingHintAntiAlias provides the best quality for rotated text. Generally, a process that produces higher quality text is slower than a process that produces lower quality text.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP, Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | gdiplusenums.h (include Gdiplus.h) |