JavaFX 2D 도형의 smooth 속성 완벽 가이드 – setSmooth()로 가장자리 부드럽게 만들기

smooth 속성이란?

JavaFX에서 smooth 속성은 도형을 렌더링할 때 앤티앨리어싱(antialiasing) 힌트를 적용할지 여부를 결정합니다. 앤티앨리어싱은 도형 가장자리에 나타나는 계단 현상(jagged edges)을 줄여 훨씬 매끄러운 화면을 만들어 주는 기술입니다.

이 속성의 값은 javafx.scene.shape.Shape 클래스가 제공하는 setSmooth() 메서드를 통해 설정할 수 있습니다. 이 메서드는 boolean 값을 인수로 받으며, true를 전달하면 도형의 가장자리가 부드럽게 처리되고, false를 전달하면 가장자리가 그대로 거칠게 표시됩니다.

동작 방식 요약

• setSmooth(true) — 앤티앨리어싱을 적용하여 가장자리를 부드럽게 렌더링합니다.
• setSmooth(false) — 앤티앨리어싱을 비활성화하여 가장자리를 날카롭고 각지게 표현합니다.

예제 코드

다음 예제는 두 개의 삼각형(Polygon)을 그린 뒤, 하나에는 smooth를 true로, 다른 하나에는 false로 설정하여 두 결과의 차이를 시각적으로 비교합니다.

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.paint.Color;
import javafx.scene.shape.Polygon;
import javafx.scene.shape.StrokeLineJoin;
import javafx.scene.text.Font;
import javafx.scene.text.FontPosture;
import javafx.scene.text.FontWeight;
import javafx.scene.text.Text;
import javafx.stage.Stage;

public class SmoothExample extends Application {
   public void start(Stage stage) {
      Font font = Font.font("verdana", FontWeight.BOLD, FontPosture.REGULAR, 12);

      Text label2 = new Text("Smooth: true");
      label2.setFont(font);
      label2.setX(80.0);
      label2.setY(250.0);

      Polygon shape1 = new Polygon(100.0, 75.0, 50.0, 200.0, 200.0, 200.0);
      shape1.setStroke(Color.BLUE);
      shape1.setStrokeWidth(20);
      shape1.setStrokeLineJoin(StrokeLineJoin.MITER);
      shape1.setSmooth(true);

      Text label3 = new Text("Smooth: false");
      label3.setFont(font);
      label3.setX(370.0);
      label3.setY(250.0);

      Polygon shape2 = new Polygon(450.0, 75.0, 350.0, 200.0, 500.0, 200.0);
      shape2.setStroke(Color.BLUE);
      shape2.setStrokeWidth(20.0);
      shape2.setStrokeLineJoin(StrokeLineJoin.MITER);
      shape2.setSmooth(false);

      //Group 객체 생성
      Group root = new Group(label2, label3, shape1, shape2);
      //Scene 객체 생성
      Scene scene = new Scene(root, 595, 310);
      //Stage에 제목 설정
      stage.setTitle("Smooth Example");
      //Stage에 Scene 추가
      stage.setScene(scene);
      //Stage 내용 표시
      stage.show();
   }
   public static void main(String args[]) {
      launch(args);
   }
}

실행 결과

위 코드를 실행하면 왼쪽 삼각형(smooth: true)은 가장자리가 부드럽게 처리되어 자연스러운 반면, 오른쪽 삼각형(smooth: false)은 가장자리가 각지고 거칠게 보이는 것을 확인할 수 있습니다. 굵은 스트로크(stroke)를 사용할수록 두 결과의 차이가 더욱 뚜렷하게 드러납니다.