GraphicsPath::AddCurve(constPoint*,INT,REAL) 메서드(gdipluspath.h)

아티클
02/28/2024

GraphicsPath::AddCurve 메서드는 이 경로의 현재 그림에 카디널 스플라인을 추가합니다.

구문

Status AddCurve(
  [in] const Point *points,
  [in] INT         count,
  [in] REAL        tension
);

매개 변수

[in] points

형식: const Point*

카디널 스플라인을 정의하는 점 배열에 대한 포인터입니다. 카디널 스플라인은 배열의 각 지점을 통과하는 곡선입니다.

[in] count

형식: INT

점 배열의 요소 수를 지정하는 정수입니다.

[in] tension

형식: REAL

곡선의 길이와 곡선이 구부러지는 방식을 제어하는 무수 실수입니다. 값 0은 스플라인이 직선 세그먼트 시퀀스임을 지정합니다. 값이 증가하면 곡선이 더 충만해집니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

나중에 해당 점이 필요한 경우 점 배열의 복사본을 유지해야 합니다. GraphicsPath 개체는 AddClosedCurve 메서드에 전달된 점을 저장하지 않습니다. 대신, 카디널 스플라인을 Bézier 스플라인 시퀀스로 변환하고 해당 Bézier 스플라인을 정의하는 점을 저장합니다. GraphicsPath 개체에서 원래 점 배열을 검색할 수 없습니다.

예제

다음 예제에서는 GraphicsPath 개체를 만들고 GraphicsPath::AddCurve 메서드를 호출하여 경로에 카디널 스플라인을 추가합니다. GraphicsPath::AddCurve에 전달된 세 번째 인수는 카디널 스플라인의 장력을 지정합니다.

VOID AddCurveExample(HDC hdc)
{
   Graphics graphics(hdc);
   Point pts[] = {Point(50, 50),
                  Point(60, 20),
                  Point(70, 100),
                  Point(80, 50)};
   GraphicsPath path;
   path.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);   
}
Color(255, 255, 0,  0)

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdipluspath.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll