Руководство разработчика

Aspose.3D FOSS for TypeScript — это открытая библиотека с лицензией MIT, позволяющая разработчикам Node.js загружать, конструировать, трансформировать и экспортировать 3D‑сцены с полной типовой безопасностью TypeScript. Независимо от того, создаёте ли вы конвейер ассетов, сервис конвертации форматов, инструмент проверки геометрии или скрипт авторинга 3D‑контента, эта библиотека предоставляет чистый, согласованный API, основанный на модели графа сцены, отражающей отраслевые стандарты 3D‑концепций.

Это руководство разработчика охватывает всё, что необходимо, чтобы выйти за рамки быстрой установки и писать 3D‑код промышленного качества.

Что вы найдёте в этом разделе

Функции и возможности

Эта Возможности страница является основным справочным ресурсом для работы с Aspose.3D FOSS для 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 для glTF) к узлам сцены, и чтение свойств материалов, загруженных из файлов .mtl.
  • Математические утилиты: Использование Vector3, Vector4, Matrix4, Quaternion, и BoundingBox для трансформ, запросов ограничивающих коробок и геометрических вычислений.
  • Анимация: Создание и чтение AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, и Extrapolation данные.
  • Поддержка потоков и буферов: Загрузка 3D‑сцен из памяти Buffer объекты через scene.openFromBuffer() для безсерверных и потоковых сценариев использования.
  • Полные примеры использования: Скрипты TypeScript от начала до конца для загрузки OBJ, экспорта GLB, обратного преобразования STL и обхода графов сцены.
  • Советы, распространённые проблемы и часто задаваемые вопросы: Практические рекомендации по избежанию распространённых подводных камней при эксплуатации.
  • Сводка справочника API: Список быстрого доступа со всеми ключевыми классами и их основными методами.

Ключевые концепции

Граф сцены: Весь 3D‑контент в Aspose.3D FOSS представлен в виде дерева из Node объектов, корневой точкой которых scene.rootNode. Каждый узел может нести Entity (например, a Mesh, Camera, или Light) Transform который размещает его в иерархии.

API, не зависящее от формата: Вы открываете любой поддерживаемый формат через scene.open() или scene.openFromBuffer() и сохраняете в любой поддерживаемый формат через scene.save(). Одни и те же объекты графа сцены используются независимо от формата источника или назначения.

Строгая типизация TypeScript: Библиотека поставляется со строгими настройками компилятора (noImplicitAny, strictNullChecks) и полными определениями типов. Каждый класс, метод и свойство опций полностью типизированы, предоставляя автодополнение в IDE и безопасность во время компиляции по всему вашему коду 3D‑обработки.

Одна зависимость: Единственная зависимость во время выполнения — xmldom, которая устанавливается автоматически через npm. Нет нативных аддонов для компиляции и системных пакетов для установки.

Начало работы

Если вы ещё не установили библиотеку, см. the Начало работы раздел и Установка руководство перед тем как читать дальше.

Доступные темы

 Русский