@drawcall/glts

中文文档
6.1.0发布于 2026/11/13MITTypeScriptES Module构建来源已验证近 30 天下载 5364

像GLTF,但程序三.js资产.

中文使用文档
文档目录3 节
  1. 使用量
  2. 国 际
  3. 代理技能

枪声

像GLTF,但程序三.js资产.

A 类 .glts 文件是一个小的TypeScript脚本,它用普通的Tree.js代码构建一个场景. GLTSLoader 捡起并运行它 给你一个本地人 THREE.Scene 您可以在任何地方添加, 更新每个框架, 热重装, 并处理 .

使用GLTS 当一个资产比模型更容易写作代码时:程序几何,参数化或动画道具,或由AI编码代理所写的资产. 资产可以装入其他资产,通过帮助模块共享代码,实例为Tree.js InstancedMesh,导入 npm 包,并带来自己的预览中转和渲染设置.

GLTS 运行脚本作为代码,而不是在沙盒中. 只装入您信任的脚本 .

pnpm add @drawcall/glts three

使用量

脚本构建其资产 scene 它进口:

// public/crystal.glts
import * as THREE from "three/webgpu"
import { disposeRecursive, onDispose, onFrame, scene } from "@drawcall/glts"

const crystal = new THREE.Mesh(new THREE.IcosahedronGeometry(), new THREE.MeshNormalMaterial())
scene.add(crystal)

onFrame((delta) => {
  crystal.rotation.y += delta
})

onDispose(() => disposeRecursive(scene))

该应用程序像其他任何 Three.js 资产一样加载并使用 WebGPU 制作:

import { GLTSLoader } from "@drawcall/glts"
import * as THREE from "three/webgpu"

const renderer = new THREE.WebGPURenderer({ canvas })
await renderer.init()

const loader = new GLTSLoader(new THREE.LoadingManager())
const crystal = await loader.loadAsync("/crystal.glts")
scene.add(crystal)

const timer = new THREE.Timer()
renderer.setAnimationLoop((time) => {
  timer.update(time)
  crystal.update(timer.getDelta())
  renderer.render(scene, camera)
})

在虚拟应用程序中,添加 glts() 从 @drawcall/glts/vite 转到插件:公共脚本然后装入预编译并共享应用程序的软件包.

国 际

显示 a .glts 向巴布亚新几内亚提供资产或将其导出至GLB(节点22.18+或24.11+):

npx drawcall glts render asset.glts -o preview.png
npx drawcall glts render asset.glts -o views.png --views '[[{"camera":"+x"},{"camera":"persp"}]]'
npx drawcall glts export asset.glts -o asset.glb

渲染用途 @drawcall/webgpu (英语),有或没有GPU,并包括预览中转;在节点.js中, render(file, options) 从 @drawcall/glts/node 返回与字节相同的 PNG。 导出排除并写入支持的几何、材料、纹理、外观和清晰的动画剪辑;程序框回调保留在 .glts 文档.

代理技能

其他一切(帮助者、构成、进取、渲染、再装入、包件和Vite插件)都记录在 GLTS 技能。为您的编码代理安装它 :

npx skills add drawcall-ai/glts --skill glts

技术也飞入 @drawcall/glts npm 软件包在 skills/glts/SKILL.md这样 技术-npm 自动链接 node_modules,在您安装的版本中.

版本与发布记录

@drawcall/glts 共发布 37 个版本,首次发布于 2026/08/12;过去 12 个月发布了 37 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
6.1.0latest2026/11/13今天
6.0.02026/11/121 天前
5.2.02026/11/112 天前
5.1.02026/11/102 天前
5.0.02026/11/103 天前
4.1.02026/11/058 天前

关于 @drawcall/glts 的常见问题

@drawcall/glts 是什么?

像GLTF,但程序三.js资产.

如何安装 @drawcall/glts?

在项目目录运行 npm install @drawcall/glts,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:three(>=0.186.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 glts,可以用 npx glts 直接运行。

@drawcall/glts 支持 TypeScript 吗?

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

@drawcall/glts 支持 ESM 还是 CommonJS?

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

@drawcall/glts 需要什么版本的 Node.js?

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

@drawcall/glts 可以商用吗?

@drawcall/glts 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@drawcall/glts 的下载量有多少?

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

@drawcall/glts 还在维护吗?

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