Asteroid

Asteroid is a profiler tool that allows you to profile C++ applications using its API inside the source code.

Usage:

1. Copy 'Asteroid.h' and 'Asteroid.cpp' files from download zip to your game project

2. Add ASTEROID_INIT(); macro at the init of the application

  void main() 

  {

      ASTEROID_INIT();

      ...

  } 

3. Add  ASTEROID_FRAME(); macro to the main loop of your application

  while(true) 

  {

      ASTEROID_FRAME();

      application.Update();

  } 

4. In order to instrument a function, add one of the following macros:

•      Use ASTEROID_FUNCTION(); at the beginning of a function to intrument it with default values

      void SomeFunction() 

      {

          ASTEROID_FUNCTION();

          ...

      } 

•   Use ASTEROID_FUNCTION_EX("My Function"); at the beginning of a function to intrument it with a given name

      void SomeFunction() 

      {

          ASTEROID_FUNCTION_EX("My Function");

          ...

      } 

• Use ASTEROID_CATEGORY("My Category", AsteroidColor::ORANGE); at the beginning of a function to intrument it with a given name and color

      void SomeFunction() 

      {

          ASTEROID_CATEGORY("My Category", AsteroidColor::ORANGE);

          ...

      } 

5. Add ASTEROID_CLEANUP(); at the end of the application

  void main() 

  {

      ...

      ASTEROID_CLEANUP();

  } 

6. Open Asteroid application

7. Open the application you want to test

8. Click the play button on the Asteroid interface

9. Once you think you have enough frames collected, click the pause button

10. Examine the frames