Next: 9.2 The 'map+' message Up: 9. Mapping graphic space Previous: 9. Mapping graphic space Contents Index

9.1 The 'map' message

The map messages can be sent to any address with the form /ITL/scene/identifier. It is intended to describe the target object relation to time and sets a relation between an object segmentation and a time segmentation. The global form of the message is:

$\begin{rail} mapMsg : 'map' ( \vert mapName ) (relation \vert ( del )) \end{rail}$

The relation parameter must be sent as a single string which format is described below. It consists in a list of associations between the object local space and its time space expressed as segments.

$\begin{rail} relation : ([1] float2DSegment relativeTimeSegment ) + \vert ([2... ...tiveTimeSegment ) + \vert ([3] int1DSegment relativeTimeSegment ) + \end{rail}$

Segments are expressed as a list of intervals. For a 1 dimension resource, a segment is a made of a single interval. For a 2 dimensions resource, a segment is a made of 2 intervals: an interval on the x-axis and one on the y-axis for graphic based resource, or an interval on columns and one on lines for text based resources. Intervals are right-opened.

The different kind of relations corresponds to:

[1] a relation between a 2 dimensions segmentation expressed in float values and a relative time segmentation. These segmentations are used by rect, ellipse, polygon, curve, line components.
[2] a relation between a 2 dimensions segmentation expressed in integer values and a relative time segmentation. These segmentations are used by txt, txtf, img components.
[3] a relation between a 1 dimension segmentation expressed in integer values and a relative time segmentation. These segmentations are used by the graph component and express a relation between a signal space and time.

Table 9.1 summarizes the specific local segmentation used by each component type.

The specified map can be named with an optional mapName string; this name can be further reused, during object synchronization, to specify the mapping to use. When mapName is not specified, the mapping has a default empty name.

The del command deletes the mapping specified with mapName, or the 'empty name' mapping if no map name is specified.

**Table 9.1:** Local segmentation type for each component
component type	segmentation type
`txt, txtf`	int2DSegments
`img`	int2DSegments
`rect, ellipse, polygon, curve`	float2DSegments
`graph`	int1DSegments

$\begin{rail} relativeTimeSegment : '(' relativeTimeInterval ')' \end{rail}$

$\begin{rail} float2DSegment : '(' floatInterval floatInterval ')' \end{rail}$

$\begin{rail} int2DSegment : '(' intInterval intInterval ')' \end{rail}$

$\begin{rail} int1DSegment : '(' intInterval ')' \end{rail}$

$\begin{rail} relativeTimeInterval : '[' rational ',' rational '[' \end{rail}$

$\begin{rail} floatInterval : '[' float32 ',' float32 '[' \end{rail}$

$\begin{rail} intInterval : '[' int32 ',' int32 '[' \end{rail}$

Relative time is expressed as rational values where 1 represents a whole note.

$\begin{rail} rational : int32 '/' int32 \end{rail}$

EXAMPLE
Mapping an image graphic space to time:

/ITL/scene/myImage map "( [0, 67[ [0, 86[ ) ( [0/2, 1/2[ ) ( [67, 113[ [0, 86[ ) ( [1/2, 1/1[ ) ( [113, 153[ [0, 86[ ) ( [1/1, 3/2[ ) ( [153, 190[ [0, 86[ ) ( [3/2, 2/1[ ) ( [190, 235[ [0, 86[ ) ( [2/1, 5/2[ )"

the image is horizontally segmented into 5 different graphic segments that express pixel positions. The vertical dimension of the segments remains the same and corresponds to the interval [0, 86[. Each graphic segment is associated to a time interval which duration is 1/2 (a half note).

NOTE ABOUT LOCAL SPACES

Text objects (txt txtf) local space is expressed by intervals on columns and rows.
Html object (html, htmlf) do not support mapping because there is not correspondence between the text and the graphic space.
Vectorial objects (rect, ellipse, polygon, curve, svg,...) express their local graphic space in internal coordinates system i.e. on the [-1.,1.] interval.
Bitmap objects (img) express their local graphic space in pixels.

Next: 9.2 The 'map+' message Up: 9. Mapping graphic space Previous: 9. Mapping graphic space Contents Index

Grame - INScore project