Metodo IDWriteTextAnalyzer::GetGdiCompatibleGlyphPlacements (dwrite.h)

Posizionare l'output degli glifi dal metodo GetGlyphs in base al tipo di carattere e alle regole di rendering del sistema di scrittura.

Sintassi

HRESULT GetGdiCompatibleGlyphPlacements(
  [in]           WCHAR const                           *textString,
  [in]           UINT16 const                          *clusterMap,
  [in]           DWRITE_SHAPING_TEXT_PROPERTIES        *textProps,
                 UINT32                                textLength,
  [in]           UINT16 const                          *glyphIndices,
  [in]           DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProps,
                 UINT32                                glyphCount,
  [in]           IDWriteFontFace                       *fontFace,
                 FLOAT                                 fontEmSize,
                 FLOAT                                 pixelsPerDip,
  [in, optional] DWRITE_MATRIX const                   *transform,
                 BOOL                                  useGdiNatural,
                 BOOL                                  isSideways,
                 BOOL                                  isRightToLeft,
  [in]           DWRITE_SCRIPT_ANALYSIS const          *scriptAnalysis,
  [in, optional] WCHAR const                           *localeName,
  [in, optional] DWRITE_TYPOGRAPHIC_FEATURES const     **features,
  [in, optional] UINT32 const                          *featureRangeLengths,
                 UINT32                                featureRanges,
  [out]          FLOAT                                 *glyphAdvances,
  [out]          DWRITE_GLYPH_OFFSET                   *glyphOffsets
);

Parametri

[in] textString

Tipo: const WCHAR*

Matrice di caratteri contenente la stringa originale da cui sono venuti glifi.

[in] clusterMap

Tipo: const UINT16*

Puntatore al mapping da intervalli di caratteri a intervalli di glifi. Viene restituito da GetGlyphs.

[in] textProps

Tipo: DWRITE_SHAPING_TEXT_PROPERTIES*

Puntatore a una matrice di strutture che contiene le proprietà di forma per ogni carattere. Questa struttura viene restituita da GetGlyphs.

textLength

Tipo: UINT32

Lunghezza del testo di textString.

[in] glyphIndices

Tipo: const UINT16*

Matrice di indici glifi restituiti da GetGlyphs.

[in] glyphProps

Tipo: const DWRITE_SHAPING_GLYPH_PROPERTIES*

Puntatore a una matrice di strutture che contengono proprietà di forma per ogni glifo restituito da GetGlyphs.

glyphCount

Tipo: UINT32

Numero di glifi restituiti da GetGlyphs.

[in] fontFace

Tipo: IDWriteFontFace*

Puntatore al viso del tipo di carattere che rappresenta l'origine per glifi di output.

fontEmSize

Tipo: FLOAT

Dimensioni dei caratteri logici in INDIRIZZI DIP.

pixelsPerDip

Tipo: FLOAT

Numero di pixel fisici per DIP.

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Trasformazione facoltativa applicata agli glifi e alle loro posizioni. Questa trasformazione viene applicata dopo il ridimensionamento specificato dalle dimensioni del carattere e pixelPerDip.

useGdiNatural

Tipo: BOOL

Se impostato su FALSE, le metriche sono uguali alle metriche del testo con alias GDI. Se impostato su TRUE, le metriche sono uguali alle metriche di testo misurate da GDI usando un tipo di carattere creato con CLEARTYPE_NATURAL_QUALITY.

isSideways

Tipo: BOOL

Flag booleano impostato su TRUE se il testo deve essere disegnato verticalmente.

isRightToLeft

Tipo: BOOL

Flag booleano impostato su TRUE per il testo da destra a sinistra.

[in] scriptAnalysis

Tipo: const DWRITE_SCRIPT_ANALYSIS*

Puntatore a un'analisi script risultante da una chiamataAnalysisScript .

[in, optional] localeName

Tipo: const WCHAR*

Matrice di caratteri contenenti le impostazioni locali da usare quando si selezionano glifi. Ad esempio, lo stesso carattere può essere mappato a glifi diversi per ja-jp rispetto a zh-chs. Se si tratta di NULL, viene usato il mapping predefinito basato sullo script.

[in, optional] features

Tipo: const DWRITE_TYPOGRAPHIC_FEATURES**

Matrice di puntatori ai set di funzionalità tipografiche da usare in ogni intervallo di funzionalità.

[in, optional] featureRangeLengths

Tipo: const UINT32*

Lunghezza di ogni intervallo di funzionalità, in caratteri.
La somma di tutte le lunghezze deve essere uguale a textLength.

featureRanges

Tipo: UINT32

Numero di intervalli di funzionalità.

[out] glyphAdvances

Tipo: FLOAT*

Quando questo metodo restituisce, contiene la larghezza avanzata di ogni glifo.

[out] glyphOffsets

Tipo: DWRITE_GLYPH_OFFSET*

Quando questo metodo restituisce, contiene l'offset dell'origine di ogni glifo.

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
Piattaforma di destinazione	Windows
Intestazione	dwrite.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Vedi anche

IDWriteTextAnalyzer