ID2D1SpriteBatch：：GetSprites 方法 (d2d1_3.h)

从此子画面批处理中检索子画面的指定子集。 为获得最佳性能，请对不需要检索的属性使用 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}。

[out, optional] transforms

类型： D2D1_MATRIX_3X2_F*

此方法返回时，包含指向数组的指针，该数组包含要应用于检索的子画面的转换。

对于未分配转换的任何子画面，将返回标识矩阵。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

目标平台	Windows
标头	d2d1_3.h
Library	D2d1.lib
DLL	D2d1.dll

另请参阅

ID2D1SpriteBatch