次の方法で共有


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

参照

IDWriteTextAnalyzer