Entity
Methods
Methods Entity classe é a classe base abstrata para objetos que podem ser anexados a um Node no grafo de cena Aspose.3D. Subclasses concretas incluem Mesh, Camera, Light, e Geometry. Entity fornece acesso à hierarquia de nós pai e expõe o excluded propriedade para controle de visibilidade.
Todos os atributos listados abaixo são propriedades; acesse-os sem parênteses.
from aspose.threed import Scene
from aspose.threed.entities import Mesh
scene = Scene.from_file("model.obj")
for node in scene.root_node.child_nodes:
entity = node.entity
if entity is not None:
# excluded is a property, not a method call
if not entity.excluded:
# parent_node is a property, not a method call
parent = entity.parent_node
print(f"Active entity '{entity.name}', parent: {parent.name if parent else 'None'}")Methods
A3DObject → SceneObject → Entity
Subclasses: Geometry → Mesh, Camera, Light, e outros.
Methods
Entity é uma classe base abstrata e não é instanciada diretamente. Use uma subclasse concreta como Mesh.
Methods
| Methods | Methods | Methods |
|---|---|---|
parent_nodes | list[Node] (somente leitura) | Todos os nós pai aos quais esta entidade está anexada. Suporta instanciação (mesma entidade referenciada por múltiplos nós). |
parent_node | Optional[Node] (leitura/gravação) | O nó pai primário, ou None se a entidade não estiver anexada. |
excluded | bool (leitura/gravação) | Methods True, esta entidade está excluída da renderização. Acesse e defina como uma propriedade: entity.excluded = True. |
name | str (leitura/gravação) | Nome legível por humanos para esta entidade. |
properties | PropertyCollection (somente leitura) | Coleção de propriedades personalizadas. |
Methods
| Methods | Tipo de Retorno | Methods |
|---|---|---|
get_property(name) | Any | Obtém o valor de uma propriedade pelo nome. |
find_property(name) | Optional[Property] | Encontra uma propriedade pelo nome. |
Importante: parent_node, parent_nodes, e excluded são propriedades, não métodos. Não os invoque com parênteses. Os padrões corretos são:
# CORRECT
is_excluded = entity.excluded
parent = entity.parent_node
parents = entity.parent_nodes
# WRONG: do not do this
is_excluded = entity.excluded() # TypeError
parent = entity.parent_node() # TypeErrorPara definir parent_node, atribua à propriedade:
entity.parent_node = some_node # CORRECTMethods
Inspecione o estado da entidade após carregar uma cena:
from aspose.threed import Scene
from aspose.threed.entities import Mesh
scene = Scene.from_file("model.stl")
for node in scene.root_node.child_nodes:
entity = node.entity
if entity is None:
continue
# Properties accessed without parentheses
print(f"Entity: {entity.name or '(unnamed)'}")
print(f" Type: {type(entity).__name__}")
print(f" Excluded: {entity.excluded}")
print(f" Parent node: {entity.parent_node.name if entity.parent_node else 'None'}")
if isinstance(entity, Mesh):
print(f" Vertices: {len(entity.control_points)}")
print(f" Polygons: {entity.polygon_count}")