Método IDWriteFactory3::CreateCustomRenderingParams (dwrite_3.h)

Cria um objeto de parâmetros de renderização com as propriedades especificadas.

Sintaxe

HRESULT CreateCustomRenderingParams(
        FLOAT                   gamma,
        FLOAT                   enhancedContrast,
        FLOAT                   grayscaleEnhancedContrast,
        FLOAT                   clearTypeLevel,
        DWRITE_PIXEL_GEOMETRY   pixelGeometry,
        DWRITE_RENDERING_MODE1  renderingMode,
        DWRITE_GRID_FIT_MODE    gridFitMode,
  [out] IDWriteRenderingParams3 **renderingParams
);

Parâmetros

gamma

Tipo: FLOAT

O valor gama usado para correção gama, que deve ser maior que zero e não pode exceder 256.

enhancedContrast

Tipo: FLOAT

A quantidade de melhoria de contraste, zero ou maior.

grayscaleEnhancedContrast

Tipo: FLOAT

A quantidade de melhoria de contraste a ser usada para suavização em escala de cinza, zero ou maior.

clearTypeLevel

Tipo: FLOAT

O grau do nível ClearType, de 0,0f (sem ClearType) a 1,0f (ClearType completo).

pixelGeometry

Tipo: DWRITE_PIXEL_GEOMETRY

Um valor de tipo DWRITE_PIXEL_GEOMETRY que especifica a estrutura interna de um pixel de dispositivo (ou seja, a disposição física dos componentes de cor vermelho, verde e azul) que é assumida para fins de renderização de texto.

renderingMode

Tipo: DWRITE_RENDERING_MODE1

Um valor de tipo DWRITE_RENDERING_MODE1 que especifica o método (por exemplo, qualidade natural ClearType) para renderizar glifos. Na maioria dos casos, especifique DWRITE_RENDERING_MODE1_DEFAULT para usar automaticamente um modo apropriado.

gridFitMode

Tipo: DWRITE_GRID_FIT_MODE

Um valor de tipo DWRITE_GRID_FIT_MODE que especifica como ajustar estruturas de glifo de ajuste de grade. Na maioria dos casos, especifique DWRITE_GRID_FIT_DEFAULT para escolher automaticamente um modo apropriado.

[out] renderingParams

Tipo: IDWriteRenderingParams3**

Um ponteiro para um bloco de memória que recebe um ponteiro para uma interface IDWriteRenderingParams3 para o objeto de parâmetros de renderização recém-criado ou NULL em caso de falha.

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 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dwrite_3.h
Biblioteca	Dwrite.lib
DLL	Dwrite.dll

Confira também

IDWriteFactory3