MIDIPoet - Composer - Events: general concepts

The events in a MIDIPoet piece modify the properties of an area.

We can think of areas as the characters in the piece. In MIDIPoet pieces, the characters can be texts or images.
Each of these characters appears (or disappears) in a specific moment, and has behaviors which can be either pre-defined or responsive to external impulses. Each character is independent from the rest, and has specific attributes which can be modified. The modification of these attributes can result in animations, changes in color, size, etc. To learn about the specific properties of text and image areas, you can check the text events and image events sections.


Two image areas and two text areas.


The text and image areas can contain any text or image respectively, and their content can vary through time. You can have as many text and image areas as you need, limited only by your machine's RAM.

While you compose a MIDIPoet piece, the text and image areas are defined as needed. Areas are defined using a unique number, which will be specified in the event properties screen. For instance, the first text area you use can be number 1, the next one number 2, and so on. You create new areas simply by defining new numbers. Each area is identified by its number. There can be more then one event modifying a single area; in such case, both events will make reference to this area's number.


Text events are represented in diagrams as red blocks labeled with the letter "t", followed by a number that represents the area or areas that are modified when the event occurs. If an event modifies text area '1', the event will be labeled "t1" in the diagram. If an event modifies various areas at the same time, for example, areas 1 to 10, the events label will be "t1-10".
The same goes for image events, which are labeled with an "i" letter, instead of "t".


Text and image events can occur only once (they happen on a determinate time and/or when a condition is met) or repeatedly (they happen in cyclic way and with a specific frequency, starting from a specific time and/or when a condition is met). This allows, for example, to activate the animation of an image sequence, or to modify progressively the X and Y coordinates of a text.

Cycles are a property of each event. One area can have an unlimited number of simultaneous cycles. For example, a text area can have its content changed, be moved and resized using independ cycles for each modification, each one with its own frequency of occurrence.

Cyclic events are distinguished in the diagrams with the "+" symbol.

This is a cyclic event that affects areas 2,3,4,5,6,7 and 8.


Other types of events (all of which can be cyclic):

Screen background: These events affect the properties of the screen background; the scenery on which text and image areas appear. The only property of the screen background which can be modified is its color. Please check the screen background events section.

Screen drawing style: These events affect the way text and image areas are drawn on screen. To learn more about this type of events, check the screen drawing style section.

MIDI Outputs: Events that generate a MIDI message that is sent to the chosen MIDI out port. Please check the MIDI out events section.