Metodo IDWriteFontFace::GetGlyphRunOutline (dwrite.h)

Articolo
02/26/2024

Calcola la struttura di un'esecuzione di glifi richiamando l'interfaccia del sink struttura.

Sintassi

HRESULT GetGlyphRunOutline(
                 FLOAT                     emSize,
  [in]           UINT16 const              *glyphIndices,
  [in, optional] FLOAT const               *glyphAdvances,
  [in, optional] DWRITE_GLYPH_OFFSET const *glyphOffsets,
                 UINT32                    glyphCount,
                 BOOL                      isSideways,
                 BOOL                      isRightToLeft,
                 IDWriteGeometrySink       *geometrySink
);

Parametri

emSize

Tipo: FLOAT

Dimensioni logiche del tipo di carattere nelle unità DIP. Un DIP ("pixel indipendente dal dispositivo") è uguale a 1/96 pollici.

[in] glyphIndices

Tipo: const UINT16*

Matrice di indici glifi. Glifi sono in ordine logico e la direzione avanzata dipende dal parametro isRightToLeft . La matrice deve essere allocata e può contenere il numero di elementi specificati da glyphCount.

[in, optional] glyphAdvances

Tipo: const FLOAT*

Matrice facoltativa di avanzamenti del glifo in INDIRIZZI DIP. L'avanzamento di un glifo è la quantità per avanzare la posizione (nella direzione della linea di base) dopo aver disegnato il glifo. glifoAdvances contiene il numero di elementi specificati da glyphCount.

[in, optional] glyphOffsets

Tipo: const DWRITE_GLYPH_OFFSET*

Matrice facoltativa di offset del glifo, ognuna delle quali specifica l'offset lungo la linea di base e l'offset perpendicolare alla linea di base di un glifo rispetto alla posizione della penna corrente. glifoOffsets contiene il numero di elementi specificati da glyphCount.

glyphCount

Tipo: UINT32

Numero di glifi nell'esecuzione.

isSideways

Tipo: BOOL

Se TRUE, l'ascendente del glifo viene eseguito insieme alla linea di base. Se FALSE, il glifo crescente viene eseguito perpendicolare alla linea di base. Ad esempio, un alfabeto inglese in una baseline verticale è impostato su FALSE.

Un client può eseguire il rendering di un'esecuzione verticale impostando suTRUE e ruotando la geometria risultante a 90 gradi a destra usando una trasformazione. I parametri isSideways e isRightToLeft non possono essere entrambi true.

isRightToLeft

Tipo: BOOL

Ordine visivo degli glifi. Se questo parametro è FALSE, glifi avanzano da sinistra a destra. Se TRUE, la direzione di avanzamento è destra a sinistra. Per impostazione predefinita, la direzione di avanzamento viene lasciata a destra.

geometrySink

Tipo: IDWriteGeometrySink*

Puntatore all'interfaccia richiamata per eseguire operazioni di disegno struttura.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dwrite.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Vedi anche

IDWriteFontFace

Condividi tramite