Scene
Methods
Methods Scene class in Aspose.3D kalpo kā saknes konteineris 3D saturam, pārvaldot augstākā līmeņa objektus un ļaujot pārvaldīt vecāka/bērna attiecības skatu hierarhijā. Tā nodrošina piekļuvi saknes mezgliem un apakšskatiem, veidojot ieejas punktu 3D skatu ielādēšanai, konstruēšanai un saglabāšanai.
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 klasi var instancēt bez argumentiem, lai izveidotu tukšu skatu, vai ar izvēles parametriem.
| Methods | Methods | Methods |
|---|---|---|
name | str | Opcionāls skata nosaukums |
entity | Entity | Opcionāls vienums, ko pievienot saknes mezglam izveides brīdī |
parent_scene | Scene | Opcionāls vecāka skats (apakšskatiem) |
from aspose.threed import Scene
# Empty scene
scene = Scene()
# Access the root node (property, not a method)
root = scene.root_nodeKlases metodes
| Methods | Atgriešanas tips | Methods |
|---|---|---|
Scene.from_file(file_path) | Scene | Ielādē skatu no norādītā faila ceļa, automātiski noteiktot formātu. Pieņem tieši vienu argumentu. |
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 un citas skata līmeņa atribūti ir īpašības; piekļūst tiem bez iekavām.
| Methods | Methods | Methods |
|---|---|---|
root_node | Node | Saknes mezgls ainas hierarhijā. Piekļūst kā īpašībai: scene.root_node |
sub_scenes | list[Scene] | Apakš‑ainas, kas ir iekļautas šajā ainā |
asset_info | AssetInfo | Līdzekļu metadati, piemēram, autors, izveides datums un vienības |
animation_clips | list[AnimationClip] | Animācijas klipi, kas definēti ainā |
current_animation_clip | `AnimationClip | None` |
library | list[CustomObject] | Lietotāja definēti metadatu objekti, kas pievienoti ainai. |
name | str | Ainas objekta nosaukums |
properties | PropertyCollection | Pielāgotas īpašības, kas pievienotas ainai |
Methods
| Methods | Atgriešanas tips | Methods |
|---|---|---|
save(file_path) | None | Saglabā ainu failā; formāts tiek noteikts no paplašinājuma |
save(file_path, format) | None | Saglabā ainu failā norādītajā FileFormat |
save(file_path, options) | None | Saglabā ainu, izmantojot formātam specifiskās saglabāšanas opcijas |
get_property(name) | Any | Iegūst īpašības vērtību pēc nosaukuma |
find_property(name) | Optional[Property] | Atrod īpašību pēc nosaukuma |
create_animation_clip(name) | AnimationClip | Izveido jaunu nosauktu animācijas klipu un pievieno to ainai |
get_animation_clip(name) | `AnimationClip | None` |
clear() | None | Notīra visu saturu no ainas |
Piezīme: root_node ir īpašība uz Scene klase, nevis metode. Nerakstiet scene.root_node(); pareizais piekļuves veids ir scene.root_node.
Methods
Izveidojiet ainu, pievienojiet režģa mezglu un saglabājiet kā 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)