Package org.jlab.geom.prim

Class Shape3D

java.lang.Object
org.jlab.geom.prim.Shape3D
All Implemented Interfaces:
Transformable, Showable
public class Shape3D extends Object implements Transformable, Showable
A collection of Face3D objects.

Faces can be added and retrieved via addFace(org.jlab.geom.prim.Face3D) and face(int).

The center of the shape can be calculated via center(), which returns the geometric mean of all of the points of all the faces contained in this shape.

The moveTo(org.jlab.geom.prim.Point3D) method translates this shape so that its center is at the given point.

Author:
gavalian

  • Constructor Summary

    Constructors
    Constructor
    Description
    Shape3D()
    Constructs a new empty Shape3D.
    Shape3D(Face3D... faces)
    Constructs a new Shape3D from the given faces.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addFace(Face3D face)
    Adds the given face to this shape.
    static Shape3D
    box(double xd, double yd, double zd)
     
    Point3D
    center()
    Constructs a point center of the shape.
    Face3D
    face(int index)
    Returns the face corresponding to the given index.
    String
    getMeshFXML()
     
    boolean
    hasIntersection(Line3D line)
    Returns true if the infinite line intersects this shape.
    boolean
    hasIntersectionRay(Line3D line)
    Returns true if the ray intersects this shape.
    boolean
    hasIntersectionSegment(Line3D line)
    Returns true if the line segment intersects this shape.
    int
    intersection(Line3D line, List<Point3D> intersections)
    Finds intersections of the given infinite line with this shape.
    int
    intersection_with_faces(Line3D line, List<Point3D> intersections, List<Integer> ifaces)
    Finds intersections of the given infinite line with this shape.
    int
    intersectionRay(Line3D line, List<Point3D> intersections)
    Finds intersections of the given ray with this shape.
    int
    intersectionSegment(Line3D line, List<Point3D> intersections)
    Finds intersections of the given line segment with this shape.
    void
    moveTo(double x, double y, double z)
    Translates this shape so that it's geometric center coincides with the given point at the given coordinates.
    void
    moveTo(Point3D point)
    Translates this shape so that it's geometric center coincides with the given point.
    void
    rotateX(double angle)
    Rotates this object clockwise around the x axis.
    void
    rotateY(double angle)
    Rotates this object clockwise around the y axis.
    void
    rotateZ(double angle)
    Rotates this object clockwise around the z axis.
    void
    show()
    Invokes System.out.println(this).
    int
    size()
    Returns the number of faces in this shape.
    String
    toString()
     
    void
    translateXYZ(double x, double y, double z)
    Translates this object linearly by the amounts specified.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • Shape3D

      public Shape3D()
      Constructs a new empty Shape3D.

    • Shape3D

      public Shape3D(Face3D... faces)
      Constructs a new Shape3D from the given faces. If any of the face are subsequently modified, then this shape will also be modified.
      Parameters:
      faces - the faces of of this shape

  • Method Details

    • addFace

      public void addFace(Face3D face)
      Adds the given face to this shape. If the face is subsequently modified, this shape will also be modified.
      Parameters:
      face - the face to add

    • face

      public Face3D face(int index)
      Returns the face corresponding to the given index.
      Parameters:
      index - the index of the face to get
      Returns:
      the face at the corresponding index or null if there is no such face

    • size

      public int size()
      Returns the number of faces in this shape.
      Returns:
      the number of faces in this shape

    • center

      public Point3D center()
      Constructs a point center of the shape. This point is at the geometric mean of every point in every face of the shape.
      Returns:
      a point at the geometric center of the shape, or a point at the origin if the shape has no faces

    • translateXYZ

      public void translateXYZ(double x, double y, double z)
      Description copied from interface: Transformable
      Translates this object linearly by the amounts specified.
      Specified by:
      translateXYZ in interface Transformable
      Parameters:
      x - amount to translate along the x axis
      y - amount to translate along the y axis
      z - amount to translate along the z axis

    • rotateX

      public void rotateX(double angle)
      Description copied from interface: Transformable
      Rotates this object clockwise around the x axis.
      Specified by:
      rotateX in interface Transformable
      Parameters:
      angle - rotation angle in radians

    • rotateY

      public void rotateY(double angle)
      Description copied from interface: Transformable
      Rotates this object clockwise around the y axis.
      Specified by:
      rotateY in interface Transformable
      Parameters:
      angle - rotation angle in radians

    • rotateZ

      public void rotateZ(double angle)
      Description copied from interface: Transformable
      Rotates this object clockwise around the z axis.
      Specified by:
      rotateZ in interface Transformable
      Parameters:
      angle - rotation angle in radians

    • moveTo

      public void moveTo(Point3D point)
      Translates this shape so that it's geometric center coincides with the given point.
      Parameters:
      point - the new position of the shape's center

    • moveTo

      public void moveTo(double x, double y, double z)
      Translates this shape so that it's geometric center coincides with the given point at the given coordinates.
      Parameters:
      x - the x coordinate
      y - the y coordinate
      z - the z coordinate

    • intersection

      public int intersection(Line3D line, List<Point3D> intersections)
      Finds intersections of the given infinite line with this shape. Intersection points will be appended to the given list.
      Parameters:
      line - the infinite line
      intersections - the list of intersections
      Returns:
      the number of intersections that were found

    • intersection_with_faces

      public int intersection_with_faces(Line3D line, List<Point3D> intersections, List<Integer> ifaces)
      Finds intersections of the given infinite line with this shape. Intersection points will be appended to the given list.
      Parameters:
      line - the infinite line
      intersections - the list of intersections
      Returns:
      the number of intersections that were found

    • intersectionRay

      public int intersectionRay(Line3D line, List<Point3D> intersections)
      Finds intersections of the given ray with this shape. Intersection points will be appended to the given list.
      Parameters:
      line - the ray
      intersections - the list of intersections
      Returns:
      the number of intersections that were found

    • intersectionSegment

      public int intersectionSegment(Line3D line, List<Point3D> intersections)
      Finds intersections of the given line segment with this shape. Intersection points will be appended to the given list.
      Parameters:
      line - the line segment
      intersections - the list of intersections
      Returns:
      the number of intersections that were found

    • hasIntersection

      public boolean hasIntersection(Line3D line)
      Returns true if the infinite line intersects this shape.
      Parameters:
      line - the infinite line
      Returns:
      true if the line intersects the shape

    • hasIntersectionRay

      public boolean hasIntersectionRay(Line3D line)
      Returns true if the ray intersects this shape.
      Parameters:
      line - the ray
      Returns:
      true if the line intersects the shape

    • hasIntersectionSegment

      public boolean hasIntersectionSegment(Line3D line)
      Returns true if the line segment intersects this shape.
      Parameters:
      line - the line segment
      Returns:
      true if the line intersects the shape

    • show

      public void show()
      Invokes System.out.println(this).
      Specified by:
      show in interface Showable

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • box

      public static Shape3D box(double xd, double yd, double zd)

    • getMeshFXML

      public String getMeshFXML()