This module presents up to 10 single dimension (i.e. numeric value range) inputs in a 2 dimensional way. The first dimension is the obvious one -- the value the number has is shown as a tiny rectangle in the column associated with the input. The top rectangle is the highest value, the bottom rectangle is the lowest value.
The second dimension is time, which is represented by the color of the rectangle. If a value is within a range
for a configurable period of time, the color changes. Similarly, when a rectangle has a color, that color fades
to previous color values, again within a configurable period.
This module was created to work with static and dynamic gesture recognition modules, which can use the time/value
representation to detect a gesture.
Up to 10 inputs are supported, any value range is acceptable.
timer: tick interval controls how often the input values are used.
calibrator: necessary to calibrate the input value range. The alternative is to assume all inputs are pre-calibrated, but this complicates the ".ntl" graph.
number rows: each input is mapped into a single column in the module display. This column is divided into a number of rows. This control is designed to be used with any integer input ranging from 0-65535, it maps this into an actual number of rows 1-32. This can also be updated directly as a property (right click) of the module.
advance count: the color of the occupied row changes to the "next color" after this many timer ticks have elapsed. The "next color" and number of colors to used is defined in the property list (right click) of the module.
decay count: the color of a row changes to the "previous color" after this many timer ticks have elapsed.
propagation width: the color of a row propagates to neighboring rows based on this value. The color decays as it propagates.
numberColors -- how many colors from the list color 0 through color 15 to use
color0 -- always black
color 1-15 -- only color values less than "numberColors" property are used. Black colors are place holders for interpolated colors. So for example, if you set "numberColors" to 16, and color15 to white, and all other colors remain black, then the display will advance colors from black through shades of gray to white.