IDWriteTextAnalyzer1::ApplyCharacterSpacing-Methode (dwrite_1.h)

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

Weitere Informationen

IDWriteTextAnalyzer1