DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 애니메이션 함수 D3DXLoadMeshHierarchyFromX [목차열람] [주소복사] [슬롯비우기]
|
DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 애니메이션 함수 D3DXLoadMeshHierarchyFromX [목차열람] [주소복사] [슬롯비우기]
|
| Microsoft DirectX 9.0 |
최초의 프레임 계층을 . x 파일로부터 로드한다.
구문
HRESULT D3DXLoadMeshHierarchyFromX(
LPCTSTR Filename, DWORD MeshOptions, LPDIRECT3DDEVICE9 pDevice, LPD3DXALLOCATEHIERARCHY pAlloc, LPD3DXLOADUSERDATA pUserDataLoader, LPD3DXFRAME* ppFrameHeirarchy, LPD3DXANIMATIONCONTROLLER* ppAnimController );
파라미터
- Filename
- [in] 파일명을 지정하는 캐릭터 라인의 포인터. 컴파일러의 설정이 Unicode 를 요구하고 있는 경우, 데이터 타입 LPCTSTR 는 LPCWSTR 가 된다. 그 이외의 경우는, 이 캐릭터 라인의 데이터 타입은 LPCSTR 가 된다. 「주의」를 참조할것.
- MeshOptions
- [in] D3DXMESH 열거형으로부터의 1 개 또는 복수의 플래그의 편성. 메쉬의 생성 옵션을 지정한다.
- pDevice
- [in] IDirect3DDevice9 인터페이스의 포인터. 메쉬에 관련지을 수 있는 장치 개체를 나타낸다.
- pAlloc
- [in] ID3DXAllocateHierarchy 인터페이스의 포인터.
- pUserDataLoader
- [in] 애플리케이션이 제공하는, 사용자 데이터의 로드를 허가하는 인터페이스. 「ID3DXLoadUserData 」를 참조할것.
- ppFrameHeirarchy
- [out, retval] 로드 되는 프레임 계층의 포인터를 돌려준다. 「D3DXFRAME 」를 참조할것.
- ppAnimController
- [out, retval] .x 파일내의 애니메이션에 대응하는 애니메이션 콘트롤러의 포인터를 돌려준다. 이것은, 디폴트의 트랙 및 이벤트를 사용해 생성 된다. 「ID3DXAnimationController 」를 참조할것.
반환값
성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다. E_OUTOFMEMORY Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.
주의
컴파일러의 설정에 의해 함수의 버전도 정해진다. Unicode 가 정의되고 있는 경우, 이 함수의 호출은 D3DXLoadMeshHeirarchyFromXW 가 된다. 그 이외의 경우는 ANSI 캐릭터 라인을 사용하므로, 이 함수의 호출은 D3DXLoadMeshHeirarchyFromXA 가 된다.
파일내의 모든 메쉬가 1 개의 출력 메쉬에 정리한다. 파일에 프레임 계층이 저장 되고 있는 경우, 모든 변환이 메쉬에 적용된다.
D3DXLoadMeshHierarchyFromX 는,. x 파일로부터 애니메이션 데이터와 프레임 계층을 로드한다.. x 파일을 조사해pAlloc 로 건네받은,ID3DXAllocateHierarchy 의 파생 개체에 근거해 프레임 계층과 애니메이션 콘트롤러를 구축한다. 데이터의 로드는, 다음의 순서로 실시한다.
- ID3DXAllocateHierarchy 로부터 파생시켜, 각 메서드를 처리 한다. 이것에 의해, 프레임 및 메쉬의 할당과 릴리즈를 어떻게 실시하는지를 제어한다.
- ID3DXLoadUserData 로부터 파생시켜, 각 메서드를 처리 한다.. x 파일내에 매입의 사용자 정의 데이터가 존재하지 않는지, 이것을 필요로 하지 않는 경우는, 이 부분은 생략해도 좋다.
- ID3DXAllocateHierarchy 클래스의 개체를 생성 해, 필요에 따라서 LoadUserData 클래스의 개체를 생성 한다. 이러한 개체의 메서드를 호출할 필요는 없다.
- D3DXLoadMeshHierarchyFromX 를 호출해 ID3DXAllocateHierarchy 개체 및 ID3DXLoadUserData 개체 (또는 NULL)를 건네주어, 프레임 계층과 애니메이션 콘트롤러를 생성 한다. 모든 애니메이션 세트와 프레임이 자동적으로 애니메이션 콘트롤러에 등록된다.
로드시에는, 프레임의 로드와 할당을 제어하기 위해서, 각 프레임에 대해서 ID3DXAllocateHierarchy::CreateFrame 와 ID3DXLoadUserData::LoadFrameChildData 가 콜백 된다. 애플리케이션은, 이러한 메서드를 정의하는 것에 의해, 프레임의 보관 방법을 제어한다. 메쉬 개체의 로드와 할당을 제어하기 위해서, 각 메쉬 개체에 대해서 ID3DXAllocateHierarchy::CreateMeshContainer 와 ID3DXLoadUserData::LoadMeshChildData 가 콜백 된다. 다른 메서드로 로드 되지 않는 최상정도의 각 개체에 대해서,ID3DXLoadUserData::LoadTopLevelData 가 콜백 된다.
이 데이터를 릴리즈 하려면 , ID3DXAnimationController::Release 를 호출해 애니메이션 세트를 릴리즈 해,D3DXFrameDestroy 를 호출해 프레임 계층 루트 노드와 ID3DXAllocateHierarchy 의 상속 클래스의 개체를 건네준다. 프레임 계층내의 모든 프레임 및 메쉬 개체에 대해서,ID3DXAllocateHierarchy::DestroyFrame 와 ID3DXAllocateHierarchy::DestroyMeshContainer 가 각각 호출된다. ID3DXAllocateHierarchy::DestroyFrame 의 처리에서는,ID3DXAllocateHierarchy::CreateFrame 에 의해 할당할 수 있던 것을 모두 릴리즈 하도록(듯이) 하지 않으면들 없다. 메쉬 컨테이너의 메서드에 대해서도 같이이다.
함수의 정보
헤더 d3dx9anim.h 임포트 라이브러리 d3dx9.lib 최저한의 operating system Windows 98