ID2D1SpriteBatch：：SetSprites 方法 (d2d1_3.h)

匯報 這個 Sprite 批次中指定之 Sprite 的屬性。為任何屬性提供 Null 值，將會讓該屬性針對該 Sprite 保持未修改。

語法

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

要更新此 Sprite 批次中第一個 Sprite 的索引。

spriteCount

類型： UINT32

要以新屬性更新的Sprite數目。 這會決定每個指定陣列 Direct2D 將讀取多少步。

[in, optional] destinationRectangles

類型： const D2D1_RECT_F*

陣列的指標，包含目的地矩形，指定要在目的地裝置內容上繪製Sprite的位置。

[in, optional] sourceRectangles

類型： const D2D1_RECT_U*

數位的指標，包含來源矩形，指定要繪製為Sprite的來源位圖區域。

Direct2D 會針對指派 Null 值或 InfiniteRectU 的 Sprite 使用整個來源位圖。 如果完全省略此參數或設定為 Null 值，則 Direct2D 會針對所有更新的 Sprite 使用整個來源位圖。

[in, optional] colors

類型： const D2D1_COLOR_F*

數位的指標，其中包含要套用至每個Sprite的色彩。 輸出色彩是來源位圖色彩和所提供色彩之元件乘法的結果。 輸出色彩不會受到限制。

Direct2D 不會變更指派 Null 值的 Sprite 色彩。 如果完全省略此參數或設定為 Null 值，則 Direct2D 不會變更任何更新的 Sprite 色彩。

[in, optional] transforms

類型： const D2D1_MATRIX_3X2_F*

數位的指標，其中包含要套用至每個Sprite目的地矩形的轉換。

Direct2D 不會轉換指派 Null 值之任何 Sprite 的目的地矩形。 如果完全省略此參數或設定為 Null 值，則 Direct2D 將不會轉換任何更新的 Sprite 的目的地矩形。

destinationRectanglesStride

類型： UINT32

指定 destinationRectangles 陣列中每個矩形之間的距離，以位元組為單位。 如果您提供 0 的步幅，則每個更新的 Sprite 都會使用相同的目的地矩形。

sourceRectanglesStride

類型： UINT32

指定當指定陣列) 時，sourceRectangles 陣列中每個矩形之間的距離，以位元組為單位 (。 如果您提供 0 的步幅，則會針對每個更新的 Sprite 使用相同的來源矩形。

colorsStride

類型： UINT32

指定當指定陣列) 時，色彩陣列中每個色彩之間的距離，以位元組為單位 (。 如果您提供 0 的步幅，則每個更新的 Sprite 都會使用相同的色彩。

transformsStride

類型： UINT32

指定當指定陣列) 時，轉換陣列中每個轉換之間的距離 (以位元組為單位。 如果您提供 0 的步幅，則會針對每個更新的 Sprite 使用相同的轉換。

傳回值

類型： HRESULT

傳回成功時S_OK。 如果傳遞無效的值傳遞至 方法，則傳回E_INVALIDARG。 在此情況下，此呼叫 SetSprites 不會修改任何 Sprite。

規格需求

需求	值
目標平台	Windows
標頭	d2d1_3.h
程式庫	D2d1.lib
Dll	D2d1.dll

另請參閱

ID2D1SpriteBatch