JavaFX로 폴리라인(Polyline) 그리는 방법 – 단계별 완벽 가이드

폴리라인(Polyline)은 동일한 평면 위에 존재하는 여러 개의 선분(n개의 선)으로 이루어진 열린 도형입니다. 즉, 폴리라인은 끝점이 연결되어 닫히지 않는다는 점만 제외하면 폴리곤(다각형)과 동일합니다. JavaFX에서 폴리라인은 javafx.scene.shape.Polyline 클래스를 통해 표현됩니다.

JavaFX에서 폴리라인 만드는 절차

JavaFX로 폴리라인을 그리려면 아래 단계를 순서대로 따라 하면 됩니다.

1. 클래스 인스턴스 생성 – Polyline 클래스를 인스턴스화합니다.

2. 좌표 값 지정 – 그릴 각 선분의 시작점과 끝점(XY 좌표)을 생성자의 인수로 전달하거나, getPoints() 메서드를 사용해 설정합니다.

polygon.getPoints().addAll(new Double[]{ 
   // 쉼표로 구분된 XY 좌표 목록 
});

3. Group에 노드 추가 – 생성된 노드(도형)를 Group 객체에 추가하여 화면에 표시합니다.

예제 코드

아래는 JavaFX 애플리케이션에서 폴리라인을 직접 그려 보는 전체 예제입니다.

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.paint.Color;
import javafx.stage.Stage;
import javafx.scene.shape.Polyline;

public class DrawingPolyLine extends Application {
   public void start(Stage stage) {
      // 폴리라인 생성
      Polyline polyline = new Polyline();

      // 폴리라인의 좌표 설정
      polyline.getPoints().addAll(new Double[]{
         150.0, 200.0, 410.0, 200.0, 250.0, 50.0, 250.0, 230.0 });

      // 기타 속성 설정
      polyline.setStrokeWidth(8.0);
      polyline.setStroke(Color.DARKSLATEGREY);

      // Scene 설정
      Group root = new Group(polyline);
      Scene scene = new Scene(root, 595, 300, Color.BEIGE);
      stage.setTitle("Drawing Polyline");
      stage.setScene(scene);
      stage.show();
   }

   public static void main(String args[]) {
      launch(args);
   }
}

실행 결과

위 코드를 실행하면 지정한 네 개의 좌표(150,200 → 410,200 → 250,50 → 250,230)를 잇는 굵기 8픽셀의 진회색(DARKSLATEGREY) 폴리라인이 베이지색 배경의 창에 그려집니다. 시작점과 끝점이 자동으로 연결되지 않으므로 결과물은 닫히지 않은 열린 형태의 도형으로 출력되며, 이것이 폴리라인이 폴리곤과 구별되는 핵심 특징입니다.

선 두께와 색상을 조절하고 싶다면 setStrokeWidth()와 setStroke() 메서드의 값을 변경하면 되고, 좌표를 추가·수정하면 원하는 모양의 복잡한 선형 도형도 손쉽게 그릴 수 있습니다.