D3DXCreateTextureFromFile 함수

파일에서 텍스처를 만듭니다.

구문

HRESULT D3DXCreateTextureFromFile(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  LPCTSTR            pSrcFile,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

매개 변수

pDevice [in]

형식: LPDIRECT3DDEVICE9

텍스처와 연결할 디바이스를 나타내는 IDirect3DDevice9 인터페이스에 대한 포인터입니다.

pSrcFile [in]

형식: LPCTSTR

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

ppTexture [out]

형식: LPDIRECT3DTEXTURE9*

생성된 텍스처 개체를 나타내는 IDirect3DTexture9 인터페이스에 대한 포인터의 주소입니다.

반환 값

형식: HRESULT

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

설명

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

이 함수는 .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm 및 .tga 파일 형식을 지원합니다. D3DXIMAGE_FILEFORMAT 참조하세요.

함수는 D3DXCreateTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppTexture)와 동일합니다.

Mipmapped 텍스처는 로드된 텍스처로 채워진 각 수준을 자동으로 갖습니다.

Mipmapped 텍스처에 이미지를 로드할 때 일부 디바이스는 1x1 이미지로 이동하지 못하며 이 함수는 실패합니다. 이 경우 이미지를 수동으로 로드해야 합니다.

이 함수를 사용하여 만든 리소스는 D3DPOOL_MANAGED 나타내는 메모리 클래스에 배치됩니다.

필터링은 이 메서드를 사용하여 만든 텍스처에 자동으로 적용됩니다. 필터링은 D3DX_FILTER_TRIANGLE | D3DX_FILTER D3DX_FILTER_DITHER.

D3DXCreateTextureFromFile을 사용할 때 최상의 성능을 위해 다음을 수행합니다.

1. 로드 시 이미지 크기 조정 및 형식 변환을 수행하면 속도가 느려질 수 있습니다. 이미지를 사용할 형식 및 해상도로 저장합니다. 대상 하드웨어에 2차원의 전원이 필요한 경우 2차원의 전원을 사용하여 이미지를 만들고 저장합니다.
2. DDS(DirectDraw Surface) 파일을 사용하는 것이 좋습니다. DDS 파일을 사용하여 Direct3D 9 텍스처 형식을 나타낼 수 있으므로 D3DX를 읽기가 매우 쉽습니다. 또한 Mipmap을 저장할 수 있으므로 모든 Mipmap 생성 알고리즘을 사용하여 이미지를 작성할 수 있습니다.

요구 사항

요구 사항	값
헤더	D3dx9tex.h
라이브러리	D3dx9.lib

추가 정보

D3DXCreateTextureFromFileEx

D3DX 9의 텍스처 함수