Метод ID2D1SpriteBatch::SetSprites (d2d1_3.h)
Обновления свойства указанных спрайтов в этом пакете спрайтов. Если указать значение NULL для любого свойства, это свойство останется неизменимым для спрайта.
Синтаксис
HRESULT SetSprites(
UINT32 startIndex,
UINT32 spriteCount,
[in, optional] const D2D1_RECT_F *destinationRectangles,
[in, optional] const D2D1_RECT_U *sourceRectangles,
[in, optional] const D2D1_COLOR_F *colors,
[in, optional] const D2D1_MATRIX_3X2_F *transforms,
UINT32 destinationRectanglesStride,
UINT32 sourceRectanglesStride,
UINT32 colorsStride,
UINT32 transformsStride
);
Параметры
startIndex
Тип: UINT32
Индекс первого спрайта в этом пакете спрайта для обновления.
spriteCount
Тип: UINT32
Количество спрайтов, обновляемых с помощью новых свойств. Это определяет, сколько шагов в каждом заданном массиве будет считывать Direct2D.
[in, optional] destinationRectangles
Тип: const D2D1_RECT_F*
Указатель на массив, содержащий прямоугольники назначения, указывающий, где следует рисовать спрайты в контексте конечного устройства.
[in, optional] sourceRectangles
Тип: const D2D1_RECT_U*
Указатель на массив, содержащий исходные прямоугольники, указывающие области исходного растрового изображения для рисования в виде спрайтов.
Direct2D будет использовать все исходное растровое изображение для спрайтов, которым присвоено значение NULL или InfiniteRectU. Если этот параметр полностью опущен или задано значение NULL, Direct2D будет использовать весь исходный растровый рисунок для всех обновленных спрайтов.
[in, optional] colors
Тип: const D2D1_COLOR_F*
Указатель на массив, содержащий цвета, применяемые к каждому спрайту. Выходной цвет является результатом компонентного умножения исходного цвета растрового изображения и предоставленного цвета. Выходной цвет не зажимается.
Direct2D не изменяет цвет спрайтов, которым присваивается значение NULL. Если этот параметр полностью опущен или задано значение NULL, Direct2D не изменит цвет обновленных спрайтов.
[in, optional] transforms
Тип: const D2D1_MATRIX_3X2_F*
Указатель на массив, содержащий преобразования, применяемые к целевому прямоугольнику каждого спрайта.
Direct2D не преобразует целевой прямоугольник спрайтов, которым присвоено значение NULL. Если этот параметр полностью опущен или задано значение NULL, Direct2D не преобразует целевой прямоугольник любого из обновленных спрайтов.
destinationRectanglesStride
Тип: UINT32
Указывает расстояние (в байтах) между каждым прямоугольником в массиве destinationRectangles. Если указать шаг 0, то для каждого обновленного спрайта будет использоваться один и тот же целевой прямоугольник.
sourceRectanglesStride
Тип: UINT32
Указывает расстояние (в байтах) между каждым прямоугольником в массиве sourceRectangles (если этот массив задан). Если указать шаг 0, то для каждого обновленного спрайта будет использоваться один и тот же исходный прямоугольник.
colorsStride
Тип: UINT32
Указывает расстояние (в байтах) между каждым цветом в массиве цветов (если этот массив задан). Если вы указываете шаг 0, то для каждого обновленного спрайта будет использоваться один и тот же цвет.
transformsStride
Тип: UINT32
Указывает расстояние (в байтах) между каждым преобразованием в массиве transforms (если этот массив задан). Если вы указываете шаг 0, то для каждого обновленного спрайта будет использоваться одно и то же преобразование.
Возвращаемое значение
Тип: HRESULT
Возвращает S_OK при успешном выполнении. Возвращает E_INVALIDARG, если в метод было передано недопустимое значение. В этом случае этот вызов SetSprites не изменяется.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | d2d1_3.h |
| Библиотека | D2d1.lib |
| DLL | D2d1.dll |