Struct Object 

pub struct Object {
    pub name: String,
    pub transform: Transform,
    pub geometry: Option<Geometry>,
    pub color: [f32; 4],
    pub children: Vec<usize>,
    pub parent: Option<usize>,
    pub str_id: String,
    pub texture_path: Option<String>,
}

A node in the scene graph.

Every visible or logical entity in a scene is represented by an Object. Objects are stored in and managed by a crate::world::World; use crate::world::World::spawn_object (or crate::scene::Scene::spawn) to insert them.

Hierarchy

Parent-child relationships are tracked via the Object::parent and Object::children integer-ID lists. Do not mutate these directly: use crate::world::World::reparent and crate::world::World::delete to keep the hierarchy consistent.

Identity

Each object has two identifiers:

• An integer id assigned by crate::world::World at spawn time, fast for per-frame lookups.
• A stable str_id string chosen at construction, human-readable, resolved to an integer via crate::world::World::get_id.

Fields

name: String

Human-readable display name (does not need to be unique).

transform: Transform

Local-space transform (position, rotation, scale) relative to the parent, or to world origin if at the scene root.

geometry: Option<Geometry>

Optional procedural geometry attached to this object. None means the object is invisible (useful for empty pivot nodes).

color: [f32; 4]

RGBA base color multiplied with the geometry during rendering. Values outside [0.0, 1.0] are currently clamped by the shader.

children: Vec<usize>

Integer IDs of direct children. Managed by crate::world::World; do not mutate directly.

parent: Option<usize>

Integer ID of the parent object, or None if this is a root object. Managed by crate::world::World; do not mutate directly.

str_id: String

Stable string identifier used as a human-friendly handle. Should be unique within a world. Use crate::world::World::rename_str_id to change it after spawn.

texture_path: Option<String>

Path to a texture image applied to this object’s surface.

Implementations

impl Object

pub fn new(config: ObjectConstructor) -> Self

Create a new object from an ObjectConstructor configuration.

None fields fall back to their defaults:

• transform -> identity
• str_id -> random UUID
• color -> opaque white
• geometry -> None (invisible)

pub fn from_geometry( name: &str, str_id: Option<String>, geometry: Geometry, transform: Transform, color: [f32; 4], ) -> Self

Convenience constructor for an object with a known geometry, transform, and color.

• name - display name.
• str_id - stable string handle; a random UUID is used if None.
• geometry - shape attached to the object.
• transform- initial local transform.
• color - RGBA base color.

Trait Implementations

impl Clone for Object

fn clone(&self) -> Object

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Object

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Object

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Object

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Object

fn eq(&self, other: &Object) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Object

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Object