Struct NodeGraph 

pub struct NodeGraph {
    pub root: NodeId,
    pub dirty: bool,
    pub name: String,
    /* private fields */
}

The full SDF node graph owned by the editor.

Fields

root: NodeId

The node whose output is the final body SDF.

dirty: bool

Whether the graph has unsaved changes.

name: String

Human-readable name of this graph.

Implementations

impl NodeGraph

pub fn new(name: impl Into<String>) -> Self

pub fn add_primitive(&mut self, kind: PrimitiveKind) -> NodeId

Add a primitive node and return its ID.

pub fn add_combinator(&mut self, kind: CombinatorKind) -> NodeId

Add a combinator node and return its ID.

pub fn remove_node(&mut self, id: NodeId) -> Option<SdfNode>

Remove a node and all connections that reference it.

pub fn get(&self, id: NodeId) -> Option<&SdfNode>

Get a node by ID.

pub fn get_mut(&mut self, id: NodeId) -> Option<&mut SdfNode>

Get a mutable node by ID.

pub fn nodes(&self) -> impl Iterator<Item = &SdfNode>

Iterate over all nodes.

pub fn node_count(&self) -> usize

pub fn connect( &mut self, from: NodeId, to: NodeId, port: PortId, ) -> Result<(), String>

Connect from’s output to to’s input port. Replaces any existing connection to the same (to, port) pair.

pub fn disconnect(&mut self, to: NodeId, port: PortId)

Disconnect all connections to (to, port).

pub fn connections(&self) -> &[Connection]

pub fn input_of(&self, to: NodeId, port: PortId) -> Option<NodeId>

Find which node feeds input port of to.

pub fn topo_sort(&self) -> Vec<NodeId>

Return nodes in evaluation order (leaves first, root last).

pub fn evaluate_at( &self, node: NodeId, p: Vec3, cache: &mut HashMap<NodeId, f32>, ) -> f32

Recursively evaluate the SDF tree rooted at node at world point p.

pub fn sample(&self, p: Vec3) -> f32

Convenience: evaluate from the root node.

pub fn gradient(&self, p: Vec3) -> Vec3

Numerical gradient of the SDF at p (approximated with finite differences).

pub fn compile_glsl(&self) -> String

Compile the graph to a GLSL float sdf_body(vec3 p) function body.

pub fn auto_layout(&mut self)

Assign canvas positions to all nodes using a simple layered layout.

pub fn to_text(&self) -> String

Serialise to a compact text format for display / persistence.

pub fn stats(&self) -> NodeGraphStats

Trait Implementations

impl Clone for NodeGraph

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeGraph

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

Formats the value using the given formatter.