CDC::GetGlyphOutline
Extrait la courbe ou la bitmap d'ensemble pour un caractère d'ensemble de la police actuelle.
DWORD GetGlyphOutline(
UINT nChar,
UINT nFormat,
LPGLYPHMETRICS lpgm,
DWORD cbBuffer,
LPVOID lpBuffer,
const MAT2* lpmat2
) const;
Paramètres
nChar
Spécifie le caractère dont les informations doivent être retournées.nFormat
Spécifie le format dans lequel la fonction est de retourner les informations. Elle peut avoir l'une des valeurs suivantes, ou 0 :Valeur
Signification
GGO_BITMAP
Retourne la bitmap de glyphe. Lorsque la fonction, la mémoire tampon pointée pointe vers lpBuffer contient un 1 bits par pixel de bitmap dont les lignes commencent sur les frontières de double mot.
GGO_NATIVE
Retourne les points de données de courbe au format natif de le rastériseur, à l'aide de les unités. Lorsque cette valeur est spécifiée, toute transformation spécifiée dans lpmat2 est ignorée.
Lorsque la valeur d' nFormat est 0, la fonction remplit une structure de GLYPHMETRICS mais ne retourne pas de données de glyphe- plan.
lpgm
Pointe vers une structure de GLYPHMETRICS qui décrit le positionnement du glyphe dans la cellule de caractère.cbBuffer
Spécifie la taille de la mémoire tampon dans laquelle la fonction copie des informations sur le caractère d'ensemble. Si cette valeur est 0 et le paramètre d' nFormat a les valeurs de GGO_BITMAP ou de GGO_NATIVE , la fonction retourne la taille requise de la mémoire tampon.lpBuffer
Pointe vers une mémoire tampon dans laquelle la fonction copie des informations sur le caractère d'ensemble. Si nFormat spécifie la valeur de GGO_NATIVE , les informations sont copiées sous la forme de structures de TTPOLYGONHEADER et de TTPOLYCURVE . Si cette valeur est NULL et nFormat est la valeur de GGO_BITMAP ou de GGO_NATIVE , la fonction retourne la taille requise de la mémoire tampon.lpmat2
Les points à MAT2 structure qui contient une matrice de transformation du caractère. Ce paramètre ne peut pas être NULL, même lorsque la valeur de GGO_NATIVE est spécifiée pour nFormat.
Valeur de retour
Taille, en octets, de la mémoire tampon requise pour les informations récupérées si cbBuffer est 0 ou lpBuffer est NULL. Sinon, il s'agit d'une valeur positive si la fonction est réussie, ou à 1 en cas de erreur.
Notes
Une application peut faire pivoter des caractères extraits au format bitmap en spécifiant une matrice de transformation 2 by-2 dans la structure pointée pointe vers lpmat2.
Un contour de glyphe est retourné comme une série de découpes. Chaque découpe est définie par une structure de TTPOLYGONHEADER suivi d'un nombre illimité de structures de TTPOLYCURVE comme sont requis de la description. Tous les points sont retournés comme structures de POINTFX et représentent des positions absolues, déplace pas associés. Le point de départ donné par le membre de pfxStart de la structure de TTPOLYGONHEADER est le point auquel le contour d'une découpe démarre. Les structures de TTPOLYCURVE qui suivent peuvent être l'un ou l'autre des enregistrements de polyligne ou canneler des enregistrements. Les enregistrements de polyligne sont une série de points ; les lignes dessinées entre les points décrivent le plan du caractère. Les enregistrements de spline représentent les courbes quadratiques utilisées par TrueType (autrement dit, splines B- quadratiques).
Configuration requise
Header: afxwin.h