Funzione GetGlyphOutlineW (wingdi.h)

La funzione GetGlyphOutline recupera la struttura o la bitmap per un carattere nel tipo di carattere TrueType selezionato nel contesto di dispositivo specificato.

Sintassi

DWORD GetGlyphOutlineW(
  [in]  HDC            hdc,
  [in]  UINT           uChar,
  [in]  UINT           fuFormat,
  [out] LPGLYPHMETRICS lpgm,
  [in]  DWORD          cjBuffer,
  [out] LPVOID         pvBuffer,
  [in]  const MAT2     *lpmat2
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] uChar

Carattere per il quale devono essere restituiti i dati.

[in] fuFormat

Formato dei dati recuperati dalla funzione. Questo parametro può essere uno dei valori seguenti.

Si noti che, per i valori GGO_GRAYn_BITMAP, la funzione recupera una bitmap del glifo contenente n^2+1 (n quadrati più uno) livelli di grigio.

[out] lpgm

Puntatore alla struttura GLYPHMETRICS che descrive la posizione del glifo nella cella di caratteri.

[in] cjBuffer

Dimensioni, in byte, del buffer (*lpvBuffer) in cui la funzione deve copiare informazioni sul carattere di struttura. Se questo valore è zero, la funzione restituisce le dimensioni necessarie del buffer.

[out] pvBuffer

Puntatore al buffer che riceve informazioni sul carattere di struttura. Se questo valore è NULL, la funzione restituisce le dimensioni necessarie del buffer.

[in] lpmat2

Puntatore a una struttura MAT2 che specifica una matrice di trasformazione per il carattere.

Valore restituito

Se viene specificato GGO_BITMAP, GGO_GRAY2_BITMAP, GGO_GRAY4_BITMAP, GGO_GRAY8_BITMAP o GGO_NATIVE e la funzione ha esito positivo, il valore restituito è maggiore di zero; in caso contrario, il valore restituito è GDI_ERROR. Se viene specificato uno di questi flag e la dimensione o l'indirizzo del buffer è zero, il valore restituito specifica le dimensioni del buffer necessarie, in byte.

Se viene specificato GGO_METRICS e la funzione ha esito negativo, il valore restituito viene GDI_ERROR.

Osservazioni

Il contorno del glifo restituito dalla funzione GetGlyphOutline è per un glifo a griglia. Un glifo dotato di griglia è un glifo modificato in modo che la sua immagine bitmap sia conforme al più possibile alla progettazione originale del glifo. Se un'applicazione necessita di un contorno glifo non modificato, può richiedere il contorno del glifo per un carattere in un tipo di carattere la cui dimensione è uguale all'unità em del tipo di carattere. Il valore dell'unità em di un tipo di carattere viene archiviato nel membro otmEMSquare della struttura OUTLINETEXTMETRIC.

La bitmap del glifo restituita da GetGlyphOutline quando si specifica GGO_BITMAP è una bitmap monocromatica allineata a DWORD, orientata alle righe. Quando si specifica GGO_GRAY2_BITMAP, la bitmap restituita è una matrice DWORD allineata alle righe di byte i cui valori sono compresi tra 0 e 4. Quando si specifica GGO_GRAY4_BITMAP, la bitmap restituita è una matrice DWORD allineata alle righe di byte i cui valori sono compresi tra 0 e 16. Quando si specifica GGO_GRAY8_BITMAP, la bitmap restituita è una matrice di byte allineata a DWORD e orientata alle righe i cui valori sono compresi tra 0 e 64.

Il buffer nativo restituito da GetGlyphOutline quando viene specificato GGO_NATIVE è un contorno del glifo. Un contorno del glifo viene restituito come una serie di uno o più contorni definiti da una struttura TTPOLYGONHEADER seguita da una o più curve. Ogni curva del contorno è definita da una struttura TTPOLYCURVE seguita da un numero di punti dati POINTFX . pointFX punti sono posizioni assolute, non spostamenti relativi. Il punto iniziale di un contorno viene assegnato dal membro pfxStart della struttura TTPOLYGONHEADER. Il punto iniziale di ogni curva è l'ultimo punto della curva precedente o il punto iniziale del contorno. Il conteggio dei punti dati in una curva viene archiviato nel membro cpfx di struttura di TTPOLYCURVE. Le dimensioni di ogni contorno nel buffer, in byte, vengono archiviate nel membro cb di struttura TTPOLYGONHEADER. Le definizioni di curva aggiuntive vengono compresse nel buffer dopo le curve precedenti e i contorni aggiuntivi vengono compressi nel buffer seguendo i contorni precedenti. Il buffer contiene il numero di contorni che rientrano nel buffer restituito da GetGlyphOutline.

La struttura GLYPHMETRICS specifica la larghezza della cella di caratteri e la posizione di un glifo all'interno della cella di caratteri. L'origine della cella di caratteri si trova sul lato sinistro della cella in corrispondenza della linea di base del tipo di carattere. La posizione dell'origine del glifo è relativa all'origine della cella di caratteri. L'altezza di una cella di caratteri, la linea di base e altre metriche globali per il tipo di carattere vengono date dalla struttura OUTLINETEXTMETRIC .

Un'applicazione può modificare i caratteri recuperati in formato bitmap o nativo specificando una matrice di trasformazione 2 per 2 nel parametro lpMatrix. Ad esempio, il glifo può essere modificato da taglio, rotazione, ridimensionamento o qualsiasi combinazione dei tre usando la moltiplicazione della matrice.

Altre informazioni sui contorni di un glifo si trovano nelle specifiche tecniche TrueType e OpenType.

Fabbisogno

Vedere anche

ExtTextOut

FORM_INFO_1

funzioni di tipo carattere e testo

panoramica tipi di carattere e testo

GLYPHMETRICS

GetOutlineTextMetrics

MAT2

OUTLINETEXTMETRIC

POINT

POINTFX

TTPOLYCURVE

TTPOLYGONHEADER