JavaFX のフォントレンダリング品質問題


はじめに

JavaFx font rendering low quality などで検索すると山ほどでてくる昔からの問題。


実例

以下のようなコード。

public class App extends Application {

    @Override
    public void start(Stage stage) {
        var vbox = new VBox(canvas1(), canvas2(), stackPaneText(), stackPaneLabel());
        vbox.setStyle("-fx-background-color: #000;");
        var scene = new Scene(vbox, 600, 200);
        scene.setFill(Color.TRANSPARENT);
        stage.setScene(scene);
        stage.setTitle("font-rendering-quality");
        stage.show();
    }

    private Canvas canvas1() {
        var canvas = new Canvas(600, 25);
        var gc = canvas.getGraphicsContext2D();
        gc.setFontSmoothingType(FontSmoothingType.LCD);
        gc.setFill(Color.WHITE);
        gc.fillText("Font Rendering Quality : フォントレンダリング品質(Canvas LCD)", 13, 20);
        return canvas;
    }

    private Canvas canvas2() {
        var canvas = new Canvas(600, 25);
        var gc = canvas.getGraphicsContext2D();
        gc.setFontSmoothingType(FontSmoothingType.GRAY);
        gc.setFill(Color.WHITE);
        gc.fillText("Font Rendering Quality : フォントレンダリング品質(Canvas GRAY)", 13, 20);
        return canvas;
    }

    private Pane stackPaneText() {
        var pane = new StackPane();
        Text text = new Text("Font Rendering Quality : フォントレンダリング品質(StackPane + Text)");
        text.setFill(Color.WHITE);
        StackPane.setAlignment(text, Pos.CENTER_LEFT);
        StackPane.setMargin(text, new Insets(10, 0, 0, 13));
        pane.getChildren().add(text);
        return pane;
    }

    private Pane stackPaneLabel() {
        var pane = new StackPane();
        Label label = new Label("Font Rendering Quality : フォントレンダリング品質(StackPane + Label)");
        label.setTextFill(Color.WHITE);
        label.setPadding(new Insets(10, 0, 0, 13));
        StackPane.setAlignment(label, Pos.CENTER_LEFT);
        pane.getChildren().add(label);
        return pane;
    }

    private Canvas canvasRecoat() {
        var canvas = new Canvas(600, 25);
        var gc = canvas.getGraphicsContext2D();
        gc.setFontSmoothingType(FontSmoothingType.LCD);
        gc.setFill(Color.WHITE);
        gc.fillText("Font Rendering Quality : フォントレンダリング品質(Canvas LCD 重ね塗り)", 13, 20);
        gc.fillText("Font Rendering Quality : フォントレンダリング品質(Canvas LCD 重ね塗り)", 13, 20);
        return canvas;
    }

}

手元の MacOS 上(JavaFX25)での出力は以下。

拡大すると

漢字部分は特にぼやけ、明瞭ではない。

もっと拡大すると

フォントを選べば少しマシに見えることもあるが、いずれにしても日本語は厳しい。 これは Windows でも同様。


なお、macOS の場合は、JavaFX 18より FontSmoothingType.LCD は無視されるようになり、常に FontSmoothingType.GRAY が利用されます。 macOS 10.15 Catalina: LCD text renders badly


巷でよく聞く対応策

以下のシステムプロパティ設定

System.setProperty("prism.lcdtext", "false");

変わらず


以下のシステムプロパティ設定

System.setProperty("prism.text", "t2k");

変わらず


以下のシステムプロパティ設定

System.setProperty("prism.text", "t2k");
System.setProperty("prism", "lcdtext");

変わらず


あと、snapToPixel を有効にするもの。

vbox.setSnapToPixel(true);

まぁ、これはデフォルトで true なので変わるはずがない。


重ね塗り

唯一それなりにマシになるのは、重ね塗り。

    private Canvas canvasRecoat() {
        var canvas = new Canvas(600, 25);
        var gc = canvas.getGraphicsContext2D();
        gc.setFontSmoothingType(FontSmoothingType.LCD);
        gc.setFill(Color.WHITE);
        gc.fillText("Font Rendering Quality : フォントレンダリング品質(Canvas LCD 重ね塗り)", 13, 20);
        gc.fillText("Font Rendering Quality : フォントレンダリング品質(Canvas LCD 重ね塗り)", 13, 20);
        return canvas;
    }

拡大すると


根本的には Prism 側に直接手を入れないとダメそう。


Metal レンダリングパイプライン

JavaFX 27 では Metal が macOS のデフォルトレンダリングパイプラインになる(旧来はOpenGLベースのES2パイプラインがデフォルト)。これで多少は改善されるか?

JavaFX 26 でもシステムプロパティの設定で切り替えることができる。

System.setProperty("prism.order", "mtl,es2,sw");
System.setProperty("prism.verbose", "true");

このあたりの設定は以下を見ると良い

github.com

まぁ、以下のように変化は見られない。

そもそも JavaFX では、Font Hinting は無視するようです。

フォント処理は、macOS はの場合は CoreText、Linux では FreeType(Pango)、Windows の場合は DirectWrite を使用しています。

例えば FreeType の場合は、FT_LOAD_NO_HINTING で明示的にヒントを無効化し、フォントが持つ純粋なベクターアウトラインをそのまま読み込んでいます。

class FTFontFile extends PrismFontFile {

    synchronized Path2D createGlyphOutline(int gc, float size) {
        int size26dot6 = (int)(size * 64);
        OSFreetype.FT_Set_Char_Size(face, 0, size26dot6, 72, 72);
        int flags = OSFreetype.FT_LOAD_NO_HINTING | OSFreetype.FT_LOAD_NO_BITMAP | OSFreetype.FT_LOAD_IGNORE_TRANSFORM;
        OSFreetype.FT_Load_Glyph(face, gc, flags);
        return OSFreetype.FT_Outline_Decompose(face);
    }
}

CoreText や DirectWrite の詳細は見ていませんが、拡大縮小や3D回転などのアニメーションを滑らかに行うため、なるべくそのままのグリフを扱いたいのでしょう。なので、小さなフォントはぼやけて表示されることが多いのではないでしょうか。

でも、まぁ、Retinaディスプレイとかだと問題にならないのでしょう。


Windows / Linux 向けの対応

一生放置され続けていた以下の Issue bugs.openjdk.org

最近になり、フォントのレンダリング品質に対して動きがありました。

github.com

改善に期待しましょう。


Vello による描画との対比

FFI API を使い、Vello(Rust) で描画したものと、JavaFX の Canvas に描画したものを並べたアプリケーションを実行した結果は以下のようになります。

FFI API で Canvas を代替する方向で進めるのが良さそうです。


macOS における描画例

JavaFX で Canvas に直接描画した例


Vello(Rust) で描画した例(行間の計算が異なりますが気にしないでください)


JavaFX で Canvas に重ね書きした例


実際の印象とブラウザで見た時の印象は異なりますが、Canvas に直接描画した場合は、かすれて読みにくいです。

Vello(Rust) で描画したものと、Canvas に重ね書きしたものは、同程度に見えます。


Windows における描画例

JavaFX で Canvas に直接描画した例


Vello(Rust) で描画した例


JavaFX で Canvas に重ね書きした例


Windows の場合も、同様で、Canvas に直接描画した場合は、かすれて読みにくく、Vello(Rust) で描画したものと、Canvas に重ね書きしたものは、同程度に見えます。