Home

Awesome

Tarp (v0.1.6)

Overview

Tarp is an almost single header C library to raster vector graphics. It provides a lightweight and portable API purely focussed on decently fast rendering without any gimmicks.

<p align="center"><img src="https://user-images.githubusercontent.com/10217168/40217212-6e979956-5a20-11e8-9012-0c30483df8a7.gif" alt="tarp demo" width="322px"/></p>

What can Tarp do?

What does Tarp not want to provide?

Basic usage

Install Tarp or add the Tarp folder to your source directory. Include it into your project with #include <Tarp/Tarp.h>. Specify the implementation you want to compile in one c/c++ file to create the implementation, i.e.:

/* include OpenGL here! */

/* tell Tarp to compile the opengl implementations */
#define TARP_IMPLEMENTATION_OPENGL
#include <Tarp/Tarp.h>

Here is a basic Tarp example:

tpContext ctx;
tpPath path;
tpStyle style;
tpMat4 proj;

/* initialize the tarp context */
ctx = tpContextCreate();
if (!tpContextIsValidHandle(ctx))
{
    printf("Could not init Tarp context: %s\n", tpErrorMessage());
    return EXIT_FAILURE;
}

/* set an orthographic projection based on the window size */
proj = tpMat4MakeOrtho(0, wwidth, wheight, 0, -1, 1);
tpSetProjection(ctx, &proj);

/* create a path and add one circle contour */
path = tpPathCreate();
tpPathAddCircle(path, 400, 300, 100);

/* add another custom contour to the path */
tpPathMoveTo(path, 400, 320);
tpPathLineTo(path, 420, 280);
tpPathQuadraticCurveTo(path, 400, 260, 380, 280);
tpPathClose(path); /* close the contour */

/* create a style that we can draw the path with */
style = tpStyleMake();
style.fill = tpPaintMakeColor(1.0f, 1.0f, 0.0f, 1.0f);
style.stroke = tpPaintMakeColor(1.0f, 0.6f, 0.1f, 1.0f);
style.strokeWidth = 10.0;
style.strokeJoin = kTpStrokeJoinRound;

/* ... */

/* call this at the beginning of your frame */
tpPrepareDrawing(ctx);

/* draw the path with our style */
tpDrawPath(ctx, path, &style);

/* call this when you are done with Tarp for the frame */
tpFinishDrawing(ctx);

/* ... */

/* clean up tarp */
tpPathDestroy(path);
tpContextDestroy(ctx);

Check out HelloWorld.c in the examples folder for the full source of this example using OpenGL and GLFW.

Building the examples using CMake

cd Tarp
mkdir build
cd build
cmake ..
make

Building the examples using Meson & Ninja

cd Tarp
meson build
cd build
ninja

Installing Tarp

If you use Tarp a lot and you'd prefer to have it installed, you can do it in one of the following ways: make install if you are using CMake and ninja install if you are using Meson.

TODO

How does Tarp rasterize

The only available backend right now is one written in OpenGL. It is based on the stencil and cover method.

Supported Platforms

Any platform that supports OpenGL 3.0+. Tested on OSX, Linux and Windows so far.

Credits & Inspiration

License

MIT License:

Copyright (c) 2018 Matthias Dörfelt

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.