JavaFXの2D図形におけるStrokeプロパティの使い方を徹底解説

Strokeプロパティとは

JavaFXにおけるstrokeプロパティは、図形の輪郭線（境界線）の色を指定・定義するためのプロパティです。javafx.scene.shape.Shapeクラスが提供するsetStroke()メソッドを使用することで、任意の色を図形の境界線に設定できます。

このメソッドは、Colorクラスのインスタンスを引数として受け取り、指定された色を図形の境界線に適用します。

各図形のデフォルト値

デフォルトでは、Line（直線）、Path（パス）、Polyline（折れ線）の各オブジェクトに対するこのプロパティの値は null（ストロークなし）です。それ以外のすべての図形では、初期値として Color.BLACK（黒）が設定されています。

サンプルコード

以下の例では、菱形（Polygon）や直線（Line）を作成し、setStroke()メソッドを使ってそれぞれ異なる色の輪郭線を設定しています。あわせて setStrokeWidth() メソッドで線の太さも変更している点に注目してください。

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.paint.Color;
import javafx.scene.shape.Line;
import javafx.scene.shape.Polygon;
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 StrokeExample extends Application {
   public void start(Stage stage) {
      // ラベル用のフォントを設定
      Font font = Font.font("verdana", FontWeight.BOLD, FontPosture.REGULAR, 12);

      Text label1 = new Text("Original Image");
      label1.setFont(font);
      label1.setX(250.0);
      label1.setY(125.0);

      // 輪郭線なしの菱形を作成
      Polygon rhombus1 = new Polygon(300.0, 0.0, 250.0, 50.0, 300.0, 100.0, 350.0, 50.0);

      Text label2 = new Text("Stroke for a line");
      label2.setFont(font);
      label2.setX(50.0);
      label2.setY(275.0);

      // 直線を作成し、濃い青色の太いストロークを設定
      Line line = new Line();
      line.setStartX(50.0);
      line.setStartY(200.0);
      line.setEndX(150.0);
      line.setEndY(200.0);
      line.setStrokeWidth(10.0);
      line.setStroke(Color.DARKBLUE);

      Text label3 = new Text("Stroke: Blue");
      label3.setFont(font);
      label3.setX(250.0);
      label3.setY(275.0);

      // 青色の輪郭線を持つ菱形を作成
      Polygon rhombus3 = new Polygon(300.0, 150.0, 250.0, 200.0, 300.0, 250.0, 350.0, 200.0);
      rhombus3.setStroke(Color.BLUE);
      rhombus3.setStrokeWidth(7.0);

      Text label4 = new Text("Stroke: Red");
      label4.setFont(font);
      label4.setX(450.0);
      label4.setY(275.0);

      // 赤色の輪郭線を持つ菱形を作成
      Polygon rhombus4 = new Polygon(490.0, 150.0, 440, 200.0, 490.0, 250.0, 540.0, 200.0);
      rhombus4.setStroke(Color.RED);
      rhombus4.setStrokeWidth(7.0);

      // Groupオブジェクトを作成
      Group root = new Group(label1, label2, label3, label4, rhombus1, line, rhombus3, rhombus4);

      // Sceneオブジェクトを作成
      Scene scene = new Scene(root, 595, 310);

      // Stageにタイトルを設定
      stage.setTitle("Stroke Example");

      // StageにSceneを追加して表示
      stage.setScene(scene);
      stage.show();
   }
   public static void main(String args[]){
      launch(args);
   }
}

実行結果

このプログラムを実行すると、以下のようなウィンドウが表示されます。上段には輪郭線を設定していない元の菱形、下段左には濃い青色の太いストロークを適用した直線、下段中央と右にはそれぞれ青色・赤色の輪郭線を設定した菱形が描画されていることが確認できます。

まとめ

strokeプロパティを活用することで、JavaFXの2D図形の見た目を自由にカスタマイズできます。setStroke()で輪郭線の色を指定し、setStrokeWidth()で線の太さを調整することで、より視認性の高いUIやグラフィック表現が可能になります。