Метод IDWriteFontFace3::GetRecommendedRenderingMode (dwrite_3.h)

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

Синтаксис

HRESULT GetRecommendedRenderingMode(
  [in]           FLOAT                    fontEmSize,
  [in]           FLOAT                    dpiX,
  [in]           FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
  [in]           BOOL                     isSideways,
  [in]           DWRITE_OUTLINE_THRESHOLD outlineThreshold,
  [in]           DWRITE_MEASURING_MODE    measuringMode,
  [in, optional] IDWriteRenderingParams   *renderingParams,
  [out]          DWRITE_RENDERING_MODE1   *renderingMode,
  [out]          DWRITE_GRID_FIT_MODE     *gridFitMode
);

Параметры

[in] fontEmSize

Тип: FLOAT

Размер логического шрифта в DIP.

[in] dpiX

Тип: FLOAT

Количество пикселей на логический дюйм в горизонтальном направлении.

[in] dpiY

Тип: FLOAT

Количество пикселей на логический дюйм в вертикальном направлении.

[in, optional] transform

Тип: const DWRITE_MATRIX*

Структура DWRITE_MATRIX, описывающая преобразование мира.

[in] isSideways

Тип: BOOL

Указывает, находится ли шрифт в стороне. ЗНАЧЕНИЕ TRUE , если шрифт находится в стороне; в противном случае — FALSE.

[in] outlineThreshold

Тип: DWRITE_OUTLINE_THRESHOLD

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

[in] measuringMode

Тип: DWRITE_MEASURING_MODE

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

[in, optional] renderingParams

Тип: IDWriteRenderingParams*

Указатель на интерфейс IDWriteRenderingParams для объекта параметров отрисовки. Этот параметр необходим, если объект параметров отрисовки переопределяет режим отрисовки.

[out] renderingMode

Тип: DWRITE_RENDERING_MODE1*

Указатель на переменную, которая получает DWRITE_RENDERING_MODE1 типизированное значение для рекомендуемого режима отрисовки.

[out] gridFitMode

Тип: DWRITE_GRID_FIT_MODE*

Указатель на переменную, которая получает DWRITE_GRID_FIT_MODE типизированное значение для рекомендуемого режима размещения сетки.

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

Тип: HRESULT

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

Требования

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

IDWriteFontFace3