AVOSUPPORT - macros

Action and Menus

Anonymous (anonymous@undisclosed.example.com) — 2017-11-19T15:27:46+00:00

Action and Menus When dealing with macros you'll soon learn that even simple actions might require several steps: in general, programming is a very fine-grained business. One of the aspects of this is that the menu - which is displayed to you - is independent from the things which are going on inside the programm. And while there might be measures in place to keep menus and the core in sync, there are also occasions where it is your duty to deal with this. In doubt, try to find out if there is…

Active Binding

Anonymous (anonymous@undisclosed.example.com) — 2019-01-04T16:43:30+00:00

Active Binding You will have noticed that the factory macros for palette fade time and palette overlap feature something special: if e.g. you fire the macro to set palette overlap to 50%, this macro handle (key or button) is highlighted as active until you set palette overlap to another value. In this case, this is very useful to always have an overview what values overlap and fade time are set to.

Console and simulator

Anonymous (anonymous@undisclosed.example.com) — 2017-11-19T14:52:02+00:00

Console and simulator When it comes to describing actions on the real console (or on the simulated one), the following conventions are used (an extensive example is Recorded vs. coded macros): * always write as like as you were performing on a real console, even if playing with the simulator

Control Structures

Anonymous (anonymous@undisclosed.example.com) — 2019-02-06T21:07:22+00:00

Control Structures When a macro is called, all its steps are executed sequentially. However, you can define conditional steps - steps which are only executed if a condition is met. In order to do this, simply give the step a condition property, like in

Deploying macros

Anonymous (anonymous@undisclosed.example.com) — 2017-12-07T20:42:32+00:00

