Jeongyong-park / SFCGAL4J

Java wrapper for Simple Feature CGAL(SFCGAL) on Maven environment

SFCGAL for Java

Java wrapper for Simple Feature CGAL (SFCGAL) which is a C++ wrapper library around CGAL with the aim of supporting ISO 19107:2013 and OGC Simple Features Access 1.2 for 3D operations. Since SFCGAL is C++ library, this module employs JavaCPP as a bridge between C++ and Java. Due to dependency on SFCGAL, there exist limitations such as supported platforms. If you need 3D operations in gt-geometry, you have to install SFCGAL manually.

Documentation

• User Guide - unavailable now
• Java Doc

Supported platform

• GNU/Linux

Prerequisites

• JDK 8 or newer
• CMake
• GMP
• MPFR
• Boost, CGAL, SFCGAL
• (Optional) OpenSceneGraph

License of third party libraries

• SFCGAL is distributed under the terms of the LGPL(v2+).
• Starting from release 4.0. CGAL is available under the GPL(v3+)/LGPL(v3+).
• JavaCPP is available under Apache License(v2.0)/GPL(v2+) with "Classpath" exception.

Building

This project uses Apache Maven. To build this project run maven from the root of the repository. Boost, CGAL and SFCGAL libraries will be installed automatically. If you don't want to install it, set javacpp.cppbuild.skip=True

mvn clean install

Usage

After building this project, insert following a dependency code to pom.xml in your maven project.

  <dependency>
    <groupId>edu.pnu.stemlab</groupId>
    <artifactId>sfcgal4j-platform</artifactId>
    <version>1.0.0-SNAPSHOT</version>
  </dependency>

Note

This project is based on SFCGAL and JavaCPP

Authors

• Hyung-Gyu Ryoo / Pusan National University ([e-mail])
• Donguk Seo / Pusan National University ([e-mail])