IDWriteFactory2::TranslateColorGlyphRun, méthode (dwrite_2.h)

Article
08/23/2023

Cette méthode est appelée sur une exécution de glyphe pour la traduire en plusieurs exécutions de glyphes de couleur.

Syntaxe

HRESULT TranslateColorGlyphRun(
                 FLOAT                              baselineOriginX,
                 FLOAT                              baselineOriginY,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldToDeviceTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator     **colorLayers
);

Paramètres

baselineOriginX

Type : FLOAT

Origine horizontale de la ligne de base de l’exécution du glyphe d’origine.

baselineOriginY

Type : FLOAT

Origine de la ligne de base verticale de l’exécution du glyphe d’origine.

[in] glyphRun

Type : const DWRITE_GLYPH_RUN*

Exécution de glyphe d’origine contenant des ID de glyphes monochromes.

[in, optional] glyphRunDescription

Type : const DWRITE_GLYPH_RUN_DESCRIPTION*

Description facultative de l’exécution du glyphe.

measuringMode

Type : DWRITE_MEASURING_MODE

Mode de mesure utilisé pour calculer les positions de glyphe si l’exécution contient des glyphes de couleur.

[in, optional] worldToDeviceTransform

Type : const DWRITE_MATRIX*

Transformation mondiale multipliée par n’importe quelle mise à l’échelle DPI. Cela est nécessaire pour calculer les positions de glyphe si l’exécution contient des glyphes de couleur et que le mode de mesure n’est pas DWRITE_MEASURING_MODE_NATURAL. Si ce paramètre a la valeur NULL et que la transformation d’identité est supposée.

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 : IDWriteColorGlyphRunEnumerator**

Si l’exécution de glyphe d’origine contient des glyphes de couleur, ce paramètre reçoit un pointeur vers une interface IDWriteColorGlyphRunEnumerator . Le client utilise l’interface retournée pour obtenir des informations sur les exécutions de glyphes et les couleurs associées à restituer au lieu de l’exécution du glyphe d’origine. Si l’exécution du glyphe d’origine ne contient pas de glyphes de couleur, cette méthode retourne DWRITE_E_NOCOLOR et le pointeur de sortie est NULL.

Valeur retournée

Type : HRESULT

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

Notes

Si le code appelle cette méthode avec une exécution de glyphe qui ne contient aucune information de couleur, la méthode retourne DWRITE_E_NOCOLOR pour informer l’application qu’elle peut simplement dessiner l’exécution du glyphe d’origine. Si l’exécution du glyphe contient des informations de couleur, la fonction retourne un objet qui peut être énuméré pour exposer les exécutions et les couleurs associées. L’application appelle ensuite DrawGlyphRun avec chacune des exécutions de glyphe et des couleurs de premier plan retournées.

Spécifications


Client minimal pris en charge	Windows 8.1 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite_2.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteFactory2

Partager via