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 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 or to specify it with the ScreenTrace action.

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.