Node

Node — Aspose.3D FOSS for .NET

Overview

The Node class represents a named element in the Aspose.3D scene graph. Each node can hold one Entity (such as a Mesh, Camera, or Light), maintains parent-child relationships with other nodes, and carries a local transform. Nodes are the primary way to organize 3D objects in a scene hierarchy.

using Aspose.ThreeD;

var scene = new Scene();

// Access the root node
Node root = scene.RootNode;

// Create a child node
Node child = root.CreateChildNode("my_node");

// Iterate child nodes
foreach (var node in root.ChildNodes)
{
    Console.WriteLine(node.Name);
}

Properties

Name	Type	Access	Description
`Name`	`string`	get/set	Human-readable identifier for the node
`Entity`	`Entity`	get/set	The primary entity attached to this node
`Entities`	`List<Entity>`	get	All entities attached to this node
`ChildNodes`	`List<Node>`	get	Child nodes in the scene hierarchy
`ParentNode`	`Node`	get	Parent node in the hierarchy
`Transform`	`Transform`	get	Local transformation (translation, rotation, scale)
`GlobalTransform`	`GlobalTransform`	get	Computed world-space transformation
`Properties`	`PropertyCollection`	get	Custom properties

Methods

Method	Return Type	Description
`CreateChildNode(string name)`	`Node`	Creates a new child node with the given name
`CreateChildNode(string name, Entity entity)`	`Node`	Creates a child node with an attached entity

Example

using Aspose.ThreeD;
using Aspose.ThreeD.Entities;

var scene = new Scene();

// Build a hierarchy with entities
var parent = scene.RootNode.CreateChildNode("Parent");
parent.Transform.Translation = new FVector3(10, 0, 0);

var box = new Box(2, 2, 2);
var child = parent.CreateChildNode("BoxChild", box);
child.Transform.Translation = new FVector3(5, 0, 0);

scene.Save("hierarchy.gltf");