DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 메쉬 함수 D3DXLoadMeshFromXof [목차열람] [주소복사] [슬롯비우기]
|
DirectX Graphics 레퍼런스 Direct3D extension (D3DX) C/C++ 레퍼런스 함수 메쉬 함수 D3DXLoadMeshFromXof [목차열람] [주소복사] [슬롯비우기]
|
| Microsoft DirectX 9.0 |
IDirectXFileData 개체로부터 메쉬를 로드한다.
구문
HRESULT D3DXLoadMeshFromXof(
LPDIRECTXFILEDATA pXofObjMesh, DWORD Options, LPDIRECT3DDEVICE9 pD3DDevice, LPD3DXBUFFER *ppAdjacency, LPD3DXBUFFER *ppMaterials, LPD3DXBUFFER* ppEffectInstances, WORD* pNumMaterials, LPD3DXMESH *ppMesh );
파라미터
- pXofObjMesh
- [in] IDirectXFileData 인터페이스의 포인터. 로드하는 파일 데이터 개체를 나타낸다.
- Options
- [out] D3DXMESH 열거형으로부터의 1 개 또는 복수의 플래그의 편성. 메쉬의 생성 옵션을 지정한다.
- pD3DDevice
- [in] IDirect3DDevice9 인터페이스의 포인터. 메쉬에 관련지을 수 있는 장치 개체를 나타낸다.
- ppAdjacency
- [out] 인접성 데이터를 포함한 버퍼의 포인터. 1 면근처의 3 개의 DWORD 의 배열의 포인터. 메쉬에 포함되는 각면의 3 개의 인접면을 지정한다. 버퍼에의 액세스의 더 자세한 정보는, 「ID3DXBuffer 」를 참조할것.
- ppMaterials
- [in, out]ID3DXBuffer 인터페이스의 포인터 주소. 메서드가 돌아가면 이 파라미터에는 D3DXMATERIAL 구조체의 배열이 입력된다.
- ppEffectInstances
- [out] 돌려받는 메쉬내의 속성 그룹 마다 1 개의, 이펙트 인스턴스의 배열을 포함한 버퍼의 포인터. 이펙트 인스턴스는, 이펙트의 초기화에 사용하는 상태 정보의 특정의 인스턴스이다. 「D3DXEFFECTINSTANCE 」를 참조할것. 버퍼에의 액세스의 더 자세한 정보는, 「ID3DXBuffer 」를 참조할것.
- pNumMaterials
- [in, out] 메서드가 돌아왔을 때의 ppMaterials 배열내의 D3DXMATERIAL 구조체의 수의 포인터.
- ppMesh
- [out, retval] 로드 된 메쉬를 나타내는 ID3DXMesh 인터페이스의 포인터 주소.
반환값
성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다. D3DXERR_INVALIDDATA 데이터가 무효이다. E_OUTOFMEMORY Microsoft® Direct3D® 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.
주의
이펙트 인스턴스 정보를 포함하지 않는 메쉬 파일의 경우,. x 파일의 머트리얼 정보로부터 디폴트의 이펙트 인스턴스가 생성된다. 디폴트의 이펙트 인스턴스에는,D3DMATERIAL9 구조체의 멤버에 대응하는 디폴트값이 포함된다.디폴트의 텍스처명도 설정되지만, 다른 방법으로 처리된다. 이름은 Texture0@Name 가 되어,"Name" 라고 하는 코멘트 첨부의 "Texture0" 라는 이름으로 이펙트 변수에 대응한다. 이것에는, 텍스처의 캐릭터 라인 파일명이 포함된다.
IDirectXFileDataReference::Resolve 를 사용해 취득한 IDirectXFileData 인터페이스로 D3DXLoadMeshFromXof 를 호출하면, 참조 처리의 기존의 문제를 위해서(때문에) 실패한다.
함수의 정보
헤더 d3dx9mesh.h 임포트 라이브러리 d3dx9.lib 최저한의 operating system Windows 98
참조
D3DXEFFECTDEFAULT ,D3DXEFFECTINSTANCE