Console Graphics Library 🔮
open-source rendering engine for console 🖥
Philosophy
ConGL is created for developers that needed a simple API for rendering in console. This library can be used for any purposes (from game engine, to outputing images) The main goal of the project was to create a simple API that will keep your code clean even in big projects.
As said before, ConGL is very simple to use, so it will be also helpful for begginers to create simple projects.
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 with binary add #define BIN_LINK before including congl
ConGL on Python
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
