D3DXSplitMesh 함수

메쉬를, 지정한 사이즈보다 세세한 메쉬에 분할한다.

구문

void D3DXSplitMesh(      

    const LPD3DXMESH pMeshIn,
    const DWORD *pAdjacencyIn,
    const DWORD MaxSize,
    const DWORD Options,
    DWORD *pMeshesOut,
    LPD3DXBUFFER *ppMeshArrayOut,
    LPD3DXBUFFER *ppAdjacencyArrayOut,
    LPD3DXBUFFER *ppFaceRemapArrayOut,
    LPD3DXBUFFER *ppVertRemapArrayOut
);

파라미터

pMeshIn
[in] ID3DXMesh 인터페이스의 포인터. 소스 메쉬를 나타낸다.
pAdjacencyIn
[in] 1 면근처의 3 개의 DWORD 의 배열의 포인터. 단순화 하는 메쉬에 포함되는 각면의 3 개의 인접면을 지정한다.
MaxSize
[in] 생성되는 메쉬의 정점의 최대수.
Options
[in] 새로운 메쉬의 옵션 플래그.
pMeshesOut
[out, retval] 돌려받는 메쉬의 수.
ppMeshArrayOut
[out, retval] 새로운 메쉬의 ID3DXMesh 인터페이스의 배열을 포함한 버퍼. 소스 메쉬를 n 개의 메쉬에 분할하는 경우, ppMeshArrayOut 는 n 개의 ID3DXMesh 포인터의 배열이 된다.
ppAdjacencyArrayOut
[out, retval] 새로운 메쉬의 인접성 배열 (DWORD)의 배열을 포함한 버퍼. 「ID3DXBuffer 」를 참조할것. 이 파라미터는, 옵션이다.
ppFaceRemapArrayOut
[out, retval] 새로운 메쉬의 면재맵 배열 (DWORD)의 배열을 포함한 버퍼. 「ID3DXBuffer」를 참조할것. 이 파라미터는, 옵션이다.
ppVertRemapArrayOut
[out, retval] 새로운 메쉬의, 정점재맵 배열의 배열을 포함한 버퍼. 「ID3DXBuffer」를 참조할것. 이 파라미터는, 옵션이다.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DXERR_INVALIDDATA 데이터가 무효이다.
E_OUTOFMEMORY Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

주의

이 함수의 일반적인 사용 방법은, 32 비트의 인덱스를 가지는 (정점이 65535 개보다 많다) 메쉬를, 각각이 16 비트의 인덱스를 가지는 복수의 메쉬에 분할 하면 말하는 것이다.
인접성 배열, 정점재맵 배열, 및 면재맵 배열은 DWORD 의 배열이다. 각 배열은 n 개의 DWORD 포인터를 포함해, 그 후에는, 포인터로 참조하는 DWORD 데이터가 들어가 있다. 예를 들어, 메쉬 2 의 면 3 에 대한 면재맵 정보를 얻어온다 경우는, 다음 코드를 사용할 수 있다. 여기에서는, 면재맵 데이터가 ppFaceRemapArrayOut 라는 이름의 변수로 돌려받는 것과 가정하고 있다.
	
const DWORD **face_remaps = 
	static_cast<DWORD **>(ppFaceRemapArrayOut->GetBufferPointer());
const DWORD remap = face_remaps[2][3];

함수의 정보

헤더 d3dx9mesh.h
임포트 라이브러리 d3dx9.lib
최저한의 operating system Windows 98

D3DERR_INVALIDCALL	메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DXERR_INVALIDDATA	데이터가 무효이다.
E_OUTOFMEMORY	Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

헤더	d3dx9mesh.h
임포트 라이브러리	d3dx9.lib
최저한의 operating system	Windows 98