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]
-
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를 명시적으로 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보