IDWriteFontSet4::ConvertWeightStretchStyleToFontAxisValues-Methode (dwrite_3.h)

Artikel
02/29/2024

Berechnet abgeleitete Werte der Schriftartachse aus der angegebenen Schriftgröße, -dehnung, -format und -größe.

Syntax

UINT32 ConvertWeightStretchStyleToFontAxisValues(
  DWRITE_FONT_AXIS_VALUE const *inputAxisValues,
  UINT32                       inputAxisCount,
  DWRITE_FONT_WEIGHT           fontWeight,
  DWRITE_FONT_STRETCH          fontStretch,
  DWRITE_FONT_STYLE            fontStyle,
  float                        fontSize,
  DWRITE_FONT_AXIS_VALUE       *outputAxisValues
);

Parameter

inputAxisValues

Typ: _In_reads_opt_(inputAxisCount) DWRITE_FONT_AXIS_VALUE const*

Optionaler Zeiger auf ein Array von Eingabeachsenwerten. Achsen, die in diesem Array vorhanden sind, werden von der Ausgabe ausgeschlossen. Das ist so, dass explizite Achsenwerte Vorrang vor abgeleiteten Achsenwerten haben.

inputAxisCount

Typ: UINT32

Größe des Arrays der Eingabeachsenwerte.

fontWeight

Typ: DWRITE_FONT_WEIGHT

Schriftgewichtung, die verwendet wird, um den Wert der "wght"-Achse zu berechnen.

fontStretch

Typ: DWRITE_FONT_STRETCH

Schriftdehnung, die zum Berechnen des "wdth"-Achsenwerts verwendet wird.

fontStyle

Typ: DWRITE_FONT_STYLE

Schriftartstil, der verwendet wird, um die Achsenwerte "slnt" und "ital" zu berechnen.

fontSize

Typ: float

Schriftgrad in DIPs, der zum Berechnen des Achsenwerts "opsz" verwendet wird. Wenn dieser Parameter 0 ist, wird dem Ausgabearray kein Opsz-Achsenwert hinzugefügt.

outputAxisValues

Typ: _Out_writes_to_(DWRITE_STANDARD_FONT_AXIS_COUNT, rückgabe) DWRITE_FONT_AXIS_VALUE*

Zeiger auf ein Ausgabearray, in das abgeleitete Achsenwerte geschrieben werden. Die Größe dieses Arrays muss mindestens DWRITE_STANDARD_FONT_AXIS_COUNT (5) sein. Der Rückgabewert ist die Anzahl der Achsenwerte, die tatsächlich in dieses Array geschrieben wurden.

Rückgabewert

Typ: UINT32

Gibt die Anzahl der abgeleiteten Achsenwerte zurück, die tatsächlich in das Ausgabearray geschrieben wurden.

Hinweise

Der Aufrufer sollte die Ausgabeachsenwerte mit den Eingabeachsenwerten (falls vorhanden) verketten und die kombinierten Achsenwerte an die GetMatchingFonts-Methode übergeben. Dies führt nicht zu Duplikaten, da die Ausgabe keine Achsen enthält, die im array inputAxisValues vorhanden sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11 Build 22621
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Freigeben über