Πώς να αποθηκεύσετε 3D σκηνές σε Python

Το Aspose.3D FOSS for Python σάς επιτρέπει να αποθηκεύσετε ένα Scene σε οποιαδήποτε υποστηριζόμενη μορφή εξόδου χρησιμοποιώντας μία μόνο κλήση Scene.save(). Η ανίχνευση μορφής είναι αυτόματη όταν παρέχετε διαδρομή αρχείου· για προχωρημένες επιλογές όπως δυαδική έξοδο ή ενσωμάτωση υφής, παρέχετε ένα αντικείμενο επιλογών αποθήκευσης ειδικό για τη μορφή.

Οδηγός βήμα-βήμα

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)

Κοινά προβλήματα και διορθώσεις

Κενό αρχείο εξόδου μετά από scene.save()
Αυτό συνήθως σημαίνει ότι ο ριζικός κόμβος της σκηνής δεν έχει παιδικούς κόμβους με γεωμετρία. Επαληθεύστε ότι κάθε κόμβος πλέγματος (mesh node) έχει προσαρτηθεί στο scene.root_node πριν καλέσετε το save. Ελέγξτε το len(scene.root_node.child_nodes) μετά την κατασκευή της σκηνής.

AttributeError κατά τη δημιουργία γεωμετρίας πλέγματος
Η κλάση Mesh αποθηκεύει τις κορυφές ως εσωτερική λίστα σημείων ελέγχου. Για λεπτομερή μοτίβα κατασκευής πλέγματος, ανατρέξτε στο άρθρο Πώς να δημιουργήσετε ένα πλέγμα σε Python που καλύπτει τη δημιουργία πολύγωνων, τα στοιχεία κορυφών και τα δεδομένα UV.

GLB output is larger than expected Το δυαδικό GLB ενσωματώνει όλα τα δεδομένα γεωμετρίας και υφής. Εάν GltfSaveOptions.flip_tex_coord_v είναι ορισμένο σε True, περιλαμβάνεται μια επιπλέον διέλευση αντιστροφής συντεταγμένων. Ορίστε το σε False εάν δεν χρειάζεστε αντιστροφή υφής στον άξονα V.

FBX import/export round-trip loses materials Η εξαγωγή υλικού FBX ελέγχεται από FbxSaveOptions.export_legacy_material_properties. Ορίστε το σε True για να γράψετε τυπικά μπλοκ υλικού FBX που μπορούν να διαβάσουν εργαλεία τρίτων.

Collada DAE δεν περιλαμβάνει υλικά
Ορίστε ColladaSaveOptions.enable_materials = True (είναι False από προεπιλογή) πριν από την εξαγωγή.

Συχνές Ερωτήσεις

Ποια μορφές μπορεί να εξάγει το Aspose.3D FOSS για Python;

Η βιβλιοθήκη υποστηρίζει εξαγωγή σε: STL, glTF 2.0 (text and binary GLB), FBX, OBJ, Collada (DAE), και 3MF. Η ανίχνευση μορφής είναι αυτόματη όταν περνάτε μια συμβολοσειρά διαδρομής αρχείου στο Scene.save()· η βιβλιοθήκη διαβάζει την επέκταση για να επιλέξει τον σωστό εξαγωγέα.

Υπάρχει κάποιο API εξαγωγής ροής που αποφεύγει τη γραφή στο δίσκο;

Ναι. GltfExporter.export(scene, stream, options) γράφει σε οποιοδήποτε io.BytesIO ή αντικείμενο τύπου αρχείου. Μπορείτε να περάσετε το buffer μνήμης απευθείας σε μια απάντηση web ή σε περαιτέρω επεξεργασία χωρίς να αγγίξετε το σύστημα αρχείων.

Πώς μπορώ να μετατρέψω μια σκηνή από μια μορφή σε άλλη;

Φορτώστε τη σκηνή με Scene.from_file("input.fbx") και αποθηκεύστε με scene.save("output.gltf"). Η βιβλιοθήκη διαχειρίζεται τη μετατροπή στη μνήμη· δεν απαιτούνται ενδιάμεσα αρχεία.

Μπορώ να αποθηκεύσω πολλαπλές υπο-σκηνές σε ξεχωριστά αρχεία;

Πρόσβαση scene.sub_scenes για επανάληψη σε κάθε υπο-σκηνή, δημιουργία ενός νέου αντικειμένου Scene, σύνδεση των σχετικών κόμβων και κλήση του save() σε καθένα.

Το Scene.save() αντικαθιστά υπάρχοντα αρχεία σιωπηρά;

Ναι. Η βιβλιοθήκη δεν προκαλεί σφάλμα εάν το αρχείο προορισμού υπάρχει ήδη· το αντικαθιστά. Προσθέστε έναν έλεγχο ύπαρξης αρχείου στον κώδικά σας εάν χρειάζεται να προστατεύσετε από τυχαίες αντικαταστάσεις.

Δείτε επίσης

• Πώς να φορτώσετε 3D μοντέλα σε Python
• Πώς να μετατρέψετε 3D μοντέλα σε Python
• Πώς να μετατρέψετε FBX σε glTF σε Python
• Πώς να δημιουργήσετε ένα πλέγμα σε Python