GraphicsPath::Outline 메서드(gdipluspath.h)

아티클
08/24/2023

GraphicsPath::Outline 메서드는 이 경로를 변환하고 평면화한 다음 경로의 윤곽선만 나타내도록 이 경로의 데이터 요소를 변환합니다.

구문

Status Outline(
  [in] const Matrix *matrix,
  [in] REAL         flatness
);

매개 변수

[in] matrix

형식: const Matrix*

(선택 사항) 변환을 지정하는 Matrix 개체에 대한 포인터입니다. 이 매개 변수가 NULL이면 변환이 적용되지 않습니다. 기본값은 NULL입니다.

[in] flatness

형식: REAL

(선택 사항) 경로와 해당 평면화된 근사값 사이의 최대 오류를 지정하는 실수입니다. 평탄도를 줄이면 근사치의 선 세그먼트 수가 증가합니다. 기본값은 Gdiplusenums.h에 정의된 상수인 FlatnessDefault입니다.

반환 값

형식: 상태

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

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

설명

GraphicsPath 개체는 선과 곡선을 나타내는 데이터 요소 컬렉션을 저장합니다. GraphicsPath::Outline 메서드는 이러한 데이터 요소를 변경하고 원래 데이터 요소가 손실됩니다.

예제

다음 예제에서는 GraphicsPath 개체를 만들고 GraphicsPath::AddClosedCurve 메서드를 호출하여 닫힌 카디널 스플라인을 경로에 추가합니다. 이 코드는 GraphicsPath::Widen 메서드를 호출하여 경로를 확장한 다음 경로를 그립니다. 다음으로, 코드는 경로의 Outline 메서드를 호출 합니다 . 이 코드는 Graphics 개체의 TranslateTransform 메서드를 호출하여 DrawPath 에 대한 후속 호출에서 그린 윤곽선 경로가 첫 번째 경로의 오른쪽에 배치되도록 합니다.


VOID OutlineExample(HDC hdc)
{
   Graphics graphics(hdc);

   Pen bluePen(Color(255, 0, 0, 255));
   Pen greenPen(Color(255, 0, 255,  0), 10);

   PointF points[] = {
      PointF(20.0f, 20.0f),
      PointF(160.0f, 100.0f),
      PointF(140.0f, 60.0f),
      PointF(60.0f, 100.0f)};

   GraphicsPath path;
   path.AddClosedCurve(points, 4);

   path.Widen(&greenPen);
   graphics.DrawPath(&bluePen, &path);

   path.Outline();

   graphics.TranslateTransform(180.0f, 0.0f);
   graphics.DrawPath(&bluePen, &path);
}

요구 사항


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