mcpField
C
calibrate-model

calibrate-model

github.com/playcanvas开发31309 次安装1 周前更新
代码仓库

关于 calibrate-model

用于在应用中统一放置 GLB 模型的校准技能。它为每个资源记录测量边界、目标尺寸、缩放、位置和朝向，并说明动画模型与支撑点的处理方式。

主要功能

  1. 01每个 GLB 只测量一次
  2. 02记录每项资源的调校值
  3. 03计算缩放和垂直偏移
  4. 04在应用中确认朝向
  5. 05嵌套根节点、偏航和视觉变换
  6. 06检查动画模型的接触状态

适用场景

  1. 01按实际或相对尺寸校准导入模型
  2. 02让模型在测量过的支撑点上保持一致

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/playcanvas/skills --skill calibrate-model

安装后在 Claude Code 中输入/calibrate-model确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
direct-engine.md
react.md
web-components.md

详细介绍

模型校准

使用 inspect-glb 测量每个 GLB 一次，只有当 boundsSource 为 vertices 时才信任边界，并为每个资产保留一条调校记录：

const ASSET_TUNING = {
    model: {
        boundsSource: 'vertices', dims: [8, 7, 18], center: [0, 2.5, 0], groundOffset: 1,
        intended: { dimension: 'length', size: 18 }, scale: 1, y: 1, yaw: 180
    }
} as const;
  1. 选择定义模型实际尺寸的维度，单位为米，或相对于已校准的模型。
  2. 设置 scale = intendedSize / measuredDimension；对于放置在地面上的模型，设置 y = groundOffset * scale。为不应放置在地面上的模型记录一个经过慎重设定的偏移量。
  3. 在运行中的应用里确认一次朝向，并记录 yaw。

嵌套三个层级，确保根节点位置对每个资产含义相同：语义根节点、yaw 包装节点，然后是带有缩放和本地位置 (-center.x * scale, y, -center.z * scale) 的视觉子节点。只应用一次校准，不要按实例重复应用。

将根节点放置在经过测量的支撑点上，例如安装点或射线检测点，而不是全局 AABB 最大值处。蒙皮边界是绑定姿势的估算值；请在动画姿势下确认接触情况。

只阅读与代码匹配的参考文档：直接使用 Engine、React 或 Web Components。

评论

支持 Markdown