Widget Properties - FunkybotsEvilTwin/CSIWiki GitHub Wiki

Widget Properties

Widget Properties are designed to send additional, specific, instructions to a given widget and added after the action in a zone file. For instance, on a typical MCU-style device, you can set the Rotary encoder feedback to vary between Dot, BoostCut, Fill, and Spread modes. Or turning off feedback for a given action.

Feedback

CSI will automatically attempt to display feedback for a single action, or display the feedback for the first action in a CSI macro action (i.e. one button assigned to trigger more than action). There may be use-cases where you want to disable feedback (example: you have a button that's constantly lit because the action does not report a toggle state), or where you want CSI to report the feedback state of anything other than the first action in a macro list.

Example 1. I've got a single action assigned to a widget, but want to disable feedback on an action...

    SomeButton SomeAction Feedback=No

Example 2. I only want feedback on the first action (default behaviour - no additional syntax required)....

    SomeButton SomeAction
    SomeButton AnotherAction
    SomeButton YetAnotherAction

Example 3. I want feedback on the middle action only; so I use the new Feedback widget Property to specify which action gets it....

    SomeButton SomeAction
    SomeButton AnotherAction Feedback=Yes 
    SomeButton YetAnotherAction

Example 4. I want feedback on the last action only....

    SomeButton SomeAction
    SomeButton AnotherAction
    SomeButton YetAnotherAction Feedback=Yes

Example 5. Erroneous definition. In this case only the 3rd Action gets feedback.

    SomeButton SomeAction
    SomeButton AnotherAction Feedback=Yes
    SomeButton YetAnotherAction Feedback=Yes

RingStyle (For Use With Encoders)

    Rotary|                     TrackPan RingStyle=Dot
    DisplayLower|      		TrackPanDisplay

    Toggle+Rotary|              TrackPanWidth RingStyle=BoostCut
    Toggle+DisplayLower| 	TrackPanWidthDisplay

The new functionality is similarly dependent on the type of feedback processor used in your .mst for a given widget.

If using FB_Encoder, then the available options are:

RingStyle=Dot
RingStyle=BoostCut
RingStyle=Fill
RingStyle=Spread

BarStyle (For Use With FaderPort8/16 Value Bars)

If using FB_FaderportValueBar, then the available options are:

BarStyle=Normal
BarStyle=BiPolar
BarStyle=Fill
BarStyle=Spread

FaderPort Display Mode (For Use With FaderPort8/16 Stribble Strips)

If using FB_FP8ScribbleStripMode, then the available options are:

Mode=0
Mode=1
Mode=2
....
Mode=8

TextAlign (For Use With FaderPort8/16 Stribble Strips)

If using FB_FP8ScribbleLine1, etc., then the available options are:

TextAlign=Center
TextAlign=Left
TextAlign=Right

TextInvert=Yes
TextInvert=No