Package heronarts.lx.mixer

Class LXChannel

java.lang.Object
heronarts.lx.LXComponent
heronarts.lx.LXModulatorComponent
heronarts.lx.LXModelComponent
heronarts.lx.mixer.LXBus
heronarts.lx.mixer.LXAbstractChannel
heronarts.lx.mixer.LXChannel
All Implemented Interfaces:
LXComponent.Renamable, LXLoopTask, LXPath, LXPresetComponent, LXSerializable, LXOscComponent, LXParameterListener
public class LXChannel extends LXAbstractChannel
A channel is a single component of the engine that has a set of patterns from which it plays and rotates. It also has a fader to control how this channel is blended with the channels before it.

  • Field Details

  • Constructor Details

    • LXChannel

      public LXChannel(LX lx, int index, LXPattern[] patterns)

  • Method Details

    • onParameterChanged

      public void onParameterChanged(LXParameter p)
      Description copied from class: LXComponent
      Subclasses are free to override this if desired. It will automatically fire for any listenable parameter that is registered with this component.
      Specified by:
      onParameterChanged in interface LXParameterListener
      Overrides:
      onParameterChanged in class LXAbstractChannel
      Parameters:
      p - Parameter that has a value change

    • onPatternEnabled

      public void onPatternEnabled(LXPattern pattern)

    • getModelView

      public LXModel getModelView()
      Overrides:
      getModelView in class LXAbstractChannel

    • addListener

      public final void addListener(LXChannel.Listener listener)

    • removeListener

      public final void removeListener(LXChannel.Listener listener)

    • handleOscMessage

      public boolean handleOscMessage(OscMessage message, String[] parts, int index)
      Description copied from class: LXComponent
      Handles an OSC message sent to this component. By default this method handles registered components and parameters, but subclasses may override this method to handle different types of OSC messages.
      Specified by:
      handleOscMessage in interface LXOscComponent
      Overrides:
      handleOscMessage in class LXBus
      Parameters:
      message - Full OSC message object
      parts - The OSC address pattern, broken into an array of parts
      index - Which index into the parts array corresponds to this component's children
      Returns:
      true if the OSC message was handled and should be considered consumed, false otherwise

    • midiDispatch

      public void midiDispatch(LXShortMessage message)
      Description copied from class: LXAbstractChannel
      Dispatch a MIDI message to all the active devices on this channel, without notifying listeners.
      Overrides:
      midiDispatch in class LXAbstractChannel
      Parameters:
      message - Message

    • getGroup

      public LXGroup getGroup()
      Description copied from class: LXBus
      Returns the group that this channel belongs to
      Overrides:
      getGroup in class LXBus
      Returns:
      Group that this channel belongs to, or null

    • constructClip

      protected LXClip constructClip(int index)
      Specified by:
      constructClip in class LXBus

    • getPatterns

      public final List<LXPattern> getPatterns()

    • getPattern

      public final LXPattern getPattern(int index)

    • getPattern

      public final LXPattern getPattern(String label)

    • getPatternByClassName

      public final LXPattern getPatternByClassName(String className)

    • setPatterns

      public final LXChannel setPatterns(LXPattern[] patterns)

    • addPattern

      public final LXChannel addPattern(LXPattern pattern)

    • addPattern

      public final LXChannel addPattern(LXPattern pattern, int index)

    • removePattern

      public final LXChannel removePattern(LXPattern pattern)

    • movePattern

      public LXChannel movePattern(LXPattern pattern, int index)

    • reloadPattern

      public LXChannel reloadPattern(LXPattern pattern)

    • getFocusedPatternIndex

      public final int getFocusedPatternIndex()

    • getFocusedPattern

      public final LXPattern getFocusedPattern()
      Returns the pattern that currently has focus in this channel's pattern list.
      Returns:
      Pattern focused in the list

    • getClipLabel

      public String getClipLabel()
      Overrides:
      getClipLabel in class LXBus

    • getActivePatternIndex

      public final int getActivePatternIndex()
      Returns the index of the currently active pattern, if any
      Returns:
      Index of the currently active pattern

    • getActivePattern

      public final LXPattern getActivePattern()

    • getTargetPattern

      public final LXPattern getTargetPattern()

    • getNextPatternIndex

      public final int getNextPatternIndex()

    • getNextPattern

      public final LXPattern getNextPattern()

    • goPreviousPattern

      public final LXChannel goPreviousPattern()
      Activates the previous pattern in this channel's pattern list
      Returns:
      this

    • goNextPattern

      public final LXChannel goNextPattern()
      Activates the next pattern in this channel's pattern list
      Returns:
      this

    • goPattern

      public final LXChannel goPattern(LXPattern pattern)
      Activates the given pattern, which must belong to this channel.
      Parameters:
      pattern - Pattern to acivate
      Returns:
      this

    • goRandomPattern

      public final LXChannel goRandomPattern()
      Activates a randomly seleted pattern on the channel, from the set of patterns that have auto cycle enabled.
      Returns:
      this

    • goPatternIndex

      public final LXChannel goPatternIndex(int index)
      Activates the pattern at the given index, if it is within the bounds of this channel's pattern list.
      Parameters:
      index - Pattern index
      Returns:
      this

    • disableAutoCycle

      public LXBus disableAutoCycle()

    • enableAutoCycle

      public LXBus enableAutoCycle(double autoCycleThreshold)
      Enable automatic transition from pattern to pattern on this channel
      Parameters:
      autoCycleThreshold - time in seconds
      Returns:
      this

    • getAutoCycleProgress

      public double getAutoCycleProgress()
      Return progress towards making a cycle
      Returns:
      amount of progress towards the next cycle

    • getTransitionProgress

      public double getTransitionProgress()
      Return progress through a transition
      Returns:
      amount of progress thru current transition

    • loop

      public void loop(double deltaMs)
      Specified by:
      loop in interface LXLoopTask
      Overrides:
      loop in class LXAbstractChannel

    • dispose

      public void dispose()
      Description copied from class: LXComponent
      Invoked when a component is being removed from the system and will no longer be used at all. This unregisters the component and should free up any resources and parameter listeners. Ideally after this method is called the object should be eligible for garbage collection. Subclasses are generally expected to override this method to handle their particular cleanup work. They should also generally call super.dispose() at the appropriate time to perform the basic cleanup, which may need to happen either before or after cleaning up other objects.
      Overrides:
      dispose in class LXAbstractChannel

    • getPresetClass

      public Class<?> getPresetClass()
      Specified by:
      getPresetClass in interface LXPresetComponent
      Overrides:
      getPresetClass in class LXBus

    • postProcessPreset

      public void postProcessPreset(LX lx, JsonObject obj)
      Description copied from interface: LXPresetComponent
      Presets by default contain the results of a normal save() call, but we may not always want all of the information contained. This method post-processes the JSON object before writing to disk.
      Specified by:
      postProcessPreset in interface LXPresetComponent
      Overrides:
      postProcessPreset in class LXAbstractChannel

    • save

      public void save(LX lx, JsonObject obj)
      Description copied from class: LXComponent
      Serializes the LX component. By default, all internal and user-facing parameters are serialized, as well as any explicitly registered child components. Note that child arrays are not serialized, or any other dynamic components. Subclasses may override to perform more saving, and are expected to call super.save(lx, obj) at the appropriate time.
      Specified by:
      save in interface LXSerializable
      Overrides:
      save in class LXBus
      Parameters:
      lx - LX instance
      obj - Object to serialize into

    • load

      public void load(LX lx, JsonObject obj)
      Description copied from class: LXComponent
      Loads the LX component. Restores the ID of the component, as well as its internal and user-facing parameters. Any explicitly registered children will be automatically loaded, so long as they are direct descendants. Dynamic arrays will not be automatically loaded, this is left to subclasses to implement.
      Specified by:
      load in interface LXSerializable
      Overrides:
      load in class LXAbstractChannel
      Parameters:
      lx - LX instance
      obj - Object to deserialize