What Is It?

This library project provides Flex developers with powerful debugging tools including (but not limited to):

Developer Console

• A versatile "tilde-activated" console similar to that found in many 3D games engines (e.g. Unreal, Source, etc.)
• Provides tab-based command auto-completion, command history and built-in help
• Powerful ability to register custom call-back commands at run-time. These are treated identically to the built-in commands.
• Utility functions for serializing object information to the console
• Integrated "Hi-ReS! Stats" from Mr.doob

Client-Side Trace Logging

• Statements are logged to both the console and the Flash Player debugging trace.
• Multiple logging-levels are supported and entries are color-coded by severity in the console. (e.g. DEBUG, INFO, WARN, ERROR)
• Logging verbosity can be set using a simple console command.
• Deferred logging: even if log statements are sent before a Logger instance is created, they will be stored until one does exist, allowing log entries to be submitted from the moment the application starts.
• Explicitly turning off logging causes all logging calls to be disregarded so they don't impede application performance. (All pending deferred log calls are also discarded.)

Who Made This?

Tilde is based on code from the PushButton Games Engine and all due credit goes to the original developers for their fine work. I (Taylor Bastien) extracted the code from the library, removed all game engine-specific code and added some minor improvements that I myself wanted included. The code has changed so little from the original that I felt it was only right to re-release it back into the public domain (under the MIT license). If you use the Console, I'd love to hear what you think. Visit my blog at RIAGrande.com and drop me a comment.

How To Start?

It's easy to integrate the Tilde Console into any Flex project. Just visit the Wiki for all the info you should need to get started.

Can I See It In Action?

You most certainly can. Click the following image to launch a demo app and try out Tilde. The app allows you to log entries before turning on Logging, so you can see deferred logging in action. Once the Console has been activated, hit the "tilde" key (i.e. "~") to show the console display and type in the command "help" to view available commands. I even added a custom command (i.e. "dog") to show how easy it is to do. The source code to the demo app is of course available in the repository.