IDWriteFontSet4 ::ConvertWeightStretchStyleToFontAxisValues, méthode (dwrite_3.h)

Article
02/29/2024

Calcule les valeurs dérivées de l’axe des polices à partir de la pondération, de l’étirement, du style et de la taille de police spécifiés.

Syntaxe

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

Paramètres

inputAxisValues

Type : _In_reads_opt_(inputAxisCount) DWRITE_FONT_AXIS_VALUE const*

Pointeur facultatif vers un tableau de valeurs d’axe d’entrée. Les axes présents dans ce tableau sont exclus de la sortie. Ainsi, les valeurs d’axe explicites sont prioritaires sur les valeurs d’axe dérivées.

inputAxisCount

Type : UINT32

Taille du tableau de valeurs d’axe d’entrée.

fontWeight

Type : DWRITE_FONT_WEIGHT

Poids de police, utilisé pour calculer la valeur de l’axe « wght ».

fontStretch

Type : DWRITE_FONT_STRETCH

Étendue de police, utilisée pour calculer la valeur de l’axe « wdth ».

fontStyle

Type : DWRITE_FONT_STYLE

Style de police, utilisé pour calculer les valeurs d’axe « slnt » et « ital ».

fontSize

Type : float

Taille de police dans les DIPs, utilisée pour calculer la valeur de l’axe « opsz ». Si ce paramètre est égal à zéro, aucune valeur d’axe « opsz » n’est ajoutée au tableau de sortie.

outputAxisValues

Type : _Out_writes_to_(DWRITE_STANDARD_FONT_AXIS_COUNT, retour) DWRITE_FONT_AXIS_VALUE*

Pointeur vers un tableau de sortie dans lequel les valeurs d’axe dérivées sont écrites. La taille de ce tableau doit être d’au moins DWRITE_STANDARD_FONT_AXIS_COUNT (5). La valeur de retour correspond au nombre de valeurs d’axe réellement écrites dans ce tableau.

Valeur retournée

Type : UINT32

Retourne le nombre de valeurs d’axe dérivées qui ont été réellement écrites dans le tableau de sortie.

Remarques

L’appelant doit concaténer les valeurs de l’axe de sortie avec les valeurs de l’axe d’entrée (le cas échéant) et passer les valeurs d’axe combinées à la méthode GetMatchingFonts . Cela n’entraîne pas de doublons, car la sortie n’inclut aucun axe présent dans le tableau inputAxisValues .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11 Build 22621
En-tête	dwrite_3.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Partager via