다음을 통해 공유

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
라이브러리 D2d1.lib
DLL D2d1.dll

추가 정보

ID2D1SpriteBatch