# 3d-tiles-rendererjs-3dgs-plugin 中文文档

规范地址：https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/

版本：0\.3\.1
npm 元数据更新时间：2026-11-01T11:45:28.370Z
中文译文更新时间：2026-11-05T19:44:13.778Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/3d-tiles-rendererjs-3dgs-plugin
原文对照：https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/?lang=original
项目主页：https://github.com/WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin#readme
源码仓库：https://github.com/WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：108 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：0 个
- peer 依赖：three \>=0\.187\.0，3d-tiles-renderer ^0\.5\.0，gaussian-splat-lite ^1\.6\.0
- 首次发布：2026-04-17T07:37:25.725Z
- 最新版本发布：2026-11-01T11:45:27.999Z
- 近 30 天下载量：33330（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

Gaussian splate-tile插件,用于由WebGPU和WebGL2渲染出由Gaussian Splate Lite提供动力的3d-平板接地器.

## 安装

```sh
npm install 3d-tiles-rendererjs-3dgs-plugin
```

也可以使用：`pnpm add 3d-tiles-rendererjs-3dgs-plugin`、`yarn add 3d-tiles-rendererjs-3dgs-plugin`、`bun add 3d-tiles-rendererjs-3dgs-plugin`

## README

# 3d- 平地- 梯子- 3dg- 插件

