用于优化 glTF 资产的内容管道工具。-GLB下载网

glTF管线

用于优化 glTF 资产的内容管道工具，由 Richard Lee 和 Cesium 团队提供。

支持常见作，包括：

将 glTF 转换为 glb（并反向）
将缓冲区/纹理保存为嵌入或单独的文件
将 glTF 1.0 模型转换为 glTF 2.0
应用 Draco 网格压缩

gltf-pipeline可用作命令行工具或Node.js模块。

开始

如果还没有安装 Node.js，请安装它，然后：

npm install -g gltf-pipeline

使用 gltf-pipeline 作为命令行工具：

将 glTF 转换为 glb

gltf-pipeline -i model.gltf -o model.glb

gltf-pipeline -i model.gltf -b

将 glb 转换为 glTF

gltf-pipeline -i model.glb -o model.gltf

gltf-pipeline -i model.glb -j

将 glTF 转换为 Draco glTF

gltf-pipeline -i model.gltf -o modelDraco.gltf -d

保存单独的纹理

gltf-pipeline -i model.gltf -t

使用 gltf-pipeline 作为库：

将 glTF 转换为 glb：

const gltfPipeline = require("gltf-pipeline");
const fsExtra = require("fs-extra");
const gltfToGlb = gltfPipeline.gltfToGlb;
const gltf = fsExtra.readJsonSync("./input/model.gltf");
const options = { resourceDirectory: "./input/" };
gltfToGlb(gltf, options).then(function (results) {
  fsExtra.writeFileSync("model.glb", results.glb);
});

将 glb 转换为嵌入式 glTF

const gltfPipeline = require("gltf-pipeline");
const fsExtra = require("fs-extra");
const glbToGltf = gltfPipeline.glbToGltf;
const glb = fsExtra.readFileSync("model.glb");
glbToGltf(glb).then(function (results) {
  fsExtra.writeJsonSync("model.gltf", results.gltf);
});

将 glTF 转换为 Draco glTF

const gltfPipeline = require("gltf-pipeline");
const fsExtra = require("fs-extra");
const processGltf = gltfPipeline.processGltf;
const gltf = fsExtra.readJsonSync("model.gltf");
const options = {
  dracoOptions: {
    compressionLevel: 10,
  },
};
processGltf(gltf, options).then(function (results) {
  fsExtra.writeJsonSync("model-draco.gltf", results.gltf);
});

保存单独的纹理

const gltfPipeline = require("gltf-pipeline");
const fsExtra = require("fs-extra");
const processGltf = gltfPipeline.processGltf;
const gltf = fsExtra.readJsonSync("model.gltf");
const options = {
  separateTextures: true,
};
processGltf(gltf, options).then(function (results) {
  fsExtra.writeJsonSync("model-separate.gltf", results.gltf);
  // Save separate resources
  const separateResources = results.separateResources;
  for (const relativePath in separateResources) {
    if (separateResources.hasOwnProperty(relativePath)) {
      const resource = separateResources[relativePath];
      fsExtra.writeFileSync(relativePath, resource);
    }
  }
});

关于和`resourceDirectoryallowAbsolute`

如果未指定 a，则 glTF 对象中唯一可能的路径是绝对路径。如果事件在没有 a 的情况下调用并且 glTF 引用绝对路径，它将表现得像 if 为 true，但如果不是，也会发出警告。要摆脱此警告，请在您的选项中添加，例如：resourceDirectoryprocessGltfresourceDirectoryallowAbsoluteallowAbsolute: true

const options = {
  /*... */
};
const results = await processGltf(gltf, options);

应更改为：

const options = {
  allowAbsolute: true,
  /*... */
};
const results = await processGltf(gltf, options);

命令行标志

