javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认单位为逻辑像素，实际渲染时会根据系统 dpi 缩放因子自动转换为设备像素，确保在高分屏上清晰显示。

javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认单位为逻辑像素，实际渲染时会根据系统 dpi 缩放因子自动转换为设备像素，确保在高分屏上清晰显示。

在 JavaFX 开发中，初学者常对数值单位产生疑惑——例如 Scene(root, 250, 50) 中的 250 和 50，或 HBox(15, btn1, btn2) 中的 15，究竟代表什么？答案是：它们均以逻辑像素（logical pixels）为单位，而非物理像素、英寸或 CSS 像素。

逻辑像素是 JavaFX 坐标系统的抽象单位，用于屏蔽底层显示设备的差异。JavaFX 渲染引擎会将逻辑像素乘以当前窗口或屏幕的缩放因子（outputScaleX / outputScaleY），再映射到实际的设备像素（device pixels）。这一机制使 UI 在 100%、125%、150% 或 200% 缩放的 Windows/macOS 系统，以及 macOS Retina 屏、Windows 高 DPI 显示器上均能保持视觉一致性和清晰度。

例如，在您的代码中：

Scene scene = new Scene(root, 250, 50); // 250×50 逻辑像素的场景区域
HBox root = new HBox(15, btn1, btn2);   // 按钮间水平间距为 15 逻辑像素

• 250 和 50 定义了 Scene 内容区域的宽度与高度（不含窗口边框）；
• 15 表示 btn1 与 btn2 在 HBox 中的水平间距（spacing 属性）；
• 所有值均为 double 类型（尽管常写作整数），支持亚像素精度（如 3.75），以实现平滑动画与抗锯齿渲染。

值得注意的是，JavaFX 的坐标系原点 (0, 0) 位于舞台左上角，且整数坐标对应像素边界（cracks between pixels），而非像素中心。文档明确指出：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

立即学习“Java免费学习笔记（深入）”；

“坐标 (0.5, 0.5) 指向左上角像素的中心；矩形 (0, 0, 10, 10) 覆盖从左上角像素左上顶点到第 10 行第 10 列像素右下顶点的区域。”
这意味着：精确控制像素对齐（如避免模糊）时，应优先使用 .5 偏移（如 setTranslateX(0.5)）。

可通过以下方式获取当前缩放因子，用于高级适配：

// 获取主窗口的水平/垂直缩放比例
double scaleX = primaryStage.getOutputScaleX();
double scaleY = primaryStage.getOutputScaleY();

// 或获取主屏幕的全局缩放设置
Screen screen = Screen.getPrimary();
double screenScaleX = screen.getOutputScaleX();

⚠️ 重要注意事项：

• 缩放因子由操作系统和 JVM 启动参数共同决定（如 -Dprism.allowhidpi=true 在旧版 JDK 中可能需显式启用）；
• 自定义绘图（如 Canvas 或 GraphicsContext）同样遵循该缩放规则，无需手动换算；
• 若需强制禁用缩放（仅限调试），可设置系统属性 -Dprism.allowhidpi=false，但不推荐用于生产环境；
• 使用 Region.setPrefSize()、Node.setLayoutX() 等 API 时，传入值始终为逻辑像素，JavaFX 自动处理后续映射。

综上，JavaFX 的“像素”是面向开发者的友好抽象层：它既保留了像素级控制的直观性，又通过自动缩放保障了跨设备一致性。理解逻辑像素与输出缩放的关系，是构建高 DPI 友好 JavaFX 应用的关键基础。