| (_) |       | |           | |           
 _ __ __ _ _   _| |_| |__  ___| |_ __ _ _ __| |_ ___ _ __ 
| '__/ _` | | | | | | '_ \/ __| __/ _` | '__| __/ _ \ '__|
| | | (_| | |_| | | | |_) \__ \ || (_| | |  | ||  __/ |   
|_|  \__,_|\__, |_|_|_.__/|___/\__\__,_|_|   \__\___|_|   
            __/ |                                         
           |___/  

raylibstarter - minimal letterbox edition

A simple raylib project template for CMake and C/C++ including letterbox rendering and a fullscreen mode.

Usage

Use CMake or a CMake compatible development environment to build a minimalistic raylib project. The raylib library will be downloaded automatically by CMake.

Changing the project title and version number

The project name and version number can be customized in the src/CMakeLists.txt file. By default, the project name is 'game':

project(game VERSION 0.1 LANGUAGES CXX)

Change the window size and switch to fullscreen

The initial width and height of the output window can be adjusted in the src/config.h.in file.

By removing the comment

//#define GAME_START_FULLSCREEN

the project starts in full screen mode.

While running the user can change the window size with the OS's regular means and switch to fullscreen with left alt + enter.

Manage assets

Store assets in the designated 'assets' folder. The project already contains a sample graphic file. In the main.cpp file, this image is loaded and displayed.

Choose a different raylib version

Which raylib version is used can be specified in the cmake/raylib.cmake file. If this is changed after CMake has already created the project once, you must use CMake to completely rebuild the project.

What next?

Modify the main.cpp file according to your needs.

Create a binary distribution

The cpack command can be used on the command line to create a binary distribution of the project, for example:

cpack -G ZIP -C Debug

All assets will be packed into the distribution.

License

see LICENCE file for details.