CDC::GetGlyphOutline

Articolo
03/05/2013

Recupera la curva o la bitmap della struttura per un carattere della struttura nel carattere corrente.

DWORD GetGlyphOutline(
   UINT nChar,
   UINT nFormat,
   LPGLYPHMETRICS lpgm,
   DWORD cbBuffer,
   LPVOID lpBuffer,
   const MAT2* lpmat2
) const;

Parametri

nChar
Specifica le informazioni di carattere per il quale è di essere restituita.

nFormat
Specifica il formato in cui la funzione viene restituire informazioni.Può essere uno dei seguenti valori, o 0:

Valore	Significato
GGO_BITMAP	Restituisce la bitmap di icona.Al completamento della funzione, il buffer puntato da lpBuffer contiene un 1 bit per pixel bitmap delle righe iniziano nei limiti di primi quattro byte.
GGO_NATIVE	Restituisce i punti dati della curva nel formato nativo di unità di rasterizzazione, utilizzando le unità.Quando questo valore viene specificato, qualsiasi trasformazione specificata in lpmat2 viene ignorata.

Quando il valore nFormat è 0, la funzione inserisce una struttura GLYPHMETRICS ma non restituisce i dati di glifo- struttura.

lpgm
Punta a una struttura GLYPHMETRICS che specifica la posizione del glifo nella cella del carattere.
cbBuffer
Specifica la dimensione del buffer in cui la funzione copiare le informazioni sul carattere della struttura.Se questo valore è 0 e il parametro nFormat è valori GGO_NATIVE o GGO_BITMAP, la funzione restituisce la dimensione richiesta del buffer.
lpBuffer
Punta a un buffer in cui la funzione copiare le informazioni sul carattere della struttura.Se nFormat specifica il valore GGO_NATIVE, le informazioni vengono copiate sotto forma di strutture TTPOLYCURVE e TTPOLYGONHEADER.Se questo valore è NULL e nFormat è il valore GGO_NATIVE o GGO_BITMAP, la funzione restituisce la dimensione richiesta del buffer.
lpmat2
I punti su MAT2 struttura che contiene una matrice di trasformazione per il carattere.Questo parametro non può essere NULL, anche se il valore GGO_NATIVE è specificato per nFormat.

Valore restituito

Dimensione, in byte, del buffer richieste le informazioni recuperate se cbBuffer è 0 o lpBuffer è NULL.Altrimenti, è un valore positivo se la funzione ha esito positivo, o – 1 se è presente un errore.

Note

Un'applicazione può ruotare i caratteri recuperati in formato bitmap specificando una matrice di trasformazione 2 by-2 nella struttura indicata da lpmat2.

Una struttura di glifo viene restituita come serie di contorni.Ogni contorno è definito da una struttura TTPOLYGONHEADER seguita da tutte le strutture TTPOLYCURVE come sono necessari descriverla.Tutti i punti vengono restituiti come strutture POINTFX e rappresentano posizioni assolute, movimenti non su.Il punto iniziale fornito dal membro pfxStart della struttura TTPOLYGONHEADER è il punto in cui la struttura per un contorno avvia.Le strutture TTPOLYCURVE di seguito possono essere tutti i record della polilinea o scanalare i record.I record polilinea sono le serie di punti; le linee tracciate tra i punti descrivono la struttura del carattere.I record delle spline rappresentano le curve quadratiche utilizzate da TrueType ovvero b- spline quadratiche).