JavaFXの2D図形におけるストロークタイプ（StrokeType）プロパティの解説

ストロークタイププロパティとは

JavaFXにおいて、図形の境界線をどのように描画するかを指定するのが strokeType プロパティです。このプロパティは、javafx.scene.shape.Shape クラスが提供する setStrokeType() メソッドを使って設定できます。

JavaFXでは、StrokeType という名前のEnumが定義されており、その3つの定数によって3種類のストロークが表現されています。それぞれ以下の通りです。

• StrokeType.INSIDE ― 境界線を図形の内側に沿って描画します。

• StrokeType.OUTSIDE ― 境界線を図形の外側に沿って描画します。

• StrokeType.CENTERED ― 図形の輪郭が境界線のちょうど中央を通るように描画します。これがデフォルトの動作です。

図形に境界線を設定する際は、上記のいずれかの値を引数として setStrokeType() メソッドに渡します。なお、ストロークを実際に表示するには、setStroke() メソッドで色を指定し、必要に応じて setStrokeWidth() メソッドで線の太さを調整してください。

サンプルコード

以下の例では、4つのひし形（Polygon）を作成し、それぞれストロークタイプを変えて表示の違いを確認しています。

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.StrokeType;
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 StrokeTypeExample 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 Type: Inside");
        label2.setFont(font);
        label2.setX(25.0);
        label2.setY(275.0);
        Polygon rhombus2 = new Polygon(100.0, 150.0, 50.0, 200.0, 100.0, 250.0, 150.0, 200.0);
        rhombus2.setStroke(Color.BLUE);
        rhombus2.setStrokeWidth(7.0);
        rhombus2.setStrokeType(StrokeType.INSIDE);
        Text label3 = new Text("Stroke Type: Centered");
        label3.setFont(font);
        label3.setX(220.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);
        rhombus3.setStrokeType(StrokeType.CENTERED);
        Text label4 = new Text("Stroke Type: Outside");
        label4.setFont(font);
        label4.setX(430.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.BLUE);
        rhombus4.setStrokeWidth(7.0);
        rhombus4.setStrokeType(StrokeType.OUTSIDE);
        // Groupオブジェクトの作成
        Group root = new Group(label1, label2, label3, label4, rhombus1, rhombus2, rhombus3, rhombus4);
        // Sceneオブジェクトの作成
        Scene scene = new Scene(root, 595, 310);
        // Stageにタイトルを設定
        stage.setTitle("Stroke Type");
        // StageにSceneを追加
        stage.setScene(scene);
        // Stageの内容を表示
        stage.show();
    }
    public static void main(String args[]){
        launch(args);
    }
}

実行結果

このプログラムを実行すると、次のようなウィンドウが表示されます。上段はストロークなしの元の図形、下段は左から INSIDE・CENTERED・OUTSIDE を適用したひし形です。青い境界線が図形の内側・中央・外側のどこに描画されるかの違いを視覚的に確認できます。