IDWriteTextAnalyzer1::ApplyCharacterSpacing-Methode (dwrite_1.h)

Artikel
08/23/2023

Wendet einen Abstand zwischen Zeichen an, wobei Glyphencluster und diakritische Zeichen richtig angepasst werden.

Syntax

HRESULT ApplyCharacterSpacing(
        FLOAT                                 leadingSpacing,
        FLOAT                                 trailingSpacing,
        FLOAT                                 minimumAdvanceWidth,
        UINT32                                textLength,
        UINT32                                glyphCount,
  [in]  UINT16 const                          *clusterMap,
  [in]  FLOAT const                           *glyphAdvances,
  [in]  DWRITE_GLYPH_OFFSET const             *glyphOffsets,
  [in]  DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProperties,
  [out] FLOAT                                 *modifiedGlyphAdvances,
  [out] DWRITE_GLYPH_OFFSET                   *modifiedGlyphOffsets
);

Parameter

leadingSpacing

Der Abstand vor jedem Zeichen in Lesereihenfolge.

trailingSpacing

Der Abstand nach jedem Zeichen in Lesereihenfolge.

minimumAdvanceWidth

Der minimale Vorlauf jedes Zeichens, um zu verhindern, dass Zeichen zu dünn oder null breit werden. Dies muss null oder größer sein.

textLength

Die Länge der Clustermap und des ursprünglichen Texts.

glyphCount

Die Anzahl der Glyphen.

[in] clusterMap

Zuordnung von Zeichenbereichen zu Glyphenbereichen.

[in] glyphAdvances

Die Vorlaufbreite der einzelnen Glyphe.

[in] glyphOffsets

Der Offset des Ursprungs der einzelnen Glyphe.

[in] glyphProperties

Eigenschaften jeder Glyphe aus GetGlyphen.

[out] modifiedGlyphAdvances

Die neue Vorlaufbreite der einzelnen Glyphen.

[out] modifiedGlyphOffsets

Der neue Offset des Ursprungs jeder Glyphe.

Rückgabewert

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

Hinweise

Die Eingabe- und Ausgabevorschritte/-offsets dürfen dasselbe Array aliasen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite_1.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteTextAnalyzer1

Freigeben über