开发者指南

Aspose.3D FOSS for TypeScript 是一个开源、MIT 许可证的库，允许 Node.js 开发者在完整的 TypeScript 类型安全下加载、构建、转换和导出 3D 场景。无论您是在构建资产管线、格式转换服务、几何验证工具，还是 3D 内容创作脚本，该库都提供了一个简洁、一致的 API，基于场景图模型，映射业界标准的 3D 概念。.

本开发者指南涵盖了超越快速入门安装、编写生产级 3D 处理代码所需的全部内容。.

本节您将会看到的内容

功能与特性

该 功能 页面是使用 Aspose.3D FOSS for TypeScript 的主要参考文档。它涵盖了：:

  • 格式支持: OBJ（含 .mtl 材质），glTF 2.0 / GLB 二进制，STL（二进制和 ASCII），COLLADA（DAE），3MF，以及 FBX，提供每种格式的加载和保存选项类，包括 ObjLoadOptions 以及 GltfSaveOptions.
  • 场景图: 如何 Scene, Node, Entity, Transform,，以及 SceneObject 组合成完整的场景层次结构，包括子节点遍历模式。.
  • 几何体和网格 API: 使用 Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode,，以及 ReferenceMode 进行几何处理。.
  • 材质系统: 应用 LambertMaterial, PhongMaterial,，以及 PbrMaterial (PBR for glTF) 到场景节点，并读取从 .mtl 文件加载的材质属性。.
  • 数学工具:：使用 Vector3, Vector4, Matrix4, Quaternion,，以及 BoundingBox 用于变换、包围盒查询和几何计算。.
  • 动画:：构建和读取 AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation,，以及 Extrapolation 数据。.
  • 流和缓冲区支持:：从内存中加载 3D 场景 Buffer 对象通过 scene.openFromBuffer() 用于无服务器和流式用例。.
  • 完整使用示例: 端到端的 TypeScript 脚本，用于加载 OBJ、导出 GLB、往返转换 STL，以及遍历场景图。.
  • 技巧、常见问题及 FAQ: 实用指南，帮助在生产环境中避免常见陷阱。.
  • API 参考摘要: 快速参考，列出所有关键类及其主要方法。.

关键概念

场景图: Aspose.3D FOSS 中的所有 3D 内容都表示为一棵树， Node 以 … 为根的对象 scene.rootNode. 每个节点可以携带一个 Entity （例如一个 Mesh, Camera,，或 Light） Transform 用于在层次结构中定位它。.

与格式无关的 API: 您可以通过以下方式打开任何受支持的格式 scene.open() 或 scene.openFromBuffer() 并通过以下方式保存为任何受支持的格式 scene.save(). 无论源格式或目标格式如何，都会使用相同的场景图对象。.

强类型的 TypeScript 类型定义: 该库随严格的编译器设置一起提供 (noImplicitAny, strictNullChecks)以及完整的类型定义。每个类、方法和选项属性都已完整类型化，为您的 3D 处理代码提供 IDE 自动完成和编译时安全。.

单一依赖: 唯一的运行时依赖是 xmldom,，它会由 npm 自动安装。没有需要编译的原生插件，也没有需要安装的系统软件包。.

快速入门

如果您尚未安装该库，请参阅 快速入门 章节以及 安装 指南后再继续阅读。.

可用主题

  • 功能与特性: 完整的 API 参考，包含每个主要功能区域的代码示例。.
 中文