2. Common messages

Common messages are intended to control the graphic and the time space of the components of a scene. They could be sent to any address with the form /ITL/scene or /ITL/scene/identifier where identifier is the unique identifier of a scene component.

• show: shows or hides the destination object. The parameter is interpreted as a boolean value. Default value is 1.
• del: deletes the destination object.

• export: exports an object to an image file.
  1) exports to a full path name. The file extension is used to infer the export format. Supported extensions and formats are: pdf, bmp, gif, jpeg, png, pgm, ppm, tiff, xbm, xpm.
  2) exports to path/identifier.pdf. When path is a relative path, exports to rootPath/path/identifier.pdf.
  3) exports to rootPath/identifier.pdf.
  When the destination file is not completely specified (third form or missing extension), there is an automatic numbering of output names when the destination file already exists.

• save: recursively saves objects states to a file. The filePath can be relative or absolute. When relative, an absolute path is build using the current rootPath (see application or scene current paths p. and p.). The optional + parameter indicates an append mode for the write operation. The message must be sent to the address /ITL to save the whole application state.
  Note that the file extension for INScore files is .inscore. INScore files dropped on the application or on a window are interpreted as script files (see section 14 p.).

• 'PositionMsg' are absolute and relative position messages.
• 'ColorMsg' are absolute and relative color control messages.
• 'TimeMsg' are time management messages. They are described in section 3 p..
• 'WatchMsg' are described in section 13 p..

EXAMPLE
Export of a scene to a given file as jpeg at the current root path:

/ITL/scene export 'myexport.jpg'

Saving a scene to myScore.inscore at the current root path, the second form uses the append mode:

/ITL/scene save 'myScore.inscore'
/ITL/scene save 'myScore.inscore' '+'

Hiding an object:

/ITL/scene/myObject show 0