2D constrained Delaunay triangulation library
Go to file
Jan Niklas Hasse e9938d9c68
Merge pull request #22 from pierre-dejoue/master
Add documentation and code patches for maintenability
2020-10-26 20:18:51 +00:00
.github/workflows Add CMake files for the unit tests 2020-08-27 19:16:17 +02:00
.vscode Add debug configurations for VSCode 2020-10-19 18:27:52 +02:00
doc Add references section to README 2020-10-26 20:58:49 +01:00
poly2tri Add references section to README 2020-10-26 20:58:49 +01:00
testbed Add headers in project files generated by cmake 2020-10-26 12:07:44 +01:00
unittest Triangle::NeighborAcross to return a pointer 2020-10-26 20:58:23 +01:00
.clang-format Add .clang-format 2020-10-19 18:24:46 +02:00
.gitignore Update waf to 2.0.19 2019-11-30 14:03:43 +01:00
AUTHORS modified Authors file 2010-01-30 13:10:18 -05:00
CMakeLists.txt Add headers in project files generated by cmake 2020-10-26 12:07:44 +01:00
LICENSE Change BSD-3 license formatting a little bit so that GitHub detects it 2018-09-11 13:00:49 +02:00
meson.build Add CMake files for the unit tests 2020-08-27 19:16:17 +02:00
README.md Add references section to README 2020-10-26 20:58:49 +01:00
waf Update waf to 2.0.19 2019-11-30 14:03:43 +01:00
wscript Update waf to 1.8.20 2016-04-13 17:56:42 +02:00

Since there are no Input validation of the data given for triangulation you need to think about this. Poly2Tri does not support repeat points within epsilon.

  • If you have a cyclic function that generates random points make sure you don't add the same coordinate twice.
  • If you are given input and aren't sure same point exist twice you need to check for this yourself.
  • Only simple polygons are supported. You may add holes or interior Steiner points
  • Interior holes must not touch other holes, nor touch the polyline boundary
  • Use the library in this order:
    1. Initialize CDT with a simple polyline (this defines the constrained edges)
    2. Add holes if necessary (also simple polylines)
    3. Add Steiner points
    4. Triangulate

Make sure you understand the preceding notice before posting an issue. If you have an issue not covered by the above, include your data-set with the problem. The only easy day was yesterday; have a nice day.

TESTBED INSTALLATION GUIDE

Dependencies

Core poly2tri lib:

  • Standard Template Library (STL)

Testbed:

  • gcc
  • OpenGL
  • GLFW
  • Python

waf is used to compile the testbed. A waf script (86kb) is included in the repositoty.

Building the Testbed

Posix/MSYS environment:

./waf configure
./waf build

Windows command line:

python waf configure
python waf build

Alternatively, the testbed can be built using cmake. See below.

Running the Examples

Load data points from a file:

p2t <filename> <center_x> <center_y> <zoom>

Random distribution of points inside a constrained box:

p2t random <num_points> <box_radius> <zoom>

Examples:

./build/p2t testbed/data/dude.dat 300 500 2
./build/p2t testbed/data/nazca_monkey.dat 0 0 9

./build/p2t random 10 100 5.0
./build/p2t random 1000 20000 0.025

BUILD WITH CMAKE

Build the library

mkdir build && cd build
cmake -GNinja
cmake --build .

Build and run the unit tests

mkdir build && cd build
cmake -GNinja -DP2T_BUILD_TESTS=ON
cmake --build .
ctest --output-on-failure

Build the testbed

mkdir build && cd build
cmake -GNinja -DP2T_BUILD_TESTBED=ON
cmake --build .

References

  • Domiter V. and Zalik B. (2008) Sweepline algorithm for constrained Delaunay triangulation
  • FlipScan by library author Thomas Åhlén

FlipScan