Метод IDWriteFactory3::CreateCustomRenderingParams (dwrite_3.h)

Создает объект параметров отрисовки с указанными свойствами.

Синтаксис

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

Параметры

gamma

Тип: FLOAT

Гамма-значение, используемое для гамма-коррекции, которое должно быть больше нуля и не может превышать 256.

enhancedContrast

Тип: FLOAT

Величина увеличения контрастности, ноль или больше.

grayscaleEnhancedContrast

Тип: FLOAT

Количество улучшений контрастности, используемых для сглаживания оттенков серого, нулевое или большее.

clearTypeLevel

Тип: FLOAT

Степень уровня ClearType от 0,0f (без ClearType) до 1,0f (полный ClearType).

pixelGeometry

Тип: DWRITE_PIXEL_GEOMETRY

DWRITE_PIXEL_GEOMETRY типизированное значение, указывающее внутреннюю структуру пикселя устройства (т. е. физическое расположение компонентов красного, зеленого и синего цвета), которое предполагается для отрисовки текста.

renderingMode

Тип: DWRITE_RENDERING_MODE1

DWRITE_RENDERING_MODE1 типизированное значение, указывающее метод (например, ClearType natural quality) для отрисовки глифов. В большинстве случаев укажите DWRITE_RENDERING_MODE1_DEFAULT для автоматического использования соответствующего режима.

gridFitMode

Тип: DWRITE_GRID_FIT_MODE

DWRITE_GRID_FIT_MODE типизированное значение, указывающее, как уместить контуры глифов в сетке. В большинстве случаев укажите DWRITE_GRID_FIT_DEFAULT для автоматического выбора соответствующего режима.

[out] renderingParams

Тип: IDWriteRenderingParams3**

Указатель на блок памяти, который получает указатель на интерфейс IDWriteRenderingParams3 для созданного объекта параметров отрисовки, или ЗНАЧЕНИЕ NULL в случае сбоя.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	dwrite_3.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

См. также раздел

IDWriteFactory3