galaxy

Application Programming Library using C++20, with a Data driven design and Test driven development.

Supercluster - Application Builder/Editor for Galaxy.

Videos on Supercluster

• Basic Features: https://youtu.be/U58YtCnqu7w
• Context Menu and Tile Mapping: https://youtu.be/g5xTNY93Hqg
• New And Improved Features: https://youtu.be/JRysqbXFJS4

Building

Only supports 64bit systems. Windows 10 and Ubuntu are the only officially supported OS. MacOS is not supported.

Windows:

You will need to install at least Visual Studio 2019 16.11 Preview 3, and set the Win-SDK minimum version to 10.0.19041.0.

Make sure C++ desktop development, cmake tools, linux development, and game development with C++ are enabled when installing.

git clone --recursive https://github.com/DomRe/galaxy.git galaxy_engine
git submodule update --init --recursive
cd galaxy_engine
cmake -G "Visual Studio 16 2019" -DCMAKE_BUILD_TYPE=Release -DGALAXY_BUILD_TESTS=ON -DGALAXY_ENABLE_DOXYGEN=OFF -Bbuild -H.
cd build
msbuild galaxy_engine.sln

OR open galaxy_engine.sln and press F5 to build.

Linux:

This has only been tested on Ubuntu 21.04.

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update
sudo apt upgrade
sudo apt install make build-essential perl dkms git manpages-dev software-properties-common gcc gcc-11 g++-11 cmake libfreetype-dev libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev libasound2-dev libglu1-mesa-dev doxygen
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 110 --slave /usr/bin/g++ g++ /usr/bin/g++-11 --slave /usr/bin/gcov gcov /usr/bin/gcov-11
git clone --recursive https://github.com/DomRe/galaxy.git galaxy_engine
cd galaxy_engine
cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DGALAXY_BUILD_TESTS=ON -DGALAXY_ENABLE_DOXYGEN=OFF -Bbuild -H.
cd build
make all

Documentation

See online documentation.

Or generate offline with Doxygen, with ENABLE_DOXYGEN set to ON:

cmake -DGALAXY_ENABLE_DOXYGEN=ON -Bbuild -H.
cd build
make doxygen

Features

• Uses Modern C++ design principles, built on C++20.
• Tiled map editor parsing.
• Modern Core OpenGL renderer.
• Platform abstraction.
• Audio streaming.
• Entity component System.
• Fast Logging.
• Physics Engine.
• Event Dispatcher.
• JSON support.
• Lua Scripting.
• GUI.
• Development Toolset.
• Resource Management.
• Filesystem Management.
• Application Management.

Tiled Implementation.

• Supported:
  • Tiled 1.4.3 .json maps.
  • Loading maps from Tiled Worlds.
  • Base64 encoding.
  • zlib compression.
  • gzip compression.
• Limitations:
  • Only renders right-down maps.
  • Only renders topdown objects.
• Unsupported:
  • Tiled projects.
  • External Tiled assets.
  • Text objects.
  • Terrain.
  • Wang-Sets.
  • Tile Flipping.

Contributing / Feedback / Issues

Feel free to open an issue for feedback, bug reports, ehancements, issues, etc, and pull requests for contributions. (Don't forget to add yourself to the credits section below.)

Credits

• Uses SMAA. Copyright (C) 2011 by Jorge Jimenez, Jose I. Echevarria, Belen Masia, Fernando Navarro and Diego Gutierrez.
• doxygen-dark-theme.
• sercode.ttf.
  • Used in various icons and logos.
• galaxy image.
  • Image Credit: ESA/Hubble & NASA, A. Filippenko.
  • See NASA media guidelines.
  • Used for non-commerical purposes.
• Supercluster Icon and Logo.
  • Image Credit: NASA/JPL-Caltech/University of Wisconsin
  • See NASA media guidelines.
  • Used for non-commerical purposes.
• Any "dependency" i.e. "software library" will have an associated LICENSE.txt/COPYING.txt file included.
• Resources used in sandbox:
  • Various from OpenGameArt. No copyright infringement intended.
• https://learnopengl.com/
• https://skypjack.github.io/2019-02-14-ecs-baf-part-1/
• https://skypjack.github.io/2019-03-21-ecs-baf-part-2-insights/
• https://skypjack.github.io/2019-06-25-ecs-baf-part-4/
• https://skypjack.github.io/2019-09-25-ecs-baf-part-5/
• https://www.computist.xyz/2018/06/sparse-sets.html
• https://www.geeksforgeeks.org/sparse-set/
• https://indiegamedev.net/2020/02/25/the-complete-guide-to-openal-with-c-part-2-streaming-audio/
• https://indiegamedev.net/2020/01/16/how-to-stream-ogg-files-with-openal-in-c/
• https://gist.github.com/tilkinsc/f91d2a74cff62cc3760a7c9291290b29
• https://github.com/ocornut/imgui/issues/707
• https://github.com/SSBMTonberry/tileson/
• https://github.com/RandyGaul/cute_headers/
• https://github.com/Asmodean-/SMAA-OpenGL/
• https://gamedevelopment.tutsplus.com/tutorials/quick-tip-use-quadtrees-to-detect-likely-collisions-in-2d-space–gamedev-374
• https://github.com/lettier/3d-game-shaders-for-beginners