Метод ID2D1SpriteBatch::GetSprites (d2d1_3.h)

Статья
08/22/2023

Извлекает указанное подмножество спрайтов из этого пакета спрайтов. Чтобы обеспечить оптимальную производительность, используйте nullptr для свойств, которые не нужно извлекать.

Синтаксис

HRESULT GetSprites(
                  UINT32            startIndex,
                  UINT32            spriteCount,
  [out, optional] D2D1_RECT_F       *destinationRectangles,
  [out, optional] D2D1_RECT_U       *sourceRectangles,
  [out, optional] D2D1_COLOR_F      *colors,
  [out, optional] D2D1_MATRIX_3X2_F *transforms
);

Параметры

startIndex

Тип: UINT32

Индекс первого спрайта в этом пакете спрайта, который требуется извлечь.

spriteCount

Тип: UINT32

Количество извлекаемых спрайтов.

[out, optional] destinationRectangles

Тип: D2D1_RECT_F*

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

[out, optional] sourceRectangles

Тип: D2D1_RECT_U*

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

InfiniteRectU возвращается для всех спрайтов, которым не назначен исходный прямоугольник.

[out, optional] colors

Тип: D2D1_COLOR_F*

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

Цвет {1.0f, 1.0f, 1.0f, 1.0f} возвращается для всех спрайтов, которым не назначен цвет.

[out, optional] transforms

Тип: D2D1_MATRIX_3X2_F*

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

Матрица удостоверений возвращается для всех спрайтов, которым не назначено преобразование.

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

Тип: HRESULT

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

Требования


Целевая платформа	Windows
Header	d2d1_3.h
Библиотека	D2d1.lib
DLL	D2d1.dll

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

ID2D1SpriteBatch

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