Struct Scene 

pub struct Scene {
    pub viewport_width: f32,
    pub viewport_height: f32,
    pub zoom: f32,
    pub pan_x: f32,
    pub pan_y: f32,
    /* private fields */
}

A scene containing all canvas elements.

Fields

viewport_width: f32

Viewport width in pixels.

viewport_height: f32

Viewport height in pixels.

zoom: f32

Current zoom level (1.0 = 100%).

pan_x: f32

Pan offset X.

pan_y: f32

Pan offset Y.

Implementations

impl Scene

pub fn new(width: f32, height: f32) -> Self

Create a new empty scene with the given viewport size.

pub fn add_element(&mut self, element: Element) -> ElementId

Add an element to the scene.

pub fn remove_element(&mut self, id: &ElementId) -> CanvasResult<Element>

Remove an element from the scene.

Errors

Returns an error if the element is not found.

pub fn get_element(&self, id: ElementId) -> Option<&Element>

Get an element by ID.

pub fn get_element_mut(&mut self, id: ElementId) -> Option<&mut Element>

Get a mutable reference to an element by ID.

pub fn elements(&self) -> impl Iterator<Item = &Element>

Get all elements in the scene.

pub fn elements_mut(&mut self) -> impl Iterator<Item = &mut Element>

Get mutable references to all elements in the scene.

pub fn root_elements(&self) -> impl Iterator<Item = &Element>

Get root-level elements (not children of groups).

pub fn set_viewport(&mut self, width: f32, height: f32)

Set the viewport dimensions.

pub fn element_at(&self, x: f32, y: f32) -> Option<ElementId>

Find the element at the given canvas coordinates. Returns the ID of the topmost (highest z-index) interactive element.

pub fn select(&mut self, id: ElementId) -> CanvasResult<()>

Select an element.

Errors

Returns an error if the element is not found.

pub fn deselect_all(&mut self)

Deselect all elements.

pub fn selected_elements(&self) -> impl Iterator<Item = &Element>

Get currently selected elements.

pub fn element_count(&self) -> usize

Get the number of elements in the scene.

pub fn is_empty(&self) -> bool

Check if the scene is empty.

pub fn clear(&mut self)

Clear all elements from the scene.

pub fn to_json(&self) -> CanvasResult<String>

Serialize the scene to JSON.

Errors

Returns an error if serialization fails.

pub fn from_json(json: &str) -> CanvasResult<Self>

Deserialize a scene from JSON.

Errors

Returns an error if deserialization fails.

Trait Implementations

impl Clone for Scene

fn clone(&self) -> Scene

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scene

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

Formats the value using the given formatter.

impl Default for Scene

fn default() -> Scene

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Scene

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Scene> for ViewportDocument

fn from(scene: &Scene) -> Self

Converts to this type from the input type.

impl Serialize for Scene

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

where __S: Serializer,

Serialize this value into the given Serde serializer.