A3DObject, SceneObject, CustomObject — Aspose.3D Python API Reference
Pacote: aspose.threed (aspose-3d-foss 26.1.0)
Essas três classes formam a base da hierarquia de classes Aspose.3D. Cada objeto público na biblioteca herda de A3DObject, que fornece um nome e uma coleção de propriedades dinâmicas. SceneObject estende A3DObject com rastreamento de associação à cena. CustomObject é uma subclasse concreta leve para armazenar metadados de usuário arbitrários.
A3DObject
A classe base raiz para todos os objetos gerenciados Aspose.3D. Cada objeto nomeado na biblioteca — Node, Mesh, AnimationClip, Material, e assim por diante — herda de A3DObject.
from aspose.threed import A3DObjectEnumerations
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
name | str | leitura/gravação | Nome legível por humanos do objeto. O padrão é uma string vazia. |
properties | PropertyCollection | leitura | A coleção dinâmica de propriedades anexada a este objeto. Itere-a ou use find_property() para buscas nomeadas. |
Enumerations
find_property(property_name)
Pesquisar uma propriedade nomeada na coleção deste objeto PropertyCollection e retorne o Property instância, ou None se não encontrado.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
property_name | str | O nome a ser pesquisado. |
Retorna: 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)
Retorna o valor atual de uma propriedade nomeada, ou None se a propriedade não existir.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
property | str | Nome da propriedade. |
Retorna: Any
val = node.get_property("name")
print(val) # "origin"set_property(property, value)
Define o valor de uma propriedade nomeada. Cria a propriedade se ela ainda não existir.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
property | str | Nome da propriedade. |
value | Any | Novo valor. |
Retorna: None
node.set_property("layer", 3)
print(node.get_property("layer")) # 3remove_property(property)
Remove uma propriedade nomeada da coleção.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
property | `str | Property` |
Retorna: bool — True se a propriedade foi encontrada e removida.
Enumerations
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
Enumerations A3DObject com uma referência ao proprietário Scene. Node, Entity, e as classes relacionadas herdam de SceneObject.
from aspose.threed import SceneObjectEnumerations
A3DObject → SceneObject
Propriedades adicionais
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
scene | `Scene | None` | leitura/gravação |
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
Uma subclasse concreta leve de A3DObject que contém apenas um nome e um arbitrário PropertyCollection. Use-o para anexar metadados de formato livre a uma cena sem criar subclasses de nenhum tipo de entidade.
from aspose.threed import CustomObjectEnumerations
A3DObject → CustomObject
Enumerations
CustomObject(name: str = None)Enumerations
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