LaunchEvent

Events of this class are fired to track the progress of a game session when the user launches a table. This event has the following subtypes:

The runbeforepre, runbefore, runafter, and runafterpost events run in that order, and correspond to the similarly named external commands that can be set up for each system in the options. The separate "pre" and "post" events are provided for finer control over the display appearance during each step. During the runbeforepre and runafterpost commands, the main PinballY window is blank, showing just a uniform black background. This makes it a good time to perform any changes to the physical monitor layout, such as rotating the monitors or changing the screen resolutions, since the blank window won't show any obvious visual effect and thus will help achieve a visually seamless transition to the new layout.

The full order of the events, including the external commands, is as follows:

The sequence above is for successful launches. It will vary slightly if anything goes wrong. If the game system launch itself fails (for example, if the game program can't be started, or if it terminates or crashes before opening a UI window), a launcherror event will be fired instead of gamestarted and gameover. The sequence can also be cut short if the "Run Before" commands fail. Errors in those steps will prevent the game from being launched, although the system does try to run the paired "Run After" routines in all cases to ensure that any global changes made in the "Run Before" steps are undone by the matching "Run After" steps.

Properties

This event has the standard event properties and methods (see the Event class), plus the following: