//
// TriangleJ3D.java
//

/*
VisAD system for interactive analysis and visualization of numerical
data.  Copyright (C) 1996 - 2017 Bill Hibbard, Curtis Rueden, Tom
Rink, Dave Glowacki, Steve Emmerson, Tom Whittaker, Don Murray, and
Tommy Jasmin.

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.

You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
MA 02111-1307, USA
*/

package visad.bom.annotations;

import visad.DisplayImpl;
import visad.java3d.DisplayImplJ3D;

/**
 *  Meant to encapsulate information representing a Triangle which is
 *  going to be rendered on a VisAD display without being
 *  subject to the usual VisAD transformations. Thus the label should
 *  stick in Screen Coordinates.
 */
public class TriangleJ3D implements ScreenAnnotation
{
  /** fill style POINT */
  public static final int POINT = 1;
  /** fill style LINE */
  public static final int LINE = 2;
  /** fill style FILL */
  public static final int FILL = 3;

  private int style;
  private int x1, y1;   // points of triangle in screen coordinates
  private int x2, y2;
  private int x3, y3;
  private float[] colour;
  private double zValue;
  private double thickness;          // for line and point style

  /**
   *  Simple constructor which makes a zero size triangle at (0, 0)
   *  coloured white. Set more meaningful values after construction.
   */
  public TriangleJ3D()
  {
    this(FILL, 0, 0, 0, 0, 0, 0, new float[] {1,1,1}, 0, 1.0);
  }

  /**
   *  Constructs a TriangleJ3D from 3 points specified in
   *  screen coordinates.
   *
   *  @param style  one of 

   *         
 TriangleJ3D.FILL, 
   *         
 TriangleJ3D.LINE, 
   *         
 TriangleJ3D.POINT.
 

   *  @param x1  x screen coordinate of the first point.
   *  @param y1  y screen coordinate of the first point.
   *  @param x2  x screen coordinate of the second point.
   *  @param y2  y screen coordinate of the second point.
   *  @param x3  x screen coordinate of the third point.
   *  @param y3  y screen coordinate of the third point.
   *  @param colour  red green blue triple; each value in [0.0, 1.0].
   *  @param zValue  Virtual world value; larger z is in front.
   *  @param thickness  used for outline thickness and point size.
   */
  public TriangleJ3D(int style,
    int x1, int y1, int x2, int y2, int x3, int y3,
    float[] colour, double zValue, double thickness)
  {
    this.x1 = x1;
    this.y1 = y1;
    this.x2 = x2;
    this.y2 = y2;
    this.x3 = x3;
    this.y3 = y3;
    this.style = style;
    this.colour = colour;
    this.zValue = zValue;
    this.thickness = thickness;
  }

  /**
   *  Constructs a TriangleJ3D from 3 points specified in
   *  screen coordinates.
   *
   *  @param style  one of 

   *         
 TriangleJ3D.FILL, 
   *         
 TriangleJ3D.LINE, 
   *         
 TriangleJ3D.POINT.
 

   *  @param points  2 rows with each column containing a point
   *         in screen coordinates; requires 3 points (columns).
   *  @param colour  red green blue triple; each value in [0.0, 1.0].
   *  @param zValue  Virtual world value; larger z is in front.
   *  @param thickness  used for outline thickness and point size.
   */
  public TriangleJ3D(int style, int[][] points,
    float[] colour, double zValue, double thickness)
  {
    this(FILL, points[0][0], points[1][0], points[0][1],
      points[1][1], points[0][2], points[1][2],
      colour, zValue, thickness);  
  }

  /**
   *  Sets TriangleJ3D from 3 points specified in screen coordinates.
   *
   *  @param x1  x screen coordinate of the first point.
   *  @param y1  y screen coordinate of the first point.
   *  @param x2  x screen coordinate of the second point.
   *  @param y2  y screen coordinate of the second point.
   *  @param x3  x screen coordinate of the third point.
   *  @param y3  y screen coordinate of the third point.
   */
  public void setPoints(int x1, int y1, int x2, int y2, int x3, int y3)
  {
    this.x1 = x1;
    this.y1 = y1;
    this.x2 = x2;
    this.y2 = y2;
    this.x3 = x3;
    this.y3 = y3;
  } 

  /**
   *  Sets TriangleJ3D from the given array of 3 points specified
   *  in screen coordinates.
   *
   *  @param points  2 rows with each column containing a point
   *         in screen coordinates; requires 3 points (columns).
   */
  public void setPoints(int[][] points)
  {
    setPoints(points[0][0], points[1][0], points[0][1],
      points[1][1], points[0][2], points[1][2]);
  }

  /**
   *  Set the drawing style of the triangle.
   *
   *  @param style  one of 

   *         
 TriangleJ3D.FILL, 
   *         
 TriangleJ3D.LINE, 
   *         
 TriangleJ3D.POINT.
 

   */
  public void setStyle(int style)
  {
    this.style = style;
  }

  /**
   *  Set the colour of the triangle.
   *
   *  @param colour  red green blue triple; each value in [0.0, 1.0].
   */
  public void setColour(float[] colour)
  {
    this.colour = colour;
  }

  /**
   *  Set the Z value of the triangle.
   *
   *  @param zValue  Virtual world value; larger zValue is in front.
   */
  public void setZValue(double zValue)
  {
    this.zValue = zValue;
  }

  /**
   *  Make the TriangleJ3D into a {@link javax.media.j3d.Shape3D}.
   *
   *  @param display  the VisAD display for this Triangle.
   *
   *  @return the Triangle description as a Shape3D object.
   */
  public Object toDrawable(DisplayImpl display)
  {
    return ScreenAnnotatorUtils.makeTriangleShape3D(
      (DisplayImplJ3D)display, style,
      x1, y1, x2, y2, x3, y3, colour, zValue, thickness);
  }
} // class TriangleJ3D