Debugging Your Screen Saver

ScreenTime for Flash enables you to track the execution of your screen saver using the trace methods: STF.trace() and STF.enableAutoTrace().

The STF.enableAutoTrace() enables or disables automatic tracing of all mProjector commands. When auto tracing is enabled, ScreenTime for Flash will post STF function names and parameter values to the trace window. The STF.trace() method displays the specified text string in the trace window.

Design Time Debugging

STF trace messaging will appear in the Flash IDE Output window once you include the ScreenTimeScreenSaver component in the first frame of your movie. This tracing is limited to messages, parameters, and results provided from the Flash Player only. STF function return values are not avaliable in the Flash IDE.

For example, if you enable auto tracing, STF function calls and their corresponding parameter values sent to STF will appear in the Output window. If you were to call STF.getSpecialFolder("DESKTOP"), you would see "STF.getSpecialFolder("DESKTOP")" in the Output window, however, the callback will not be called and the return value will trace undefined.

Run Time Debugging

On Windows, the trace messages are posted to a log file on the root directory of the test machine. The log file will be named yourscreensaversnameTrace.txt - i.e. if your screen saver is named bluecar, then your trace messages will be written to C:\bluecarTrace.txt.

On the Mac, all trace messages are posted to the OSX Console application during execution. You can find the Console application in the Applications/Utilites directory.