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

Метод IDWriteFontFace1::GetRecommendedRenderingMode (dwrite_1.h)

  • Статья

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

Синтаксис

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

Параметры

fontEmSize

Тип: FLOAT

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

dpiX

Тип: FLOAT

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

dpiY

Тип: FLOAT

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

[in, optional] transform

Тип: const DWRITE_MATRIX*

Указывает преобразование мира.

isSideways

Тип: BOOL

Являются ли глифы в перспективе боковыми или нет.

outlineThreshold

Тип: DWRITE_OUTLINE_THRESHOLD

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

measuringMode

Тип: DWRITE_MEASURING_MODE

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

[out] renderingMode

Тип: DWRITE_RENDERING_MODE*

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

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

Тип: HRESULT

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

Комментарии

Этот метод следует использовать для определения фактического режима отрисовки в случаях, когда режим отрисовки объекта параметров отрисовки DWRITE_RENDERING_MODE_DEFAULT.

Требования

Требование Значение
Минимальная версия клиента 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_1.h
Библиотека Dwrite_1.lib
DLL Dwrite_1.dll

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

IDWriteFontFace1