[![npm version](https://img.shields.io/npm/v/3d-tiles-rendererjs-3dgs-plugin)](https://www.npmjs.com/package/3d-tiles-rendererjs-3dgs-plugin) [![CI](https://github.com/WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin/actions/workflows/ci.yml/badge.svg)](https://github.com/WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/LICENSE)

**3D 梯子高斯平板 · WebGPU · WebGL2 · GIS / ECEF**

![3D-Tiles-RendererJS-3DGS-Plugin](https://raw.githubusercontent.com/WilliamLiu-1997/3D-Tiles-RendererJS-3DGS-Plugin/main/3D-Tiles-RendererJS-3DGS-Plugin.png)

将3D高斯平板板板铺入3.j [`3d-tiles-renderer`](https://github.com/NASA-AMMOS/3DTilesRendererJS) 财务报告和审定财务报表 [`Gaussian Splat Lite`](https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite)。 。 。 . **WebGPU和WebGL2通过高斯克平板液1.6支持.**

插件加载标准未压缩和SPZ压缩的高斯平板 glTF/GLB格式的平板砖。 它支持明示和暗示的 三维平板,平板 处置和内存核算、大型地理信息系统/欧洲经委会坐标 `TilesFadePlugin` 过渡.

> \[大 **升级到0.3级?** 更新高斯平板字为 `^1.6.0` 和三.js (中文(简体) ) 改为 `>=0.187.0`。审查 [0.2.x至0.3.x 移徙指南](https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/docs/migration-0.3.md)。 。 。 . 对于仍在0.1.x上的应用程序,请遵循 [Spark-to-GSL 迁移指南](https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/migration.md) 先说.

## 渲染后端

| 渲染器 | 后端 | 平板排序 |
| --- | --- | --- |
| `WebGPURenderer` | 原生网络GPU | 绘图前的 GPU 排序 |
| `WebGPURenderer` 与 `forceWebGL`,或自动后退 | 网络GL2 | 同步工作/ WASM 排序 |
| `WebGLRenderer` | 网络GL2 | 同步工作/ WASM 排序 |

一样 `GaussianSplatPlugin` 设能通通三道. 渲染器 选择、排序和绘画由高斯克普特利特处理;插件 处理瓦片装载、变换、淡出和处置.

## 所需资源

-   `three@>=0.187.0`
-   `3d-tiles-renderer@^0.5.0`
-   `gaussian-splat-lite@^1.6.0`
-   带有 WebAssembly, Web Workers, ES 模块以及 WebGPU 或 WebGL2 的浏览器
-   本地 WebGPU 需要兼容的浏览器/ GPU 和安全上下文 (HTTPS或本地主机)

## 安装

```bash
npm install 3d-tiles-rendererjs-3dgs-plugin@^0.3.1 gaussian-splat-lite@^1.6.0 three@^0.187.0 3d-tiles-renderer@^0.5.0
```

## 快开始

### 网络GPU

```ts
import { Scene, PerspectiveCamera, Vector2 } from 'three';
import { WebGPURenderer } from 'three/webgpu';
import { TilesRenderer } from '3d-tiles-renderer';
import { TilesFadePlugin } from '3d-tiles-renderer/plugins';
import { GaussianSplatRenderer } from 'gaussian-splat-lite';
import { GaussianSplatPlugin } from '3d-tiles-rendererjs-3dgs-plugin';

const renderer = new WebGPURenderer({ antialias: false });
await renderer.init(); // Initialize before creating GaussianSplatRenderer.
renderer.setPixelRatio(window.devicePixelRatio);
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.appendChild(renderer.domElement);

const scene = new Scene();
const camera = new PerspectiveCamera(
  60,
  window.innerWidth / window.innerHeight,
  0.1,
  10000,
);
camera.position.set(0, 0, 3); // Adjust the camera to your tileset's coordinates.

const tiles = new TilesRenderer('https://example.com/tileset.json');
tiles.setCamera(camera);
const size = new Vector2();
tiles.setResolution(camera, renderer.getSize(size));

// The application owns one scene-level Gaussian renderer.
const splatRenderer = new GaussianSplatRenderer({ renderer });
scene.add(splatRenderer);
tiles.registerPlugin(new TilesFadePlugin());
tiles.registerPlugin(new GaussianSplatPlugin());

scene.add(tiles.group);

renderer.setAnimationLoop(() => {
  tiles.update();
  renderer.render(scene, camera);
});

window.addEventListener('resize', () => {
  camera.aspect = window.innerWidth / window.innerHeight;
  camera.updateProjectionMatrix();
  renderer.setSize(window.innerWidth, window.innerHeight);
  tiles.setResolution(camera, renderer.getSize(size));
});
```

`WebGPURenderer` 当WebGPU不可用时,自动返回WebGL2. 该示例使用 `setResolution(camera, renderer.getSize(size))` 也一样 类型检查 `3d-tiles-renderer@0.5.0`,其 `setResolutionFromRenderer` 声明只接受 `WebGLRenderer`。 。 。 .

### 网络GL2

强制使用 WebGL2 后端 `WebGPURenderer`,更改其构造器:

```ts
const renderer = new WebGPURenderer({ antialias: false, forceWebGL: true });
await renderer.init();
```

对于经典的WebGL渲染器,替换WebGPU导入,构建器,以及 初始化为:

```ts
import { WebGLRenderer } from 'three';

const renderer = new WebGLRenderer({ antialias: false });
```

留下剩下的场景,瓷砖,和 `GaussianSplatRenderer` 设置不变.

## 网络XR / VR

高斯平板制造器是WebXR-aware,当 `renderer.xr.isPresenting`。 。 。 . WebXR 应用程序必须切换 `TilesRenderer` 在正常相机和 3个J的XR `ArrayCamera` 作为会话的开始和结束。 见 [WebXR / VR 整合指南](https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/docs/webxr.md) 完全设置.

## 高斯克特立特渲染器

`GaussianSplatPlugin` 不创建、配置或处置 `GaussianSplatRenderer`创建、保留其参考文献并直接添加 在渲染前到达现场:

```ts
const gaussianSplatRenderer = new GaussianSplatRenderer({
  renderer,
  renderDepth: true,
});
scene.add(gaussianSplatRenderer);

tiles.registerPlugin(new GaussianSplatPlugin());
```

插件不验证渲染器是否存在 。 没有一块,瓷砖 `SplatMesh` 实例仍在装入,但没有绘制。 通过渲染设置, 如 `blurAmount`, (中文(简体) ), `focalAdjustment`, (中文(简体) ), `depthTest`,以及 `renderDepth` 直接转到 Gaussian Splate Lite, 不在此插件上 .

`renderDepth` 添加一个相伴的 Splat 深度绘图来分隔几何 稍后被调走 GSL 1.0还提供可选 `stochastic`, (中文(简体) ), `autoStochastic`, (中文(简体) ), 财务报告和审定财务报表 `StochasticResolvePass` 翻译。 这些是渲染器的特性和作品 与WebGPU和WebGL2上所创建的平板板一起.

对于完整的选项列表, 默认值, 运行时属性, 以及点名 渲染设置,见 [`GaussianSplatRenderer` 设置页面](https://github.com/WilliamLiu-1997/Gaussian-Splat-Lite/blob/main/docs/GaussianSplatRenderer.md)。 。 。 .

## 支持的内容

标准不压缩和SPZ压缩的高斯克平板砖得到支持 glTF/GLB格式。 两者都采用相同的插件设置.

未压缩的瓦片目前需要sRGB颜色. 其他压缩格式 不支持.

## API 密码

```ts
new GaussianSplatPlugin({
  minRaycastOpacity: 0.15,
});
```

| 选项 | 默认 | 说明 |
| --- | --- | --- |
| `minRaycastOpacity` | 高斯克特立特默认值( N)`0.15` (单位:百分数1.0) | 每平板内核-阿尔法阈值可以剪接射线广播命中区. 设定一个明确的值,以在整个GSL升级中保持这一阈值. |

公共出口:

```ts
import {
  GaussianSplatPlugin,
  type GaussianSplatPluginOptions,
} from '3d-tiles-rendererjs-3dgs-plugin';
```

## 实例与发展

这个 [`examples/`](https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/examples/) WebGL2 演示包括明示和默示样本 瓷砖,一个地球, 瓷砖交换,和LOD控制。 发展需要 节点.js 22.12.0或更新.

样本数据 [`data/`](https://npmcn.com/package/3d-tiles-rendererjs-3dgs-plugin/data/) 由 PLY 格式 3D 高斯文转换 将文件复制到 [`3DGS-PLY-3DTiles-Converter`](https://github.com/WilliamLiu-1997/3DGS-PLY-3DTiles-Converter)。 。 。 .

```bash
npm install
npm start               # Run the demo with Vite
npm run check           # Type-check the package
npm run build           # Build the npm package
npm run build-examples  # Build the static demo
```

## 许可证

阿帕奇 - 2.0

## 常见问题

### 3d-tiles-rendererjs-3dgs-plugin 是什么？

Gaussian splate-tile插件,用于由WebGPU和WebGL2渲染出由Gaussian Splate Lite提供动力的3d-平板接地器\.

### 如何安装 3d-tiles-rendererjs-3dgs-plugin？

在项目目录运行 npm install 3d-tiles-rendererjs-3dgs-plugin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：three（\>=0\.187\.0）、3d-tiles-renderer（^0\.5\.0）、gaussian-splat-lite（^1\.6\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### 3d-tiles-rendererjs-3dgs-plugin 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### 3d-tiles-rendererjs-3dgs-plugin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### 3d-tiles-rendererjs-3dgs-plugin 需要什么版本的 Node\.js？

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

### 3d-tiles-rendererjs-3dgs-plugin 可以商用吗？

3d-tiles-rendererjs-3dgs-plugin 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### 3d-tiles-rendererjs-3dgs-plugin 的下载量有多少？

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

### 3d-tiles-rendererjs-3dgs-plugin 还在维护吗？

最新版本 0\.3\.1 发布于 2026/11/01（4 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/04/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。