Sådan kommer du i gang med 3D i Python
Forudsætninger
- Python 3.8 eller nyere
- pip-pakkehåndtering
Trin 1 — Installer pakken
Installer Aspose.3D FOSS for Python fra PyPI:
pip install aspose-3d-fossBekræft installationen:
import aspose.threed as a3d
print(a3d.__version__)Trin 2 — Opret din første 3D-scene
En Scene er rodcontaineren for alle 3D-objekter. Konstruktøren accepterer en valgfri
entitet, overordnet scene og navn:
import aspose.threed as a3d
# Opret en tom scene (CLM-3d-35d727)
scene = a3d.Scene()
# Tilgå scenens rodknude (CLM-3d-859ac2)
root = scene.root_node()
print("Rodknude:", root)Trin 3 — Tilføj et mesh til scenen
Mesh repræsenterer polygon-geometri. Node tilknytter entiteter til scenegrafen:
import aspose.threed as a3d
scene = a3d.Scene()
# Opret et navngivet mesh (CLM-3d-529c11)
mesh = a3d.Mesh("my_mesh")
# Opret en knude og tilknyt meshet (CLM-3d-0edae8)
node = a3d.Node("my_node", mesh)
# Tilføj knuden som barn af roden (CLM-3d-a403f5)
scene.root_node().add_child_node(node)Trin 4 — Indlæs en eksisterende 3D-fil
Scene.open() indlæser en 3D-fil fra disk eller stream. Metoden accepterer en sti og
valgfrie indlæsningsindstillinger:
import aspose.threed as a3d
# Indlæs en OBJ-fil (CLM-3d-d84964)
scene = a3d.Scene()
scene.open("model.obj")
# Undersøg den indlæste scene
root = scene.root_node()
print("Underordnede knuder:", len(root.child_nodes()))For at registrere filformatet inden indlæsning:
import aspose.threed as a3d
# Registrer formatet ud fra et filnavn (CLM-3d-d2de62)
fmt = a3d.FileFormat.detect(None, "model.fbx")
if fmt:
print("Registreret format:", fmt.extension())Trin 5 — Gem output til en fil
Scene.save() eksporterer scenen til ethvert understøttet format. Den anbefalede tilgang er
udvidelsesbaseret auto-registrering: Aspose.3D udleder formatet fra filudvidelsen
(CLM-3d-8051bd, CLM-3d-b28d7a, CLM-3d-de8e1a):
import aspose.threed as a3d
scene = a3d.Scene()
# ... udfyld scene ...
# Gem som Wavefront OBJ — udvidelsen registrerer formatet automatisk
scene.save("output.obj")
# Gem som glTF 2.0 binær — .glb-udvidelsen udløser binært GLB-output
scene.save("output.glb")Du kan også angive et eksplicit format ved hjælp af fabriksmetoderne FileFormat.WAVEFRONT_OBJ()
eller FileFormat.GLTF2(), men udvidelsesbaseret auto-registrering er enklere og mere portabelt.
Næste trin
- Sådan indlæses 3D-modeller i Python — formater, indstillinger, gennemløb af scenegraf
- Sådan konverteres 3D-modeller i Python — batch-konverteringsworkflows
- Sådan bygges mesh-geometri i Python — kontrolpunkter, polygoner, normaler
- FAQ — almindelige spørgsmål og fejlfinding