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