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