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、1.0f} が返されます。

[out, optional] transforms

種類: D2D1_MATRIX_3X2_F*

このメソッドが戻るとき、 には、取得したスプライトに適用される変換を含む配列へのポインターが含まれます。

変換が割り当てられていたスプライトに対して、ID マトリックスが返されます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

対象プラットフォーム	Windows
ヘッダー	d2d1_3.h
Library	D2d1.lib
[DLL]	D2d1.dll

関連項目

ID2D1SpriteBatch