Struct Fixture 

pub struct Fixture { /* private fields */ }

A single fixture instance with its current property values and DMX-Channels.

Created from a FixtureType template. Each property maps to one or more DMX-Channels based on its configured ChannelParameter layout.

Implementations

impl Fixture

pub fn new( fixture_type_name: String, start_channel: ChannelIndex, universe: usize, name: String, ) -> Result<Fixture, FixtureError>

Creates a new fixture instance.

Allocates DMX-Channels based on the given FixtureType template, offset by start_channel, and returns the instantiated Fixture.

Arguments

• fixture_type_name - Name of a previously registered FixtureType
• start_channel - DMX-Channel offset within the universe
• universe - DMX universe index (0-based)
• name - Unique name for this fixture instance

Errors

• InvalidFixtureType – if fixture_type_name is not registered

pub fn iter_over_properties( &self, ) -> impl Iterator<Item = (PropertyType, &Channel)>

Returns an iterator over all properties and their channels.

pub fn move_to_channel( &mut self, new_channel: ChannelIndex, new_universe: usize, ) -> Result<(), FixtureError>

Moves the fixture to a new starting channel and universe.

Arguments

• new_channel - New starting DMX-Channel index
• new_universe - New target DMX universe index (0-based)

Errors

• ChannelOutOfRange – if the new channel range is out of bounds

pub fn set( &mut self, property_type: PropertyType, value: ChannelValue, ) -> Result<(), FixtureError>

Sets the value of a property on the fixture.

Arguments

• property_type - Property type to update (Simple or Color)
• value - 32-bit channel value to set

Errors

• FixtureError::MissingProperty – if the fixture does not have this property

pub fn get_fixture_type(&self) -> String

Returns the name of the FixtureType this fixture was created from.

pub fn get_name(&self) -> &str

Returns the name of this fixture.

Trait Implementations

impl Clone for Fixture

fn clone(&self) -> Fixture

Returns a duplicate of the value.

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

Performs copy-assignment from source.