3dtiles-inspector

中文文档
0.3.3发布于 2026/08/31Apache-2.0CommonJS构建来源已验证近 30 天下载 2138

在交互式浏览器会话中检查,对齐,并保存本地的3D平面根会变.

中文使用文档
文档目录8 节
  1. 内建于
  2. 安装
  3. 国 际
  4. 节点 API
  5. 检查员特征
  6. 作物区域
  7. 发展
  8. 处理错误

3名DTILES-检查员

npm version CI License

3DTiles-Inspector

3dtiles-inspector 是一个 Node.js 软件包和 CLI ,用于在浏览器检查器中打开一个本地的 3D 平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平.

要求节点.js 18或更新.

内建于

该项目基于并综合了以下工作:

安装

npm install 3dtiles-inspector

国 际

3dtiles-inspector <tileset_json>
npx 3dtiles-inspector <tileset_json>

从克隆寄存器 :

npm run cli -- <tileset_json>

CLI 启动本地host HTTP 服务器, 将已建检查员资产复制到临时目录中, 打开默认浏览器, 并持续运行, 直到您停止它 Ctrl+C。 。 。 .

<tileset_json> 可以是:

  • 例如,根平板 JSON 文件 out_tiles/tileset.json
  • 包含 tileset.json

节点 API

const { runInspector } = require('3dtiles-inspector');

(async () => {
  await runInspector('./out_tiles/tileset.json');
})();

如果您需要自行控制浏览器的启动或管理会话生命周期:

const {
  resolveAndValidateTilesetPath,
  startInspectorSession,
} = require('3dtiles-inspector');

(async () => {
  const tilesetPath = resolveAndValidateTilesetPath('./out_tiles/tileset.json');
  const session = await startInspectorSession(tilesetPath, {
    openBrowser: false,
    handleSignals: false,
  });

  console.log(session.url);

  await session.close();
})();

检查员特征

screenshot
  • Translate, (中文(简体) ), Rotate,无限 Scale 音轨/值输入,以及 Reset 用于根变换编辑
  • Move Camera 至 WGS84 纬度/经度/高度
  • Move Tiles 以 ENU 相通的转换来迁移平板根
  • Set Position 以单击地球、地形或已装入的瓷砖,并将瓷砖放在那里
  • Terrain默认情况下,在进入铯离子代号后切换铯世界地平线,同时保存卫星图像
  • Render on demand,默认情况下启用,以在场景闲置时暂停画布渲染
  • Geometric Error 从 1/16x 改为 16x
  • Layer Multiplier 从 1/8x 改为 8x 每块瓦片与瓦片全球叶基线的几何-误差
  • Crop Regions 用于绘制屏幕空间 排除区域或3D高斯平板砖上的收割球体
  • Save 以持久地将 root 转换编辑器、 几何- error 缩放和确认的裁剪选择返回磁盘

作物区域

Crop Regions 当装入的平板上包含3D高斯克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 它允许您绘制一个或多个屏幕空间, 排除矩形或定义单一的裁剪球体, 在查看器中预览, 然后单击时应用裁剪 Save。 。 。 .

对于屏幕区域:

  1. 点击 Draw Region 然后将一个矩形拖到花板上取出.
  2. 在移动相机前,如果屏幕区域需要调整,拖动待取的角点或侧控;待取的形状必须保持对流四面屏幕四边形.
  3. 旋转,平板,或放大相机,以3D来固定待定的屏幕形状,然后拖动远平面的手柄来设定作物区域延伸到场景的深度.
  4. 点击 Confirm 将区域添加到保存列表中,或 Cancel 以丢弃待决矩形.
  5. 如果您需要调整带有变换柄的3D远平面, 请选择确认的区域行 .
  6. 点击 Save 在已确认的作物地区持续进行根变和去掉花板.

在作物领域:

  1. 点击 Create Sphere 将一个球体置于当前平板中心.
  2. 以半径轨调整半径,或选择行并用球心局部-坐标变换柄移动.
  3. 点击 Confirm 隐藏球体外的花板,或 Cancel 把它丢掉.
  4. 点击 Save 清除确认球体外的花板.
Crop Regions

支持本地保存作物重写 .gltf 编号 : .glb 使用高斯平板资源 KHR_gaussian_splatting_compression_spz_2。完全删除的平板原生被从他们的glTF中去除,而空的平板内容可以从平板 JSON中被刷去. 远程内容和不支持的高斯克特编码被否决,而不是被修改.

若为 build_summary.json 存在于根平板旁边, Save 还更新:

  • root_transform
  • root_transform_source
  • root_coordinate
  • viewer_geometric_error_scale
  • viewer_geometric_error_layer_scale

发展

npm install
npm test
npm run pack:check

处理错误

运行时间和验证失败 InspectorError 从节点API中打印出简明错误信息.

版本与发布记录

3dtiles-inspector 共发布 35 个版本,首次发布于 2026/04/23;过去 12 个月发布了 35 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.3.3latest2026/08/312 个月前
0.3.22026/08/312 个月前
0.3.12026/08/302 个月前
0.3.02026/08/282 个月前
0.2.212026/08/063 个月前
0.2.202026/08/053 个月前

关于 3dtiles-inspector 的常见问题

3dtiles-inspector 是什么?

在交互式浏览器会话中检查,对齐,并保存本地的3D平面根会变.

如何安装 3dtiles-inspector?

在项目目录运行 npm install 3dtiles-inspector,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 3dtiles-inspector,可以用 npx 3dtiles-inspector 直接运行。

3dtiles-inspector 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/3dtiles-inspector 是否存在。

3dtiles-inspector 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

3dtiles-inspector 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

3dtiles-inspector 可以商用吗?

3dtiles-inspector 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

3dtiles-inspector 的下载量有多少?

根据 npm 官方下载统计,3dtiles-inspector 在 2026/10/04 – 2026/11/02 这 30 天内被下载 2,138 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

3dtiles-inspector 还在维护吗?

最新版本 0.3.3 发布于 2026/08/31(2 个月前);至今共发布 35 个版本,其中过去 12 个月发布了 35 个;首次发布于 2026/04/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。