旗	描述	必填
`--help`,`-h`	显示帮助	不
`--input`,`-i`	glTF 或 glb 文件的路径。	✅ 是的
`--output`,`-o`	glTF 或 glb 文件的输出路径。单独的资源将保存到同一目录。	不
`--binary`,`-b`	将输入 glTF 转换为 glb。	否，默认`false`
`--allowAbsolute`,`-a`	允许 glTF 文件引用其源路径之外的文件 URL	否，默认`false`
`--json`,`-j`	将输入 glb 转换为 glTF。	否，默认`false`
`--separate`,`-s`	编写单独的缓冲区、着色器和纹理，而不是将它们嵌入到 glTF 中。	否，默认`false`
`--separateTextures`,`-t`	仅写出单独的纹理。	否，默认`false`
`--stats`	将统计信息打印到控制台以输出 glTF 文件。	否，默认`false`
`--keepUnusedElements`	保留未使用的材质、节点和网格。	否，默认`false`
`--keepLegacyExtensions`	如果为 false，则带有、或的材质将转换为 PBR。`KHR_techniques_webglKHR_blendKHR_materials_common`	否，默认`false`
`--draco.compressMeshes`,`-d`	使用 Draco 压缩网格。添加扩展名。`KHR_draco_mesh_compression`	否，默认`false`
`--draco.compressionLevel`	天龙座压缩水平 [0-10]，最大为 10，最小为 0。值为 0 将应用顺序编码并保留人脸顺序。	否，默认`7`
`--draco.quantizePositionBits`	使用 Draco 压缩时位置属性的量化位。	否，默认`11`
`--draco.quantizeNormalBits`	使用 Draco 压缩时法线属性的量化位。	否，默认`8`
`--draco.quantizeTexcoordBits`	使用 Draco 压缩时纹理坐标属性的量化位。	否，默认`10`
`--draco.quantizeColorBits`	使用 Draco 压缩时颜色属性的量化位。	否，默认`8`
`--draco.quantizeGenericBits`	使用 Draco 压缩时，蒙皮属性（关节索引和关节权重）和自定义属性的量化位。	否，默认`8`
`--draco.unifiedQuantization`	使用相同的量化网格量化所有基元的位置。如果未设置，则单独应用量化。	否，默认`false`
`--draco.uncompressedFallback`	添加压缩网格的未压缩回退版本。	否，默认`false`
`--baseColorTextureNames`	从扩展更新到 PBR 材质时应考虑引用基色纹理的制服名称。`KHR_techniques_webgl`	不。（此处未指定默认值）
`--baseColorFactorNames`	从扩展更新到 PBR 材质时应考虑参考基本颜色因子的制服名称。`KHR_techniques_webgl`	不。（此处未指定默认值）

构建说明

运行测试：

npm run test

要在整个代码库上运行 ESLint，请运行：

npm run eslint

要在保存文件时自动运行 ESLint，请运行以下命令并将其在控制台窗口中保持打开状态：

npm run eslint-watch

构建 CesiumJS 集成

gltf-pipeline 的某些功能被 CesiumJS 用作第三方库。可以使用以下方法生成必要的文件：

npm run build-cesium

这会将 gltf-pipeline 代码的一部分输出到文件夹中，以便在浏览器中与 CesiumJS 一起使用。将文件复制到 cesium 存储库中并提交拉取请求。dist/cesiumSource/Scene/GltfPipeline/

运行测试覆盖率

覆盖范围使用纽约市。跑：

npm run coverage

有关完整的覆盖范围详细信息，请打开。coverage/lcov-report/index.html

测试和覆盖范围涵盖Node.js模块;它不包括很小的命令行界面。

生成文档

要生成文档，请执行以下作：

npm run jsdoc

文档将放置在文件夹中。doc

贡献

欢迎拉取请求！请使用与 Cesium 相同的贡献者许可协议（CLA）和编码指南。

Name
利利斯合并来自 CesiumGS/prepare-4.3.0 的拉取请求 #677 4763d6a · 3 months ago
.github/工作流程	更新依赖项，更新 github作以使用节点 20 并更新 …	2 years ago
。沙哑	更新哈士奇	2 years ago
站	将分支“main”合并到 fordi-673 中	4 months ago
医生	在文档中添加了徽标	7 years ago
自由	CesiumJS 的向后端口镜面反射处理	3 months ago
规格	在 Windows 上测试时，不要生成 Windows 路径。	4 months ago
.appveyor.yml	更新 npm 依赖项	4 years ago
.eslintignore 域名	更改为 eslint-config-cesium 2.0。从 gulp-eslint 切换到 CLI	8 years ago
.eslintrc.json	删除冗余配置扩展	3 years ago
.git属性	升级到节点 8	8 years ago
.gitignore 域名	更新依赖树（不更改代码）	2 years ago
.npm忽略	更新package.json版本和发布更改	2 years ago
.npmrc 域名	防止 npm 创建package-lock.json	8 years ago
.prettierignore域名	切换到更漂亮的格式	4 years ago
CHANGES.md	准备版本 4.3.0	3 months ago
LICENSE.md	运行更漂亮	4 years ago
README.md	无硬包装	4 months ago
ThirdParty.json	更新依赖项和更改日志	3 months ago
gulpfile.js	删除 defaultValue 的使用	5 months ago
index.js	更新全局要求	2 years ago
package.json	准备版本 4.3.0	3 months ago