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

Статья
08/23/2023

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

Синтаксис

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.

Требования


Целевая платформа	Windows
Header	dwrite_3.h
Библиотека	Dwrite.lib

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

IDWriteFactory4

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