Package org.jzy3d.plot3d.primitives

Class Geometry

java.lang.Object
org.jzy3d.plot3d.primitives.Drawable
org.jzy3d.plot3d.primitives.Wireframeable
org.jzy3d.plot3d.primitives.Geometry
All Implemented Interfaces:
IMultiColorable, ISingleColorable, IGLRenderer, ISortableDraw
Direct Known Subclasses:
Polygon, Triangle
public abstract class Geometry extends Wireframeable implements ISingleColorable, IMultiColorable

  • Field Details

    • NORMAL_AUTO_DEFAULT

      public static boolean NORMAL_AUTO_DEFAULT
      Default setting of setNormalProcessingAutomatic(boolean). Can be globally changed to avoid setting it geometry-wise.

    • SPLIT_TRIANGLE_DEFAULT

      public static boolean SPLIT_TRIANGLE_DEFAULT
      Default setting of setSplitInTriangles(boolean). Can be globally changed to avoid setting it geometry-wise.

    • NORMALIZE_NORMAL_DEFAULT

      public static boolean NORMALIZE_NORMAL_DEFAULT
      Default setting of setNormalizeNormals(boolean). Can be globally changed to avoid setting it geometry-wise.

    • SHOW_NORMALS

      public static boolean SHOW_NORMALS
      A flag to show normals for debugging lighting

    • NORMAL_LINE_WIDTH

      public static int NORMAL_LINE_WIDTH

    • NORMAL_POINT_WIDTH

      public static int NORMAL_POINT_WIDTH

    • NORMAL_END_COLOR

      public static Color NORMAL_END_COLOR

    • NORMAL_START_COLOR

      public static Color NORMAL_START_COLOR

    • polygonMode

      protected PolygonMode polygonMode

    • mapper

      protected ColorMapper mapper

    • points

      protected List<Point> points

    • color

      protected Color color

    • center

      protected Coord3d center

    • normals

      protected List<Coord3d> normals

    • normalProcessingAutomatic

      protected boolean normalProcessingAutomatic

    • splitInTriangles

      protected boolean splitInTriangles

    • normalizeNormals

      protected boolean normalizeNormals

    • normalPer

      protected Normal.NormalPer normalPer

  • Constructor Details

    • Geometry

      public Geometry()
      Initializes an empty Geometry with face status defaulting to true, and wireframe status defaulting to false.

    • Geometry

      public Geometry(int n)

    • Geometry

      public Geometry(Point... points)

    • Geometry

      public Geometry(Color wireframeColor, Color faceColor, Coord3d... points)

    • Geometry

      public Geometry(List<Point> points)

    • Geometry

      public Geometry(Color wireframeColor, Point... points)

    • Geometry

      public Geometry(Color wireframeColor, boolean wireframeDisplayed, Point... points)

  • Method Details

    • setReflectLight

      public void setReflectLight(boolean reflectLight)
      Description copied from class: Wireframeable
      If true, drawing this object will set ambient, diffuse, specular and shininess parameters. If the drawable has no normal defined, then the normal will be automatically processed.
      Overrides:
      setReflectLight in class Wireframeable

    • getNormals

      public List<Coord3d> getNormals()

    • setNormals

      public void setNormals(List<Coord3d> normals, Normal.NormalPer normalPer)
      Provides normals for this geometry. Manually setting normals will disable automatic normal processing. Not providing normals will keep the default automatic normal processing active. You may more simply set a single normal for this geometry by calling setNormal(Coord3d)
      Parameters:
      normals -
      normalPer - indicate if the supplied normals are given per vertex or per geometry. The ability to provide a list is kept for the case where one wishes to
      invalid @link 
      {@link #setSplitInTriangles(true)
      }.

    • setNormal

      public void setNormal(Coord3d normals)

    • isNormalProcessingAutomatic

      public boolean isNormalProcessingAutomatic()
      Normal processing is false by default, and becomes true as soon as one provide normals through setNormals(List, NormalPer)
      Returns:

    • setNormalProcessingAutomatic

      public void setNormalProcessingAutomatic(boolean normalProcessingAutomatic)
      Set normal processing to be automatic or not.
      Parameters:
      normalProcessingAutomatic -

    • draw

      public void draw(IPainter painter)
      Description copied from class: Drawable
      Call OpenGL2 routines for rendering the object.
      Specified by:
      draw in interface IGLRenderer
      Specified by:
      draw in class Drawable

    • drawFace

      protected void drawFace(IPainter painter)

    • callPointsForFace

      protected void callPointsForFace(IPainter painter)
      Drawing the point list in face mode (polygon content)

    • callPointsForFace_NoSplit

      protected void callPointsForFace_NoSplit(IPainter painter)

    • callPointsForFace_NoSplit_NormalSupplied

      protected void callPointsForFace_NoSplit_NormalSupplied(IPainter painter)

    • callPointsForFace_NoSplit_NormalAuto

      protected void callPointsForFace_NoSplit_NormalAuto(IPainter painter)

    • callPointsForFace_NoSplit_NoNormal

      protected void callPointsForFace_NoSplit_NoNormal(IPainter painter)

    • callPointsForFace_SplitInTriangle

      protected void callPointsForFace_SplitInTriangle(IPainter painter)

    • callPointsForFace_SplitInTriangle_NormalSupplied

      protected void callPointsForFace_SplitInTriangle_NormalSupplied(IPainter painter, Point p1, Point p2, Point p3, int t)

    • callPointsForFace_SplitInTriangle_NormalAuto

      protected void callPointsForFace_SplitInTriangle_NormalAuto(IPainter painter, Point p1, Point p2, Point p3)

    • computeNormalAutomatic

      protected Coord3d computeNormalAutomatic(List<Point> points)

    • computeNormalAutomatic

      protected Coord3d computeNormalAutomatic(Point p1, Point p2, Point p3)

    • applyPointOrMapperColor

      protected void applyPointOrMapperColor(IPainter painter, Point p)
      Apply mapper color if a mapper is defined and store the result in the point color, or use point color if mapper is undefined.

    • drawPolygonNormal

      protected void drawPolygonNormal(IPainter painter, List<Point> points, Coord3d normal)

    • drawPolygonNormal

      protected void drawPolygonNormal(IPainter painter, List<Point> points, List<Coord3d> normal)

    • drawTriangleNormal

      protected void drawTriangleNormal(IPainter painter, Point p1, Point p2, Point p3, Coord3d normal)

    • drawTriangleNormal

      protected void drawTriangleNormal(IPainter painter, Point p1, Point p2, Point p3, Coord3d n1, Coord3d n2, Coord3d n3)

    • drawNormal

      protected void drawNormal(IPainter painter, Coord3d start, Coord3d end)

    • drawWireframe

      protected void drawWireframe(IPainter painter)

    • callPointForWireframe

      protected void callPointForWireframe(IPainter painter)
      Drawing the point list in wireframe mode

    • begin

      protected abstract void begin(IPainter painter)
      Invoke GL begin with the actual geometry type
      invalid @link 
      GL#GL_POINTS
      ,
      invalid @link 
      GL#GL_LINES
      ,
      invalid @link 
      GL#GL_TRIANGLES
      ,
      invalid @link 
      GL2#GL_POLYGON
      ...

    • add

      public void add(float x, float y, float z)

    • add

      public void add(Coord3d coord)

    • add

      public void add(Coord3d coord, Color color, boolean updateBounds)

    • add

      public void add(Color faceColor, Coord3d... coords)

    • add

      public void add(Point point)

    • add

      public void add(Point point, boolean updateBounds)
      Add a point to the polygon.

    • add

      public void add(Point... points)

    • add

      public void add(List<Point> points)

    • applyGeometryTransform

      public void applyGeometryTransform(Transform transform)
      Specified by:
      applyGeometryTransform in class Drawable

    • updateBounds

      public void updateBounds()
      Specified by:
      updateBounds in class Drawable

    • getBarycentre

      public Coord3d getBarycentre()
      Description copied from class: Drawable
      Return the barycentre of this object, which is computed as the center of its bounding box. If the bounding box is not available, the returned value is
      invalid @link 
      Coord3d.INVALID
      Overrides:
      getBarycentre in class Drawable
      Returns:
      the center of the bounding box, or
      invalid @link 
      Coord3d.INVALID
      .

    • get

      public Point get(int p)

    • getPoints

      public List<Point> getPoints()
      Returns the list of the mutable points held by this polygon.

    • getPointSet

      public Set<Point> getPointSet()
      Returns a set of the mutable points held by this polygon.

    • getCoordSet

      public Set<Coord3d> getCoordSet()
      Returns a set of the mutable coordinates held by this polygon points.

    • getCoordList

      public List<Coord3d> getCoordList()
      Returns a list of the mutable coordinates held by this polygon points.

    • getCoordArray

      public Coord3d[] getCoordArray()
      Returns an array of the mutable coordinates held by this polygon points.

    • size

      public int size()

    • getDistance

      public double getDistance(Camera camera)
      Description copied from class: Drawable
      Return the distance of the object center to the Camera's eye.
      Specified by:
      getDistance in interface ISortableDraw
      Overrides:
      getDistance in class Drawable

    • getShortestDistance

      public double getShortestDistance(Camera camera)
      Specified by:
      getShortestDistance in interface ISortableDraw
      Overrides:
      getShortestDistance in class Drawable

    • getLongestDistance

      public double getLongestDistance(Camera camera)
      Specified by:
      getLongestDistance in interface ISortableDraw
      Overrides:
      getLongestDistance in class Drawable

    • getPolygonMode

      public PolygonMode getPolygonMode()

    • setPolygonMode

      public void setPolygonMode(PolygonMode polygonMode)
      A null polygonMode imply no any call to gl.glPolygonMode(...) at rendering

    • setColorMapper

      public void setColorMapper(ColorMapper mapper)
      Description copied from interface: IMultiColorable
      Set the colormapper that will be used by the Drawable, instead of using precomputed colors.
      Specified by:
      setColorMapper in interface IMultiColorable

    • getColorMapper

      public ColorMapper getColorMapper()
      Description copied from interface: IMultiColorable
      Get the colormapper.
      Specified by:
      getColorMapper in interface IMultiColorable

    • setColor

      public void setColor(Color color)
      Description copied from interface: ISingleColorable
      Set the color.
      Specified by:
      setColor in interface ISingleColorable
      Parameters:
      color - the color

    • getColor

      public Color getColor()
      Description copied from interface: ISingleColorable
      Get the color.
      Specified by:
      getColor in interface ISingleColorable
      Returns:
      color the color.

    • isSplitInTriangles

      public boolean isSplitInTriangles()

    • setSplitInTriangles

      public void setSplitInTriangles(boolean splitInTriangles)
      Splitting a polygon in multiple triangles is said to be better to adress complex rendering issues in OpenGL, but has a (very small) overhead.

    • isNormalizeNormals

      public boolean isNormalizeNormals()

    • setNormalizeNormals

      public void setNormalizeNormals(boolean normalizeNormals)
      Normalizing normals is usefull to ensure that polygons of different sizes will have a consistent light reflection. Indeed, a large polygon will have a high normal value compared to a small polygon. Normalizing requires a bit more computation though. This setting will only change something as long as
      • The object is configured to
        invalid @link 
        {@link #setReflectLight(true)
        } and if a Light is added to the chart.
      • The object is configured to
        invalid @link 
        {@link #setNormalProcessingAutomatic(true)
        }. Normals processed externally should be normalized externally.

    • toString

      public String toString(int depth)
      Overrides:
      toString in class Drawable

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • equals

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