Previous | Contents | Next

3.2.17 IBandiCapture::CaptureImage

현재 출력되고 있는 화면을 이미지 파일로 캡처합니다.

이 함수는 D3DXSaveSurfaceToFile()보다 훨씬 빠른속도로 동작합니다.

• 정의

HRESULT CaptureImage(LPCWSTR pwszFilePath, INT nFileType, INT nQuality, INT nCaptureMode,
                     BOOL bIncludeCursor, LONG_PTR lpParam1, LONG_PTR lpParam2)

• 파라메터

  LPCWSTR pwszFilePath

  [in] 캡처된 JPEG 파일이 저장될 파일 경로명. 파일의 확장자 까지 정확히 경로를 지정하여야 합니다.

  INT nFileType

  [in] 저장할 파일의 종류를 지정합니다.

  BCAP_IMAGE_BMP

  BMP 포맷으로 저장합니다. BMP 포맷은 데이터를 압축하지 않습니다.

  BCAP_IMAGE_JPG

  JPEG 포맷으로 저장합니다. JPEG 포맷은 손실압축 포맷이며, 이미지 데이터의 화질 열화가 있습니다.

  BCAP_IMAGE_PNG

  PNG 포맷으로 저장됩니다. D3D9화면을 캡처할 경우, 화면 모드가 D3DFMT_A8R8G8B8 이면 ALPHA값을 포함하여 32bpp로 저장되며, 그 이외의 경우는 24bpp로 저장됩니다. 이 포맷은 화면에 렌더링된 데이타를 알파값까지 저장하고자 할때 유용합니다. PNG 포맷은 비손실 압축포맷입니다.

  INT nQuality

  [in] JPEG 파일로 저장시 JPEG 이미지의 품질을 결정합니다. 1 ~ 100 까지 설정이 가능하며 100에 가까울 수록 품질이 좋습니다. 보통 80정도면 적당한 화질의 영상을 얻을 수 있습니다.

  INT nCaptureMode

  [in] 캡처 모드를 결정합니다.

  BCAP_MODE_D3D9

  BCAP_MODE_D3D9_SCALE

  BCAP_MODE_D3D9_SWAPCHAIN

  D3D9 화면을 캡처합니다.

  BCAP_MODE_D3D8

  D3D8 화면을 캡처합니다.

  BCAP_MODE_D3D10

  D3D10 화면을 캡처합니다.

  BCAP_MODE_GL

  OpenGL 화면을 캡처합니다.

  BCAP_MODE_DDRAW7

  DDRAW7 화면을 캡처합니다.

  BCAP_MODE_D3D11

  D3D11 화면을 캡처합니다.

  BOOL bIncludeCursor

  [in] 캡처된 이미지에 마우스 커서 이미지를 포함시킬지 여부를 결정합니다.

  LONG_PTR lpParam1

  [in] nCaptureMode 모드에 따른 디바이스 포인터값을 파라메터로 전달합니다.

  BCAP_MODE_D3D9 : 캡처 대상이 되는 영역의 Direct3D9 인터페이스 포인터 (IDirect3DDevice9*)

  BCAP_MODE_D3D9_SCALE : 캡처 대상이 되는 영역의 Direct3D9 인터페이스 포인터 (IDirect3DDevice9*)

  BCAP_MODE_D3D9_SWAPCHAIN : 캡처 대상이 되는 영역의 Direct3D9 SwapChain 인터페이스 포인터 (IDirect3DSwapChain9*)

  BCAP_MODE_D3D8 : 캡처 대상이 되는 영역의 Direct3D8 인터페이스 포인터 (IDirect3DDevice8*)

  BCAP_MODE_D3D10 : 캡처 대상이 되는 영역의 SwapChain 인터페이스 포인터 (IDXGISwapChain*)

  BCAP_MODE_GL : 파라메터를 설정하지 않음 (NULL)

  BCAP_MODE_DDRAW7 : 캡처 대상이 되는 영역의 DDRAW7 백버퍼 인터페이스 포인터 (IDirectDrawSurface7*)

  BCAP_MODE_D3D11 : 캡처 대상이 되는 영역의 SwapChain 인터페이스 포인터 (IDXGISwapChain*)

• 리턴값

  BCERR_INVALIDARG

  입력된 파라메터가 잘못되었습니다.

  BCERR_FILE_CREATE

  이미지 파일을 생성할 수 없습니다.

  BCERR_FILE_WRITE

  이미지 파일을 저장할 수 없습니다.

  BC_OK

  이미지 캡처가 정상적으로 수행되었습니다.