`simvx.core.nodes_3d.node3d`¶

Node3D – base 3D spatial node.

Module Contents¶

Classes¶

Node3D

3D spatial node with position, rotation, and scale.

API¶

class simvx.core.nodes_3d.node3d.Node3D(position=None, rotation=None, scale=None, **kwargs)[source]¶

Bases: simvx.core.node.Node

3D spatial node with position, rotation, and scale.

Extends Node with a 3D transform and cached global-transform propagation through the hierarchy. All 3D objects – meshes, cameras, lights – inherit from this.

Attributes: position: Local position as Vec3. rotation: Local rotation as Quat (quaternion). scale: Local scale as Vec3 (default (1, 1, 1)).

Example::

cube = Node3D(position=(0, 2, -5), name="Cube")
cube.rotate_y(math.radians(45))
print(cube.forward)  # unit vector along the local -Z axis

Initialization

render_layer¶: ‘Property(…)’

property position¶

property rotation: simvx.core.math.types.Quat¶

property scale¶

property rotation_degrees: simvx.core.math.types.Vec3¶: Euler angles in degrees (convenience for editor display).

property world_position: simvx.core.math.types.Vec3¶

property world_rotation: simvx.core.math.types.Quat¶

property world_scale: simvx.core.math.types.Vec3¶

property forward: simvx.core.math.types.Vec3¶

property right: simvx.core.math.types.Vec3¶

property up: simvx.core.math.types.Vec3¶

translate(offset: tuple[float, float, float] | numpy.ndarray)[source]¶: Move by offset in local space.

translate_global(offset: tuple[float, float, float] | numpy.ndarray)[source]¶: Move by offset in world space.

rotate(axis: tuple[float, float, float] | numpy.ndarray, angle: float)[source]¶: Rotate around an axis by the given angle in radians.

rotate_x(angle: float)[source]¶

rotate_y(angle: float)[source]¶

rotate_z(angle: float)[source]¶

look_at(target: tuple[float, float, float] | numpy.ndarray, up=None)[source]¶: Rotate to face a target position in world space.

set_render_layer(index: int, enabled: bool = True) → None[source]¶: Enable or disable a specific render layer (0-31).

is_on_render_layer(index: int) → bool[source]¶: Check if this node is on a specific render layer (0-31).

wrap_bounds(bounds: tuple[float, float, float] | numpy.ndarray, margin: float = 1.0)[source]¶: Wrap position within a 3D volume centered at origin.