Deploying macros Now you have written your groundbreaking macro... but: how to make Titan aware of it and use it? All you need to do is * copy the macro file to your usermacro location * restart Titan - macro files are only read upon software start * after the software has come back on again you may open the show library (or select

Examples list

Anonymous (anonymous@undisclosed.example.com) — 2025-04-29T13:09:25+00:00

Examples list This is a list of the examples in this wiki. Please feel free to add more. If you are not into writing in a wiki but want to contribute neithertheless please send an email to For those who follow this wiki and are keen on the newest additions, please check the

Examples list by last change date

Anonymous (anonymous@undisclosed.example.com) — 2020-04-19T11:15:14+00:00

Examples list by last change date This is a list of the examples in this wiki, newest additions first. Please feel free to add more. If you are not into writing in a wiki but want to contribute neithertheless please send an email to For those who follow this wiki and are keen on the newest additions, please check the

Formats and syntax

Anonymous (anonymous@undisclosed.example.com) — 2020-04-19T10:15:24+00:00

Formats and syntax This wiki attempts to introduce you to writing macros even if you had not studied computer science. However, it is like reading and writing: there is some spelling and grammar to adhere to, and knowing the basic rules makes life easier. You'll soon get used to it, and will refer back to this documentation only in rare cases.

Function list

Anonymous (anonymous@undisclosed.example.com) — 2018-08-27T14:27:00+00:00

Function list This is a list of the functions which are used in the examples resp. explained in this wiki. A full - but sparsely documented - list of functions is available at . Currently there are functions explained in this wiki: * ActionScript.SetProperty * ActionScript.SetProperty.Boolean * ActionScript.SetProperty.Double *

The Syntax of Functions

Anonymous (anonymous@undisclosed.example.com) — 2018-08-27T17:14:54+00:00

The Syntax of Functions Functions are the heart of macros, functions are listed here and - much more so - in the API documentation. But how should we read something like this: Void Group.StoreMenu.StoreOnButton(String group, Int32 index, AcwUserNumber userNumber) Essentially functions are the part of the code where the system is instructed to do something.

Identifiers

Anonymous (anonymous@undisclosed.example.com) — 2018-06-19T15:30:22+00:00

Identifiers This is a very special section: 'identifiers' tries to list and explain all the values you need to identify a certain item or state. As such, 'identifiers' are not part of pure programming logic or documentation. In fact in most parts this is just convention and system design: how to identify a certain button/playback/palette, how to tell which state a certain item to set to, etc.

Macro file format

Anonymous (anonymous@undisclosed.example.com) — 2017-11-19T15:20:18+00:00

Macro file format The macro files shall be UTF-8 encoded, no BOM, Windows-style line endings (CR LF). For a better understanding you are encouraged to have a look at the factory macro files which you can find in C:\Program Files\Avolites\Titan\Macros

Macro Folders

Anonymous (anonymous@undisclosed.example.com) — 2017-11-20T13:48:50+00:00

Macro Folders As stated elsewhere, macros are xml files. However, in order for Titan to find and read these files, they must reside in designated locations which might differ depending from your installation. Also, this is different on real consoles and with Titan PC suite (Titan One, Titan Mobile, Titan Simulator):

Namespaces

Anonymous (anonymous@undisclosed.example.com) — 2017-11-19T15:30:38+00:00

Namespaces If you have already had a glance at the online API documentation then you know that there really is a huge number of functions and properties - currently there are almost 3000 (three-thousand) entries in the API. Not even the most professional programmer could know all these by heart.

Properties list

Anonymous (anonymous@undisclosed.example.com) — 2018-06-19T15:40:04+00:00

Properties list Stricly, this is only about the system's properties (e.g. Timecode.Enabled). In contrast, general object's properties (e.g. titanId as property of the Handle object) are explained at the respective objects. * Attribute.Mask.Clear.Value * Audio.AudioTriggersEnabled * Chases.ConnectedHandle * CueLists.LiveCueNumber * Editor.Shapes.EditingPlaybackShapes * Editor.Shapes.EditShapesEmpty * Editor.Shapes.PhaseOffset * Editor.Shapes.ProgrammerShapes.Empty * Editor.Shapes.Spr…

Recorded vs. coded macros

Anonymous (anonymous@undisclosed.example.com) — 2017-11-28T15:24:06+00:00

Recorded vs. coded macros For quite many years/versions Avolites Titan allows for recording macros one the fly. This involves the button, and records all the button presses you do, in exactly this order. This sequence can then be played back by just recalling the recorded macro. More information on this is available

Macros

Anonymous (anonymous@undisclosed.example.com) — 2020-04-19T10:14:30+00:00

Macros Introduction to macros Recorded vs. coded macros Formats and syntax Macro file format Macro Folders Deploying macros XML format The Syntax of Functions Function list Properties list Namespaces Types Identifiers Examples list ---------- Start page

Introduction to macros

Anonymous (anonymous@undisclosed.example.com) — 2024-08-24T08:16:38+00:00

Introduction to macros Overview Macros are a way to automatically call specific functions or set specific values. Macros can be called from workspace buttons, or can be triggered from specific actions (like: from starting a cue in a cue list or – as of Titan v10 – starting a set list track).

Step Pause

Anonymous (anonymous@undisclosed.example.com) — 2017-11-19T15:28:28+00:00

Step Pause Pause is a direct property per step and defines a delay time before this step is executed. While some macros will flawlessly work without a step pause set, others may show unreliable behaviour. This is due to the fact that each command and action takes a certain time to complete, and if the next step is called before the previous one is completed, undesired results may occur.

Types

Anonymous (anonymous@undisclosed.example.com) — 2018-09-09T09:27:26+00:00

Types All data - in particular properties and functions' parameters - need to be of a certain type. Essentially, this is a convention you know from everyday's life. There are some information which are always a number - e.g. the phone number. Then there are other information which are always words, e.g. a person's name.

XML format

Anonymous (anonymous@undisclosed.example.com) — 2024-08-24T08:17:50+00:00

XML format There are dozens of books on XML only - it is a widely used language for many purposes. As always, wikipedia is a good read. however, based on an example, the (for this purpose) essential items will be explained. An example macro file might look like this: