IDWriteBitmapRenderTarget::D rawGlyphRun, méthode (dwrite.h)

Article
08/23/2023

Dessine une série de glyphes dans une cible bitmap à la position spécifiée.

Syntaxe

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

Paramètres

baselineOriginX

Type : FLOAT

Position horizontale de l’origine de la base de référence, dans les adresses DIPs, par rapport au coin supérieur gauche de la DIB.

baselineOriginY

Type : FLOAT

Position verticale de l’origine de la base de référence, dans les adresses DIPs, par rapport à l’angle supérieur gauche de la DIB.

measuringMode

Type : DWRITE_MEASURING_MODE

Méthode de mesure des glyphes en cours d’exécution, utilisée avec les autres propriétés pour déterminer le mode de rendu.

[in] glyphRun

Type : const DWRITE_GLYPH_RUN*

Structure contenant les propriétés de l’exécution du glyphe.

renderingParams

Type : IDWriteRenderingParams*

Objet qui contrôle le comportement de rendu.

textColor

Type : COLORREF

Couleur de premier plan du texte.

[out, optional] blackBoxRect

Type : RECT*

Rectangle facultatif qui reçoit le cadre englobant (en pixels et non en DIPs) de tous les pixels affectés par le dessin de l’exécution du glyphe. Le rectangle de boîte noire peut s’étendre au-delà des dimensions de la bitmap.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Vous pouvez utiliser IDWriteBitmapRenderTarget::D rawGlyphRun pour effectuer un rendu dans une image bitmap à partir d’un convertisseur de texte personnalisé que vous implémentez. Le convertisseur de texte personnalisé doit appeler cette méthode à partir de la méthode de rappel IDWriteTextRenderer::D rawGlyphRun , comme indiqué dans le code suivant.

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;
}

Les paramètres baselineOriginX, baslineOriginY, measuringMethod et glyphRun sont fournis (sous forme d’arguments) lorsque la méthode de rappel est appelée. Les éléments renderingParams, textColor et blackBoxRect ne le sont pas.

Les paramètres de rendu par défaut peuvent être récupérés à l’aide de la méthode IDWriteFactory::CreateMonitorRenderingParams .

Spécifications


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteBitmapRenderTarget

Partager via