Config file (xml/config.xml)
The config file should be named config.xml and be located at XML_PATH/config.xml - this is the main config file for the software.
| XML Path | Data format | Description |
|---|
| /config/hosts/host | | Host element |
| /config/hosts/host/@addr | hostname/ipaddr | to other OSC software. |
| /config/hosts/host/@rcvPort | port | that timeline recieves OSC on. |
| /config/hosts/host/@sndPort | port | that the other software recieves on. |
| /config/midi/device | | Config for a MIDI device |
| /config/midi/device/@id | String | The prefix for the midi device name (e.g. without [hw x,y] on the end), OSCMIDI:x is a special name that treats /midi x <part> <val> (this is because my hercules is a joystick under linux) |
| /config/classpath | String | The class path for compilation purposes set TIMELINE_UNPACK/timeline/Timeline/classes. |
| /config/datapath | String | arbitrary |
| /config/mappath | String | this isnt used anymore |
Controller mapping Config file (/config/mappath )
The mapping config file should be located at /config/mappath (from config.xml) - this is the main config file for MIDI controller config the software.
In the MIDI window using the middle button a rect can be drawn, the coords are shown in the to right of the MIDI window, clicking on the square next to it copies the XML to the clipboard (useful for pasting into this config file )
| XML Path | Data format | Description |
|---|
| /controlConfig/device | | Config for a device |
| /controlConfig/device/@timeLineId | String | The id the timeline uses - this is stored in files |
| /controlConfig/device/@midiId | String | The id the OS gives the midi device i.e. which one to actually open can exclude the [hwx,y] |
| /controlConfig/device/@image | File Path | The full path to the image file |
| /controlConfig/device/control/ | int | configure a control |
| /controlConfig/device/control/@num | int | control number |
| /controlConfig/device/control/@desc | String | short description (to display on image) |
| /controlConfig/device/control/@width | int | the width of the rect to map |
| /controlConfig/device/control/@height | int | the height of the rect to map |
| /controlConfig/device/control/@top | int | the top of the rect to map |
| /controlConfig/device/control/@left | int | the left of the rect to map |
| /controlConfig/device/notes/ | | configure a keyboard |
| /controlConfig/device/notes/@width | int | the width of the rect to map the whole area of the keys |
| /controlConfig/device/notes/@height | int | the height of the rect to map |
| /controlConfig/device/notes/@top | int | the top of the rect to map |
| /controlConfig/device/notes/@left | int | the left of the rect to map |
| /controlConfig/device/notes/@octaves | int | the number of octaves |
| /controlConfig/device/notes/@textAlign | String | ''vertical'' (else assumed horizontal) |
| /controlConfig/device/notes/@blackKeyWidth | int | the width of a single black key |
| /controlConfig/device/notes/@blackKeyHeight | int | the height of a single black key |
