The Options Dialog contains information about the version of Phantom for Windows and controls for trace and instant macro file assignment, sound control, hotkey assignment, and fast-play timing.
![]()
Trace File
This is the file to which the trace log data (similar to what appears in the extended control panel) will be written if trace is enabled in the extended control panel or through the SetPhantom statement.
Enable Sounds
If this checkbox is checked, a rising series of tones is played when recording begins and a falling series of tones is played when recording is ended. In addition, a high-pitched tone is sounded when playback begins, and a lower-pitched tone is sounded when playback ends.
Default String Escape Character
This is the character used to prefix non-printable characters in string literals. When Phantom for Windows records a script, it places a SetStringEscapeCharacter statement in the Init subroutine of the script. The escape character specified in this statement is the one that appears in this options item.
Record Hotkey
The hotkey you enter here can be used at any time to begin a Phantom recording. To end the recording, use the same hotkey. You will then be presented with a dialog in which you can specify the file into which the recording should be saved, or you can cancel at this time without saving the recording.
Record-to-Clipboard Hotkey
The hotkey you enter here can be used at any time to begin a Phantom recording that instead of being saved in a file, will be saved in the Windows clipboard. To end the recording, use the same hotkey. This is the moment the recording will be written to the clipboard. This hotkey is intended for use with the PhantomScript Editor so you can make small recordings and paste them into a larger script. This can be useful for adding exception and error handling features to a base script that has been recorded for the success case.
Instant Macro Controls
These controls allow you to set the Instant Macro record and play hotkeys as well as the file into which Instant Macros are recorded.
Image Match Hotkey
This hotkey is used during recording to include a WaitForMatch statement in the script being recorded. See the Image statement for more information.
Insert ScriptText Hotkey
This hotkey is used during recording to temporarily suspend recording and display a dialog that allows you to enter text into the script being recorded at that point in the recording. This is useful for adding comments that you can then use to locate portions of a long script during subsequent editing and for entering script code "on-the-fly".Here is the Insert Script Text dialog:
![]()
Fast Playback Timing
These controls allow you to set the delays and durations that replace those present in a script file that is fast-played. Depending on the speed of your computer's CPU, it may be possible to decrease or necessary to increase these times to achieve reliable high-speed playback with a particular application set. (Note that these settings can be altered from within a Phantom script using the SetPhantom FastPlay statement.)Mouse Movement Duration is the amount of time the mouse takes to move to a new position.
Mouse Click Delay is the delay inserted before a mouse click is played back.
Keystring Duration is the amount of time it takes to play back a keystroke sequence (using the Keys statement).
Keystring Delay is the delay inserted before keystroke sequences (using the Keys statement) are played back.
Single Keystroke Delay is the delay inserted before single keystrokes (using the Key statement rather than the Keys statement).
Include timeout checks in recordings
If this checkbox is checked, the Phantom recorder will include timeouts on the statements that wait for windows to open or close. If, during playback, the window doesn't open or close within a specified multiple of the amount of time it took during recording, an error dialog is displayed. The default behavior of the script when a timeout occurs (showing a dialog) can be changed if you wish. See Customizing the Recording Process for more information.The timeout period is measured from the last keystroke or mouse click that was entered before the window appeared.
Timeout Multiplier: The timeout value that is placed in the recorded script is calculated by multiplying the amount of time the window took to appear (or disappear) during the recording session by the Timeout Multiplier value specified here. Thus, if the multiplier was 3 and a window took 4 seconds to appear, the timeout value placed on the SetWindow statement by the recorder would be 12 seconds.
Timeout Minimum Secs: This is the minimum timeout value that is allowed. If the calculated value is less than this value, it is automatically set to this value by the Phantom recorder.
Include comments in recordings
If this checkbox is checked, the Phantom recorder will include explanatory comments in recorded scripts.
Enable EXE Debugging
If this checkbox is checked, the Phantom Debugger can be used to examine the execution path and variable contents of exe files created from Phantom scripts. Debugging of exe's is not possible with the Phantom Debugger for exe's generated while this box is not checked.
Enable Tips on startup
If this checkbox is checked, dialogs are displayed when Phantom is started containing usage tips.