Fejlesztői útmutató

Aspose.3D FOSS for Python egy nyílt forráskódú, MIT licencű könyvtár, amely lehetővé teszi a Python fejlesztők számára, hogy betöltsék, felépítsék, átalakítsák és exportálják a 3D jeleneteket anélkül, hogy bármilyen külső futásidejű függőségre lenne szükség. Akár egy eszközláncot, egy validációs eszközt, egy geometriai feldolgozó szkriptet vagy egy formátumkonverziós szolgáltatást építesz, ez a könyvtár tiszta, konzisztens API-t biztosít, amelyet egy jelenetgrafikon modell támogat, ami 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 gyártási minőségű 3D feldolgozó kódot írj.

Mit találsz ebben a szakaszban

Funkciók és képességek

A Jellemzők az oldal az elsődleges referencia a Aspose.3D FOSS használatához Python esetén. Tartalmazza:

  • Formátumtámogatás: OBJ (.mtl anyagokkal), STL (bináris és ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, valamint a fejlesztés alatt álló FBX tokenizáló, formátumonkénti betöltési és mentési opcióosztályokkal.
  • Jelenet gráf: Hogyan Scene, Node, Entity, Transform, és GlobalTransform alkossa meg a teljes jelenet hierarchiát, beleértve a gyermekcsomópontok bejárási mintáit.
  • Mesh API: Munka a control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, és VertexElementSmoothingGroup geometriai feldolgozáshoz.
  • Anyagrendszer: Alkalmazás LambertMaterial és PhongMaterial a jelenet csomópontokra, és a .mtl fájlokból betöltött anyagtulajdonságok olvasása.
  • Matematikai segédeszközök: Használat Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, é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, KeyFrame, és KeyframeSequence adatok.
  • Betöltési és mentési beállítások: Formátumonkénti opcióosztályok, például ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Teljes használati példák: Végponttól végpontig Python szkriptek OBJ betöltéséhez, STL exportálásához, glTF körkörös konvertálásához és a jelenetgráfok bejárásához.
  • Tippek, gyakori problémák és GYIK: Gyakorlati útmutató a gyakori buktatók elkerüléséhez a termelésben való használat során.
  • API referencia összefoglaló: Gyorsreferencia a minden kulcsfontosságú osztály listájához.

Alapfogalmak

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

Formátumfüggetlen API: Bármely támogatott formátumot megnyithatsz a következőn keresztül Scene.open() vagy Scene.from_file() és bármely támogatott formátumba menthetsz 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.

Nulla függőség: A könyvtár tiszta Python. Nincs natív kiterjesztés, amit le kell fordítani, nincs telepítendő rendszercsomag, és nincs kezelendő harmadik féltől származó könyvtár.

Getting Started

Ha még nem telepítetted a könyvtárat, lásd a Getting Started szakaszt és a Telepítés útmutatót, mielőtt tovább olvasnál.

Available Topics

 Magyar