ID2D1SpriteBatch：：GetSprites 方法 (d2d1_3.h)

從這個 Sprite 批次擷取指定的 Sprite 子集。 為了獲得最佳效能，請將 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

要擷取此 Sprite 批次中第一個 Sprite 的索引。

spriteCount

類型： UINT32

要擷取的 Sprite 數目。

[out, optional] destinationRectangles

類型： D2D1_RECT_F*

當這個方法傳回時，會包含陣列的指標，其中包含所擷取之 Sprite 的目的地矩形。

[out, optional] sourceRectangles

類型： D2D1_RECT_U*

當這個方法傳回時，會包含陣列的指標，其中包含所擷取之 Sprite 的來源矩形。

針對未指派來源矩形的任何 Sprite，會傳回 InfiniteRectU。

[out, optional] colors

類型： D2D1_COLOR_F*

當這個方法傳回時，會包含陣列的指標，其中包含要套用至所擷取之 Sprite 的色彩。

未指派色彩的任何 Sprite 會傳回色彩 {1.0f、1.0f、1.0f} 色彩 { 1.0f。

[out, optional] transforms

類型： D2D1_MATRIX_3X2_F*

當這個方法傳回時，包含陣列的指標，其中包含要套用至所擷取之 Sprite 的轉換。

未指派轉換的任何 Sprite 會傳回識別矩陣。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

另請參閱

ID2D1SpriteBatch