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 resourcesconst 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

文档将放置在文件夹中。

原文链接：GLTF-pipeline (mvrlink.com)