Método IDWriteFontFace3::GetRecommendedRenderingMode (dwrite_3.h)

Determina a renderização de texto recomendada e o modo de ajuste de grade a serem usados com base na fonte, no tamanho, na transformação do mundo e no modo de medição.

Sintaxe

HRESULT GetRecommendedRenderingMode(
  [in]           FLOAT                    fontEmSize,
  [in]           FLOAT                    dpiX,
  [in]           FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
  [in]           BOOL                     isSideways,
  [in]           DWRITE_OUTLINE_THRESHOLD outlineThreshold,
  [in]           DWRITE_MEASURING_MODE    measuringMode,
  [in, optional] IDWriteRenderingParams   *renderingParams,
  [out]          DWRITE_RENDERING_MODE1   *renderingMode,
  [out]          DWRITE_GRID_FIT_MODE     *gridFitMode
);

Parâmetros

[in] fontEmSize

Tipo: FLOAT

Tamanho da fonte lógica em DIPs.

[in] dpiX

Tipo: FLOAT

Número de pixels por polegada lógica na direção horizontal.

[in] dpiY

Tipo: FLOAT

Número de pixels por polegada lógica na direção vertical.

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Uma estrutura DWRITE_MATRIX que descreve a transformação do mundo.

[in] isSideways

Tipo: BOOL

Especifica se a fonte está de lado. TRUE se a fonte estiver de lado; caso contrário, FALSE.

[in] outlineThreshold

Tipo: DWRITE_OUTLINE_THRESHOLD

Um valor de tipo DWRITE_OUTLINE_THRESHOLD que especifica a qualidade da renderização da estrutura de tópicos do sistema gráfico afeta o limite de tamanho acima do qual a renderização de estrutura de tópicos é usada.

[in] measuringMode

Tipo: DWRITE_MEASURING_MODE

Um valor de tipo DWRITE_MEASURING_MODE que especifica o método usado para medir durante o layout de texto. Para espaçamento de glifo adequado, esse método retorna um modo de renderização compatível com o modo de medição especificado.

[in, optional] renderingParams

Tipo: IDWriteRenderingParams*

Um ponteiro para uma interface IDWriteRenderingParams para o objeto de parâmetros de renderização. Esse parâmetro é necessário caso o objeto de parâmetros de renderização substitua o modo de renderização.

[out] renderingMode

Tipo: DWRITE_RENDERING_MODE1*

Um ponteiro para uma variável que recebe um valor de tipo DWRITE_RENDERING_MODE1 para o modo de renderização recomendado.

[out] gridFitMode

Tipo: DWRITE_GRID_FIT_MODE*

Um ponteiro para uma variável que recebe um valor de tipo DWRITE_GRID_FIT_MODE para o modo de ajuste de grade recomendado.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Confira também

IDWriteFontFace3