ID2D1SpriteBatch::SetSprites 메서드(d2d1_3.h)
이 스프라이트 일괄 처리에서 지정된 스프라이트의 속성을 업데이트. 모든 속성에 대해 null 값을 제공하면 해당 스프라이트에 대해 해당 속성이 수정되지 않은 상태로 남습니다.
구문
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
이 스프라이트 일괄 처리에서 업데이트할 첫 번째 스프라이트의 인덱스입니다.
spriteCount
형식: UINT32
새 속성으로 업데이트할 스프라이트 수입니다. 이렇게 하면 Direct2D가 읽을 각 배열의 보폭이 결정됩니다.
[in, optional] destinationRectangles
형식: const D2D1_RECT_F*
대상 디바이스 컨텍스트에서 스프라이트를 그릴 위치를 지정하는 대상 사각형이 포함된 배열에 대한 포인터입니다.
[in, optional] sourceRectangles
형식: const D2D1_RECT_U*
스프라이트로 그릴 원본 비트맵의 영역을 지정하는 원본 사각형이 포함된 배열에 대한 포인터입니다.
Direct2D는 null 값 또는 InfiniteRectU가 할당된 스프라이트에 전체 소스 비트맵을 사용합니다. 이 매개 변수를 완전히 생략하거나 null 값으로 설정하면 Direct2D는 업데이트된 모든 스프라이트에 전체 소스 비트맵을 사용합니다.
[in, optional] colors
형식: const D2D1_COLOR_F*
각 스프라이트에 적용할 색이 포함된 배열에 대한 포인터입니다. 출력 색은 원본 비트맵 색과 제공된 색을 구성 요소 단위로 곱한 결과입니다. 출력 색이 고정되지 않습니다.
Direct2D는 null 값이 할당된 스프라이트의 색을 변경하지 않습니다. 이 매개 변수를 완전히 생략하거나 null 값으로 설정하면 Direct2D는 업데이트된 스프라이트의 색을 변경하지 않습니다.
[in, optional] transforms
형식: const D2D1_MATRIX_3X2_F*
각 스프라이트의 대상 사각형에 적용할 변환을 포함하는 배열에 대한 포인터입니다.
Direct2D는 null 값이 할당된 스프라이트의 대상 사각형을 변환하지 않습니다. 이 매개 변수를 완전히 생략하거나 null 값으로 설정하면 Direct2D는 업데이트된 스프라이트의 대상 사각형을 변환하지 않습니다.
destinationRectanglesStride
형식: UINT32
destinationRectangles 배열의 각 사각형 사이의 거리를 바이트 단위로 지정합니다. 0의 보폭을 제공하는 경우 업데이트된 각 스프라이트에 동일한 대상 사각형이 사용됩니다.
sourceRectanglesStride
형식: UINT32
sourceRectangles 배열의 각 사각형 사이의 거리를 바이트 단위로 지정합니다(해당 배열이 지정된 경우). 0의 보폭을 제공하는 경우 업데이트된 각 스프라이트에 동일한 원본 사각형이 사용됩니다.
colorsStride
형식: UINT32
색 배열의 각 색 사이의 거리를 바이트 단위로 지정합니다(해당 배열이 지정된 경우). 0의 보폭을 제공하는 경우 업데이트된 각 스프라이트에 동일한 색이 사용됩니다.
transformsStride
형식: UINT32
변환 배열의 각 변환 간 거리를 바이트 단위로 지정합니다(해당 배열이 지정된 경우). 0의 보폭을 제공하는 경우 업데이트된 각 스프라이트에 동일한 변환이 사용됩니다.
반환 값
형식: HRESULT
성공하면 S_OK를 반환합니다. 잘못된 값이 메서드에 전달된 경우 E_INVALIDARG 반환합니다. 이 경우 SetSprites를 호출하여 스프라이트를 수정하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | d2d1_3.h |
| 라이브러리 | D2d1.lib |
| DLL | D2d1.dll |