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