Metodo IDWriteFontSet4::ConvertWeightStretchStyleToFontAxisValues (dwrite_3.h)

Articolo
08/23/2023

Calcola i valori dell'asse dei tipi di carattere derivati dal peso del tipo di carattere, dall'estensione, dallo stile e dalle dimensioni specificati.

Sintassi

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

Parametri

inputAxisValues

Tipo: _In_reads_opt_(inputAxisCount) DWRITE_FONT_AXIS_VALUE const*

Puntatore facoltativo a una matrice di valori dell'asse di input. Gli assi presenti in questa matrice vengono esclusi dall'output. In questo modo, i valori espliciti dell'asse hanno la precedenza sui valori dell'asse derivati.

inputAxisCount

Tipo: UINT32

Dimensioni della matrice di valori dell'asse di input.

fontWeight

Tipo: DWRITE_FONT_WEIGHT

Spessore del carattere, utilizzato per calcolare il valore dell'asse "wght".

fontStretch

Tipo: DWRITE_FONT_STRETCH

Estensione del tipo di carattere, utilizzata per calcolare il valore dell'asse "wdth".

fontStyle

Tipo: DWRITE_FONT_STYLE

Stile del carattere, usato per calcolare i valori dell'asse "slnt" e "axis".

fontSize

Tipo: float

Dimensioni del carattere in DIP, usate per calcolare il valore dell'asse "opsz". Se questo parametro è zero, alla matrice di output non viene aggiunto alcun valore dell'asse "opsz".

outputAxisValues

Tipo: _Out_writes_to_(DWRITE_STANDARD_FONT_AXIS_COUNT, return) DWRITE_FONT_AXIS_VALUE*

Puntatore a una matrice di output in cui vengono scritti i valori dell'asse derivati. Le dimensioni di questa matrice devono essere almeno DWRITE_STANDARD_FONT_AXIS_COUNT (5). Il valore restituito è il numero di valori dell'asse effettivamente scritti in questa matrice.

Valore restituito

Tipo: UINT32

Restituisce il numero di valori dell'asse derivati effettivamente scritti nella matrice di output.

Commenti

Il chiamante deve concatenare i valori dell'asse di output ai valori dell'asse di input (se presenti) e passare i valori dell'asse combinato al metodo GetMatchingFonts . Ciò non comporta duplicati perché l'output non include assi presenti nella matrice inputAxisValues .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 11 Build 22621
Intestazione	dwrite_3.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Condividi tramite