如何禁用JavaFX中2D绘图操作的抗锯齿效果？

我用JavaFX的gc.strokeOval()在黑色背景绘制白色圆形，放大后发现边缘有自动抗锯齿效果。已尝试通过SceneAntialiasing.DISABLED和gc.setImageSmoothing(false)禁用抗锯齿，但前者对2D绘图无效，后者只作用于图片渲染，始终无法关闭基础2D操作的抗锯齿。

解决方案 #

JavaFX的Canvas 2D绘图抗锯齿需要通过修改GraphicsContext的渲染提示（Rendering Hints）来禁用，具体需要设置两个关键参数：

• KEY_ANTIALIASING：关闭全局抗锯齿
• KEY_STROKE_CONTROL：强制纯线条渲染，避免边缘平滑

修改后的完整代码如下，关键修改已标注：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.SceneAntialiasing;
import javafx.scene.canvas.Canvas;
import javafx.scene.canvas.GraphicsContext;
import javafx.scene.layout.StackPane;
import javafx.scene.paint.Color;
import javafx.stage.Stage;
// 引入AWT的渲染提示类
import java.awt.RenderingHints;

public class App extends Application {

    public static void main(String[] args) {
        launch();
    }

    @Override
    public void start(Stage stage) {
        
        double screenW = 640, screenH = 480;
        Canvas canvas = new Canvas(screenW, screenH);       
        
        Scene scene = new Scene(new StackPane(canvas), screenW, screenH, false, SceneAntialiasing.DISABLED);        
        stage.setScene(scene);
        stage.show();       
        GraphicsContext gc = canvas.getGraphicsContext2D();
        
        gc.setImageSmoothing(false);
        
        // 关键：添加以下两行禁用2D绘图抗锯齿
        gc.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_OFF);
        gc.setRenderingHint(RenderingHints.KEY_STROKE_CONTROL, RenderingHints.VALUE_STROKE_PURE);
        
        gc.setFill(Color.BLACK);
        gc.fillRect(0, 0, screenW, screenH);        
        double lineWidth = screenH / 10;
        double lineWidth2 = lineWidth / 2;      
        double x = lineWidth2;
        double y = lineWidth2;
        double w = screenW - lineWidth;
        double h = screenH - lineWidth;
        double sz = Math.min(w, h);
        gc.setLineWidth(lineWidth);
        gc.setStroke(Color.WHITE);
        gc.strokeOval(x, y, sz, sz);
        
    }

}

补充说明 #

• SceneAntialiasing.DISABLED仅针对JavaFX的3D场景渲染抗锯齿，对Canvas的2D绘图逻辑不产生影响
• setImageSmoothing(false)仅控制图片缩放时的平滑处理，和图形的stroke/fill操作无关
• 上述渲染提示的设置会直接作用于所有后续的2D绘图操作，包括strokeOval、fillRect等，确保边缘无抗锯齿效果

内容的提问来源于stack exchange，提问作者user32233359