IDWriteFontResource::GetFontAxisRanges method (dwrite_3.h)

Article
11/20/2024

Retrieves the value ranges of each axis.

Syntax

HRESULT GetFontAxisRanges(
  [out] DWRITE_FONT_AXIS_RANGE *fontAxisRanges,
        UINT32                 fontAxisRangeCount
);

Parameters

[out] fontAxisRanges

Type: DWRITE_FONT_AXIS_RANGE*

A pointer to an array of DWRITE_FONT_AXIS_RANGE structures into which GetFontAxisRanges writes the list of font axis value ranges. You're responsible for managing the size and the lifetime of this array. Call GetFontAxisCount to determine the size of array to allocate.

fontAxisRangeCount

Type: UINT32

The maximum number of font axis value ranges to write into the memory block pointed to by fontAxisRanges.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Return value	Description
E_INVALIDARG	`fontAxisValueCount` doesn't match the value returned by GetFontAxisCount.

Remarks

A non-varying axis has an empty range (minValue == maxValue).

Requirements

Requirement	Value
Minimum supported client	Windows 10 Build 16299
Minimum supported server	Windows 10 Build 16299
Target Platform	Windows
Header	dwrite_3.h
Library	Dwrite.lib

Share via