Skip to content

Repository files navigation

Atlas Tracer

GitHub contributors GitHub last commit GitHub Issues or Pull Requests GitHub Repo stars Build Status

Atlas Tracer is a macOS application that helps the user debug Atlas applications made with the engine.

How does it work?

Atlas Tracer works in a simple way through ports in your computer. The application interacts with the engine, and they send and recieve packets of information encoded that then the application deciphers to give the user real-time data of what's going on the inside of the compiled game.

Types of Sessions

Atlas Tracer works with different types of sessions, which they are basically different types of information that it can display:

  • Graphics Sessions: These are focused on draw calls and performance of the Graphics Engine and Vulkan.
  • Resource Sessions: These are focused on what resources is the engine loading, how much time it spends doing it and other insights.
  • Object Sessions: These are focused on the objects rendered in the screen, meaning triangle count, and general computing time insights.
  • Trace Sessions: These are focused on how many memory is the engine using, including also render buffers.
  • Profiling Sessions: These are focused on the timing that it takes to do certain stuff, they are tailored to what the person debugging wants.

How to implement an Atlas Tracer?

If you waent to implement you own application that can interact with Atlas, you can consult our documentation on the protocol.

About running the application

Since we work primarily with macOS, the implementation we offer is indeed for macOS. However, you can implement your own version for other operating systems using the protocol documentation. Also, you need to bypass Gatekeeper to run the application, since it is not signed. To do so, right click on the application and select "Open", then confirm you want to open it. We do not have an Apple Developer account, hence the lack of signing. Our apologies for the inconvenience.

About

A debugging assistant for the Atlas Engine in macOS

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages