Посібник розробника

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 та обходу графів сцени.
  • Поради, типові проблеми та FAQ: Практичні рекомендації щодо уникнення типових підводних каменів у виробничому використанні.
  • Огляд довідки API: Швидкий довідковий перелік усіх ключових класів та їх основних методів.

Ключові концепції

Граф сцени: Увесь 3D‑контент у Aspose.3D FOSS представлений у вигляді дерева Node об’єктів, коренем яких є scene.rootNode. Кожен вузол може містити an Entity (наприклад, a Mesh, Camera, або Light) Transform яка розташовує його в ієрархії.

API, незалежний від формату: Ви відкриваєте будь-який підтримуваний формат через scene.open() або scene.openFromBuffer() і зберігаєте у будь-який підтримуваний формат через scene.save(). Ті ж об’єкти графу сцени використовуються незалежно від формату джерела чи призначення.

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

Одинарна залежність: Єдина залежність під час виконання — це xmldom, який встановлюється автоматично через npm. Немає нативних аддонів для компіляції та системних пакетів для встановлення.

Початок роботи

Якщо ви ще не встановили бібліотеку, перегляньте the Початок роботи розділ і Встановлення посібник перед читанням далі.

Доступні теми

 Українська