IDWriteFactory4::TranslateColorGlyphRun, méthode (dwrite_3.h)

Article
08/23/2023

Convertit une exécution de glyphes en séquence d’exécutions de glyphes de couleur, qui peut être rendue pour produire une représentation en couleur de l’exécution « de base » d’origine.

Syntaxe

HRESULT TranslateColorGlyphRun(
                 D2D1_POINT_2F                      baselineOrigin,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_GLYPH_IMAGE_FORMATS         desiredGlyphImageFormats,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldAndDpiTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator1    **colorLayers
);

Paramètres

baselineOrigin

Type : D2D1_POINT_2F

Origine horizontale et verticale de l’exécution du glyphe de base en coordonnées de pré-transformation.

[in] glyphRun

Type : DWRITE_GLYPH_RUN

Pointeur vers l’exécution de glyphe « de base » d’origine.

[in, optional] glyphRunDescription

Type : DWRITE_GLYPH_RUN_DESCRIPTION

Description de l’exécution de glyphes facultative.

desiredGlyphImageFormats

Type : DWRITE_GLYPH_IMAGE_FORMATS

Formats de données dans lesquels les exécutions doivent être fractionnées.

measuringMode

Type : DWRITE_MEASURING_MODE

Mode de mesure, nécessaire pour calculer l’origine de chaque glyphe.

[in, optional] worldAndDpiTransform

Type : DWRITE_MATRIX

Matrice de conversion de l’espace de coordonnées du client en coordonnées d’appareil (pixels), c’est-à-dire la transformation mondiale multipliée par toute mise à l’échelle PPP.

colorPaletteIndex

Type : UINT32

Index de base zéro de la palette de couleurs à utiliser. Les index valides sont inférieurs au nombre de palettes dans la police, tel que retourné par IDWriteFontFace2::GetColorPaletteCount.

[out] colorLayers

Type : IDWriteColorGlyphRunEnumerator1**

Si la fonction réussit, reçoit un pointeur vers un objet énumérateur qui peut être utilisé pour obtenir les exécutions de glyphes de couleur. Si l’exécution de base n’a pas de glyphes de couleur, le pointeur de sortie est NULL et la méthode retourne DWRITE_E_NOCOLOR.

Valeur retournée

Type : HRESULT

Renvoie DWRITE_E_NOCOLOR si la police ne contient aucune information de couleur, si l’exécution des glyphes ne contient aucun glyphe de couleur ou si l’index de palette de couleurs spécifié est hors limites. Dans ce cas, le client doit restituer l’exécution du glyphe d’origine. Sinon, retourne un code d’erreur HRESULT standard.

Notes

Appeler IDWriteFactory2::TranslateColorGlyphRun équivaut à appeler IDWriteFactory4::TranslateColorGlyph exécuter avec les formats suivants spécifiés : DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

Spécifications


Plateforme cible	Windows
En-tête	dwrite_3.h
Bibliothèque	Dwrite.lib

Voir aussi

IDWriteFactory4

Partager via