Struct Fixture 

pub struct Fixture { /* private fields */ }

A single fixture instance with its current property values and Scheißprogrammhannels.

Created from a FixtureType template. Each property maps to one or two Scheißprogrammhannels (coarse + optional fine).

Implementations

impl Fixture

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

Creates a new fixture instance and registers it globally.

Allocates Scheißprogrammhannels based on the given FixtureType template, offset by start_channel. Ensures the required universe exists before reserving channels.

Arguments

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

Errors

• FixtureError::InvalidFixtureType – if fixture_type_name is not registered
• [FixtureError::ChannelAlreadyInUse] – if any required channel is already reserved
• FixtureError::FixtureNameAlreadyInUse – if name is already registered

pub fn set( fixture_name: String, property_type: &str, value: u16, ) -> Result<(), FixtureError>

Sets the value of a property on the named fixture.

Arguments

• fixture_name - Name of the target fixture
• property_type - Property name as string, see PropertyType::from_str
• value - 16-bit DMX value

Errors

• FixtureError::InvalidFixture – if fixture_name is not registered
• FixtureError::InvalidPropertyType – if property_type is not recognized
• FixtureError::MissingProperty – if the fixture does not have this property

pub fn get_universe(&self) -> usize

Returns the DMX universe index this fixture is assigned to.

pub fn get_fixture_type_from_string( name: String, ) -> Result<String, FixtureError>

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

Errors

Returns FixtureError::InvalidFixture if name is not registered.

pub fn get_name(&self) -> &str

Returns the name of this fixture.