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

Traduit une exécution de glyphe en une séquence d’exécutions de glyphe de couleur, qui peut être rendue pour produire une représentation de couleur de l’exécution « 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

L’origine horizontale et verticale du glyphe de base s’exécute dans les coordonnées de pré-transformation.

[in] glyphRun

Type : DWRITE_GLYPH_RUN

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

[in, optional] glyphRunDescription

Type : DWRITE_GLYPH_RUN_DESCRIPTION

Description facultative de l’exécution du glyphe.

desiredGlyphImageFormats

Type : DWRITE_GLYPH_IMAGE_FORMATS

Les 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 les origines de chaque glyphe.

[in, optional] worldAndDpiTransform

Type : DWRITE_MATRIX

Matrice convertie de l’espace de coordonnées du client en coordonnées d’appareil (pixels), c’est-à-dire la transformation mondiale multipliée par n’importe quelle mise à l’échelle DPI.

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, comme retourné par IDWriteFontFace2 ::GetColorPaletteCount.

[out] colorLayers

Type : IDWriteColorGlyphRunEnumerator1**

Si la fonction réussit, reçoit un pointeur vers un objet d’énumérateur qui peut être utilisé pour obtenir les exécutions de glyphe 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

Retourne DWRITE_E_NOCOLOR si la police n’a pas d’informations de couleur, l’exécution du glyphe ne contient aucun glyphe de couleur ou l’index de palette de couleurs spécifié n’est pas à portée. Dans ce cas, le client doit afficher l’exécution du glyphe d’origine. Sinon, retourne un code d’erreur HRESULT standard.

Remarques

L’appel d’IDWriteFactory2 ::TranslateColorGlyphRun équivaut à appeler IDWriteFactory4 ::TranslateColorGlyph exécuté avec les formats suivants spécifiés : DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

Spécifications

Voir aussi

IDWriteFactory4