Console Graphics Library 🔮

open-source rendering engine for console 🖥

Philosophy

ConGL is created for developers that wanted to create retro-style console apps or games. The main goal of the project was to create a simple API that will let you do anything in your console keeping your code clean and beautiful, even in big projects.

As said before, ConGL is very simple to use, so it will be also helpful for begginers to create starting interactive projects to gain some experience.

Documentation

Screen

// ConGL namespace
Screen screen;

screen.setFont({5, 5});  // set console font size
screen.toggleAutosize(true);  // apodt automatically to the new console size
screen.toggleMeta(true);  // outputs metadata

// surface is a boundary for screen
// it allows you to have space where everything will be drawn
// surface is always placed in the middle of console
COORD newSurface = {30, 30};

// now we apply our surface to the screen
screen.setSurfaceSize(newSurfaceSize);

Figures are objects that are being drawn on the screen. There are few figure types (rectangle, ellipse, sprite).

shapes::Rectangle rect({10, 10});  // rectangle with size of 10 x 10

// we can move our rectangle 
rect.movePos({5, 5});  // X + 5, Y + 5

// we can set its size
rect.setSize({7, 7});


// pixel with 'G' character and purple background
PIXEL fill(L'G', colors::BG::BLUE | colors::BG::RED); 

// and we can set its filling
rect.setFilling(fill);

Layout

// eng2D namespace 
Layout main(&screen);

// on the layout are placed all objects that will be drawn
int id = main.addFigure(&rect);

// also we may want to disable it 
main.disableFigure(id);

// and enable it back
main.enableFigure(id);

// finally draw our rectangle!
main.draw();

Now we can combine everything we learned so far and write a small program which draws rectangle

#include "congl.h"
using namespace ConGL;
using namespace eng2D;

int main() {
    Screen screen;  
    screen.toggleAutosize(true);

    Layout main(&screen);
    shapes::Rectangle rect({30, 30});
    main.addFigure(&rect); 
    
    // create loop for drawing our beatiful rectangle
    while (true) {
        // terminate when escape is pressed
        if (keys::released(VK_ESCAPE)) break;

        main.draw();
    }
}

If you compile using binary add #define BIN_LINK before including congl.h

---

Python ConGL

Now you can use ConGL API in python. See readme

Textures

ConGL sprites can use either self-defined textures (like is shown in this example) or .txr files (check out textures)

Reference

Full ConGL reference

Contributing

If you really wish to contribute see contributing 🤗

Other

Some ConGL projects