Método IDWriteFontFace1::GetRecommendedRenderingMode (dwrite_1.h)

Determina o modo de renderização recomendado para a fonte, usando os parâmetros de renderização e tamanho especificados.

Sintaxe

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

Parâmetros

fontEmSize

Tipo: FLOAT

O tamanho lógico da fonte em unidades DIP. Um DIP ("pixel independente do dispositivo") é igual a 1/96 polegada.

dpiX

Tipo: FLOAT

O número de pixels físicos por DIP em uma posição horizontal. Por exemplo, se o DPI da superfície de renderização for 96, esse valor será 1,0f. Se o DPI for 120, esse valor será 120.0f/96.

dpiY

Tipo: FLOAT

O número de pixels físicos por DIP em uma posição vertical. Por exemplo, se o DPI da superfície de renderização for 96, esse valor será 1,0f. Se o DPI for 120, esse valor será 120.0f/96.

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Especifica a transformação do mundo.

isSideways

Tipo: BOOL

Se os glifos na execução estão de lado ou não.

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.

measuringMode

Tipo: DWRITE_MEASURING_MODE

O método de medição que será usado para glifos na fonte. As implementações do renderizador podem escolher diferentes modos de renderização para diferentes métodos de medição, por exemplo:

• DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL para DWRITE_MEASURING_MODE_NATURAL
• DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC para DWRITE_MEASURING_MODE_GDI_CLASSIC
• DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL para DWRITE_MEASURING_MODE_GDI_NATURAL

[out] renderingMode

Tipo: DWRITE_RENDERING_MODE*

Quando este método retorna, contém um valor que indica o modo de renderização recomendado a ser usado.

Retornar valor

Tipo: HRESULT

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

Comentários

Esse método deve ser usado para determinar o modo de renderização real nos casos em que o modo de renderização do objeto params de renderização é DWRITE_RENDERING_MODE_DEFAULT.

Requisitos

Confira também

IDWriteFontFace1