mirror of https://github.com/rusefi/jzy3d-api.git
70 lines
3.5 KiB
Markdown
70 lines
3.5 KiB
Markdown
jzy3d-main
|
|
==========
|
|
|
|
This is a main Git repository for Jzy3d providing multiple maven modules.
|
|
|
|
Travis build status : [![Build Status](https://travis-ci.org/jzy3d/jzy3d-api.svg?branch=master)](https://travis-ci.org/jzy3d/jzy3d-api)
|
|
|
|
|
|
|
|
|
|
API and modules
|
|
-----------------------------------
|
|
- <a href="https://github.com/jzy3d/jzy3d-api/blob/master/jzy3d-tutorials">jzy3d-tutorials</a> : few examples for building main chart families (surfaces, scatters, etc).
|
|
|
|
Application will require <a href="https://github.com/jzy3d/jzy3d-api/blob/master/jzy3d-api/src/api">jzy3d-api</a> <i>plus</i> 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):
|
|
- <a href="https://github.com/jzy3d/jzy3d-api/blob/master/jzy3d-api/src/awt">jzy3d-awt</a> : provides AWT canvases (source folder separation but part of jzy3d-api build)
|
|
- <a href="https://github.com/jzy3d/jzy3d-api/blob/master/jzy3d-api/src/swing">jzy3d-swing</a> : provides Swing canvases (source folder separation but jzy3d-api build)
|
|
- <a href="https://github.com/jzy3d/jzy3d-api/blob/master/jzy3d-swt">jzy3d-swt</a> : provides a wrapper on AWT canvas to embed a chart in a SWT application.
|
|
- <a href="https://github.com/jzy3d/jzy3d-api/blob/master/jzy3d-jdt-core">jzy3d-jdt-core</a> : 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:
|
|
- <a href="https://github.com/jzy3d/jzy3d-extensions">jzy3d-extensions</a> : 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:
|
|
<pre>
|
|
<code>
|
|
<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>
|
|
</code>
|
|
</pre>
|
|
|
|
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
|