OpenMusic Reference
Prev| Chapter 10. Maquettes| Next
The Temporalbox object
When a patch is dropped into a Maquette, it is enclosed in a Temporalbox, which has two unique elements: the self box and the tempout output. The temporal box returns information about the geometry and positioning of the box within the frame. You can use these values to affect the behavior of the patch. The output tempout must be connected to a playable music object, as this is the object that will be played within the Maquette when the play pointer crosses the left edge of the box. Additional inputs and outputs may be added with the usual buttons as with any patch. These are represented in the Maquette frame as tick marks on the upper and lower edges of the box, and may be used to create connections between Maquette boxes in order to pass data between them.
The self outputs
The self object represents the box itself. The 10 outlets return the following information about the box in the context of the Maquette frame:
-
self - The Temporalbox object itself. Can be used with addbox2maquette and related functions.
-
offset - The distance of the left edge of the box from the zero point of the x axis, in milliseconds.
-
extend - The duration of the object (or of the musical object connected to tempout , if a patch) as played, not as represented graphically, in milliseconds. Changing the scale of the view will not affect this value. If you have changed the size of the box, this real duration of the object is nonetheless represented graphically; the extension of the box beyond the real duration will not be colored like the front portion of the box.
-
colorframe - A value representing the color assigned to the box.
-
value - The object connected to the box’s tempout
-
posy - The height of the top edge of the box as measured against the y axis.
-
stretch-factor - The ratio of the distance spanned by the box graphically against the time axis to the real duration of the object. A value of 1 means the object is drawn at ‘actual length’. Values smaller than 1 represent a compression, larger values an expansion.
-
sizey - The length of the left edge of the box as measured against the y axis.
-
free-store - An open slot where you may store values using the get-set-slot mechanism. See the chapter on Classes for more information on the get-set-slot mechanism.
-
Reference - The OM internal reference for the Temporalbox object. The self object can’t be put in reference mode, so you must take this value here if you need it. See the Chapter on Patches for more info on reference mode.
| Prev | Home | Next |
|---|---|---|
| The structure of a Maquette | ||
| Up | Maquettes in patches |