Lapiz

A general purpose 2d canvas for c++

Description

Lapiz is a very simple 2d header only graphics library for c++. It was created to quickly prototype simple graphic ideas. This is possible through the use of the simple but effective .ppm file format.

Getting Started

Dependecies

• CMake version >= 3.14.4
• clangd version >= 9.00

Installing

• Clone the repository in a desired location

Executing Program

• create a build directory:

mkdir build

• Navigate to build directory

cd build

• execute the command:

cmake -S ../ -B .

• a makefile will be generated, compile the program:

make

• run the program:

./Lapiz

Examples

Generating lines:

#include "lapiz.hpp" 
#include <iostream>

int main(int argc, const char * argv[]) {
    lpz::lapiz canvas(800, 800, "lines.ppm");
    canvas.fill_canvas(lpz::BLACK);

    canvas.draw_line(0, 0, canvas.getSize().width, canvas.getSize().height, lpz::YELLOW);
    canvas.draw_line(0, canvas.getSize().height, canvas.getSize().width, 0, lpz::GREEN);
    canvas.draw_line(0, canvas.getSize().height/2, canvas.getSize().width, canvas.getSize().height/2, lpz::LIGHTPINK);

    canvas.write();
    return 0;
}

will produce the lines.ppm file which when converted to a .png looks like:

Generating rows and cols of circles

#include "lapiz.hpp" 
#include <iostream>

int main(int argc, const char * argv[]) {
    int row{2}, col{2};
    lpz::lapiz canvas(800, 800, "circles.ppm");
    canvas.fill_canvas(lpz::BLACK);

    for(int i = 1; i <= row; i++){
        for(int j = 1; j <= col; j++){
            lpz::circle circ ((canvas.getSize().width/row/2), lpz::PURPLE);
            canvas.fill_circle((i-1)*(canvas.getSize().width/col), (j-1)*(canvas.getSize().height/row), circ);
        }
    }

    canvas.write();
    return 0;
}

will produce the circle.ppm file which when converted to a .png looks like:

Generating a checkerboard:

#include "lapiz.hpp" 
#include <iostream>

int main(int argc, const char * argv[]) {
    int row{8}, col{8};
    lpz::lapiz canvas(800, 800, "checkerboard.ppm");
    canvas.fill_canvas(lpz::DARKPINK);

    for(int i = 0; i < row; i++){
        for(int j = 0; j < col; j++){
            if(i % 2 == 0 && j % 2 == 0){
                canvas.fill_rect(j*canvas.getSize().width/col, i*canvas.getSize().height/row,
                                 lpz::rectangle(canvas.getSize().height/row, canvas.getSize().width/col, lpz::LIGHTPINK));
            }else if(i % 2 == 1 && j % 2 == 1){
                canvas.fill_rect(j*canvas.getSize().width/col, i*canvas.getSize().height/row,
                                 lpz::rectangle(canvas.getSize().height/row, canvas.getSize().width/col, lpz::LIGHTPINK));
            }
        }
    }
    canvas.write();
    return 0;
}

will produce the checkerboard.ppm file which when converted to a .png looks like:

To Do

• Support for triangles
• Support for polinomials
• Support for arcs/curving lines

Authors

Alexis Rodriguez aka alexisM8

Licence

This project is licensed under the MIT License - see the LICENSE.md file for details