Microsoft DirectX 9.0 SDK Update (October 2004)

FontQuality Enumeration

Language:

Note: This documentation is preliminary and is subject to change.

Specifies the level of font quality.

Definition

Visual Basic .NET Public Enum FontQuality
C# public enum FontQuality
Managed C++ __value public enum FontQuality
JScript .NET public enum FontQuality

Members

Member Value Description
ClearTypeNatural 6 Text is rendered using the Microsoft® ClearType® antialiasing (smoothing) method when possible. The font quality is given more importance than maintaining the text size; thus, the text width can change. When using this mode for measuring and rendering, ensure that the application does not cache any layout information. If it does, remote users who do not have Microsoft® ClearType® enabled will view different width and metrics.
ClearType 5 Microsoft® Windows® XP: Text is rendered using the Microsoft® ClearType® antialiasing method when possible. The font quality is given less importance than maintaining the text size.
AntiAliased 4 Microsoft® Windows NT® 4.0 and later: Font is antialiased, if it supports antialiasing and if its size falls within the accepted range.

Microsoft® Windows® 95 with Microsoft® Plus!, Microsoft® Windows® 98/Microsoft® Windows® Millennium Edition (Windows Me): The display must be greater than 8-bit color, must be a single plane device, cannot be a palette display, and cannot be part of a multiple-display monitor setup. In addition, a TrueType® font must be selected into a screen device context before it is used in a DIBSection (a structure that contains information about a device-independent bitmap); otherwise, antialiasing does not occur.
NonAntiAliased 3 Microsoft® Windows® 95 with Microsoft® Plus!, Microsoft® Windows® 98/Microsoft® Windows® Millennium Edition (Windows Me), Microsoft® Windows NT® 4.0 and later: Font is never antialiased.
Proof 2 Font's character quality is given more importance than exact matching of the logical-font attributes. For Microsoft® Windows® Graphics Device Interface (GDI) raster fonts, scaling is disabled and the font closest in size is chosen. Although this size might not correspond exactly when Proof is used, the font's quality is high and its appearance is not distorted. Bold, italic, underline, and strikeout fonts are synthesized if necessary.
Draft 1 Font's appearance is given less importance than when the Proof value is used. Scaling is enabled for Microsoft® Windows® Graphics Device Interface (GDI) raster fonts, which means that more font sizes are available, but their quality might be lower. Bold, italic, underline, and strikeout fonts are synthesized if necessary.
Default 0 Font's appearance does not matter.

Remarks

In Microsoft® Windows® XP, the following situations do not support Microsoft ClearType® antialiasing:

Enumeration Information

Namespace Microsoft.DirectX.Direct3D
Assembly Microsoft.DirectX.Direct3DX (microsoft.directx.direct3dx.dll)
Strong Name Microsoft.DirectX.Direct3DX,  Version=1.0.2902.0,  Culture=neutral,  PublicKeyToken=31bf3856ad364e35

© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center