D3DXLoadSurfaceFromFile 함수

파일에서 표면을 로드합니다.

구문

HRESULT D3DXLoadSurfaceFromFile(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          LPCTSTR            pSrcFile,
  _In_    const RECT               *pSrcRect,
  _In_          DWORD              Filter,
  _In_          D3DCOLOR           ColorKey,
  _Inout_       D3DXIMAGE_INFO     *pSrcInfo
);

매개 변수

pDestSurface [in]

형식: LPDIRECT3DSURFACE9

IDirect3DSurface9 인터페이스에 대한 포인터입니다. 이미지를 수신하는 대상 화면을 지정합니다.

pDestPalette [in]

형식: const PALETTEENTRY*

PALETTEENTRY 구조체, 256색 또는 NULL의 대상 팔레트에 대한 포인터입니다.

pDestRect [in]

형식: const RECT*

RECT 구조체에 대한 포인터입니다. 대상 사각형을 지정합니다. 전체 표면을 지정하려면 이 매개 변수를 NULL 로 설정합니다.

pSrcFile [in]

형식: LPCTSTR

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

pSrcRect [in]

형식: const RECT*

RECT 구조체에 대한 포인터입니다. 원본 사각형을 지정합니다. 이 매개 변수를 NULL 로 설정하여 전체 이미지를 지정합니다.

필터 [in]

형식: DWORD

하나 이상의 D3DX_FILTER 이미지 필터링 방법을 제어하는 조합입니다. 이 매개 변수에 D3DX_DEFAULT 지정하는 것은 D3DX_FILTER_TRIANGLE 지정하는 것과 같습니다. | D3DX_FILTER_DITHER.

ColorKey [in]

형식: D3DCOLOR

투명 검정으로 바꿀 D3DCOLOR 값이거나 색 키를 사용하지 않도록 설정하려면 0입니다. 원본 이미지 형식과 관계없이 항상 32비트 ARGB 색입니다. 알파는 중요하며 일반적으로 불투명 색 키의 경우 FF로 설정해야 합니다. 따라서 불투명 검정의 경우 값은 0xFF000000 같습니다.

pSrcInfo [in, out]

형식: D3DXIMAGE_INFO*

원본 이미지 파일 또는 NULL의 데이터에 대한 설명으로 채울 D3DXIMAGE_INFO 구조체에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

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

이 함수는 압축된 텍스처 형식으로의 변환을 처리하고 .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm 및 .tga 파일 형식을 지원합니다. D3DXIMAGE_FILEFORMAT 참조하세요.

수준 0이 아닌 표면에 쓰면 더티 사각형이 업데이트되지 않습니다. D3DXLoadSurfaceFromFile이 호출되고 표면이 아직 더티 않은 경우(일반적인 사용 시나리오에서는 가능성이 낮음) 애플리케이션은 표면에서 AddDirtyRect를 명시적으로 호출해야 합니다.

요구 사항

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

추가 정보

D3DX 9의 텍스처 함수