Kaip išsaugoti 3D scenas Python

Aspose.3D FOSS for Python leidžia išsaugoti Scene į bet kurį palaikomą išvesties formatą naudojant vieną Scene.save() kvietimą. Formato aptikimas yra automatinis, kai pateikiate failo kelią; išplėstinėms parinktimoms, tokioms kaip dvejetainė išvestis arba tekstūrų įterpimas, pateikiate formatui specifinį išsaugojimo parinkčių objektą.

Žingsnis po žingsnio vadovas

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)

Dažnos problemos ir sprendimai

Tuščias išvesties failas po scene.save()
Tai paprastai reiškia, kad scenos šakninis mazgas neturi vaikų mazgų su geometrija. Patikrinkite, ar kiekvienas tinklelio mazgas buvo prijungtas prie scene.root_node prieš iškviečiant save. Patikrinkite len(scene.root_node.child_nodes) po scenos sukūrimo.

AttributeError kuriant tinklelio geometriją
Klasė Mesh saugo viršūnes kaip vidinį valdymo taškų sąrašą. Išsamiai apie tinklelio kūrimo šablonus žiūrėkite straipsnį Kaip sukurti tinklelį Python kalba, kuriame aptariama daugiakampių kūrimas, viršūnių elementai ir UV duomenys.

GLB išvestis didesnė nei tikėtasi
Binary GLB įterpia visus geometrijos ir tekstūros duomenis. Jei GltfSaveOptions.flip_tex_coord_v yra nustatyta į True, įtraukiamas papildomas koordinatės apvertimo etapas. Nustatykite ją į False, jei jums nereikia V ašies tekstūros apvertimo.

FBX import/export round-trip loses materials
FBX medžiagų eksportą valdo FbxSaveOptions.export_legacy_material_properties. Nustatykite tai į True, kad įrašytumėte standartinius FBX medžiagų blokus, kuriuos gali perskaityti trečiųjų šalių įrankiai.

Collada DAE neįtraukia medžiagų
Nustatykite ColladaSaveOptions.enable_materials = True (pagal numatymą tai yra False) prieš eksportavimą.

Dažnai užduodami klausimai

Kuriuos formatus Aspose.3D FOSS for Python gali eksportuoti?

Biblioteka palaiko eksportavimą į: STL, glTF 2.0 (tekstinį ir binarinį GLB), FBX, OBJ, Collada (DAE) ir 3MF. Formato aptikimas yra automatinis, kai perduodate failo kelio eilutę Scene.save(); biblioteka skaito plėtinį, kad pasirinktų tinkamą eksportuotoją.

Ar yra srautinio eksporto API, kuris išvengia rašymo į diską?

Taip. GltfExporter.export(scene, stream, options) rašo į bet kurį io.BytesIO arba failų tipo objektą. Galite tiesiogiai perduoti atminties buferį į tinklo atsakymą arba tolesnį apdorojimą, nepaliesdami failų sistemos.

Kaip konvertuoti sceną iš vieno formato į kitą?

Įkelkite sceną naudodami Scene.from_file("input.fbx") ir išsaugokite naudodami scene.save("output.gltf"). Biblioteka tvarko konversiją atmintyje; tarpiniai failai nėra reikalingi.

Ar galiu išsaugoti kelias sub‑scenas į atskirus failus?

Pasiekite scene.sub_scenes, kad iteruotumėte per kiekvieną sub‑sceną, sukurkite naują Scene objektą, prijunkite atitinkamus mazgus ir iškvieskite save() kiekvienam.

Ar Scene.save() perrašo esamus failus tyliai?

Taip. Biblioteka nekelia klaidos, jei tikslinis failas jau egzistuoja; ji jį perrašo. Pridėkite failo egzistavimo patikrinimą savo kode, jei reikia apsaugoti nuo netyčinių perrašymų.

Žr. taip pat

• Kaip įkelti 3D modelius Python kalboje
• Kaip konvertuoti 3D modelius Python kalboje
• Kaip konvertuoti FBX į glTF Python kalboje
• Kaip sukurti tinklelį Python kalboje