Skip to content
libtess2 wrapper for Nim
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Nimtess2 is a Nim wrapper for libtess2.

Nimtess2 is distributed as a Nimble package and depends on nimgen and c2nim to generate the wrappers. The libtess2 source code is downloaded using Git so having git in the path is required.


Nimtess2 can be installed via Nimble:

> nimble install nimtess2

This will download, wrap and install nimtess2 in the standard Nimble package location, typically ~/.nimble. Once installed, it can be imported into any Nim program.


Module documentation can be found here.

import nimtess2/tesselator

  ma: TESSalloc
  tess: ptr TESStesselator

proc stdAlloc*(userData: pointer; size: cuint): pointer {.stdcall.} =
  return alloc(size)

proc stdFree*(userData: pointer; `ptr`: pointer) {.stdcall.} =

ma.memalloc = stdAlloc
ma.memfree = stdFree

tess = tessNewTess(addr ma)

tessSetOption(tess, 0, 1);

Refer to the tests directory for examples on how the library can be used.


Nimtess2 wraps the libtess2 source code and all licensing terms of libtess2 apply to the usage of this package.

Credits go out to c2nim as well without which this package would be greatly limited in its abilities.


Nimtess2 is a work in progress and any feedback or suggestions are welcome. It is hosted on GitHub with an MIT license so issues, forks and PRs are most appreciated.

You can’t perform that action at this time.