javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认以逻辑像素为单位，实际渲染时会自动乘以系统级输出缩放因子（如 1.25、1.5 或 2.0），以适配高 dpi 显示屏。
javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认以逻辑像素为单位，实际渲染时会自动乘以系统级输出缩放因子（如 1.25、1.5 或 2.0），以适配高 dpi 显示屏。
在 JavaFX 开发中，初学者常对数值单位产生疑惑：例如 Scene(root, 250, 50) 中的 250 和 50，或 HBox(15, btn1, btn2) 中的 15，究竟代表什么？答案是：它们均为逻辑像素（logical pixels）——即开发者编写的坐标与尺寸值，是面向“用户空间”的抽象单位，而非直接映射到物理屏幕像素。
JavaFX 的坐标系统基于浮点数，支持亚像素精度。根据官方文档，整数坐标（如 (0, 0)）对应设备像素的边界（corner），而 (0.5, 0.5) 则精确指向左上角像素的中心。这意味着：
- 一个宽高为 10 × 10 的矩形，从 (0, 0) 开始，将覆盖从左上角像素左上顶点到第 10 行第 10 列像素右下顶点的区域；
- 其内部最后一个像素的中心坐标为 (9.5, 9.5)。
这种设计既保证了清晰的像素对齐（当使用整数值时），又支持平滑抗锯齿与动画过渡（当使用小数值时）。
然而，在高 DPI 显示器（如 macOS Retina、Windows 缩放设置为 125% 或 150%）上，JavaFX 会自动应用输出缩放因子（Output Scale Factor），将逻辑像素转换为实际渲染的设备像素。该因子由系统环境决定，并通过以下 API 暴露：
立即学习“Java免费学习笔记（深入）”；
// 获取当前窗口的水平/垂直缩放比例（通常为 1.0、1.25、1.5、2.0 等） double scaleX = primaryStage.getOutputScaleX(); double scaleY = primaryStage.getOutputScaleY(); // 或获取主屏幕的全局缩放设置 Screen primary = Screen.getPrimary(); double screenScaleX = primary.getOutputScaleX();
例如，在缩放比为 2.0 的 4K 屏幕上，Scene(250, 50) 实际占用 500 × 100 设备像素 的显示区域；HBox(15, ...) 的间距也会被渲染为 30 物理像素。这一过程完全透明，开发者无需手动换算——JavaFX 在布局计算、几何变换和最终光栅化阶段自动完成缩放。
✅ 关键注意事项：
- 所有 Node 子类的 setPrefWidth()、setMinHeight()、setSpacing()、setPadding() 等方法均接受逻辑像素值；
- 布局容器（如 HBox、VBox、GridPane）的尺寸约束与间距全部基于同一逻辑像素体系；
- 若需获取真实设备像素尺寸（如截图、自定义渲染），应使用 getBoundsInLocal() 结合 getOutputScaleX/Y() 进行换算；
- 切勿硬编码依赖固定缩放比——应始终通过 getOutputScaleX() 动态获取，确保跨平台与跨设备一致性。
总之，JavaFX 的“像素”是面向开发者的友好抽象层，兼顾精度、性能与高 DPI 适配能力。理解其逻辑像素本质与自动缩放机制，是构建响应式、跨分辨率 JavaFX 应用的基础。
