GLTF-pipeline

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

转换好的模型可使用GLTF编辑器进行查看和编辑。

将 glb 转换为 glTF

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

gltf-pipeline -i model.glb -j

转换好的模型可使用GLTF编辑器进行查看和编辑。

将 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);
    }
  }
});

命令行标志

构建说明

运行测试：

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/

运行测试覆盖率

覆盖范围使用NYC。跑：

npm run coverage

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

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

生成文档

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

npm run jsdoc

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