Skip to content

SatvikR/LCGE

Repository files navigation

LCGE

     ___       ________  ________  _______
    |\  \     |\   ____\|\   ____\|\  ___ \
    \ \  \    \ \  \___|\ \  \___|\ \   __/|
     \ \  \    \ \  \    \ \  \  __\ \  \_|/__
      \ \  \____\ \  \____\ \  \|\  \ \  \_|\ \
       \ \_______\ \_______\ \_______\ \_______\
        \|_______|\|_______|\|_______|\|_______| v1.1.0

A Lightweight C game engine built with OpenGL.

Docs

TOC

Capabilities

  • Create a window
  • Maintain an FPS
  • Render 2D rectangles
  • Render 2D images
  • Render 2D lines
  • Rotate 2D rectangles and images
  • Get keyboard input
  • Get mouse input
  • Load truetype fonts
  • Render text
  • More coming soon!

Build From Source

  1. Clone
git clone --recursive https://github.com/SatvikR/LCGE.git
  1. Build using CMake
cmake -B ./build .
cmake --build ./build

Make sure you link with LCGE (shared), glad, and glfw

Basic usage

Look here for specific exaxmples

#include <LCGE/lcge.h>

int main(int argc, char const *argv[])
{
    // Initialize LCGE with the path to the res directory of LCGE (specific to you)
    if (lcge_init("vendor/LCGE/res") == LCGE_INIT_ERR)
    {
        lcge_exit();
        return -1;
    }

    // Create a window
    int success = lcge_create_context(500, 500, "LCGE Example",
                                      LCGE_NON_RESIZEABLE);

    // Create clock with a max fps
    LCGE_clock *clock = lcge_clock_create(60);

    // Check if there was an error creating the window
    if (success == LCGE_CONTEXT_ERR)
    {
        lcge_exit();
        return -1;
    }

    while (lcge_window_is_open())
    {
        // Do any udpating here

        // Do any drawing here
        lcge_window_clear();

        // Get ready for next iteration
        lcge_clock_tick(clock);
        lcge_window_update();
    }

    // Clean up
    lcge_clock_delete(clock);

    lcge_exit();

    return 0;
}

License(s)

LCGE is licensed under the GNU Lesser General Public License v2.1

Copyright (c) 2021 Satvik Reddy

A brief summary of the license:

  • You can use LCGE in any project, though if its closed source, you must dynamically link with LCGE
  • If you make changes/additions to LCGE, they must be released with an LGPL compatible license (though I prefer you submit your changes back to this repository)
  • More info in the LICENSE file in the root of the source tree

Dependencies

Dependency License
GLFW zlib/libpng
glad Public Domain/WTFPL/CC0
stb MIT/Public Domain