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*

Le retour contient des données pour 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.

Remarques

Le glyphDataContext doit être libéré via ReleaseGlyphImageData lorsque les données ne sont pas vides, comme 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é.

Le DWRITE_GLYPH_IMAGE_DATA ::uniqueDataId est utile à des fins de mise en cache afin que si la même ressource est retournée plusieurs fois, une ressource existante peut être récupérée rapidement plutôt que de devoir analyser ou 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. Ceux-ci doivent être dessinés via DrawGlyphRun ou interrogés à l’aide de GetGlyphOutline à la place. Exactement un 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.

Spécifications

Voir aussi

IDWriteFontFace4