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

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. Всеки възел може да носи an Entity (например a Mesh, Camera, или Light) и a Transform което го позиционира в йерархията.

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

Силно типизиране в TypeScript: Библиотеката се доставя със стриктни настройки на компилатора (noImplicitAny, strictNullChecks) и пълни дефиниции на типове. Всеки клас, метод и свойство на опцията е напълно типизиран, осигурявайки автодовършване в IDE и безопасност по време на компилация във вашия 3D обработващ код.

Единствена зависимост: Единствената runtime зависимост е xmldom, който се инсталира автоматично чрез npm. Няма native добавки за компилация и няма системни пакети за инсталиране.

Започване

Ако все още не сте инсталирали библиотеката, вижте the Започване раздел и Инсталиране ръководство преди да продължите да четете.

Достъпни теми

  • Функции и функции: Пълен справочник на API с примерен код за всяка основна област на функционалност.
 Български