ID2D1RenderTarget::P ushAxisAlignedClip(constD2D1_RECT_F&,D2D1_ANTIALIAS_MODE) 메서드(d2d1.h)

모든 후속 그리기 작업이 잘리는 사각형을 지정합니다.

구문

void PushAxisAlignedClip(
  const D2D1_RECT_F & clipRect,
  D2D1_ANTIALIAS_MODE antialiasMode
);

매개 변수

clipRect

형식: [in] const D2D1_RECT_F &

클리핑 영역의 크기와 위치(디바이스 독립적 픽셀)입니다.

antialiasMode

형식: [in] D2D1_ANTIALIAS_MODE

하위 픽셀 경계가 있는 클립 사각형의 가장자리를 그리고 장면 내용과 클립을 혼합하는 데 사용되는 앤티앨리어싱 모드입니다. 혼합은 PopAxisAlignedClip 메서드가 호출될 때 한 번 수행되며 계층 내의 각 기본 형식에는 적용되지 않습니다.

반환 값

없음

설명

clipRect는 렌더링 대상에 설정된 현재 월드 변환에 의해 변환됩니다. 변환이 전달되는 clipRect 에 적용된 후 clipRect 에 대한 축 맞춤 경계 상자가 계산됩니다. 효율성을 위해 콘텐츠는 전달된 원래 clipRect 가 아닌 축 맞춤 경계 상자로 잘립니다.

다음 다이어그램에서는 회전 변환이 렌더링 대상, 결과 clipRect 및 계산된 축 맞춤 경계 상자에 적용되는 방법을 보여 줍니다.

1. 다음 그림에서 사각형이 화면 픽셀에 맞춰진 렌더링 대상이라고 가정합니다.
2. 렌더링 대상에 회전 변환을 적용합니다. 다음 그림에서 검은색 사각형은 원래 렌더링 대상을 나타내고 빨간색 파선 사각형은 변환된 렌더링 대상을 나타냅니다.
3. PushAxisAlignedClip을 호출하면 회전 변환이 clipRect에 적용됩니다. 다음 그림에서 파란색 사각형은 변환된 clipRect를 나타냅니다.
4. 축 맞춤 경계 상자가 계산됩니다. 녹색 파선 사각형은 다음 그림의 경계 상자를 나타냅니다. 모든 콘텐츠가 이 축 맞춤 경계 상자에 잘립니다.

참고 렌더링 작업이 실패하거나 PopAxisAlignedClip 이 호출되지 않으면 클립 사각형으로 인해 렌더링 대상에 일부 아티팩트가 발생할 수 있습니다. PopAxisAlignedClip 은 클리핑 영역의 테두리를 수정하도록 설계된 그리기 작업으로 간주될 수 있습니다. 이 호출이 없으면 잘린 영역의 테두리가 앤티앨리어스되거나 수정되지 않을 수 있습니다.

 

PushAxisAlignedClip 및 PopAxisAlignedClip이 일치해야 합니다. 그렇지 않으면 오류 상태가 설정됩니다. 렌더링 대상이 계속해서 새 명령을 수신하려면 Flush 를 호출하여 오류를 지울 수 있습니다.

PushAxisAlignedClip 및 PopAxisAlignedClip 쌍은 PushLayer 및 PopLayer 주변 또는 내에서 발생할 수 있지만 겹칠 수는 없습니다. 예를 들어 PushAxisAlignedClip, PushLayer, PopLayer, PopAxisAlignedClip 시퀀스는 유효하지만 PushAxisAlignedClip, PushLayer, PopAxisAlignedClip, PopLayer 시퀀스는 유효하지 않습니다.

이 메서드는 실패할 경우 오류 코드를 반환하지 않습니다. 그리기 작업(예: PushAxisAlignedClip)이 실패했는지 여부를 확인하려면 ID2D1RenderTarget::EndDraw 또는 ID2D1RenderTarget::Flush 메서드에서 반환된 결과를 검사.

요구 사항

지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	d2d1.h
라이브러리	D2d1.lib
DLL	D2d1.dll

추가 정보

ID2D1RenderTarget