IDWriteFontSet4::ConvertWeightStretchStyleToFontAxisValues メソッド (dwrite_3.h)

指定したフォントの太さ、ストレッチ、スタイル、サイズから派生したフォント軸の値を計算します。

構文

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

パラメーター

inputAxisValues

型: _In_reads_opt_(inputAxisCount) DWRITE_FONT_AXIS_VALUE const*

オプションの入力軸値の配列へのポインター。 この配列に存在する軸は、出力から除外されます。 これは、明示的な軸値が派生軸の値よりも優先されるようにするためです。

inputAxisCount

種類: UINT32

入力軸値の配列のサイズ。

fontWeight

種類: DWRITE_FONT_WEIGHT

"wght" 軸の値を計算するために使用されるフォントの太さ。

fontStretch

種類: DWRITE_FONT_STRETCH

"wdth" 軸の値を計算するために使用されるフォント ストレッチ。

fontStyle

種類: DWRITE_FONT_STYLE

"slnt" 軸と "ital" 軸の値を計算するために使用されるフォント スタイル。

fontSize

型: float

"opsz" 軸の値を計算するために使用される、DIP のフォント サイズ。 このパラメーターが 0 の場合、出力配列に "opsz" 軸値は追加されません。

outputAxisValues

型: _Out_writes_to_(DWRITE_STANDARD_FONT_AXIS_COUNT, return) DWRITE_FONT_AXIS_VALUE*

派生軸の値が書き込まれる出力配列へのポインター。 この配列のサイズは、少なくとも DWRITE_STANDARD_FONT_AXIS_COUNT にする必要があります (5)。 戻り値は、この配列に実際に書き込まれた軸値の数です。

戻り値

種類: UINT32

出力配列に実際に書き込まれた派生軸値の数を返します。

注釈

呼び出し元は、出力軸の値を入力軸の値 (存在する場合) に連結し、結合された軸値を GetMatchingFonts メソッドに渡す必要があります。 inputAxisValues 配列に存在する軸が出力に含まれていないため、重複は発生しません。

要件

要件	値
サポートされている最小のクライアント	Windows 11 ビルド 22621
Header	dwrite_3.h
Library	Dwrite.lib
[DLL]	Dwrite.dll