JavaFX入門：2Dシェイプのストローク・マイターリミット（StrokeMiterLimit）プロパティの使い方

JavaFXでは、StrokeLineJoin.MITERスタイルで線分同士を結合する際、その結合部（マイター結合）の突出具合に上限を設定できます。この上限値を定義するのがストローク・マイターリミット（Stroke Miter Limit）プロパティです。

マイター結合とは、2つの線分が鋭い角度で交わったときに、角を尖らせてつなぐ結合方式のことです。交差する角度が浅くなるほど尖りは長く伸びるため、極端に細長い突起が描画されるのを防ぐ目的で、このリミット値が活用されます。

この値を設定するには、javafx.scene.shape.Shapeクラスが提供するsetStrokeMiterLimit()メソッドを使用します。

setStrokeMiterLimit()メソッドのポイント

• 引数としてdouble型の値を受け取ります。
• 指定した値が、ストロークのマイターリミットとして適用されます。
• 1.0未満の値を指定した場合は、自動的に1.0として扱われます。

サンプルコード

次の例では、3つの三角形ポリゴンに対して、それぞれ異なるマイターリミット値（3、4、0.4）を設定し、描画結果の違いを比較しています。

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 StrokeMiterExample extends Application {
   public void start(Stage stage) {
      Font font = Font.font("verdana", FontWeight.BOLD, FontPosture.REGULAR, 12);
      Text label2 = new Text("Miter Limit: 3");
      label2.setFont(font);
      label2.setX(50.0);
      label2.setY(275.0);
      Polygon shape1 = new Polygon(100.0, 50.0, 50.0, 200.0, 150.0, 200.0);
      shape1.setStroke(Color.BLUE);
      shape1.setStrokeWidth(20);
      shape1.setStrokeLineJoin(StrokeLineJoin.MITER);
      shape1.setStrokeMiterLimit(3);
      Text label3 = new Text("Miter Limit: 4");
      label3.setFont(font);
      label3.setX(250.0);
      label3.setY(275.0);
      Polygon shape2 = new Polygon(300.0, 50.0, 250.0, 200.0, 350.0, 200.0);
      shape2.setStroke(Color.BLUE);
      shape2.setStrokeWidth(20.0);
      shape2.setStrokeLineJoin(StrokeLineJoin.MITER);
      shape2.setStrokeMiterLimit(4);
      Text label4 = new Text("Miter Limit: 0.4");
      label4.setFont(font);
      label4.setX(430.0);
      label4.setY(275.0);
      Polygon shape3 = new Polygon(490.0, 50.0, 440, 200.0, 540.0, 200.0);
      shape3.setStroke(Color.BLUE);
      shape3.setStrokeWidth(20.0);
      shape3.setStrokeLineJoin(StrokeLineJoin.MITER);
      shape3.setStrokeMiterLimit(0.4);
      //Groupオブジェクトの作成
      Group root = new Group(label2, label3, label4, shape1, shape2, shape3);
      //Sceneオブジェクトの作成
      Scene scene = new Scene(root, 595, 310);
      //Stageにタイトルを設定
      stage.setTitle("Stroke Miter Limit");
      //Stageにシーンを設定
      stage.setScene(scene);
      //Stageの内容を表示
      stage.show();
   }
   public static void main(String args[]){
      launch(args);
   }
}

実行結果

上記のコードを実行すると、左から順にマイターリミット値が「3」「4」「0.4」の三角形が表示されます。リミット値によって、頂点部分の角の尖り方がどのように変化するかを確認できます。特に0.4を指定した3つ目の図形は、1.0未満の値が1.0として処理される挙動を示す好例です。