Driver Details

Text Helper

By: RTI
Updated: Aug. 7, 2020
Version: 1.00

Description:

This driver lets you format text variables to produce varied text effects which can be used to produce more dramatic and noticeable UI's. It will also provide an event when the variable changes so the driver can be used to monitor any text variable.

Text Helper
XP Processor

This driver doesn't control any external devices, it lets you format text variables in specific ways to produce varied text effects which can be used aesthetically or artistically to produce more dramatic and noticeable UI's. It will also provide an event when the variable changes so the driver can be used to monitor any text variable.

Version History

1.0 The original release of the driver

General Description
The driver supports up to 16 text variables. The variables can come from any driver in the file and are monitored by this driver to create outputs that are styled based on the configuration, and the actual text variables chosen

Driver configuration
The driver can reformat text by adding extra spacing between characters. The number of spaces inserted between each character can be entered into the configuration for the variable. The driver doesn't enter an actual space, it enters a non-breakable space character so that the UI does not break the text between words at the button edges. To make the look right on the edges of the box, it has to actually leave the space between letters in the string so the OS knows where to break up the words. This is different depending on whether the text needs to be shown right, left, or center justified, so that option shows in the config once a spacing value is entered.

Driver commands
The driver has no commands, it is monitoring the state of all the input variables and changes the outputs immediately when they change. There is no need to 'trigger' that recalculation.

Driver Variables
Every text variable can be added in one of three formats:

UPPERCASE -- Converts all the characters to uppercase, and spaces them out if needed.
lowercase -- All lowercase, still spaced as configured.
S p a c e d -- Spaced out, but no change to the case of the text.

Driver Events
The driver triggers events when any of the variables change.

Sample File
The sample file controls a Yamaha MusicCast device. The KA-11 sample shows a useable interface: The music note at the top turns on the device and the cover art is a viewport that flips to several browsing frames. The progress and volume gauges both use the text gauge from the Integer Helper driver. The virtual panel just shows metadata examples, including examples of the justification options.