This and other 15-466 base code is built around a collection of useful libraries and functions which we will collectively call "nest". This name captures the goal of having the various parts and functions relatively easy to reconfigure (and remove), while still forming a good support for your game.
What Is Included + New
Here is a quick overview of what is included. For further information, ☺read the code☺ !
- Base code (files you will certainly edit):
main.cppcreates the game window and contains the main loop. Set your window title, size, and initial Mode here.
MenuMode.*ppdeclaration+definition for a sprite-based menu. New: text drawing included. New: menu movement sounds.
StoryMode.*ppdeclaration+definition for demo story mode. You'll probably adapt this to do something else entirely. New: background music loading and playing.
Sound.*ppa basic game audio system. You may wish to add extra parameters (like looping) to sounds.
Jamfileresponsible for telling FTJam how to build the project. Change this when you add additional .cpp files and to change your runtime executable's name.
.gitignoreignores generated files. You will need to change it if your executable name changes. (If you find yourself changing it to ignore, e.g., your editor's swap files you should probably, instead be investigating making this change in the global git configuration.)
- Useful code (files you should investigate, but probably won't change):
load_wav.*ppload audio data from wav files.
load_opus.*ppload audio data from opus files.
Load.*ppdeferred resource loading.
data_path.*ppget paths relative to the game's directory.
read_write_chunk.hppsimple helper to load/save data arrays.
Sprite.*ppruntime component of a sprite asset pipeline.
DrawSprites.*pphelper for drawing
Sprites from the same
draw_textincluded. New: pixel-perfect alignment mode included.
Mode.hppbase class for modes (things that recieve events and draw).
ColorTextureProgram.hppexample OpenGL shader program, wrapped in a helper class.
gl_compile_program.hpphelper function to compiles OpenGL shader programs.
load_save_png.hpphelper functions to load and save PNG images.
GL.hppincludes OpenGL 3.3 prototypes without the namespace pollution of (e.g.) SDL's OpenGL header; on Windows, deals with some function pointer wrangling.
sprites/extract-sprites.pyutilities used in the sprite asset pipeline. See the README.
- Here be dragons (files you probably don't need to look at):
make-GL.pydoes what it says on the tin. Included in case you are curious. You won't need to run it.
This code is set up to build across Linux, Windows, and MacOS.
Building will be done from the command prompt, using FTJam, the freetype project's fork of Perforce's excellent "Jam" build tool (Documentation page at Perforce, for the curious).
To add or remove files from the build, read and edit the Jamfile.
Setup for your development environment should be relatively simple:
- (Optional) Make sure your system is set up to make it easy to use your favorite code editor and git from the command prompt. So much nicer than using a GUI.
- Install one of our target C++ compilers:
- Linux: g++
- MacOS: clang++ (from XCode)
- Windows: Visual Studio Community 2019
- Install ftjam from your OS's package manager:
- Linux: e.g.
sudo apt-get install ftjam
- MacOS: e.g.
brew install ftjam
- Windows: (skip this step; jam for windows is included in the nest-libs package)
- Linux: e.g.
- Extract an appropriate release of nest-libs to a sibling of this folder:
Once you are finished, your directory tree should looks something like this:
game-programming/ #can be called anything nest-libs/ #nest-libs from that repository's releases page windows/ #subdirectory name varies depending on platform ... my-game/ #fork of this code; can be called anything ... ... #eventually, you will have further subdirectories for other games
Once you have your development environment set up, building is as simple as opening a command prompt (see Windows Note below), changing to the game directory, and running
Here are a few worthwhile variations:
# Note: Always build from the game's root folder: $ cd game-programming $ cd my-game # Simplest build command: $ jam # Variation: multiple (six, in this case) build jobs in parallel: $ jam -j6 # Variation: quit if any build job fails: $ jam -q # Variation: run game if build succeeds: $ jam && dist/CookMap # Variation: show commands being run (useful for debugging the Jamfile): $ jam -dx # Useful: show summary of jam flags: $ jam -h # Variation: this is what I generally use: $ jam -q -j6 && dist/CookMap # Useful: delete all built files: $ jam clean
Windows Note: a pre-compiled
jam.exe and a .bat file + .lnk to launch a VS2019 command prompt with jam in the
%PATH% are included in the
nest-libs/windows/tools/ directory. The README.md in that folder explains how to use them.