IDWriteBitmapRenderTarget::D rawGlyphRun メソッド (dwrite.h)

指定した位置にあるビットマップ ターゲットにグリフの実行を描画します。

構文

HRESULT DrawGlyphRun(
                  FLOAT                  baselineOriginX,
                  FLOAT                  baselineOriginY,
                  DWRITE_MEASURING_MODE  measuringMode,
  [in]            DWRITE_GLYPH_RUN const *glyphRun,
                  IDWriteRenderingParams *renderingParams,
                  COLORREF               textColor,
  [out, optional] RECT                   *blackBoxRect
);

パラメーター

baselineOriginX

型: FLOAT

DIB の左上隅に対する基準原点の水平方向の位置 (DIP 単位)。

baselineOriginY

型: FLOAT

DIB の左上隅に対する基準原点の垂直方向の位置 (DIP 単位)。

measuringMode

種類: DWRITE_MEASURING_MODE

実行中のグリフの測定方法。レンダリング モードを決定するために他のプロパティと共に使用されます。

[in] glyphRun

型: const DWRITE_GLYPH_RUN*

グリフ実行のプロパティを含む 構造体。

renderingParams

種類: IDWriteRenderingParams*

レンダリング動作を制御する オブジェクト。

textColor

種類: COLORREF

テキストの前景色。

[out, optional] blackBoxRect

種類: RECT*

グリフ実行の描画によって影響を受けるすべてのピクセルの境界ボックス (DIP ではなくピクセル単位) を受け取る省略可能な四角形。 黒いボックスの四角形は、ビットマップの寸法を超えて延びることがあります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

IDWriteBitmapRenderTarget::D rawGlyphRun を使用して、実装するカスタム テキスト レンダラーからビットマップにレンダリングできます。 カスタム テキスト レンダラーは、次のコードに示すように 、IDWriteTextRenderer::D rawGlyphRun コールバック メソッド内からこのメソッドを呼び出す必要があります。

STDMETHODIMP GdiTextRenderer::DrawGlyphRun(
    __maybenull void* clientDrawingContext,
    FLOAT baselineOriginX,
    FLOAT baselineOriginY,
    DWRITE_MEASURING_MODE measuringMode,
    __in DWRITE_GLYPH_RUN const* glyphRun,
    __in DWRITE_GLYPH_RUN_DESCRIPTION const* glyphRunDescription,
    IUnknown* clientDrawingEffect
    )
{
    HRESULT hr = S_OK;

    // Pass on the drawing call to the render target to do the real work.
    RECT dirtyRect = {0};

    hr = pRenderTarget_->DrawGlyphRun(
        baselineOriginX,
        baselineOriginY,
        measuringMode,
        glyphRun,
        pRenderingParams_,
        RGB(0,200,255),
        &dirtyRect
        );
    

    return hr;
}

callback メソッドが呼び出されると、 baselineOriginX、 baslineOriginY、 measuringMethod、 glyphRun の各パラメーターが (引数として) 指定されます。 renderingParams、textColor、blackBoxRect は使用されません。

既定のレンダリング パラメーターは、 IDWriteFactory::CreateMonitorRenderingParams メソッドを 使用して取得できます。

要件

関連項目

IDWriteBitmapRenderTarget