MIDIPoet - Composer - Text events

Text events modify the attributes of one or various text areas.

A text area's modifyable attributes are:

-- Text: textual content of the area.
-- Font: font used to display the text
-- Size: size of the text, expressed in points.
-- Angle: angle of the text. It is measured in relation to the upper left corner of the text area, and expressed in degrees.
-- Position X: X coordinate of the text area's position. It is expressed in pixels, and ranges from 0 (left) to the value of the piece's area width.
-- Position Y: Y coordinate of the text area's position. It is expressed in pixels, and ranges from 0 (top) to the value of the piece's area height.
-- Red: Red component of the text's color. Ranges from 0 to 255.
-- Green: Green component of the text's color. Ranges from 0 to 255.
-- Blue: Blue component of the text's color. Ranges from 0 to 255.

NOTE: Colors in MIDIPoet are expressed as a combination of RGB (red, green, blue) values.

The attributes of a text area are expressed using numeric values (size, angle, position, red, green, blue) or text values (text and font).

The attributes' values can be modified using the following commands:

Valid for all attributes:
-- Fixed value: A unique value, numeric or textual.
-- Random: A random value chosen from a range of values or from a data list.
-- Loop: A value that increases from a starting point to an ending point, and then starts again. The values can be taken from a numeric range or a data list.
-- Bidirectional loop: A value that increases/decreases inside a range. When it reaches the range's upper or lower limit, it changes direction. The values can be taken from a numeric range or a data list.
-- Travel: A value that increases from a starting point to an ending point, and then stops. The values can be taken from a numeric range or a data list.
-- Drunk: A value resulting from a random walk between the starting and ending points of a range. The values can be taken from a numeric range or a data list.
-- MIDI Table: A value taken from a MIDI table. If the event is activated by a MIDI trigger, this value will correspond to the triggering message's specific note or velocity values.

The Loop, Bidirectional loop, Travel and Drunk commands need, besides a range of values, an increment value, which can be numeric or a resulting value of a MIDI table. For example, a bidirectional loop with a range of 0-255 and with an increment value of 2 will go from 0 to 255 and back, stepping 2 positions every time. Another example: a loop that goes through the values of the data list "data 1", and with an increment value of "vel table 1", will loop through the elements in the list "data 1", skipping "n" positions, where "n" is a resulting value coming from the MIDI table "vel table 1".

Valid for numeric attributes:
-- Increase: Increases the value of the attribute by the specified quantity
-- Decrease: Decreases the value of the attribute by the specified quantity.
-- MIDI Range: A value coming from a MIDI range. If the event is activated by a MIDI trigger, this value will correspond to the triggering message's specific note or velocity values.

Valid for textual attributes:
-- Next: The value will be the next element of a data list.
-- Previous: The value will be the previous element of a data list.
These commands use an internal index to keep track of the current element in the specified list.

Valid only for the "text" attribute:
-- Mix letters: Mixes the letters of the area's current text.
-- Mix words: Mixes the words of the area's current text.
-- Shift left: Shifts all letters of the area's current text to the left.
-- Shift right: Shifts all letters of the area's current text to the right.
All modifications to an area's "text" attribute can be accumulative -- this means that every modification is added to the area's previous text value. This is done by marking the "Concatenate text" checkbox (check the events' properties section)

<--