D3DXSaveMeshToX 함수

. x 파일에 메쉬를 보존한다.

구문

HRESULT D3DXSaveMeshToX(      

    LPCTSTR pFilename,
    LPD3DXMESH pMesh,
    CONST DWORD* pAdjacency,
    CONST D3DXMATERIAL* pMaterials,
    CONST D3DXEFFECTINSTANCE* pEffectInstances,
    DWORD NumMaterials,
    DWORD Format
);

파라미터

pFilename
[in] 파일명을 지정하는 캐릭터 라인의 포인터. 컴파일러의 설정이 Unicode 를 요구하고 있는 경우, 데이터 타입 LPCTSTR 는 LPCWSTR 가 된다. 그 이외의 경우는, 이 캐릭터 라인의 데이터 타입은 LPCSTR 가 된다. 「주의」를 참조할것.
pMesh
[in] ID3DXMesh 인터페이스의 포인터.. x 파일에 보존하는 메쉬를 나타낸다.
pAdjacency
[in] 1 면근처의 3 개의 DWORD 의 배열의 포인터. 메쉬에 포함되는 각면의 3 개의 인접면을 지정한다.
pMaterials
[in] D3DXMATERIAL 구조체의 배열의 포인터.. x 파일에 보존되고 있는 머트리얼 정보를 저장 한다.
pEffectInstances
[in] 이펙트 인스턴스의 배열의 포인터. 이 배열은, 메쉬내의 속성 그룹 마다 1 개의 이펙트 인스턴스를 포함한다. 이펙트 인스턴스는, 이펙트를 초기화할 경우에 사용하는, 스테이트 정보의 특정의 인스턴스이다. 더 자세한 정보는, 「D3DXEFFECTINSTANCE 」를 참조할것.
NumMaterials
[in] pMaterials 배열내의 D3DXMATERIAL 구조체의 수.
Format
[in] .x 파일의 보존에 사용하는 포맷을 지정한다. 더 자세한 정보는, 「주의」를 참조할것.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.

주의

컴파일러의 설정에 의해 함수의 버전도 정해진다. Unicode 가 정의되고 있는 경우, 이 함수의 호출은 D3DXSaveMeshToXW 가 된다. 그 이외의 경우는 ANSI 캐릭터 라인을 사용하므로, 이 함수의 호출은 D3DXSaveMeshToXA 가 된다.
파일 포맷의 디폴트값은, DXFILEFORMAT_BINARY 이다. 파일 사이즈를 작게 하려면 , DXFILEFORMAT_COMPRESSED 를 텍스트 플래그 또는 바이너리 플래그와 조합해 (논리 OR 를 사용) 사용한다. 바이너리 플래그 (DXFILEFORMAT_BINARY)와 텍스트 플래그 (DXFILEFORMAT_TEXT)를 양쪽 모두 사용해 지정한 파일은, 텍스트 파일로서 보존된다.

함수의 정보

헤더 d3dx9mesh.h
임포트 라이브러리 d3dx9.lib
최저한의 operating system Windows 98

헤더	d3dx9mesh.h
임포트 라이브러리	d3dx9.lib
최저한의 operating system	Windows 98

참조

D3DXEFFECTDEFAULT ,D3DXEFFECTINSTANCE