Hur man konverterar 3D-modeller till Python

Format konvertering med Aspose.3D FOSS för Python är en tvåstegs process: ladda in i ett Scene objekt, spara sedan till önskad utgångsformat. Eftersom all geometri hålls i en gemensam in-minnespresentation behövs inga formatpecifika mellansteg. Avdelningarna nedan visar de vanligaste omvandlingarna med arbetskod.

Steg för steg guide

from aspose.threed import Scene

scene = Scene.from_file("model.obj")

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

options = ObjLoadOptions()
options.flip_coordinate_system = True  # Convert to Z-up if needed
options.enable_materials = True        # Load the accompanying .mtl file
options.normalize_normal = True

scene = Scene()
scene.open("model.obj", options)

from aspose.threed import Scene
from aspose.threed.entities import Mesh

scene = Scene.from_file("model.obj")

mesh_count = 0
total_vertices = 0

def count_meshes(node) -> None:
    global mesh_count, total_vertices
    for entity in node.entities:
        if isinstance(entity, Mesh):
            mesh_count += 1
            total_vertices += len(entity.control_points)
    for child in node.child_nodes:
        count_meshes(child)

count_meshes(scene.root_node)
print(f"Loaded {mesh_count} mesh(es), {total_vertices} total vertices")

if mesh_count == 0:
    raise ValueError("Scene contains no geometry: check the source file path and format")

from aspose.threed import Scene
from aspose.threed.formats import StlSaveOptions

scene = Scene.from_file("model.obj")

save_opts = StlSaveOptions()
##StlSaveOptions defaults to binary output, which is more compact.

scene.save("model.stl", save_opts)
print("Saved model.stl")

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions

scene = Scene.from_file("model.obj")

save_opts = GltfSaveOptions()

scene.save("model.gltf", save_opts)
print("Saved model.gltf")

scene.save("model.glb", save_opts)

from aspose.threed import Scene
from aspose.threed.formats import ThreeMfSaveOptions

scene = Scene.from_file("model.obj")

save_opts = ThreeMfSaveOptions()

scene.save("model.3mf", save_opts)
print("Saved model.3mf")

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions

scene = Scene.from_file("input.stl")
scene.save("output.gltf", GltfSaveOptions())
print("Saved output.gltf")

import os
from aspose.threed import Scene
from aspose.threed.entities import Mesh

output_path = "model.stl"

##Basic file-system check
size = os.path.getsize(output_path)
print(f"Output file size: {size} bytes")
if size == 0:
    raise RuntimeError("Output file is empty: save may have failed silently")

##Round-trip verification: reload and count geometry
def _iter_nodes(node):
    yield node
    for child in node.child_nodes:
        yield from _iter_nodes(child)

reloaded = Scene.from_file(output_path)
mesh_count = sum(
    1
    for node in _iter_nodes(reloaded.root_node)
    for entity in node.entities
    if isinstance(entity, Mesh)
)
print(f"Round-trip check: {mesh_count} mesh(es) in output")

Vanliga problem och fixar

Utgångsfilen är skapad men innehåller ingen geometri

Källfilen kan ha laddat med nollmässa. Lägg till inspektörsteg från Steg 3 innan spara. Bekräfta också att filutvidden matchar det faktiska formatet; Aspose.3D använder utvidgningen för att välja parser.

GTTF-produktionen saknar texturer

Aspose.3D FOSS bär geometri och materialegenskaper genom omvandling. Om källan OBJ refererar till externa bildfiler i .mtl, dessa bildfiler kopieras inte automatiskt bredvid .gltf.Kopiera texturbilder till utgångsdirektivet manuellt efter spara.

STL utgång ser inuti och ut (flicka normala flipped)

STL bär inte metadata för vindbeställning. om utgångsnormerna är inverterade, ställ in StlSaveOptions alternativ om tillgängliga, eller flip koordinatsystemet under laddning: ObjLoadOptions.flip_coordinate_system = True.

ValueError: unsupported format När spara

Kontrollera utgångsfil förlängning är en av .obj, .stl, .gltf, .glb, .dae, .3mf.Extensioner är fallsensitiva på Linux.

Mycket stora filer orsakar långsam konvertering

Aspose.3D FOSS behandlar geometri i minnet. För filer med miljoner polygoner, säkerställer tillräckligt RAM. Det finns för närvarande ingen streaming-skrivande API.

Ofta ställda frågor (FAQ)

Kan jag konvertera en fil utan att skriva den till disk först?

Ja, båda två scene.open() och scene.save() acceptera binära filliknande objekt utöver filvägar. passera alla objekt som implementerar read() för laddning eller write() För att spara:

import io
from aspose.threed import Scene

# Load from an in-memory buffer
data = open('model.obj', 'rb').read()
scene = Scene()
scene.open(io.BytesIO(data))

# Save to an in-memory buffer
buf = io.BytesIO()
scene.save(buf)

Är FBX stöds som ett källformat för konvertering?

FBX tokenisering är delvis implementerad, men parserna är inte färdiga. FBx-inträde kan producera ofullständiga scener. Använd OBJ, STL, glTF, COLLADA eller 3MF som tillförlitliga källformat.

Kommer material att överleva en OBJ-till-glTF omvandling?

Grundläggande Phong/Lambert materialegenskaper (diffusfärg) bäras genom Scene Modellen och skrivs i materialblocket glTF. Procedurella eller anpassade skugga parametrar som inte kan uttryckas i gltf-materialmodellen dras ner.

Kan jag konvertera flera filer i en loop?

Ja, var och en Scene.from_file() Call skapar ett oberoende objekt, så en runda över en lista med vägar är enkel:

from pathlib import Path
from aspose.threed import Scene
from aspose.threed.formats import StlSaveOptions

source_dir = Path("input")
output_dir = Path("output")
output_dir.mkdir(exist_ok=True)

opts = StlSaveOptions()
for obj_file in source_dir.glob("*.obj"):
    scene = Scene.from_file(str(obj_file))
    out_path = output_dir / obj_file.with_suffix(".stl").name
    scene.save(str(out_path), opts)
    print(f"Converted {obj_file.name} -> {out_path.name}")

Bevar omvandlingen scenen hierarki (föräldrarna/barn noderna)?

Ja. Noden är bevarad så långt som målsformat tillåter. Formater som STL lagrar endast platt geometri utan nodestruktur; hierarkin är flätad på spara. Format som glTF och COLLADA behåller den fullständiga hierarki.