D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES 구조체(d2d1.h)

ID2D1LinearGradientBrush에 대한 그라데이션 축의 시작점과 엔드포인트를 포함합니다.

구문

typedef struct D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES {
  D2D1_POINT_2F startPoint;
  D2D1_POINT_2F endPoint;
} D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES;

멤버

startPoint

형식: D2D1_POINT_2F

브러시의 좌표 공간에서 그라데이션 축의 시작점입니다.

endPoint

형식: D2D1_POINT_2F

브러시의 좌표 공간에서 그라데이션 축의 엔드포인트입니다.

설명

CreateLinearGradientBrush 메서드를 사용하여 새 ID2D1LinearGradientBrush 개체를 만들 때 이 메서드를 사용합니다. 편의를 위해 Direct2D는 새 D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES 구조를 만들기 위한 D2D1::LinearGradientBrushProperties 도우미 함수를 제공합니다.

다음 그림에서는 시작점과 끝점을 변경할 때 선형 그라데이션이 어떻게 변하는지 보여 줍니다. 첫 번째 그라데이션의 경우 시작점은 (0,0)로 설정되고 끝점은 (150, 50)로 설정됩니다. 그러면 왼쪽 위 모서리에서 시작하여 그리는 영역의 오른쪽 아래 모서리까지 확장되는 대각선 그라데이션이 만들어집니다. 시작점을 (0, 25)로 설정하고 끝점을 (150, 25)로 설정하면 가로 그라데이션이 만들어집니다. 마찬가지로 시작점을 (75, 0)으로 설정하고 끝점을 (75, 50)로 설정하면 세로 그라데이션이 생성됩니다. 시작점을 (0, 50)로 설정하고 끝점을 (150, 0)으로 설정하면 왼쪽 아래 모서리에서 시작하여 그리는 영역의 오른쪽 위 모서리까지 확장되는 대각선 그라데이션이 만들어집니다.

예제

다음 예제에서는 CreateLinearGradientBrush 메서드를 사용하여 ID2D1LinearGradientBrush (m_pLinearGradientBrush)를 만듭니다. D2D1::LinearGradientBrushProperties 도우미 메서드를 사용하여 시작점(0, 0) 및 끝점(150, 150)을 포함하는 D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES 구조를 만들고 CreateLinearGradientBrush 메서드에 전달합니다.

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

선형 그라데이션 브러시를 만들고 사용하는 방법에 대한 자세한 내용은 선형 그라데이션 브러시를 만드는 방법 항목 및 브러시 개요를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
머리글	d2d1.h

추가 정보

브러시 개요

선형 그라데이션 브러시를 만드는 방법