Método IDWriteFontFace::GetRecommendedRenderingMode (dwrite.h)

Artigo
02/29/2024

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

Sintaxe

HRESULT GetRecommendedRenderingMode(
        FLOAT                  emSize,
        FLOAT                  pixelsPerDip,
        DWRITE_MEASURING_MODE  measuringMode,
        IDWriteRenderingParams *renderingParams,
  [out] DWRITE_RENDERING_MODE  *renderingMode
);

Parâmetros

emSize

Tipo: FLOAT

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

pixelsPerDip

Tipo: FLOAT

O número de pixels físicos por DIP. 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.

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

renderingParams

Tipo: IDWriteRenderingParams*

Um ponteiro para um objeto que contém configurações de renderização, como nível gama, contraste aprimorado e nível ClearType. 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_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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dwrite.h
Biblioteca	Dwrite.lib
DLL	Dwrite.dll

Confira também

IDWriteFontFace

Compartilhar via