Hogyan mentse a 3D jeleneteket Pythonban

Az Aspose.3D FOSS for Python lehetővé teszi, hogy egy Scene‑t bármely támogatott kimeneti formátumba mentsen egyetlen Scene.save() hívással. A formátum felismerése automatikus, ha fájlútvonalat ad meg; haladó beállításokhoz, például bináris kimenethez vagy textúra beágyazásához, formátum‑specifikus mentési beállítási objektumot kell megadnia.

Lépésről‑lépésre útmutató

pip install aspose-3d-foss

from aspose.threed import Scene

from aspose.threed.formats.gltf import GltfSaveOptions, GltfExporter
from aspose.threed.formats.stl import StlFormat, StlSaveOptions
from aspose.threed.formats.fbx import FbxExporter, FbxSaveOptions
from aspose.threed.formats.collada import ColladaExporter, ColladaSaveOptions

# Load from an existing file — format auto-detected from extension
scene = Scene.from_file("input.obj")

from aspose.threed import Scene

scene = Scene()
scene.open("input.fbx")

# ASCII STL — format detected from the .stl extension
scene.save("output.stl")

# Binary STL — smaller file size
from aspose.threed.formats.stl import StlFormat, StlSaveOptions

stl_format = StlFormat()
options = stl_format.create_save_options()
options.binary_mode = True
scene.save("output_binary.stl", options)

import io
from aspose.threed.formats.gltf import GltfExporter, GltfSaveOptions

# Text glTF
options = GltfSaveOptions()
options.binary_mode = False
options.file_name = "output.gltf"

exporter = GltfExporter()
with open("output.gltf", "wb") as f:
    stream = io.BytesIO()
    exporter.export(scene, stream, options)
    f.write(stream.getvalue())

# Binary GLB
options_glb = GltfSaveOptions()
options_glb.binary_mode = True
options_glb.file_name = "output.glb"

stream_glb = io.BytesIO()
exporter.export(scene, stream_glb, options_glb)
with open("output.glb", "wb") as f:
    f.write(stream_glb.getvalue())

from aspose.threed.formats.fbx import FbxExporter, FbxSaveOptions

options = FbxSaveOptions()
options.enable_compression = True
options.embed_textures = False  # keep textures as separate files

exporter = FbxExporter()
exporter.save(scene, "output.fbx", options)

# OBJ — format auto-detected from .obj extension
scene.save("output.obj")

# Collada DAE — with material and coordinate-system options
from aspose.threed.formats.collada import ColladaExporter, ColladaSaveOptions

options = ColladaSaveOptions()
options.enable_materials = True
options.flip_coordinate_system = False
options.indented = True

exporter = ColladaExporter()
exporter.export(scene, open("output.dae", "wb"), options)

Általános problémák és megoldások

Üres kimeneti fájl a scene.save() után
Ez általában azt jelenti, hogy a jelenet gyökércsomópontjának nincs geometriai gyermekcsomópontja. Ellenőrizze, hogy minden hálócsomópontot csatoltak‑e a scene.root_node‑hez, mielőtt meghívná a save‑t. Ellenőrizze a len(scene.root_node.child_nodes)‑t a jelenet felépítése után.

AttributeError háló geometria építésekor
A Mesh osztály a csúcspontokat egy belső vezérlőpont-listában tárolja. A részletes hálóépítési mintákért tekintse meg a How to Build a Mesh in Python cikket, amely a sokszög létrehozását, a csúcselemeket és az UV adatokat tárgyalja.

GLB output is larger than expected A bináris GLB beágyazza az összes geometriai és textúra adatot. Ha GltfSaveOptions.flip_tex_coord_v értéke True, egy extra koordináta‑fordítási lépés kerül bele. Állítsa False‑re, ha nincs szükség V‑tengelyes textúra fordításra.

FBX import/export körúton elvesznek az anyagok
Az FBX anyag exportálását a FbxSaveOptions.export_legacy_material_properties szabályozza. Állítsa ezt True értékre, hogy szabványos FBX anyagblokkokat írjon, amelyeket a harmadik fél eszközei olvashatnak.

Collada DAE nem tartalmaz anyagokat
Állítsa be a ColladaSaveOptions.enable_materials = True‑t (alapértelmezés szerint False) exportálás előtt.

Gyakran Ismételt Kérdések

Milyen formátumokba exportálhatja az Aspose.3D FOSS for Python?

A könyvtár támogatja az exportálást a következő formátumokba: STL, glTF 2.0 (szöveges és bináris GLB), FBX, OBJ, Collada (DAE), és 3MF. A formátumdetektálás automatikus, ha egy fájlútvonal karakterláncot ad át a Scene.save()-nek; a könyvtár a kiterjesztést olvassa, hogy kiválassza a megfelelő exportálót.

Van olyan streaming export API, amely elkerüli a lemezre írást?

Igen. GltfExporter.export(scene, stream, options) bármilyen io.BytesIO vagy fájl-szerű objektumba ír. A memóriában lévő puffert közvetlenül átadhatja egy webválasznak vagy további feldolgozásnak anélkül, hogy a fájlrendszert érintené.

Hogyan konvertálhatok egy jelenetet az egyik formátumból a másikba?

Töltsd be a jelenetet a Scene.from_file("input.fbx") segítségével, és mentsd el a scene.save("output.gltf")-val. A könyvtár kezeli a memóriában történő konverziót; nincs szükség köztes fájlokra.

Menthetek több aljelenetet külön fájlokba?

Használja a scene.sub_scenes-t az egyes aljelenetek iterálásához, hozzon létre egy új Scene objektumot, csatolja a megfelelő csomópontokat, és hívja meg a save()-t mindegyiken.

Felülírja Scene.save() a meglévő fájlokat csendben?

Igen. A könyvtár nem dob hibát, ha a célfájl már létezik; felülírja. Adj hozzá egy fájl létezésének ellenőrzését a kódodban, ha meg szeretnéd védeni a véletlen felülírásoktól.

Lásd még

• 3D modellek betöltése Pythonban
• 3D modellek konvertálása Pythonban
• FBX konvertálása glTF formátumba Pythonban
• Háló (mesh) létrehozása Pythonban