IDWriteFontFace1::GetVerticalGlyphVariants method (dwrite_1.h)

Retrieves the vertical forms of the nominal glyphs retrieved from GetGlyphIndices.

Syntax

HRESULT GetVerticalGlyphVariants(
        UINT32       glyphCount,
  [in]  UINT16 const *nominalGlyphIndices,
  [out] UINT16       *verticalGlyphIndices
);

Parameters

glyphCount

Type: UINT32

The number of glyphs to retrieve.

[in] nominalGlyphIndices

Type: const UINT16*

Original glyph indices from cmap.

[out] verticalGlyphIndices

Type: UINT16*

The vertical form of glyph indices.

Return value

Type: HRESULT

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

Remarks

The retrieval uses the font's 'vert' table. This is used in CJK vertical layout so the correct characters are shown.

Call GetGlyphIndices to get the nominal glyph indices, followed by calling this to remap the to the substituted forms, when the run is sideways, and the font has vertical glyph variants. See HasVerticalGlyphVariants for more info.

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header dwrite_1.h
Library Dwrite_1.lib
DLL Dwrite_1.dll

See also

IDWriteFontFace1