IDirect3DDevice9::D rawIndexedPrimitive 메서드(d3d9helper.h)

아티클
03/14/2023

인덱싱에 따라 지정된 기하학적 기본 형식을 꼭짓점 배열로 렌더링합니다.

구문

HRESULT DrawIndexedPrimitive(
  [in] D3DPRIMITIVETYPE unnamedParam1,
  [in] INT              BaseVertexIndex,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             startIndex,
  [in] UINT             primCount
);

매개 변수

[in] unnamedParam1

형식: D3DPRIMITIVETYPE

렌더링할 기본 형식을 설명하는 D3DPRIMITIVETYPE 열거형 형식의 멤버입니다. 이 메서드에서는 D3DPT_POINTLIST 지원되지 않습니다. 설명 부분을 참조하세요.

[in] BaseVertexIndex

형식: INT

꼭짓점 버퍼의 시작부터 첫 번째 꼭짓점까지의 오프셋입니다. 시나리오 4를 참조하세요.

[in] MinVertexIndex

형식: UINT

이 호출 중에 사용되는 꼭짓점의 최소 꼭짓점 인덱스입니다. BaseVertexIndex를 기준으로 하는 0부터 시작하는 인덱스입니다.

[in] NumVertices

형식: UINT

이 호출 중에 사용되는 꼭짓점 수입니다. 첫 번째 꼭짓점은 BaseVertexIndex + MinIndex 인덱스에 있습니다.

[in] startIndex

형식: UINT

꼭짓점 버퍼에 액세스할 때 사용할 첫 번째 인덱스의 인덱스입니다. StartIndex부터 꼭짓점 버퍼에서 꼭짓점을 인덱싱합니다.

[in] primCount

형식: UINT

렌더링할 기본 형식의 수입니다. 사용되는 꼭짓점 수는 기본 개수 및 기본 형식의 함수입니다. 허용되는 최대 기본 형식 수는 D3DCAPS9 구조체의 MaxPrimitiveCount 멤버를 확인하여 결정됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_INVALIDCALL 수 있습니다.

설명

이 메서드는 현재 데이터 입력 스트림 집합에서 인덱싱된 기본 형식을 그립니다. MinIndex 및 인덱스 스트림의 모든 인덱스는 BaseVertexIndex를 기준으로 합니다.

MinIndex 및 NumVertices 매개 변수는 각 IDirect3DDevice9::D rawIndexedPrimitive 호출에 사용되는 꼭짓점 인덱스 범위를 지정합니다. 이러한 꼭짓점으로 인덱싱하기 전에 순차적인 꼭짓점 범위를 처리하여 인덱싱된 기본 형식의 꼭짓점 처리를 최적화하는 데 사용됩니다. 이 범위를 벗어나는 꼭짓점을 참조하기 위해 이 호출 중에 사용되는 인덱스에는 유효하지 않습니다.

인덱스 배열이 설정되지 않은 경우 IDirect3DDevice9::D rawIndexedPrimitive가 실패합니다.

D3DPRIMITIVETYPE 열거형 형식의 D3DPT_POINTLIST 멤버는 지원되지 않으며 이 메서드에 유효한 형식이 아닙니다.

레거시 애플리케이션을 Direct3D 9로 변환할 때 고정 함수 파이프라인을 사용하도록 IDirect3DDevice9::SetFVF 에 대한 호출을 추가하거나 그리기 호출을 하기 전에 꼭짓점 셰이더를 사용하려면 IDirect3DDevice9::SetVertexDeclaration 을 추가해야 합니다.