JavaFX旋转立方体时模型移出屏幕？如何实现原地固定旋转

问题现象 #

开发JavaFX 3D模型旋转功能时，按下向左旋转按键后，立方体会在旋转过程中同步向屏幕左侧平移，最终完全移出可视区域，无法实现模型固定在原位置、绕自身指定轴平稳旋转的预期效果。

现有实现代码 #

场景与立方体初始化 #

Box box = new Box(100,20,50);
SmartGroup group = new SmartGroup();
group.getChildren().add(box);

Camera camera = new PerspectiveCamera();

Scene scene = new Scene(group, WIDTH, HEIGHT);
scene.setFill(Color.SILVER);
scene.setCamera(camera);

box.translateXProperty().set(WIDTH/2);
box.translateYProperty().set(HEIGHT/2);
box.translateZProperty().set(-1000);

自定义旋转包装类SmartGroup #

class SmartGroup extends Group{
  Rotate r;
  Transform t = new Rotate();
  void rotateByX(double ang){
    r = new Rotate(ang, Rotate.X_AXIS);
    t = t.createConcatenation(r);
    this.getTransforms().clear();
    this.getTransforms().addAll(t);
  }
  void rotateByY(double ang){
    r = new Rotate(ang, Rotate.Y_AXIS);
    t = t.createConcatenation(r);
    this.getTransforms().clear();
    this.getTransforms().addAll(t);
  }
  void rotateByZ(double ang){
    r = new Rotate(ang, Rotate.Z_AXIS);
    t = t.createConcatenation(r);
    this.getTransforms().clear();
    this.getTransforms().addAll(t);
  }
}

问题根因 #

偏移的核心原因是旋转枢轴点的位置与模型实际位置不重合：
JavaFX中默认创建的Rotate变换，会以当前Group坐标系的原点（即(0,0,0)位置，也就是场景的左上角坐标点）作为旋转的轴心。在当前实现里，立方体被平移到了(WIDTH/2, HEIGHT/2, -1000)的屏幕中心位置，和Group原点有很远的直线距离，这时候绕Group原点旋转，相当于用长杆顶着立方体的端点做圆周运动，立方体自然会划出大半径的圆弧，视觉上就表现为边旋转、边平移，最终跑出可视区域。
另外，原代码每次旋转都重新清空、拼接变换矩阵的逻辑，也容易累积矩阵计算误差，进一步放大位置偏移的效果。

修复实现 #

• 统一变换层级：把原本单独设置在Box上的平移属性，移动到SmartGroup层级上，避免父子节点的变换逻辑错位。
• 固定旋转枢轴点：让旋转轴心和模型的几何中心位置完全对齐，从根源上避免旋转带来的位置偏移。
• 简化变换逻辑：不需要每次触发旋转时新建变换对象、拼接矩阵，直接维护三个独立的Rotate实例，通过角度累加实现旋转效果，减少矩阵计算带来的误差。

修改后的代码示例 #

调整后的SmartGroup类

class SmartGroup extends Group {
  // 初始化三个轴向的旋转对象，默认枢轴点为Group内部坐标原点
  private final Rotate rotateX = new Rotate(0, 0, 0, 0, Rotate.X_AXIS);
  private final Rotate rotateY = new Rotate(0, 0, 0, 0, Rotate.Y_AXIS);
  private final Rotate rotateZ = new Rotate(0, 0, 0, 0, Rotate.Z_AXIS);

  public SmartGroup() {
    // 启动时一次性加载旋转变换，不需要每次按键时清空重建
    this.getTransforms().addAll(rotateX, rotateY, rotateZ);
  }

  public void rotateByX(double ang) {
    rotateX.setAngle(rotateX.getAngle() + ang);
  }

  public void rotateByY(double ang) {
    rotateY.setAngle(rotateY.getAngle() + ang);
  }

  public void rotateByZ(double ang) {
    rotateZ.setAngle(rotateZ.getAngle() + ang);
  }
}

注：调整后因为SmartGroup自身被平移到了屏幕中心位置，Group的内部坐标原点就和组内Box的几何中心完全重合，所以Rotate的枢轴点直接设为(0,0,0)即可，不需要额外写入WIDTH/2这类外部场景的坐标值。

调整后的初始化逻辑

Box box = new Box(100,20,50);
SmartGroup group = new SmartGroup();
group.getChildren().add(box);

Camera camera = new PerspectiveCamera();

Scene scene = new Scene(group, WIDTH, HEIGHT);
scene.setFill(Color.SILVER);
scene.setCamera(camera);

// 把原代码中给box设置的平移属性，移动到group上，统一变换层级
group.translateXProperty().set(WIDTH/2);
group.translateYProperty().set(HEIGHT/2);
group.translateZProperty().set(-1000);

调整完成后，立方体就会始终保持在屏幕中心位置，绕自身几何中心完成旋转，不会出现边转边平移跑出屏幕的问题。 #

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