Bevezetés
Kiadjuk Aspose.3D FOSS a Python számára, egy tiszta-Python könyvtár a gyakori 3D fájlformátumok olvasásához, írásához és átalakításához. A könyvtár a PyPI-n elérhető mint aspose-3d-foss, MIT licencet tartalmaz, és nulla külső függősége van.
Ha valaha is programozottan kellett 3D fájlokat vizsgálnia vagy konvertálnia (például háló csúcsainak számát kinyerni, OBJ geometriát egy feldolgozó szkriptbe továbbítani, vagy STL fájlokat kötegelt módon glTF-re konvertálni egy webes megjelenítőhöz), ez a könyvtár erre a felhasználási esetre készült. Nem igényel grafikus illesztőprogramot, natív kiterjesztési modult vagy semmilyen felhőkapcsolatot.
Mi van benne
Alap Jelenetgrafikon
Minden fájl betöltődik egy Scene objektum, amely tükrözi az eredeti fájl csomópont-hierarchiáját. A csomópontok tartalmazzák Transform (fordítás, forgatás, méretezés) és egy vagy több csatolt entitás, például Mesh, Camera, vagy Light. A jelenetgrafikon ugyanaz, függetlenül a forrásformátumtól, így a geometria bejárására és feldolgozására írt kód módosítás nélkül működik minden támogatott formátumon.
Geometria Hozzáférés
Mesh objektumok elérhetőek:
control_points:csúcspozíciók listája, mintVector4(x, y, z, w)polygons:felület indexlisták listája (tetszőleges sokszög aritás, nem csak háromszögek)get_element(VertexElementType):lekéri a név szerint megadott csúcsadat rétegeket a normálokhoz, UV-khez, csúcs színekhez és simítási csoportokhoz
Anyagok
LambertMaterial és PhongMaterial tartalmazzák az OBJ‑ből beolvasott anyagtulajdonságokat .mtl fájlok (ambient, diffuse, specular, emissive, transparency, shininess). Az anyagok megmaradnak a betöltés–mentés körúton azoknál a formátumoknál, amelyek támogatják őket.
Matematikai segédeszközök
Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, BoundingBox bele vannak foglalva könnyű értéktípusokként a geometriai számításokhoz.
Animáció
A AnimationClip, AnimationNode, KeyframeSequence, és KeyFrame osztályok hozzáférést biztosítanak a kulcskocka animációs adatokhoz olyan formátumokból, amelyek tartalmazzák, például a glTF és a COLLADA.
Gyors kezdés
pip install aspose-3d-foss
Töltsön be egy 3D fájlt, és írja ki minden háló csúcsainak számát:
from aspose.threed import Scene
from aspose.threed.entities import Mesh
scene = Scene.from_file("model.obj")
def visit(node):
for entity in node.entities:
if isinstance(entity, Mesh):
print(f"{node.name}: {len(entity.control_points)} vertices, "
f"{len(entity.polygons)} polygons")
for child in node.child_nodes:
visit(child)
visit(scene.root_node)
Konvertálja ugyanazt a fájlt glTF formátumba:
from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions
scene = Scene.from_file("model.obj")
scene.save("model.gltf", GltfSaveOptions())
Ez a teljes program. Nincsenek konfigurációs fájlok, API kulcsok vagy hálózati hívások.
Támogatott formátumok
| Formátum | Extension(s) | Betöltés | Mentés | Megjegyzések |
|---|---|---|---|---|
| Wavefront OBJ | .obj | Igen | Igen | .mtl anyagbetöltés támogatott |
| STL | .stl | Igen | Igen | Bináris és ASCII; koordináta-rendszer fordítási opció |
| glTF 2.0 | .gltf, .glb | Igen | Igen | GLB (önálló bináris) támogatott |
| COLLADA | .dae | Igen | Igen | ColladaSaveOptions elérhető a flip_coordinate_system, enable_materials, indented |
| 3MF | .3mf | Igen | Igen | Alkalmas 3D nyomtatási munkafolyamatokhoz |
| FBX | .fbx | Részleges | N/A | Csak tokenizáló; a teljes elemző fejlesztés alatt |
A formátumdetektálás automatikus a fájlkiterjesztés alapján. Formátum-specifikus betöltési és mentési beállítások (ObjLoadOptions, StlSaveOptions, GltfSaveOptions, ThreeMfSaveOptions) érhetők el a finomhangolt vezérléshez.
Nyílt forráskódú és ingyenes
A könyvtár MIT licenc alatt áll. Kereskedelmi alkalmazásokban is használhatja, módosíthatja, és korlátozás nélkül terjesztheti. A forrás a GitHubon érhető el a Aspose szervezet alatt.
Nincsenek használati szintek, tokenkorlátok vagy telemetria. A könyvtár minden feldolgozást helyben végez.
Függőségek: nincs. A csomag tiszta-Python wheelként települ C kiterjesztés és harmadik féltől származó futásidejű követelmény nélkül.
Első lépések
- Telepítés:
pip install aspose-3d-foss - Útmutató: Fájlok betöltése: Hogyan töltsünk be 3D modelleket a Python rendszerben
- Útmutató: Fájlok konvertálása: Hogyan konvertáljunk 3D modelleket a Python rendszerben
- API-referencia: Aspose.3D FOSS a Python API-referencia számára
- PyPI: aspose-3d-foss a PyPI-n
Összegzés
Aspose.3D FOSS for Python 26.1.0 lefedi a leggyakoribb 3D fájlformátumokat, amelyeket szerszámkészítésben, adatcsatornákban és webalkalmazásokban használnak (OBJ, STL, glTF, COLLADA és 3MF), egységes Python API-val és telepítési nehézség nélkül. Ha hibát, nem támogatott szélhelyzetet vagy egy hozzáadandó formátumot észlel, kérjük, nyisson egy issue-t a GitHubon. Aktívan karbantartjuk a könyvtárat, és szívesen fogadunk hozzájárulásokat.
