A3DObject, SceneObject, CustomObject — Aspose.3D Python API Reference
Пакет: aspose.threed (aspose-3d-foss 26.1.0)
Тези три класа образуват основата на йерархията от класове Aspose.3D. Всеки публичен обект в библиотеката наследява от A3DObject, който предоставя име и динамична колекция от свойства. SceneObject разширява A3DObject с проследяване на членство в сцена. CustomObject е лека конкретна подклас за съхраняване на произволни потребителски метаданни.
A3DObject
Коренният базов клас за всички управлявани обекти Aspose.3D. Всеки именуван обект в библиотеката — Node, Mesh, AnimationClip, Material, и т.н. — наследява от A3DObject.
from aspose.threed import A3DObjectExample
| Example | Example | Example | Example |
|---|---|---|---|
name | str | четене/запис | Човеко‑четимо име на обекта. По подразбиране е празен низ. |
properties | PropertyCollection | четене | Динамичната колекция от свойства, прикрепена към този обект. Обхождайте я или използвайте find_property() за именовани търсения. |
Example
find_property(property_name)
Търсете именовано свойство в този обект PropertyCollection и върнете Property екземпляр, или None ако не е намерено.
| Example | Example | Example |
|---|---|---|
property_name | str | Името за търсене. |
Връща: Property | None
from aspose.threed import Scene
scene = Scene()
node = scene.root_node.create_child_node("origin")
prop = node.find_property("name")
if prop is not None:
print(prop.value) # "origin"get_property(property)
Върнете текущата стойност на именувано свойство, или None ако свойството не съществува.
| Example | Example | Example |
|---|---|---|
property | str | Име на свойството. |
Връща: Any
val = node.get_property("name")
print(val) # "origin"set_property(property, value)
Задава стойността на именувано свойство. Създава свойството, ако все още не съществува.
| Example | Example | Example |
|---|---|---|
property | str | Име на свойството. |
value | Any | Нова стойност. |
Връща: None
node.set_property("layer", 3)
print(node.get_property("layer")) # 3remove_property(property)
Премахва именувано свойство от колекцията.
| Example | Example | Example |
|---|---|---|
property | `str | Property` |
Връща: bool — True ако свойството е намерено и премахнато.
Example
from aspose.threed import Scene
scene = Scene()
node = scene.root_node.create_child_node("my_node")
# Set and retrieve a custom property
node.set_property("export_lod", 2)
print(node.get_property("export_lod")) # 2
# Enumerate all properties
for prop in node.properties:
print(f" {prop.name} = {prop.value!r}")
# Find and inspect a specific property
p = node.find_property("name")
if p:
print(p.value_type) # <class 'str'>SceneObject
Example A3DObject с препратка към притежаващия Scene. Node, Entity, и свързаните класове наследяват от SceneObject.
from aspose.threed import SceneObjectExample
A3DObject → SceneObject
Допълнителни свойства
| Example | Example | Example | Example |
|---|---|---|---|
scene | `Scene | None` | четене/запис |
from aspose.threed import Scene
scene = Scene()
node = scene.root_node.create_child_node("child")
print(node.scene is scene) # True (Node inherits SceneObject)CustomObject
Лек конкретен подклас на A3DObject който съдържа само име и произволен PropertyCollection. Използвайте го, за да прикрепите свободноформени метаданни към сцена, без да създавате подклас на нито един тип обект.
from aspose.threed import CustomObjectExample
A3DObject → CustomObject
Example
CustomObject(name: str = None)Example
from aspose.threed import CustomObject, Scene
# Attach pipeline metadata to a node as a custom object
meta = CustomObject("render_settings")
meta.set_property("max_bounces", 8)
meta.set_property("use_denoiser", True)
scene = Scene()
# Store as a user property on the root node
scene.root_node.set_property("render_meta", meta.name)
print(meta.get_property("max_bounces")) # 8