ID2D1RenderTarget::CreateCompatibleRenderTarget(constD2D1_SIZE_F*,constD2D1_SIZE_U*,constD2D1_PIXEL_FORMAT*,D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS,ID2D1BitmapRenderTarget**) 메서드(d2d1.h)
현재 렌더링 대상과 호환되는 중간 오프스크린 그리기 중에 사용할 비트맵 렌더링 대상을 만듭니다.
구문
HRESULT CreateCompatibleRenderTarget(
const D2D1_SIZE_F *desiredSize,
const D2D1_SIZE_U *desiredPixelSize,
const D2D1_PIXEL_FORMAT *desiredFormat,
D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
ID2D1BitmapRenderTarget **bitmapRenderTarget
);
매개 변수
desiredSize
형식: [in] const D2D1_SIZE_F*
원래 렌더링 대상과 달라야 하는 경우 새 렌더링 대상의 원하는 크기(디바이스 독립적 픽셀)입니다. 자세한 내용은 설명 섹션을 참조하세요.
desiredPixelSize
형식: [in] const D2D1_SIZE_U*
원래 렌더링 대상과 달라야 하는 경우 새 렌더링 대상의 원하는 크기(픽셀)입니다. 자세한 내용은 주의 섹션을 참조하세요.
desiredFormat
형식: [in] const D2D1_PIXEL_FORMAT*
새 렌더링 대상의 원하는 픽셀 형식 및 알파 모드입니다. 픽셀 형식이 DXGI_FORMAT_UNKNOWN 설정되면 새 렌더링 대상은 원래 렌더링 대상과 동일한 픽셀 형식을 사용합니다. 알파 모드가 D2D1_ALPHA_MODE_UNKNOWN 경우 새 렌더링 대상의 알파 모드는 기본적으로 D2D1_ALPHA_MODE_PREMULTIPLIED. 지원되는 픽셀 형식에 대한 자세한 내용은 지원되는 픽셀 형식 및 알파 모드를 참조하세요.
options
형식: [in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS
새 렌더링 대상이 GDI와 호환되어야 하는지 여부를 지정하는 값입니다.
bitmapRenderTarget
형식: [out] ID2D1BitmapRenderTarget**
이 메서드가 반환되면 새 비트맵 렌더링 대상에 대한 포인터에 대한 포인터가 포함됩니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
설명
desiredSize 또는 desiredPixelSize에 대한 값을 지정하여 새 렌더링 대상의 픽셀 크기와 DPI를 변경할 수 있습니다.
- desiredSize를 지정했지만 desiredPixelSize가 지정되지 않은 경우 픽셀 크기는 부모 대상 DPI를 사용하여 원하는 크기에서 계산됩니다. desiredSize가 정수 픽셀 크기에 매핑되는 경우 호환되는 렌더링 대상의 DPI는 부모 대상의 DPI와 동일합니다. desiredSize가 소수 픽셀 크기에 매핑되는 경우 픽셀 크기는 가장 가까운 정수로 반올림되고 호환되는 렌더링 대상의 DPI는 부모 렌더링 대상의 DPI보다 약간 높습니다. 모든 경우에 좌표(desiredSize.width, desiredSize.height)는 호환되는 렌더링 대상의 오른쪽 아래 모서리에 매핑됩니다.
- desiredPixelSize가 지정되고 desiredSize가 지정되지 않은 경우 새 렌더링 대상의 DPI는 원래 렌더링 대상과 동일합니다.
- desiredSize와 desiredPixelSize를 모두 지정하면 새 렌더링 대상의 DPI가 배율 차이를 고려하여 계산됩니다.
- desiredSize 또는 desiredPixelSize를 지정하지 않으면 새 렌더링 대상 크기와 DPI가 원래 렌더링 대상과 일치합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | d2d1.h |
라이브러리 | D2d1.lib |
DLL | D2d1.dll |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기