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

See also

IDWriteFontFace1