MIDIPoet - Composer - Data sources, ranges and tables

Text, image, screen background and drawing style events modify the attributes of the various components of a MIDIPoet piece. These attributes can be modified in a different number of ways. For example, a random text can be chosen from a list of possible texts, or the screen's background color can vary according to the incoming MIDI notes. Also, the frequency with which a cyclic event occurs can vary according to a note's velocity. All these processes require the definition of data sources: data lists, MIDI ranges and MIDI tables.

**

Data lists.

Data lists are lists of numeric or textual elements that can be used as resulting values for an area's modified attributes. There can be as many lists as needed, and each list can have an unlimites number of elements. Each list can be later recalled by specifying its index, a unique numeric identifier. When a new list is created, an index is automatically assigned to it. To create/modify/delete lists, choose the Window --> Data option from the menu. This is the data lists screen:

The current list's index is at the top right corner of the screen, in this case the index is 1. The big field at the center of the screen is the list itself, with each of its elements occupying a single line. Elements of a list can be a word or words, or a number. Lists can be filled using the contents of a text (.txt) file. To do this, press the "File" button and choose the file. The list can also be filled with other elements: image names, fonts or drawing styles. To fill the list with one of these elements press the "Fill..." button. A screen that lets you choose which elements you want to use will appear.

Use the "<" and ">" buttons to move through existing lists; press the "Delete" button to delete the current list.

**

MIDI Ranges.

MIDI ranges let you modify the value of an area's numeric attribute according to a MIDI note input. Actually two different ranges must be specified in a MIDI range: a range of incoming note or velocity values, and a range of resulting values which will be applied to an attribute. When MIDIPoet receives a MIDI message that falls inside the first range, calculations will be performed to obtain the corresponding value from the second range, which will be relative to the MIDI input. An unlimited number of MIDI ranges can be defined; each range can respond to either note or velocity values. MIDI ranges are later recalled using their index, a unique numeric identifier that is automatically generated when a new MIDI range is created. To create/modify/delete MIDI ranges, choose the Window --> MIDI --> Ranges option from the menu. This is the MIDI ranges screen:

In this case, a MIDI note range is defined. If a note between 0 and 12 is received, values ranging from 0 to 255 will be generated. For example, note 6 results in a value of 127. Resulting values will always be rounded integers. The keyboard at the top of the screen can be useful to find a specific note's MIDI value. Previously included images can be used as resulting values of a MIDI range. In this case, a range of images is defined by choosing their names from the drop down lists labeled "Lower value" and "Upper value".

Use the "<" and ">" buttons to move through existing MIDI ranges; press the "Delete" button to delete the current MIDI range.

**

MIDI Tables

MIDI tables let you modify and area's attribute according to incoming MIDI values. MIDI tables are lists of MIDI value ranges, which can be note or velocity values. For each of the ranges, there is a single resulting value, which can be numeric or textual. When MIDIPoet receives a MIDI value that is inside one of the ranges, the value of that range will be applied to the selected attribute. The resulting values of a MIDI table can also modify an event's frequency, or an increment used by one of the event's processes. MIDI tables can respond to note or velocity values. MIDI tables are later recalled using their index, a unique numeric identifier that is automatically generated when a new MIDI table is created. To create/modify/delete MIDI tables, choose the Window --> MIDI --> Tables option from the menu. This is the MIDI tables screen:

In this example there is a table with seven ranges of MIDI values. These ranges make reference to incoming MIDI note values. The first range comprises notes 0-10, and yields a value of {s1a} (an image name). The second range comprises notes 11-21. and yields a value of {s1b}, and so on. The keyboard at the top of the screen helps in finding a specific note's MIDI value. The resulting value of a range can be a text or a number; a previously defined image can be chosen from the drop-down list. Use the scroll bar at the right of the screen to see all the ranges in a table. A table can have up to 128 ranges. Ranges, and their resulting values, can be automatically generated, by pressing the "Fill..." button. This button will show a screen that lets you sepcify the number of ranges, and/or a number of resulting values of different types (images, fonts or drawing styles).

Use the "<" and ">" buttons to move through existing MIDI tables; press the "Delete" button to delete the current MIDI table.

<--