D3DXSaveTextureToFile 함수

질감을 파일에 저장 합니다.

구문

HRESULT D3DXSaveTextureToFile(
  _In_       LPCTSTR                pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT   DestFormat,
  _In_       LPDIRECT3DBASETEXTURE9 pSrcTexture,
  _In_ const PALETTEENTRY           *pSrcPalette
);

매개 변수

Pdestfile [ 진행]

유형: LPCTSTR

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

Destformat [ 진행]

유형: D3DXIMAGE _ FILEFORMAT

D3DXIMAGE _ 저장할 때 사용할 파일 형식을 지정 하는 FILEFORMAT입니다. 이 함수는 이식 가능한 Pixmap (. ppm) 및 Targa/Truevision Graphics Adapter (.tga)를 제외한 모든 D3DXIMAGE _ FILEFORMAT 형식에 저장을 지원 합니다.

Psrctexture [ 진행]

유형: LPDIRECT3DBASETEXTURE9

저장할 질감이 포함 된 IDirect3DBaseTexture9 interface에 대 한 포인터입니다.

Psrcpalette [ 진행]

형식: Const PALETTEENTRY *

256 색의 색상표를 포함 하는 PALETTEENTRY 구조체에 대 한 포인터입니다. 이 매개 변수는 NULL 일 수 있습니다.

반환 값

유형: HRESULT

함수가 성공 하면 반환 값은 D3D _ OK입니다. 함수가 실패 하면 반환 값은 다음과 같을 수 있습니다. D3DERR _ invalidcall

설명

컴파일러 설정에도 함수 버전이 결정 됩니다. Unicode가 정의 된 경우 함수 호출은 D3DXSaveTextureToFileW로 확인 됩니다. 그렇지 않으면 ANSI 문자열이 사용 되 고 있기 때문에 함수 호출이 D3DXSaveTextureToFileA으로 확인 됩니다.

이 함수는 압축 된 질감 형식으로의 변환을 처리 합니다.

볼륨이 동적이 아닌 경우 (생성 시 사용 매개 변수를 0으로 설정 하 고) 비디오 메모리 (D3DPOOL DEFAULT로 설정 됨)에 있는 경우 _ D3DX는 비디오 메모리에 있는 비동적 볼륨을 잠글 수 없기 때문에 D3DXSaveTextureToFile 가 실패 합니다.

요구 사항

요구 사항
헤더
D3dx9tex
라이브러리
D3dx9

추가 정보

D3DX 9의 질감 함수

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile