Метод IDWriteFontFace::GetRecommendedRenderingMode (dwrite.h)

Статья
08/23/2023

Определяет рекомендуемый режим отрисовки для шрифта, используя указанный размер и параметры отрисовки.

Синтаксис

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

Параметры

emSize

Тип: FLOAT

Логический размер шрифта в единицах DIP. DIP ("независимый от устройства пиксель") равен 1/96 дюйма.

pixelsPerDip

Тип: FLOAT

Количество физических пикселей на DIP. Например, если значение DPI поверхности отрисовки равно 96, это значение равно 1,0f. Если значение DPI равно 120, это значение равно 120,0f/96.

measuringMode

Тип: DWRITE_MEASURING_MODE

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

DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL для DWRITE_MEASURING_MODE_NATURAL
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC для DWRITE_MEASURING_MODE_GDI_CLASSIC
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL для DWRITE_MEASURING_MODE_GDI_NATURAL

renderingParams

Тип: IDWriteRenderingParams*

Указатель на объект, содержащий параметры отрисовки, такие как гамма-уровень, повышенная контрастность и уровень ClearType. Этот параметр необходим, если объект параметров отрисовки переопределяет режим отрисовки.

[out] renderingMode

Тип: DWRITE_RENDERING_MODE*

При возврате этим методом содержит значение, указывающее рекомендуемый режим отрисовки для использования.

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	dwrite.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

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

IDWriteFontFace

Поделиться через