Struct Topology 

pub struct Topology {
    pub fixtures: BTreeMap<FixtureId, Fixture>,
    pub default_layout: Layout,
    pub edges: BiMap<FixtureId, FixtureId>,
    pub ports: BTreeMap<FixtureId, Port>,
}

The default layout plus how the fixtures are connected to ports and in which order. One per project.

Fields

fixtures: BTreeMap<FixtureId, Fixture>

default_layout: Layout

Necessarily contains every fixture — the patching topology cannot be defined otherwise. Maintained by add_fixture/remove_fixture.

edges: BiMap<FixtureId, FixtureId>

Directed parent → child edges. A fixture that is nobody’s child is a chain head and owns a port.

ports: BTreeMap<FixtureId, Port>

Implementations

impl Topology

pub fn add_fixture( &mut self, fixture: Fixture, position: LayoutPosition, ) -> FixtureId

pub fn remove_fixture(&mut self, id: FixtureId, layouts: &mut [Layout])

Removes a fixture everywhere: from the topology, its chain, and every user layout.

pub fn make_leaf(&mut self, id: FixtureId)

Detaches whatever follows id, making that successor a chain head.

pub fn chain_head_of(&self, id: FixtureId) -> FixtureId

The head of the chain id belongs to.

pub fn make_successor(&mut self, parent: FixtureId, child: FixtureId) -> bool

Connects child after parent. Rejected if it would form a cycle.

A chain’s network output belongs to the chain, not to the fixture that happens to be first: putting a new fixture in front of a chain carries the port’s settings over to it.

pub fn is_chain_head(&self, id: FixtureId) -> bool

pub fn successor(&self, id: FixtureId) -> Option<FixtureId>

pub fn chain_from(&self, head: FixtureId) -> Vec<FixtureId>

Every fixture from head down its chain, head first.

pub fn chain_heads(&self) -> Vec<FixtureId>

pub fn is_reachable(&self, start: FixtureId, target: FixtureId) -> bool

true if target is reachable from start by following parent → child edges. Used to keep connections acyclic.

Trait Implementations

impl Clone for Topology

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 Topology

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

Formats the value using the given formatter.

impl Default for Topology

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Topology

where Topology: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Topology

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Topology

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 Topology