CommandFusion Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Regex Examples ======

===== Source Selection Feedback =====

It is quite common to want to indicate which source is currently selected by way of making a button active. Below is an example of data sent from an Opus system indicating which source is selected:
<code>
#11U0101!
#11U0102!
#11U0103!
....
#11U0108!
</code>

Each line is a different message the Opus system would send back depending on which source was selected (1 to 8).\\
\\
Now, we need to parse this source selection so that only one of the 8 source select buttons is active at any one time. This is done by using the following regex syntax:
<code>
#11U010(\d)!
</code>

Notice the round brackets and digit specifier - this means 'capture a single digit character' at the position of the message before the exclamation mark.

===== Regex Tester =====

You can use the Regex Tester in guiDesigner to test your regex pattern and ensure the correct data is captured when any of the 8 different messages from Opus come through the feedback system.

{{ :software:gui-designer:system-manager:feedback-parsing:01_regex_example_tester.png?nolink |}}

===== Feedback Properties =====

Once you have this regex perfectly written, you need to assign a [[software:gui-designer:system-manager:feedback-parsing|Feedback Parsing]] item in the [[software:gui-designer:system-manager|System Manager]] to use this regex and assign the capture groups to join numbers.\\
To do this, you click on the 'Add Feedback' button in the System Manager toolbar.

{{:software:gui-designer:system-manager:feedback-parsing:01_regex_example_feedback_properties.png?nolink|}}

Notice the 'Off Value' is always left empty - this ensures when there is an empty capture for that group that the assigned digital join will go low.\\
Also notice the 'On Value' is assigned the actual value that will be captured by the regex when we want to set the assigned digital join high. If this was left empty as well, then the assigned digital join is set to either low or high depending if the captured value results in a 0 or 1 by forcing the captured value to return a boolean (0 or 1) value. So in this example leaving the 'On Value' empty would also work, as the numbers 1 through 8 all result in a boolean value of 1 (basically any number above 0 will result in a boolean 1), yet the empty capture values would result in a boolean 0.

===== Assigning Join Numbers =====

In the above Feedback Properties example, notice the join numbers 1 through 8 are assigned, and they are set to 'Digital' type. These join numbers can then be assigned to a button in your GUI to change the state of the button when the feedback is processed from the system.\\
Simply create 8 buttons on a page and assign then join numbers 1 through 8 using the 'Click assign digital join' tool in the main toolbar (much quicker than editing each buttons properties manually).

{{:software:gui-designer:system-manager:feedback-parsing:01_regex_example_page.png?nolink|}}
CommandFusion Wiki

User Tools

Site Tools

Page Tools
