Compartilhar via

Método IDWriteFontSet4::ConvertWeightStretchStyleToFontAxisValues (dwrite_3.h)

  • Artigo

Calcula valores de eixo de fonte derivados do peso, estiramento, estilo e tamanho da fonte especificados.

Sintaxe

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

Parâmetros

inputAxisValues

Tipo: _In_reads_opt_(inputAxisCount) DWRITE_FONT_AXIS_VALUE const*

Ponteiro opcional para uma matriz de valores de eixo de entrada. Os eixos presentes nessa matriz são excluídos da saída. Isso é para que os valores de eixo explícitos têm precedência sobre valores de eixo derivados.

inputAxisCount

Tipo: UINT32

Tamanho da matriz de valores do eixo de entrada.

fontWeight

Tipo: DWRITE_FONT_WEIGHT

Peso da fonte, usado para calcular o valor do eixo "wght".

fontStretch

Tipo: DWRITE_FONT_STRETCH

Alongamento de fonte, usado para calcular o valor do eixo "wdth".

fontStyle

Tipo: DWRITE_FONT_STYLE

Estilo de fonte, usado para calcular valores de eixo "slnt" e "ital".

fontSize

Tipo: float

Tamanho da fonte em DIPs, usado para calcular o valor do eixo "opsz". Se esse parâmetro for zero, nenhum valor do eixo "opsz" será adicionado à matriz de saída.

outputAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE _Out_writes_to_(DWRITE_STANDARD_FONT_AXIS_COUNT, return)*

Ponteiro para uma matriz de saída na qual os valores de eixo derivados são gravados. O tamanho dessa matriz deve ser pelo menos DWRITE_STANDARD_FONT_AXIS_COUNT (5). O valor retornado é o número de valores de eixo que foram realmente gravados nessa matriz.

Retornar valor

Tipo: UINT32

Retorna o número de valores de eixo derivados que foram realmente gravados na matriz de saída.

Comentários

O chamador deve concatenar os valores do eixo de saída para os valores do eixo de entrada (se houver) e passar os valores de eixo combinados para o método GetMatchingFonts . Isso não resulta em duplicatas porque a saída não inclui nenhum eixo presente na matriz inputAxisValues .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11 Build 22621
Cabeçalho dwrite_3.h
Biblioteca Dwrite.lib
DLL Dwrite.dll