Getting Started

This website explain how to use Jzy3D framework to build 3D charts for Java applications.

You will find 3 main sections

  • This Getting Started pages, providing code samples to draw your first 3D and 2D charts in Java and configure project to get all dependencies. They are intended for developers willing to get started quickly.
  • The User Guide chapters explaining the features of the framework. All code samples demonstrating these features can be purchased here.
  • The Developer Guide helps understand the internal architecture of the framework to help developers improving it.

Configure dependencies

Jzy3D can be retrieved with Maven. We here describe what your pom.xml file should contain to get started

Add reference to the Maven repository

The repositories definition must be located under the project tag

<project>
  ...
  <repositories>
    <repository>
      <id>jzy3d-snapshots</id>
      <name>Jzy3d Snapshots</name>
      <url>https://maven.jzy3d.org/snapshots/</url>
    </repository>
    <repository>
      <id>jzy3d-releases</id>
      <name>Jzy3d Releases</name>
      <url>https://maven.jzy3d.org/releases/</url>
    </repository>
  </repositories>
<project>

Add a reference to all artifacts

<dependencies>
  <dependency>
    <groupId>org.jzy3d</groupId>
    <artifactId>jzy3d-everything</artifactId>
    <version>2.1.1-SNAPSHOT</version>
  </dependency>
</dependencies>

Add a reference to native libraries

If you only want to use traditional GPU rendering with JOGL, you will have to define it per target windowing toolkit

For native OpenGL in AWT

<dependency>
    <groupId>org.jzy3d</groupId>
    <artifactId>jzy3d-native-jogl-awt</artifactId>
    <version>2.1.0</version>
</dependency>

For native OpenGL in Swing

<dependency>
    <groupId>org.jzy3d</groupId>
    <artifactId>jzy3d-native-jogl-swing</artifactId>
    <version>2.1.0</version>
</dependency>

For native OpenGL in SWT

<dependency>
    <groupId>org.jzy3d</groupId>
    <artifactId>jzy3d-native-jogl-swt</artifactId>
    <version>2.1.0</version>
</dependency>

Add a reference to non native libraries

If you only want to use fallback CPU rendering with EmulGL, you will have to define

<dependency>
    <groupId>org.jzy3d</groupId>
    <artifactId>jzy3d-emul-gl-awt</artifactId>
    <version>2.1.0</version>
</dependency>