IWICBitmapFrameEncode::WriteSource 메서드(wincodec.h)
비트맵 원본을 인코딩합니다.
구문
HRESULT WriteSource(
[in] IWICBitmapSource *pIBitmapSource,
[in] WICRect *prc
);
매개 변수
[in] pIBitmapSource
형식: IWICBitmapSource*
인코딩할 비트맵 원본입니다.
[in] prc
형식: WICRect*
비트맵 소스의 크기 사각형입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
WriteSource를 호출하기 전에 SetSize를 호출하지 않으면 prc에 지정된 크기가 NULL이 아닌 경우 사용됩니다. 그렇지 않으면 pIBitmapSource에 지정된 IWICBitmapSource의 크기가 사용됩니다.
WriteSource를 호출하기 전에 SetPixelFormat을 호출하지 않으면 pIBitmapSource에 지정된 IWICBitmapSource의 픽셀 형식이 사용됩니다.
WriteSource를 호출하기 전에 SetResolution을 호출하지 않으면 pIBitmapSource의 픽셀 형식이 사용됩니다.
WriteSource를 호출하기 전에 SetPalette를 호출하지 않으면 대상 픽셀 형식이 인덱싱되고 pIBitmapSource의 픽셀 형식이 인코더 프레임의 픽셀 형식과 일치하면 pIBitmapSource 픽셀 형식이 사용됩니다.
GIF 이미지를 인코딩할 때 전역 팔레트가 설정되고 프레임 수준 팔레트가 사용자 또는 사용자 지정 ISV(독립 소프트웨어 공급업체) GIF 코덱에 의해 직접 설정되지 않은 경우 WriteSource 는 pIBitmapSource 에 프레임 수준 팔레트가 있는 경우에도 전역 팔레트를 사용하여 프레임을 인코딩합니다.
Windows Vista부터 누적된 총 원본 사각형 높이가 SetSize를 통해 설정된 높이와 동일하면 반복적인 WriteSource 호출을 수행할 수 있습니다.
Windows 8.1 원본 사각형은 SetSize를 통해 설정된 차원 이상이어야 합니다. 원본 사각형 너비가 SetSize 너비를 초과하면 오른쪽의 추가 픽셀이 무시됩니다. 원본 사각형 높이가 채워지지 않은 나머지 높이를 초과하면 아래쪽의 추가 검사 줄이 무시됩니다.
요구 사항
| 지원되는 최소 클라이언트 | WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | wincodec.h |
| 라이브러리 | Windowscodecs.lib |
| DLL | Windowscodecs.dll |
추가 정보
개념