Atlas source code dump

This is a dump of the source code for the engine, graphics tool and player for
Atlas, our 64k demo released
with Macau Exports at Revision 2019. It's been updated to build with the latest
Rust nightly, but for the most part is identical to what we showed in the
graphics breakdown stream.

Goals of this dump:

• You should be able to build and run a fully-functional tool and player.
• You should be able to explore the code in this repo and maybe learn some
  things about how we built it.

To that end, we will accept pull requests and issue reports that help us
achieve these goals. Other PRs and issues will not be accepted. For instance,
a PR to fix a crash when starting the player is fine, but a PR that replaces
part of our post-processing stack is not.

Building

You'll need a 32-bit, nightly build of Rust. The repo has been tested on the
2021-10-01 nightly.
Install Rustup then run the following command in the repo
folder:

> rustup override set nightly-2021-10-01-i686

The repo contains two executable packages. The graphics tool provides features
including live shader reloading, a property editor and an animation system with
a timeline and curve editor. The player bundles up a synth, shaders and
animation data into an optimized executable that plays the demo from start to
end and can be krunched to under 64kb.

To build and launch the tool, run the following command from the tool folder:

> cargo run

To build the player:

• Ensure the tool has run at least once to generate the export blob - see the
  section below on running the tool.
• Ensure you have a resource compiler
  available on your PATH. If you have Visual Studio installed, this can be
  achieved by using a Developer Command Prompt.
• Run the following command from the player folder.

  > cargo build --release
  

This will create a player.exe inside the target folder in the repo.

Using the tool

The tool will open the project file at project/saves/000000-000000-head.save
when started, and save to that file on close. By default this has the timeline
from the post-party final version of Atlas.

When closed, the tool minifies all shaders and generates a binary blob of
shaders and animation data to be packed into a player build. This blob is placed
in project/data.blob. Closing the tool will take a bit of time due to
minifying shaders, if you want to disable this set MINIFY_SHADERS to false
at the top of
tool/src/exporter/shaders.rs.

For more info on using the tool have a look at the
Atlas graphics breakdown video.

Known issues

• There are A LOT of warnings. Some of these are just rushed coding, some of
  them are due to changes in Rust.

License

The demo code is provided under the MIT license.

laurentlb's Shader Minifier is
provided under the Apache 2.0 license.

Un4seen Developments' BASS audio library is provided under a free for
non-commercial use license.

ocornut's dear imgui is provided under the
MIT license.

cimgui is provided under the MIT license.

imgui-sys is provided under the MIT license.

WaveSabre is provided under the MIT license.