A3DObject / SceneObject / CustomObject

A3DObject, SceneObject, CustomObject — Aspose.3D Python API Reference

Pakke: aspose.threed (aspose-3d-foss 26.1.0)

Disse tre klasser udgør grundlaget for Aspose.3D-klassehierarkiet. Hvert offentligt objekt i biblioteket arver fra A3DObject, som giver et navn og en dynamisk egenskabssamling. SceneObject udvider A3DObject med sporscenemedlemskabssporing. CustomObject er en letvægts konkret underklasse til at gemme vilkårlig bruger‑metadata.


A3DObject

Den grundlæggende rodklasse for alle Aspose.3D‑administrerede objekter. Hvert navngivet objekt i biblioteket — Node, Mesh, AnimationClip, Material, og så videre — arver fra A3DObject.

from aspose.threed import A3DObject

Example

ExampleExampleExampleExample
namestrlæs/skrivMenneskelæsbart navn på objektet. Standard er en tom streng.
propertiesPropertyCollectionlæsDen dynamiske egenskabssamling knyttet til dette objekt. Iterer den eller brug find_property() til navngivne opslag.

Example

find_property(property_name)

Søg efter en navngivet egenskab i dette objekts PropertyCollection og returner Property instans, eller None hvis den ikke findes.

ExampleExampleExample
property_namestrNavnet der skal søges efter.

Returnerer: 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)

Returner den aktuelle værdi af en navngivet egenskab, eller None hvis egenskaben ikke findes.

ExampleExampleExample
propertystrEgenskabsnavn.

Returnerer: Any

val = node.get_property("name")
print(val)   # "origin"

set_property(property, value)

Sæt værdien af en navngivet egenskab. Opretter egenskaben, hvis den ikke allerede findes.

ExampleExampleExample
propertystrEgenskabsnavn.
valueAnyNy værdi.

Returnerer: None

node.set_property("layer", 3)
print(node.get_property("layer"))   # 3

remove_property(property)

Fjern en navngivet egenskab fra samlingen.

ExampleExampleExample
property`strProperty`

Returnerer: boolTrue hvis egenskaben blev fundet og fjernet.


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 med en reference til den ejende Scene. Node, Entity, og relaterede klasser arver fra SceneObject.

from aspose.threed import SceneObject

Example

A3DObjectSceneObject

Yderligere egenskaber

ExampleExampleExampleExample
scene`SceneNone`læs/skriv
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

En letvægts konkret underklasse af A3DObject som kun bærer et navn og en vilkårlig PropertyCollection. Brug den til at vedhæfte fri-form metadata til en scene uden at underklasse nogen entitetstype.

from aspose.threed import CustomObject

Example

A3DObjectCustomObject

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

Se også

 Dansk