ScreenTrace resource

Description
When set to true, enables screen tracing. Screen tracing captures an image of the screen each time it changes, saving the results in a file or printing them.

The default target is a file, unless overridden by the screenTraceTarget resource. The default file type is plain text, unless overridden by the screenTraceType resource or inferred from the suffix on the file name.

The default file name comes from the screenTraceFile resource.

The default print command on POSIX is defined by the printTextCommand resource. The default printer on Windows is defined by the printer.name resource.

The default is to save to a file, but this can be changed with the screenTraceTarget resource or specified with the ScreenTrace action. When saving to a file, the default is to save plain text, but it is also possible to change this with the screenTraceType resource, to specify it with the ScreenTrace action, or infer it from the suffix on the file name.

Note
Users sometimes complain that screen tracing is always "one screen behind". This is by design; the code is optimized to avoid generating a new snapshot for each tiny change the host makes on the screen. Thus screen tracing will not generate a snapshot until the host overwrites some text that has not been previously captured in a screen trace. The final screen contents are captured when screenTrace is set to False or the emulator exits.