+0
Daily
5,741
stars
815
forks
232
watchers
220
prs
463
issues
0
releases
README
This project is not actively maintained. NanoVG ========== NanoVG is small antialiased vector graphics rendering library for OpenGL. It has lean API modeled after HTML5 canvas API. It is aimed to be a practical and fun toolset for building scalable user interfaces and visualizations. Screenshot !screenshot of some text rendered witht the sample program Usage ===== The NanoVG API is modeled loosely on HTML5 canvas API. If you know canvas, you're up to speed with NanoVG in no time. Creating drawing context The drawing context is created using platform specific constructor function. If you're using the OpenGL 2.0 back-end the context is created as follows: C define NANOVG_GL2_IMPLEMENTATION // Use GL2 implementation. include "nanovg_gl.h" ... struct NVGcontext vg = nvgCreateGL2(NVG_ANTIALIAS | NVG_STENCIL_STROKES); The first parameter defines flags for creating the renderer. - NVG_ANTIALIAS means that the renderer adjusts the geometry to include anti-aliasing. If you're using MSAA, you can omit this flags. - NVG_STENCIL_STROKES means that the render uses better quality rendering for (overlapping) strokes. The quality is mostly visible on wider strokes. If you want speed, you can omit this flag. Currently there is an OpenGL back-end for NanoVG: nanovg_gl.h for OpenGL 2.0, OpenGL ES 2.0, OpenGL 3.2 core profile and OpenGL ES 3. The implementation can be chosen using a define as in above example. See the header file and examples for further info. NOTE: The render target you're rendering to must have stencil buffer. Drawing shapes with NanoVG Drawing a simple shape using NanoVG consists of four steps: 1) begin a new shape, 2) define the path to draw, 3) set fill or stroke, 4) and finally fill or stroke the path. C nvgBeginPath(vg); nvgRect(vg, 100,100, 120,30); nvgFillColor(vg, nvgRGBA(255,192,0,255)); nvgFill(vg); Calling nvgBeginPath() will clear any existing paths and start drawing from blank slate. There are number of number of functions to define the path to draw, such as rectangle, rounded rectangle and ellipse, or you can use the common moveTo, lineTo, bezierTo and arcTo API to compose the paths step by step. Understanding Composite Paths Because of the way the rendering backend is build in NanoVG, drawing a composite path, that is path consisting from multiple paths defining holes and fills, is a bit more involved. NanoVG uses even-odd filling rule and by default the paths are wound in counter clockwise order. Keep that in mind when drawing using the low level draw API. In order to wind one of the predefined shapes as a hole, you should call nvgPathWinding(vg, NVG_HOLE), or nvgPathWinding(vg, NVG_CW) _after_ defining the path. C nvgBeginPath(vg); nvgRect(vg, 100,100, 120,30); nvgCircle(vg, 120,120, 5); nvgPathWinding(vg, NVG_HOLE); // Mark circle as a hole. nvgFillColor(vg, nvgRGBA(255,192,0,255)); nvgFill(vg); Rendering is wrong, what to do? - make sure you have created NanoVG context using one of the nvgCreatexx
Top issues
#614Vulkan support25 comments · 2021-05-13#55Font not works23 comments · 2014-04-01#403Java2D, SVG shapes to NVG20 comments · 2017-08-18#216what's NVGpathCache?19 comments · 2015-04-05#197Any facility to hit test on stroke and fill path?18 comments · 2015-02-06#269How to draw from my own array of pixels?12 comments · 2016-02-24#627NanoVG string width13 comments · 2022-04-21#371Performances and display lists13 comments · 2017-05-19