Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IDWriteFontFace::GetRecommendedRenderingMode method

Determines the recommended rendering mode for the font, using the specified size and rendering parameters.

Syntax


virtual HRESULT GetRecommendedRenderingMode(
        FLOAT                   emSize,
        FLOAT                   pixelsPerDip,
        DWRITE_MEASURING_MODE   measuringMode,
        IDWriteRenderingParams * renderingParams,
  [out] DWRITE_RENDERING_MODE  * renderingMode
) = 0;

Parameters

emSize

Type: FLOAT

The logical size of the font in DIP units. A DIP ("device-independent pixel") equals 1/96 inch.

pixelsPerDip

Type: FLOAT

The number of physical pixels per DIP. For example, if the DPI of the rendering surface is 96, this value is 1.0f. If the DPI is 120, this value is 120.0f/96.

measuringMode

Type: DWRITE_MEASURING_MODE

The measuring method that will be used for glyphs in the font. Renderer implementations may choose different rendering modes for different measuring methods, for example:

renderingParams

Type: IDWriteRenderingParams*

A pointer to an object that contains rendering settings such as gamma level, enhanced contrast, and ClearType level. This parameter is necessary in case the rendering parameters object overrides the rendering mode.

renderingMode [out]

Type: DWRITE_RENDERING_MODE*

When this method returns, contains a value that indicates the recommended rendering mode to use.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

Dwrite.h

Library

Dwrite.lib

DLL

Dwrite.dll

See also

IDWriteFontFace

 

 

Show:
© 2017 Microsoft