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, and so on — наследуется от A3DObject.
from aspose.threed import A3DObjectExample
| Example | Example | Example | Example |
|---|---|---|---|
name | str | Read/Write | Человекочитаемое имя объекта. По умолчанию — пустая строка. |
properties | PropertyCollection | Read | Динамическая коллекция свойств, прикреплённая к этому объекту. Перебирайте её или используйте 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