Skip to content

DJUTILS DRAW project

The DJUTILS-DRAW project contains packages for handling points, poly-lines, line-segments, rays, in 2D and 3D. All objects in DJUTILS-DRAW (except the Transformations) are immutable. This is in major contrast to the java.awt.geom package where almost everything is mutable. In DJUTILS-DRAW, all coordinates are internally stored as double values. We do not intend to provide float versions.

DJUTILS-DRAW consists of a number of packages:

  • / (top level): The DrawRuntimeException class and:
    • Drawable: the interface that all Drawable objects must implement.
    • Directed and Oriented: Directed is the interface that all Ray and DirectedPoint objects implement; the Oriented is the interface that all OrientedPoint3d object implement. See table below.
    • Affine transformations: the Transform2d and Transform3d classes that implement transformations using affine matrices.
  • bounds package: The classes that can hold the minimum and maximum of the coordinates of a Drawable object.
  • point package: The classes for points and oriented points (2D and 3D).
  • line package: The classes for LineSegment, PolyLine, Ray, Polygon and the Beziér approximators of PolyLines.
  • surface package: Intended for various surface types and generators of those (very rudimentary at this time).
  • volume package: Intended for 3D objects and generators of those (very rudimentary at this time).

All Drawable 3D objects implement a project() method that constructs a corresponding 2D object (where this might fail, the project() method may throw a DrawRuntimeException).

A direction in 2d is implemented as a rotation around the z-axis. A direction in 3d is implemented as a rotation around the z-axis and the y-axis. The rotation around the z-axis typically ranges from 0 to 2 π whereas the rotation around the y-axis is limited to range from 0 to π to reach all directions in 3d. An orientation in 3d means that the object is directed, but can also 'roll' along its x-axis (think about a airplane) and therefore implements a rotation around the x-axis as well (ranging from 0 to 2 π). See the table below.

class dirX dirY dirZ
Directed no no yes
Directed3d no yes yes
Oriented3d yes yes yes

Maven use

Maven is one of the easiest ways to include DJUTILS-DRAW in a Java project. The Maven files for DJUTILS-DRAW reside at Maven Central as of version 2.0.0. When a POM-file is created for the project, the following snippet needs to be included to include DJUTILS-DRAW:

<dependencies>
  <dependency>
    <groupId>org.djutils</groupId>
    <artifactId>djutils-draw</artifactId>
    <version>2.3.0</version>
  </dependency>
</dependencies>

Of course, the version number (2.3.0 in the above example) needs to be replaced with the version that one wants to include in the project.

DJUTILS-DRAW jars before version 2 are kept on a server at TU Delft at https://djutils.org/maven.