IDWriteTextAnalyzer::GetGdiCompatibleGlyphPlacements メソッド (dwrite.h)
フォントと書き込みシステムのレンダリング ルールに従って 、GetGlyphs メソッドから出力されるグリフを配置します。
構文
HRESULT GetGdiCompatibleGlyphPlacements(
[in] WCHAR const *textString,
[in] UINT16 const *clusterMap,
[in] DWRITE_SHAPING_TEXT_PROPERTIES *textProps,
UINT32 textLength,
[in] UINT16 const *glyphIndices,
[in] DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProps,
UINT32 glyphCount,
[in] IDWriteFontFace *fontFace,
FLOAT fontEmSize,
FLOAT pixelsPerDip,
[in, optional] DWRITE_MATRIX const *transform,
BOOL useGdiNatural,
BOOL isSideways,
BOOL isRightToLeft,
[in] DWRITE_SCRIPT_ANALYSIS const *scriptAnalysis,
[in, optional] WCHAR const *localeName,
[in, optional] DWRITE_TYPOGRAPHIC_FEATURES const **features,
[in, optional] UINT32 const *featureRangeLengths,
UINT32 featureRanges,
[out] FLOAT *glyphAdvances,
[out] DWRITE_GLYPH_OFFSET *glyphOffsets
);
パラメーター
[in] textString
型: const WCHAR*
グリフの取得元の元の文字列を含む文字の配列。
[in] clusterMap
型: const UINT16*
文字範囲からグリフ範囲へのマッピングへのポインター。 これは GetGlyphs によって返されます。
[in] textProps
種類: DWRITE_SHAPING_TEXT_PROPERTIES*
各文字のシェイプ プロパティを含む構造体の配列へのポインター。 この構造体は GetGlyphs によって返されます。
textLength
型: UINT32
textString のテキスト長。
[in] glyphIndices
型: const UINT16*
GetGlyphs によって返されるグリフ インデックスの配列。
[in] glyphProps
型: const DWRITE_SHAPING_GLYPH_PROPERTIES*
GetGlyphs によって返される各グリフのシェイプ プロパティを含む構造体の配列へのポインター。
glyphCount
型: UINT32
GetGlyphs から返されるグリフの数。
[in] fontFace
種類: IDWriteFontFace*
出力グリフのソースであるフォント面へのポインター。
fontEmSize
型: FLOAT
DIP の論理フォント サイズ。
pixelsPerDip
型: FLOAT
DIP あたりの物理ピクセル数。
[in, optional] transform
型: const DWRITE_MATRIX*
グリフとその位置に適用される省略可能な変換。 この変換は、フォント サイズと pixelsPerDip で指定されたスケーリングの後に適用されます。
useGdiNatural
種類: BOOL
FALSE に設定すると、メトリックは GDI エイリアステキストのメトリックと同じです。 TRUE に設定すると、メトリックは、CLEARTYPE_NATURAL_QUALITYで作成されたフォントを使用して GDI によって測定されるテキストのメトリックと同じです。
isSideways
種類: BOOL
テキストを垂直方向に描画する場合は、ブール値フラグを TRUE に設定します。
isRightToLeft
種類: BOOL
右から左へのテキストの場合、ブール型のフラグを TRUE に設定します。
[in] scriptAnalysis
型: const DWRITE_SCRIPT_ANALYSIS*
AnalyzeScript 呼び出しからのスクリプト分析結果へのポインター。
[in, optional] localeName
型: const WCHAR*
グリフを選択するときに使用するロケールを含む文字の配列。 たとえば、同じ文字が ja-jp と zh-chs の異なるグリフにマップされる場合があります。 これが NULL の場合は、スクリプトに基づく既定のマッピングが使用されます。
[in, optional] features
型: const DWRITE_TYPOGRAPHIC_FEATURES**
各機能範囲で使用する文字体裁機能のセットへのポインターの配列。
[in, optional] featureRangeLengths
型: const UINT32*
各特徴範囲の長さ (文字数)。
すべての長さの合計は textLength と等しい必要があります。
featureRanges
型: UINT32
特徴範囲の数。
[out] glyphAdvances
型: FLOAT*
このメソッドから制御が戻るときに、各グリフの前の幅が格納されます。
[out] glyphOffsets
種類: DWRITE_GLYPH_OFFSET*
このメソッドが戻るときに、各グリフの原点のオフセットを格納します。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | dwrite.h |
| Library | Dwrite.lib |
| [DLL] | Dwrite.dll |