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. 축 맞춤 경계 상자가 계산됩니다. 녹색 파선 사각형은 다음 그림의 경계 상자를 나타냅니다. 모든 콘텐츠가 이 축 맞춤 경계 상자에 잘립니다.

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

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

요구 사항

추가 정보

ID2D1RenderTarget