Package org.djutils.draw.surface

Class Surface3d

java.lang.Object
org.djutils.draw.surface.Surface3d
All Implemented Interfaces:
Serializable, Iterable<Point3d>, Drawable<Point3d>, Drawable3d
public class Surface3d extends Object implements Drawable3d
Triangulated surface in 3D space.

Copyright (c) 2021-2025 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See DJUTILS License.

Author:
Alexander Verbraeck, Peter Knoppers, Wouter Schakel
See Also:

  • Constructor Details

    • Surface3d

      public Surface3d(Point3d[][] points) throws NullPointerException, IllegalArgumentException
      Construct a new Surface3d.
      Parameters:
      points - two dimensional array of points. The first index iterates over the individual triangles; the second index iterates over the points of a single triangle. The range of the second index must be 3. It is expected that all points appear multiple times in the points array, but never within the same sub-array.
      Throws:
      NullPointerException - when points is null, or contains a null value
      IllegalArgumentException - when points is empty, or any element in points does not contain exactly three different points

  • Method Details

    • iterator

      public Iterator<Point3d> iterator()
      Specified by:
      iterator in interface Iterable<Point3d>

    • size

      public int size()
      Description copied from interface: Drawable
      Retrieve the number of points that make up the object.
      Specified by:
      size in interface Drawable<Point3d>
      Returns:
      the number of points that make up the object

    • getBounds

      public Bounds3d getBounds()
      Description copied from interface: Drawable3d
      Retrieve the bounding box of the object.
      Specified by:
      getBounds in interface Drawable3d
      Returns:
      the bounding box of the object

    • project

      public Drawable2d project() throws DrawRuntimeException
      Description copied from interface: Drawable3d
      Project the object onto the z=0 plane.
      Specified by:
      project in interface Drawable3d
      Returns:
      the projected object
      Throws:
      DrawRuntimeException - when projecting onto the z=0 plane results in an invalid object. E.g. a Line3d that consists of points that all have the exact same x and y coordinates cannot be a line after projecting on the z=0 plane.

    • toString

      public String toString()
      Description copied from interface: Drawable
      Produce a string describing the Drawable using default conversion for the (double) coordinate values. Regrettably, it is not allowed to provide a default implementation here.
      Specified by:
      toString in interface Drawable<Point3d>
      Overrides:
      toString in class Object
      Returns:
      a string describing the Drawable

    • toString

      public String toString(String doubleFormat, boolean doNotIncludeClassName)
      Description copied from interface: Drawable
      Produce a String describing the Drawable.
      Specified by:
      toString in interface Drawable<Point3d>
      Parameters:
      doubleFormat - a format string (something like "%6.3f") which will be used to render every coordinate value)
      doNotIncludeClassName - if true; the output of toString is not prefixed by the class name. This is useful for concatenating the textual representation of lots of Drawables (e.g. an array, or a List).
      Returns:
      textual representation of the Drawable

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object