Метод IDWriteFactory4::TranslateColorGlyphRun (dwrite_3.h)

Преобразует глиф в последовательность запусков глифов цвета, которые можно отобразить для создания цветового представления исходного "базового" запуска.

Синтаксис

HRESULT TranslateColorGlyphRun(
                 D2D1_POINT_2F                      baselineOrigin,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_GLYPH_IMAGE_FORMATS         desiredGlyphImageFormats,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldAndDpiTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator1    **colorLayers
);

Параметры

baselineOrigin

Тип: D2D1_POINT_2F

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

[in] glyphRun

Тип: DWRITE_GLYPH_RUN

Указатель на исходный запуск глифа base.

[in, optional] glyphRunDescription

Тип: DWRITE_GLYPH_RUN_DESCRIPTION

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

desiredGlyphImageFormats

Тип: DWRITE_GLYPH_IMAGE_FORMATS

Какие данные форматирует запуски, следует разделить на.

measuringMode

Тип: DWRITE_MEASURING_MODE

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

[in, optional] worldAndDpiTransform

Тип: DWRITE_MATRIX

Матрица, преобразующаяся из пространства координат клиента в координаты устройства (пиксели), т. е. преобразование мира, умноженное на любое масштабирование DPI.

colorPaletteIndex

Тип: UINT32

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

[out] colorLayers

Тип: IDWriteColorGlyphRunEnumerator1**

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

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

Тип: HRESULT

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

Замечания

Вызов IDWriteFactory2::TranslateColorGlyphRun эквивалентен вызову IDWriteFactory4::TranslateColorGlyph с указанными ниже форматами: DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

Требования

См. также

IDWriteFactory4