IDWriteTextAnalyzer::GetGdiCompatibleGlyphPlacements-Methode (dwrite.h)

Platzieren Sie die Ausgabe von Glyphen aus der GetGlyphen-Methode entsprechend der Schriftart und den Renderingregeln des Schreibsystems.

Syntax

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
);

Parameter

[in] textString

Typ: const WCHAR*

Ein Array von Zeichen, das die ursprüngliche Zeichenfolge enthält, aus der die Glyphen stammen.

[in] clusterMap

Typ: const UINT16*

Ein Zeiger auf die Zuordnung von Zeichenbereichen zu Glyphenbereichen. Dies wird von GetGlyphen zurückgegeben.

[in] textProps

Typ: DWRITE_SHAPING_TEXT_PROPERTIES*

Ein Zeiger auf ein Array von Strukturen, das Struktureigenschaften für jedes Zeichen enthält. Diese Struktur wird von GetGlyphen zurückgegeben.

textLength

Typ: UINT32

Die Textlänge von textString.

[in] glyphIndices

Typ: const UINT16*

Ein Array von Glyphenindizes, die von GetGlyphen zurückgegeben werden.

[in] glyphProps

Typ: const DWRITE_SHAPING_GLYPH_PROPERTIES*

Ein Zeiger auf ein Array von Strukturen, die Struktureigenschaften für jede von GetGlyphen zurückgegebene Glyphe enthalten.

glyphCount

Typ: UINT32

Die Anzahl der von GetGlyphen zurückgegebenen Glyphen.

[in] fontFace

Typ: IDWriteFontFace*

Ein Zeiger auf die Schriftart, die die Quelle für die Ausgabeglyphen ist.

fontEmSize

Typ: FLOAT

Der logische Schriftgrad in DIPs.

pixelsPerDip

Typ: FLOAT

Die Anzahl der physischen Pixel pro DIP.

[in, optional] transform

Typ: const DWRITE_MATRIX*

Eine optionale Transformation, die auf die Glyphen und deren Positionen angewendet wird. Diese Transformation wird nach der Skalierung angewendet, die durch den Schriftgrad und pixelsPerDip angegeben wird.

useGdiNatural

Typ: BOOL

Bei Festlegung auf FALSE sind die Metriken identisch mit den Metriken von GDI-Aliastext. Wenn sie auf TRUE festgelegt sind, sind die Metriken identisch mit den Metriken von Text, die von GDI mithilfe einer Schriftart gemessen wird, die mit CLEARTYPE_NATURAL_QUALITY erstellt wurde.

isSideways

Typ: BOOL

Ein boolesches Flag, das auf TRUE festgelegt ist, wenn der Text vertikal gezeichnet werden soll.

isRightToLeft

Typ: BOOL

Ein boolesches Flag, das für Text von rechts nach links auf TRUE festgelegt ist.

[in] scriptAnalysis

Typ: const DWRITE_SCRIPT_ANALYSIS*

Ein Zeiger auf ein Skriptanalyseergebnis aus einemAnalyzeScript-Aufruf .

[in, optional] localeName

Typ: const WCHAR*

Ein Array von Zeichen, das das Gebietsschema enthält, das beim Auswählen von Glyphen verwendet werden soll. Beispielsweise kann das gleiche Zeichen verschiedenen Glyphen für ja-jp im Vergleich zu zh-chs zugeordnet werden. Wenn dies NULL ist, wird die Standardzuordnung basierend auf dem Skript verwendet.

[in, optional] features

Typ: const DWRITE_TYPOGRAPHIC_FEATURES**

Ein Array von Zeigern auf die Sätze typografischer Features, die in jedem Featurebereich verwendet werden sollen.

[in, optional] featureRangeLengths

Typ: const UINT32*

Die Länge jedes Featurebereichs in Zeichen.
Die Summe aller Längen sollte gleich textLength sein.

featureRanges

Typ: UINT32

Die Anzahl der Featurebereiche.

[out] glyphAdvances

Typ: FLOAT*

Wenn diese Methode zurückgibt, enthält die Erweiterte Breite der einzelnen Glyphen.

[out] glyphOffsets

Typ: DWRITE_GLYPH_OFFSET*

Wenn diese Methode zurückgibt, enthält den Offset des Ursprungs der einzelnen Glyphe.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dwrite.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteTextAnalyzer