Fejlesztői útmutató

Aspose.3D FOSS for TypeScript egy nyílt forráskódú, MIT licencű könyvtár, amely lehetővé teszi a Node.js fejlesztők számára, hogy betöltsenek, felépítsenek, átalakítsanak és exportáljanak 3D jeleneteket teljes TypeScript típusbiztonsággal. Akár egy eszközcsővezeték, egy formátumkonverziós szolgáltatás, egy geometriai validációs eszköz, vagy egy 3D tartalomkészítő szkript fejlesztésén dolgozol, ez a könyvtár tiszta, konzisztens API-t biztosít, amely egy jelenetgrafikon modellre épül, és tükrözi az iparági szabványú 3D koncepciókat.

Ez a fejlesztői útmutató mindent lefed, amire szükséged van ahhoz, hogy túllépj a gyorsindítási telepítésen, és termelési minőségű 3D feldolgozó kódot írj.

Mit találsz ebben a szakaszban

Jellemzők és funkciók

A Jellemzők Az oldal az elsődleges referencia a Aspose.3D FOSS for TypeScript használatához. Tartalmazza:

  • Formátumtámogatás: OBJ (.mtl anyagokkal), glTF 2.0 / GLB bináris, STL (bináris és ASCII), COLLADA (DAE), 3MF, és FBX, formátumonkénti betöltési és mentési opciós osztályokkal, beleértve ObjLoadOptions és GltfSaveOptions.
  • Jelenet gráf: Hogyan Scene, Node, Entity, Transform, és SceneObject összeállnak egy teljes jelenet hierarchiává, beleértve a gyermekcsomópont bejárási mintákat.
  • Geometria és háló API: A Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, és ReferenceMode geometriai feldolgozáshoz.
  • Anyagrendszer: Alkalmazás LambertMaterial, PhongMaterial, és PbrMaterial (PBR for glTF) a jelenet csomópontjaihoz, és a .mtl fájlokból betöltött anyagtulajdonságok olvasása.
  • Matematikai segédeszközök: Használat Vector3, Vector4, Matrix4, Quaternion, és BoundingBox transzformációkhoz, határolódoboz lekérdezésekhez és geometriai számításokhoz.
  • Animáció: Létrehozás és olvasás AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, és Extrapolation adatok.
  • Stream és buffer támogatás: 3D jelenetek betöltése memóriából Buffer objektumokon keresztül scene.openFromBuffer() szerver nélküli és streaming felhasználási esetekhez.
  • Teljes használati példák: Végponttól végpontig terjedő TypeScript szkriptek OBJ betöltéshez, GLB exportáláshoz, STL körkörös konvertáláshoz és a jelenetgráfok bejárásához.
  • Tippek, gyakori problémák és GYIK: Gyakorlati útmutató a termelési használat során gyakori buktatók elkerüléséhez.
  • API referencia összefoglaló: Gyorsreferencia az összes kulcsosztály és fő metódusaik felsorolásával.

Alapvető fogalmak

Jelenet gráf: Minden 3D tartalom a Aspose.3D FOSS-ban egy fa formájában van ábrázolva Node objektumok, amelyek gyökere scene.rootNode. Minden csomópont hordozhat egy Entity (például egy Mesh, Camera, vagy Light) és egy Transform ami elhelyezi a hierarchiában.

Formátumfüggetlen API: Bármely támogatott formátumot megnyithatsz a következőn keresztül scene.open() vagy scene.openFromBuffer() és menthetsz bármely támogatott formátumba a következőn keresztül scene.save(). Ugyanazok a jelenetgrafikon objektumok használatosak a forrás vagy cél formátumtól függetlenül.

Erős TypeScript típusdefiníció: A könyvtár szigorú fordítóbeállításokkal érkezik (noImplicitAny, strictNullChecks) és teljes típusdefiníciókkal. Minden osztály, metódus és opciótulajdonság teljesen tipizált, így IDE automatikus kiegészítést és fordítási időbeli biztonságot biztosít a 3D feldolgozó kódodban.

Egyetlen függőség: Az egyetlen futásidejű függőség a xmldom, amelyet az npm automatikusan telepít. Nincsenek lefordítandó natív kiegészítők és nincs telepítendő rendszercsomag.

Első lépések

Ha még nem telepítetted a könyvtárat, lásd a Első lépések szakasz és a Telepítés útmutató, mielőtt tovább olvasna.

Available Topics

 Magyar