Метод IDWriteFactory2::TranslateColorGlyphRun (dwrite_2.h)

Этот метод вызывается при выполнении глифа, чтобы преобразовать его в несколько выполнений цветных глифов.

Синтаксис

HRESULT TranslateColorGlyphRun(
                 FLOAT                              baselineOriginX,
                 FLOAT                              baselineOriginY,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldToDeviceTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator     **colorLayers
);

Параметры

baselineOriginX

Тип: FLOAT

Горизонтальная базовая линия исходного выполнения глифа.

baselineOriginY

Тип: FLOAT

Вертикальный базовый источник исходного выполнения глифа.

[in] glyphRun

Тип: const DWRITE_GLYPH_RUN*

Исходный запуск глифа, содержащий идентификаторы монохромных глифов.

[in, optional] glyphRunDescription

Тип: const DWRITE_GLYPH_RUN_DESCRIPTION*

Необязательное описание выполнения глифа.

measuringMode

Тип: DWRITE_MEASURING_MODE

Режим измерения, используемый для вычисления позиций глифов, если выполнение содержит цветные глифы.

[in, optional] worldToDeviceTransform

Тип: const DWRITE_MATRIX*

Преобразование мира, умноженное на любое масштабирование DPI. Это необходимо для вычисления позиций глифов, если выполнение содержит цветные глифы и режим измерения не DWRITE_MEASURING_MODE_NATURAL. Если этот параметр имеет значение NULL, и предполагается преобразование идентификатора.

colorPaletteIndex

Тип: UINT32

Отсчитываемый от нуля индекс используемой цветовой палитры. Допустимые индексы меньше числа палитр в шрифте, возвращаемых IDWriteFontFace2::GetColorPaletteCount.

[out] colorLayers

Тип: IDWriteColorGlyphRunEnumerator**

Если исходный запуск глифа содержит глифы цвета, этот параметр получает указатель на интерфейс IDWriteColorGlyphRunEnumerator . Клиент использует возвращенный интерфейс для получения сведений о выполнении глифов и связанных цветах для отрисовки вместо исходного выполнения глифа. Если исходный запуск глифа не содержит цветные глифы, этот метод возвращает DWRITE_E_NOCOLOR , а выходной указатель имеет значение NULL.

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

Тип: HRESULT

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

Комментарии

Если код вызывает этот метод с выполнением глифа, который не содержит сведений о цвете, метод возвращает DWRITE_E_NOCOLOR , чтобы сообщить приложению, что оно может просто нарисовать исходный запуск глифа. Если выполнение глифа содержит сведения о цвете, функция возвращает объект, который можно перечислить для предоставления выполнений и связанных цветов. Затем приложение вызывает DrawGlyphRun с каждым из возвращенных выполнений глифа и цветами переднего плана.

Требования

Минимальная версия клиента	Windows 8.1 [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2012 R2 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	dwrite_2.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

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

IDWriteFactory2