IDWriteFontFace_GetGlyphIndices

フォントの 'CMAP' テーブルで定義された UCS4 Unicode コードポイントからグリフインデックスへの名目上のマッピングを返す。

IDWriteFontFace_GetGlyphIndices this, codePoints, codePointCount, glyphIndices

this : [comobj] IDWriteFontFace インターフェースの COM オブジェクト変数
codePoints : [int] 型: const UINT32* 名目上のグリフインデックスを取得する元となる UCS4 コードポイントの配列。配列は確保され、codePointCount で指定された要素数を格納できる必要がある。
codePointCount : [int] 型: UINT32 codePoints 配列の要素数。
glyphIndices : [int] 型: UINT16* このメソッドが返るときに、この関数が埋める名目上のグリフインデックスの配列へのポインタを格納する。

(プラグイン / モジュール : com_misc.dll)

解説

フォントの 'CMAP' テーブルで定義された UCS4 Unicode
コードポイントからグリフインデックスへの名目上のマッピングを返す。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

[備考]
このマッピングは、主に物理フォント API 上に構築された行レイアウトエンジン向けに提供されることに注意。OpenType
のグリフ置換と行レイアウトの文字置換のため、名目上の変換は特定のフォントフェイスを使用してレンダリングする際に Unicode
文字列がどのようにグリフインデックスにマップされるかと必ずしも一致しない。また、Unicode
の異体字セレクタにより、文字からグリフへの代替マッピングが提供されることにも注意。この呼び出しは常にデフォルトの異体字を返す。フォントに文字が存在しない場合、このメソッドは未定義のグリフ、つまり
".notdef" グリフであるインデックス 0
を返す。文字がフォントに含まれない場合、IDWriteFont::HasCharacter は false
を返し、GetUnicodeRanges もその範囲を返さない。

情報