IDWriteTextAnalyzer::GetGlyphPlacements メソッド
フォントおよび書記体系のレンダリング規則に従って、GetGlyphs メソッドからグリフ出力を配置します。
構文
virtual HRESULT GetGlyphPlacements(
[in] const WCHAR * textString,
[in] const UINT16 * clusterMap,
[in] DWRITE_SHAPING_TEXT_PROPERTIES * textProps,
UINT32 textLength,
[in] const UINT16 * glyphIndices,
[in] const DWRITE_SHAPING_GLYPH_PROPERTIES * glyphProps,
UINT32 glyphCount,
IDWriteFontFace * fontFace,
FLOAT fontEmSize,
BOOL isSideways,
BOOL isRightToLeft,
[in] const DWRITE_SCRIPT_ANALYSIS * scriptAnalysis,
[in, optional] const WCHAR * localeName,
[in, optional] const DWRITE_TYPOGRAPHIC_FEATURES ** features,
[in, optional] const UINT32 * featureRangeLengths,
UINT32 featureRanges,
[out] FLOAT * glyphAdvances,
[out] DWRITE_GLYPH_OFFSET * glyphOffsets
) = 0;
パラメーター
textString [in]
グリフの元になった文字列を含む文字配列。clusterMap [in]
文字の範囲からグリフの範囲へのマッピングへのポインター。これは GetGlyphs によって返されます。textProps [in]
各文字の体裁プロパティを含む構造体の配列へのポインター。この構造体は GetGlyphs によって返されます。textLength
textString のテキストの長さ。glyphIndices [in]
GetGlyphs によって返されるグリフ インデックスの配列。glyphProps [in]
GetGlyphs によって返される各グリフの体裁プロパティを含む構造体の配列へのポインター。glyphCount
GetGlyphs から返されるグリフの数。fontFace
出力グリフのソースであるフォント フェイスへのポインター。fontEmSize
論理フォント サイズ (DIP 単位)。isSideways
テキストを垂直方向に描画する場合に TRUE に設定されるブール値のフラグ。isRightToLeft
テキストを右から左に記述する場合に TRUE に設定されるブール値のフラグ。scriptAnalysis [in]
AnalyzeScript の呼び出しによるスクリプト分析結果へのポインター。localeName [in, optional]
グリフの選択時に使用するロケールを含む文字配列。たとえば、ja-jp と zh-chs では、同じ文字が異なるグリフにマップされます。この値が NULL の場合、スクリプトに基づいた既定のマッピングが使用されます。features [in, optional]
各機能範囲で使用する文字体裁機能のセットへのポインターの配列。featureRangeLengths [in, optional]
各機能範囲の長さ (文字数)。すべての長さの合計は、textLength と等しくなる必要があります。featureRanges
機能範囲の数。glyphAdvances [out]
このメソッドが返されるときに、各グリフのアドバンス幅が格納されます。glyphOffsets [out]
このメソッドが返されるときに、各グリフの原点のオフセットが格納されます。
戻り値
メソッドが成功した場合は、S_OK が返されます。 それ以外の場合は、エラー コードが返されます。HRESULT.
要件
クライアントの最小要件 |
Windows 7, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム |
サーバーの最小要件 |
Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム |
ヘッダー |
Dwrite.h |
ライブラリ |
Dwrite.lib |
DLL |
Dwrite.dll |