Time to space mapping refers to the description of relationship between an object local graphic space and its time space. A mapping consists in a set of relations between the two spaces. INScore provides specific messages to describes mappings and to synchronize arbitrary objects i.e. to display their time relationships in the graphic space.
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:
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.
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:
Table 12.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.
|component type||segmentation type|
|rect, ellipse, polygon, curve||float2DSegments|
Relative time is expressed as rational values where 1 represents a whole note.
Mapping an image graphic space to time:
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
The map+ messages is similar to the map message but doesn’t replace the existing mapping data: the specified relations are added to the existing one.
The mapf messages is similar to the map message but gives the path name of a file containing the mapping data, along with the optional map name.
Mapping between the graphic and time space is automatically computed for symbolic score gmn, gmnstream, gmnf. However and depending on the application, the graphic space may be segmented in different ways, for instance: different graphic segments for different staves, a single graphic segment traversing all a system, etc. Thus for a symbolic score, the map message different and is only intended to select one king mapping supported by the system.
The default mapping for a symbolic score is unnamed but equivalent to staff1.
Requesting the mapping of the third staff of a score:
Requesting the system mapping :
A voice may be distributed on several staves and thus a staff may contain several voices.