A Java API for 3d charts
Java GLSL Other

README.md

jzy3d-main

This is a main Git repository for Jzy3d providing multiple maven modules.

Travis build status : Build Status

API and modules

  • jzy3d-tutorials : few examples for building main chart families (surfaces, scatters, etc).

Application will require jzy3d-api plus classes to address a specific windowing environement (AWT, SWT, Swing). The API itself has no dependency to AWT, making it buildable for Android environement.

Code specific to a target windowing environement is made available through modules (or sometime source folder separation):

  • jzy3d-awt : provides AWT canvases (source folder separation but part of jzy3d-api build)
  • jzy3d-swing : provides Swing canvases (source folder separation but jzy3d-api build)
  • jzy3d-swt : provides a wrapper on AWT canvas to embed a chart in a SWT application.
  • jzy3d-jdt-core : a clone of JDT, for Java Delaunay Triangulation

The API has optional extensions bundled by a parent and several children module stored in separated Git repositories:

  • jzy3d-extensions : gather 5 optional modules that may be checkout separately as well (Depth peeling, Graphs, G2D, )

Jzy3d Maven Repository

  • Release versions WILL stand on maven central
  • Snapshot versions stand on Jzy3d maven repository:
    
    <repositories>
    <repository>
       <id>jzy3d-snapshots</id>
       <name>Jzy3d Snapshots</name>
       <url>http://maven.jzy3d.org/snapshots </url>
    </repository>
    <repository>
       <id>jzy3d-releases</id>
       <name>Jzy3d Snapshots</name>
       <url>http://maven.jzy3d.org/releases </url>
    </repository>
    </repositories>
    
    

Building the projects with Maven

Build all module from master repository by calling

  • mvn install

To be friendly with Eclipse-but-non-Maven users, we add .project and .classpath files to the repositories. If you want to regenerate this files with maven and have the projects linked all together, simply run

  • mvn eclipse:eclipse -Declipse.workspace=~[your current eclipse workspace folder]
  • then edit jzy3d-api project properties to export all dependencies to other projects (Properties > Java Build Path > Order and Export > Select All. Then remove JRE System libraries).

Building the projects without Maven

We kept the repository easy to use for non-maven users.

  • Eclipse project files (.project & .classpath) with inter-project relations are commited to the repositories
  • Some modules have a lib/ directory containing required Jars. If you want to use these jars, simply edit the libraries dependencies of the Eclipse project to use them instead of the maven dependencies.

License

New BSD

More information

http://www.jzy3d.org