This is an old revision of the document!
Types/Object/Handle
Location
Within Titan, each and every single item which has been programmed and assigned to a handle (button, fader or key) also has a location - the 'address' of the handle it is assigned to. While more intuitive for the human user, this is slightly more complicated in terms of programming: a location comprises of the handle group (i.e. which window or which section of faders/buttons), the page ( 0-based: number 0 is displayed as page #1), and the handle index (which button on that page, again 0-based):
"Location={string group_id},{int32 page},{int32 index}"
Thus, a location might look like “Location=Playbacks,2,1” which denotes the 2nd button on the 3rd page of the Playbacks faders.
The entire Location string is then passed to the function which needs a handle identifier, and parsed according to some internal mechanics:
<step>CueLists.GoBack("Location=Playbacks,2,1")</step>
Known Handle Group Ids
- Workspaces – the Workspaces area
- Fixtures – the Fixtures workspace window
- Groups – the Groups workspace window
- playbacks – the main fader handles.
- RollerA – the lefthand roller on a Pearl Expert, and the odd pages of the roller on a Tiger Touch etc. However it is way easier to use 'playbacks' (see above). Also this is more transparent across the console types.
- RollerB – the righthand roller on a Pearl Expert, and the even pages of the roller on a Tiger Touch etc. However it is way easier to use 'playbacks' (see above). Also this is more transparent across the console types.
- StaticPlaybacks – the top-right fader handles on a Tiger Touch and button handles on a Titan Mobile/Quartz, also shown in the 'Static Playbacks' workspace window. Note that the second row in this window refers to Static Playback handles 11~20.
- MobileWingAPlaybacks – the fader handles on a Titan Mobile Faderwing, also mapped to the corresponding workspace window
- MobileWingAExecutor – the button handles on a Titan Mobile Faderwing, also mapped to the corresponding workspace window
- Presets – the upper fader handles on a Pearl Expert and Sapphire Touch which can be used for fixtures and for playbacks. The blue Swop buttons function as select buttons. Note that the Sapphire Touch supports 60 pages while the Pearl Expert knows only of 4 pages. This is also mapped to the 'Fixtures and Playbacks' workspace window.
- PresetFlashes – the flash buttons for the upper presets on a Pearl Expert. You can store palettes and groups here. This is also mapped to the 'Groups an Palettes' workspace window.
- PlaybackWindow – the Playbacks workspace window
- Macros – the Macros workspace window and the 10 designated 'Workspaces, Macros and Executors' buttons on a Tiger Touch - note that these are hard-linked to handles 1~10 in the current page of the macros workspace window and are paged with those.