IDWriteGlyphRunAnalysis

グリフランのレンダリングに使用される低レベル情報を格納します。

アルファテクスチャは、2値(bi-level)アルファテクスチャまたは ClearType アルファテクスチャのいずれかになります。

2値アルファテクスチャは1ピクセルあたり1バイトを含むため、2値テクスチャ用バッファのサイズはテクスチャ境界の面積(バイト単位)になります。CreateAlphaTexture によって作成された2値アルファテクスチャの各バイトは、DWRITE_ALPHA_MAX(つまり 255)またはゼロのいずれかに設定されます。

ClearType アルファテクスチャは1ピクセルあたり3バイトを含むため、ClearType アルファテクスチャ用バッファのサイズはテクスチャ境界の面積の3倍(バイト単位)になります。

例

次のコード例は、グリフラン解析オブジェクトを作成する方法を示しています。この例では、空のグリフランを使用しています。

HRESULT CreateGlyphRunAnalysis(IDWriteFontFace *pFontFace, IDWriteGlyphRunAnalysis **ppGlyphRunAnalysis)
{
    HRESULT hr = S_OK;
    IDWriteFactory* pDWriteFactory = NULL;

    // Create the DirectWrite factory.
    hr = DWriteCreateFactory(
            DWRITE_FACTORY_TYPE_SHARED,
            __uuidof(IDWriteFactory),
            reinterpret_cast<IUnknown**>(&pDWriteFactory)
            );

    DWRITE_GLYPH_RUN emptyGlyphRun = { 0 };
    UINT16 glyphIndex = 0;
    
    emptyGlyphRun.fontFace = pFontFace;
    emptyGlyphRun.glyphIndices = &glyphIndex;
    emptyGlyphRun.glyphCount = 0;
   
    emptyGlyphRun.fontEmSize = 12;

    IDWriteGlyphRunAnalysis* pGlyphRunAnalysis = NULL;

    if (SUCCEEDED(hr))
    {
        hr = pDWriteFactory->CreateGlyphRunAnalysis(
            &emptyGlyphRun,
            1.0f, // pixelsPerDip,
            NULL, // transform,
            DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC,
            DWRITE_MEASURING_MODE_GDI_CLASSIC,
            0.0f, // baselineOriginX,
            0.0f, // baselineOriginY,
            &pGlyphRunAnalysis);
    }
    
    *ppGlyphRunAnalysis = pGlyphRunAnalysis;

    SafeRelease(&pDWriteFactory);

    return S_OK;
}

グリフランの影響を受ける物理ピクセルの境界矩形を取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

指定した境界矩形内のグリフに対して、指定した種類のアルファテクスチャを作成します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

ClearType ブレンディングに必要なアルファブレンディングプロパティを取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。