Scene
Methods
Methods Scene class i Aspose.3D fungerer som rodkontainer for 3D-indhold, håndterer top‑niveau objekter og muliggør styring af forælder/barn‑relationer for scenens hierarki. Den giver adgang til rotnoder og under‑scener og udgør indgangspunktet for indlæsning, konstruktion og gemning af 3D‑scener.
from aspose.threed import Scene
# Create an empty scene
scene = Scene()
# Access the root node: root_node is a property, not a method call
root = scene.root_nodeMethods
Methods Scene class kan instantieres uden argumenter for at oprette en tom scene, eller med valgfrie parametre.
| Methods | Methods | Methods |
|---|---|---|
name | str | Valgfrit navn på scenen |
entity | Entity | Valgfri enhed, der skal knyttes til rotnoden ved oprettelse |
parent_scene | Scene | Valgfri overordnet scene (for under‑scener) |
from aspose.threed import Scene
# Empty scene
scene = Scene()
# Access the root node (property, not a method)
root = scene.root_nodeKlassemetoder
| Methods | Returtype | Methods |
|---|---|---|
Scene.from_file(file_path) | Scene | Indlæser en scene fra den angivne filsti og registrerer automatisk formatet. Accepterer præcis ét argument. |
from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load from file (format detected from extension)
scene = Scene.from_file("model.obj")
# To pass load options, use scene.open() instead:
opts = ObjLoadOptions()
scene = Scene()
scene.open("model.obj", opts)Methods
root_node og andre sceneniveau‑attributter er egenskaber; få adgang til dem uden parenteser.
| Methods | Methods | Methods |
|---|---|---|
root_node | Node | Rodenode i scenens hierarki. Få adgang som en egenskab: scene.root_node |
sub_scenes | list[Scene] | Under‑scener indlejret i denne scene |
asset_info | AssetInfo | Asset‑metadata såsom forfatter, oprettelsesdato og enheder |
animation_clips | list[AnimationClip] | Animationsklip defineret i scenen |
current_animation_clip | `AnimationClip | None` |
library | list[CustomObject] | Brugerdefinerede metadata‑objekter knyttet til scenen. |
name | str | Navn på sceneobjektet |
properties | PropertyCollection | Brugerdefinerede egenskaber knyttet til scenen |
Methods
| Methods | Returtype | Methods |
|---|---|---|
save(file_path) | None | Gemmer scenen til en fil; formatet udledes af filendelsen |
save(file_path, format) | None | Gemmer scenen til en fil i den angivne FileFormat |
save(file_path, options) | None | Gemmer scenen ved hjælp af format‑specifikke gemmeindstillinger |
get_property(name) | Any | Henter en egenskabsværdi efter navn |
find_property(name) | Optional[Property] | Finder en egenskab efter navn |
create_animation_clip(name) | AnimationClip | Opretter et nyt navngivet animationsklip og tilføjer det til scenen |
get_animation_clip(name) | `AnimationClip | None` |
clear() | None | Rydder alt indhold fra scenen |
Bemærk: root_node er en egenskab på Scene klasse, ikke en metode. Skriv ikke scene.root_node(); den korrekte adgang er scene.root_node.
Methods
Opret en scene, tilføj en mesh‑node, og gem til GLB:
from aspose.threed import Scene
from aspose.threed.entities import Mesh
from aspose.threed.formats import GltfSaveOptions
from aspose.threed.utilities import Vector4
# Create scene and mesh
# Note: control_points returns a copy — use _control_points to add vertices
scene = Scene()
mesh = Mesh()
mesh._control_points.append(Vector4(0, 0, 0, 1))
mesh._control_points.append(Vector4(1, 0, 0, 1))
mesh._control_points.append(Vector4(0.5, 1, 0, 1))
mesh.create_polygon(0, 1, 2)
# Add node to root: root_node is a property
node = scene.root_node.create_child_node("triangle", mesh)
# Save as GLB using GltfSaveOptions with binary_mode
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("triangle.glb", opts)