D3DXSaveMeshToX 함수

메시를 .x 파일에 저장합니다.

구문

HRESULT D3DXSaveMeshToX(
  _In_       LPCTSTR            pFilename,
  _In_       LPD3DXMESH         pMesh,
  _In_ const DWORD              *pAdjacency,
  _In_ const D3DXMATERIAL       *pMaterials,
  _In_ const D3DXEFFECTINSTANCE *pEffectInstances,
  _In_       DWORD              NumMaterials,
  _In_       DWORD              Format
);

매개 변수

pFilename [in]

형식: LPCTSTR

파일 이름을 지정하는 문자열에 대한 포인터입니다. 컴파일러 설정에 유니코드가 필요한 경우 데이터 형식 LPCTSTR이 LPCWSTR로 확인됩니다. 그렇지 않으면 문자열 데이터 형식이 LPCSTR로 확인됩니다. 설명 부분을 참조하세요.

pMesh [in]

형식: LPD3DXMESH

.x 파일에 저장할 메시를 나타내는 ID3DXMesh 인터페이스에 대한 포인터입니다.

pAdjacency [in]

형식: const DWORD*

메시의 각 면에 대해 세 개의 인접 항목을 지정하는 얼굴당 3개의 DWORD 배열에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

pMaterials [in]

형식: const D3DXMATERIAL*

.x 파일에 저장할 재질 정보를 포함하는 D3DXMATERIAL 구조체의 배열에 대한 포인터입니다.

pEffectInstances [in]

형식: const D3DXEFFECTINSTANCE*

메시의 특성 그룹당 하나씩 효과 인스턴스 배열에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 효과 instance 효과를 초기화하는 데 사용되는 상태 정보의 특정 instance. 자세한 내용은 D3DXEFFECTINSTANCE를 참조하세요.

NumMaterials [in]

형식: DWORD

pMaterials 배열의 D3DXMATERIAL 구조 체 수입니다 .

형식 [in]

형식: DWORD

.x 파일을 저장할 때 파일 형식과 저장 옵션의 조합입니다. D3DX X 파일 상수를 참조하세요.

반환 값

형식: HRESULT

함수가 성공하면 반환 값이 D3D_OK. 함수가 실패하면 반환 값은 D3DERR_INVALIDCALL 중 하나일 수 있습니다.

설명

컴파일러 설정은 함수 버전도 결정합니다. 유니코드가 정의되면 함수 호출이 D3DXSaveMeshToXW로 확인됩니다. 그렇지 않으면 ANSI 문자열이 사용되므로 함수 호출이 D3DXSaveMeshToXA로 확인됩니다.

기본 파일 형식은 이진 파일입니다. 그러나 파일이 이진 파일과 텍스트 파일로 모두 지정되면 텍스트 파일로 저장됩니다. 파일 형식에 관계없이 압축된 형식을 사용하여 파일 크기를 줄일 수도 있습니다.

다음은 이 함수를 사용하는 방법에 대한 일반적인 코드 예제입니다.

ID3DXMesh*    m_pMesh;           // Mesh object to be saved to a .x file
D3DXMATERIAL* m_pMaterials;      // Array of material structs in the mesh
DWORD         m_dwNumMaterials;  // Number of material structs in the mesh
    
DWORD dwFormat = D3DXF_FILEFORMAT_BINARY;  // Binary-format .x file (default)
// DWORD dwFormat = D3DXF_FILEFORMAT_TEXT; // Text-format .x file
    
// Load mesh into m_pMesh and determine values of m_pMaterials and 
// m_dwNumMaterials with calls to D3DXLoadMeshxxx or other D3DX functions
    
// ...
        
D3DXSaveMeshToX(
    L"outputxfilename.x",
    m_pMesh,
    NULL,
    m_pMaterials,
    NULL,
    m_dwNumMaterials,
    dwFormat );

요구 사항

추가 정보

메시 함수

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE