Timer Keyword
| 
        grandMA3 User Manual » Command Syntax and Keywords » General Keywords » Timer 
         | 
      
        Version 2.1
         | 
    
To enter the Timer keyword in the command line, use one of the options:
- Press MA + X6 | TC + X6 | TC + X6 | TC
 - Type Timer
 
Description
Timer is an object keyword which is used to access the timer objects.
Timers are stored in the Timer pool. There are two types of timers:
- Stopwatch - counting up from zero.
 - Countdown - counting down to zero.
 
They can be controlled using the Timer pool or the command line.
For more information on timers see Timers topic.
Syntax
[Function] Timer ["Timer_Name" or Timer_Number] (Property ["Setting"] ["Setting_Value"])
Settings
In some settings you have to assign an object. To do so use the Assign Keyword.
Other settings contain a text option or a value. Use the Set keyword for these settings.
The following table displays the settings that have to have an object:
| Setting | Object | Description | 
|---|---|---|
| Appearance | "Appearance 1" | Assigns the appearance to the pool object. | 
| Scribble | "Scribble 1" | Assigns the scribble to the preset pool object. | 
The following table displays the settings that have to have an option or value:
| Setting | Option/Value | Description | 
|---|---|---|
| Name | "Timer Name" | Sets the name of the timer pool object. | 
| Note | "This is a note" | This is the note to the timer pool object. | 
| TimerMode | "Stopwatch" / "Countdown" | Modes of the timer. | 
| TimeReadout | One of the four readout options | Readout options in the timer. | 
| RestartOption | "Continue on Go+" / "Reset on Go+" | Sets if the timer should restart or continue with a new Go+. | 
| TimerLinkType | One of the five link options | Timers can be linked to sequences and can be activated or toggled. | 
| CountdownAlertType | One of the four alert type options | Defines what should happen once the countdown has elapsed. | 
| CountdownAlertRange | "Local" / "All Stations" | Defines where an alert pop-up should appear. | 
| CountdownDuration | Time value | Sets the duration of the countdown. | 
| AlertCommand | "Command Line Input" | The command that can be executed once the countdown has elapsed. | 
| AlertText | "Text that appears in a pop-up" | The text is displayed in an alert pop-up. | 
| FrameFormat | One of the five frame format options | A setting that defines which of five formats is used in the timer. | 
| AlertDuration | Time value | Displays the duration of the alert pop-up. | 
For more information on the settings of the Timer see Timer.
Examples
- To run timer 1, type:
 
| 
             | 
        User name[Fixture]>Go Timer 1 | 
- To change the timer mode in timer 2, type:
 
| 
             | 
        User name[Fixture]>Set Timer 2 "TimerMode" "Countdown" | 
- To set timer 2 to a countdown time of 25 seconds, type:
 
| 
             | 
        User name[Fixture]>Set Timer 2 "CountdownDuration" 25 |