IDWriteFontFace4 ::GetGlyphImageData, méthode (dwrite_3.h)
Obtient un pointeur vers les données de glyphe en fonction du format d’image souhaité.
Syntaxe
HRESULT GetGlyphImageData(
[in] UINT16 glyphId,
UINT32 pixelsPerEm,
DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
[out] DWRITE_GLYPH_IMAGE_DATA *glyphData,
[out] void **glyphDataContext
);
Paramètres
[in] glyphId
Type : UINT16
ID du glyphe pour lequel récupérer les données d’image.
pixelsPerEm
Type : UINT32
Pixels demandés par em.
glyphImageFormat
Type : DWRITE_GLYPH_IMAGE_FORMATS
Spécifie les formats pris en charge dans la police.
[out] glyphData
Type : DWRITE_GLYPH_IMAGE_DATA*
Lors du retour, contient les données d’un glyphe.
[out] glyphDataContext
Type : void**
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Notes
Le glyphDataContext doit être libéré via ReleaseGlyphImageData si les données ne sont pas vides, à l’instar de IDWriteFontFileStream ::ReadFileFragment et IDWriteFontFileStream ::ReleaseFileFragment. Le pointeur de données est valide tant que l’IDWriteFontFace existe et que ReleaseGlyphImageData n’a pas été appelé.
L’DWRITE_GLYPH_IMAGE_DATA ::uniqueDataId est utile à des fins de mise en cache, de sorte que si la même ressource est retournée plusieurs fois, une ressource existante peut être récupérée rapidement au lieu d’avoir besoin de rééparer ou de décompresser les données.
La fonction retourne uniquement des données SVG ou raster : la demande de données TrueType/CFF/COLR retourne DWRITE_E_INVALIDARG. Celles-ci doivent être dessinées via DrawGlyphRun ou interrogées à l’aide de GetGlyphOutline à la place. Un seul format peut être demandé ou la fonction retourne DWRITE_E_INVALIDARG. Si le glyphe n’a pas ce format, l’appel n’est pas une erreur, mais la fonction retourne des données vides.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | dwrite_3.h |
| Bibliothèque | Dwrite.lib |