放置、锚点与相机

一条约定同时覆盖 2D 与 3D、单个对象与实例： 位置是锚点的世界位置，而 宽、高与深是目标尺寸 — 不是缩放系数。 锚点是对象自身包围盒的几何中心。

你会用到的成员

回报是你可以为导入的资产设定尺寸，而不必知道美术是怎么导出的。 Width = 1f 就是一米宽，无论 GLB 声称什么，而且 两个来自两位美术的模型并排放置时，真的是一样高。

世界矩阵，写出来

每个 3D 控件都以同样的方式构建它的矩阵，而顺序正是全部要点：

Matrix4x4.CreateTranslation(-AnchorLocal)
    * Matrix4x4.CreateScale(ComputedScale)
    * GetRotationMatrix()
    * Matrix4x4.CreateTranslation(PosX, PosY, PosZ)

在行向量约定下，那就是 ((p - A) * S) * R + Pos。锚点 A 精确落在 Pos 上，旋转枢轴就是锚点，因此旋转 一个对象既不改变它的位置也不改变它的尺寸。正是这个性质让参考应用中的 对象编辑器无需任何补偿数学就能工作。

放置原点而不是中心

有时你想把模型自身的原点钉在一个世界点上 — 例如， 一个导出时站在地面平面上的角色。恒等式 p*S*R + t == ((p-A)*S)*R + Pos 直接给你转换：

// Pin the model's local origin to a world-space target.
var target = new Vector3(4f, 0f, 12f);
var offset = robot.AnchorWorldOffset;   // recompute each frame

robot.PosX = target.X + offset.X;
robot.PosY = target.Y + offset.Y;
robot.PosZ = target.Z + offset.Z;

每一帧重新计算偏移量而不是缓存它：它已经把当前缩放和 旋转折叠进去了，所以对象变化时恒等式依然成立。先设置尺寸和旋转， 再设置位置。

三个值得提前知道、以免被它们惊讶的行为

• 未设置的维度会收敛为资产自身的尺寸。 当边界在加载后确定时， 任何为 null 或 0 的 Width、 Height 或 Depth 都会从 LocalSize 填入，所以一个没有设置尺寸的 模型会以它导出的比例出现，而不是塌缩成空。
• 扁平轴不会被缩放。 如果某个局部维度实际上是零 — 低于 1e-6，或比最大轴小四个数量级以上 — 该轴保持缩放 1。没有这个守卫，导出平面中的厚度噪声 会产生约 1e5 的缩放，把网格撕成偏移的碎片。这是一个 真实的资产，不是假设的。
• 动画模型有两个包围盒。 GetWorldBounds() 返回用于 剔除和阴影的保守盒，为蒙皮运动做了膨胀。 GetWorldBoundsRaw() 与实际渲染的身体匹配。拾取和 选择框使用原始的那个；把保守盒用作选择框会在 模型上下留下可见的空白。

相机

BaseApp.Camera 是一个单一的 Camera3D，被每个后端和每个通道共享，它是 视图、投影与视锥的唯一事实来源。 CameraPos 和 CameraTarget 转发到 Camera.Position 和 Camera.Target。

CameraTarget = new Vector3(0f, 3.5f, -2.5f);
CameraPos = CameraTarget + new Vector3(0f, 0.5f, -3.5f);

Camera.FovY = MathF.PI / 4f;   // radians
Camera.Near = 0.1f;
Camera.Far = 1300f;

当 CameraPos.Z 为负时，相机朝原点看， 世界 +X 是屏幕右侧 — 每个示例都用这个布置，2D 叠加坐标系也与它一致。