Module vecmath

Package de.grogra.vecmath.geom

Class Intersection

java.lang.Object

de.grogra.vecmath.geom.Intersection

public class Intersection
extends Object

Instances of Intersection specify the properties of an intersection point of a Line with the surface of a Volume. They are part of an IntersectionList.

Author:

Ole Kniemeyer

Field Summary

Fields

Modifier and Type	Field	Description
static final int	ALL	Parameter for Volume.computeIntersections(de.grogra.vecmath.geom.Line, int, de.grogra.vecmath.geom.IntersectionList, de.grogra.vecmath.geom.Intersection, de.grogra.vecmath.geom.Intersection) indicating that all intersections have to be found.
static final int	ANY	Parameter for Volume.computeIntersections(de.grogra.vecmath.geom.Line, int, de.grogra.vecmath.geom.IntersectionList, de.grogra.vecmath.geom.Intersection, de.grogra.vecmath.geom.Intersection) indicating that some arbitrary intersection of the set of all intersections has to be found.
static final int	CLOSEST	Parameter for Volume.computeIntersections(de.grogra.vecmath.geom.Line, int, de.grogra.vecmath.geom.IntersectionList, de.grogra.vecmath.geom.Intersection, de.grogra.vecmath.geom.Intersection) indicating that only the closest intersection (minimal value of parameter) has to be found.
static final int	ENTERING	Value for type indicating that the line is entering the solid volume at this intersection poing.
int	face	This field can be used by the volume to store additional information, e.g., a face index.
static final int	LEAVING	Value for type indicating that the line is leaving the solid volume at this intersection point.
Line	line	Defines the line which was used for this intersection point.
int	multiplicity	This field is usually 1, but when the intersection is within a cloner, this is the number of occurrences of the intersected volume within the cloner.
double	parameter	The intersection point is located at line.origin + parameter * line.direction.
static final int	PASSING	Value for type indicating that the line is passing the non-solid (infinitely thin) "volume" (in this case it is not a true volume, rather a surface) at this intersection point.
Volume	solid	Defines the solid volume on whose surface this intersection point lies.
Point3d	tmpPoint0	This point may be used freely in methods which perform computations based on this intersection.
Vector3d	tmpVector0	This vector may be used freely in methods which perform computations based on this intersection.
int	type	Indicates the type of intersection, one of ENTERING, LEAVING, or PASSING.
Volume	volume	Defines the volume which computed this intersection point.
Object	volumeData	This field can be used by the volume to store additional information.
final Vector3d	volumeVector	This field can be used by the volume to store additional information.

Constructor Summary

Constructors

Constructor	Description
Intersection(IntersectionList list)

Method Summary

Modifier and Type	Method	Description
Intersection	deepCopy()
Point3d	getLocalPoint()	Returns the intersection point in local coordinates of the volume.
Vector3d	getNormal()	Returns the surface geometric normal unit vector in global coordinates.
Point3d	getPoint()	Returns the intersection point in global coordinates.
Vector3d	getUTangent()	Returns the surface geometric normal unit vector in global coordinates.
Vector2d	getUV()	Returns the uv coordinates of this intersection point.
Vector3d	getVTangent()
void	negateNormal()	This method can be invoked by CSG operations to indicate that the true normal vector is the negation of the vector which would be computed otherwise.
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

LEAVING

public static final int LEAVING

Value for type indicating that the line is leaving the solid volume at this intersection point.

See Also:

• Constant Field Values

ENTERING

public static final int ENTERING

Value for type indicating that the line is entering the solid volume at this intersection poing.

See Also:

• Constant Field Values

PASSING

public static final int PASSING

Value for type indicating that the line is passing the non-solid (infinitely thin) "volume" (in this case it is not a true volume, rather a surface) at this intersection point.

See Also:

• Constant Field Values

ALL

public static final int ALL

Parameter for Volume.computeIntersections(de.grogra.vecmath.geom.Line, int, de.grogra.vecmath.geom.IntersectionList, de.grogra.vecmath.geom.Intersection, de.grogra.vecmath.geom.Intersection) indicating that all intersections have to be found.

See Also:

• Constant Field Values

CLOSEST

public static final int CLOSEST

Parameter for Volume.computeIntersections(de.grogra.vecmath.geom.Line, int, de.grogra.vecmath.geom.IntersectionList, de.grogra.vecmath.geom.Intersection, de.grogra.vecmath.geom.Intersection) indicating that only the closest intersection (minimal value of parameter) has to be found.

See Also:

• Constant Field Values

ANY

public static final int ANY

Parameter for Volume.computeIntersections(de.grogra.vecmath.geom.Line, int, de.grogra.vecmath.geom.IntersectionList, de.grogra.vecmath.geom.Intersection, de.grogra.vecmath.geom.Intersection) indicating that some arbitrary intersection of the set of all intersections has to be found.

See Also:

• Constant Field Values

volume

public Volume volume

Defines the volume which computed this intersection point.

solid

public Volume solid

Defines the solid volume on whose surface this intersection point lies. Normally, it equals volume, but for CSG operations, it is set to the resulting CSG volume.

line

public Line line

Defines the line which was used for this intersection point.

parameter

public double parameter

The intersection point is located at line.origin + parameter * line.direction. Within an IntersectionList, intersections are sorted in ascending order of parameter.

type

public int type

Indicates the type of intersection, one of ENTERING, LEAVING, or PASSING.

face

public int face

This field can be used by the volume to store additional information, e.g., a face index.

multiplicity

public int multiplicity

This field is usually 1, but when the intersection is within a cloner, this is the number of occurrences of the intersected volume within the cloner.

volumeVector

public final Vector3d volumeVector

This field can be used by the volume to store additional information.

volumeData

public Object volumeData

This field can be used by the volume to store additional information.

tmpPoint0

public Point3d tmpPoint0

This point may be used freely in methods which perform computations based on this intersection.

tmpVector0

public Vector3d tmpVector0

This vector may be used freely in methods which perform computations based on this intersection.

Constructor Details

Intersection

public Intersection(IntersectionList list)

Method Details

negateNormal

public void negateNormal()

This method can be invoked by CSG operations to indicate that the true normal vector is the negation of the vector which would be computed otherwise.

getPoint

public Point3d getPoint()

Returns the intersection point in global coordinates. The returned value may not be modified.

Returns:

intersection point

getLocalPoint

public Point3d getLocalPoint()

Returns the intersection point in local coordinates of the volume. Normally local and global coordinates coincide, but e.g. for a GridClonerUnion the local coordinate system corresponds to the original object. The returned value may not be modified.

Returns:

intersection point

getNormal

public Vector3d getNormal()

Returns the surface geometric normal unit vector in global coordinates. It is the outer normal vector, pointing from the surface outwards. The vector is computed once by Volume.computeNormal(Intersection, Vector3d). The returned value may not be modified.

Returns:

outer unit normal vector

getUV

public Vector2d getUV()

Returns the uv coordinates of this intersection point. It is computed once by Volume.computeUV(Intersection, Vector2d). The returned value may not be modified.

Returns:

uv coordinates

getUTangent

public Vector3d getUTangent()

Returns the surface geometric normal unit vector in global coordinates. It is the outer normal vector, pointing from the surface outwards. The vector is computed once by Volume.computeNormal(Intersection, Vector3d). The returned value may not be modified.

Returns:

outer unit normal vector

getVTangent

public Vector3d getVTangent()

deepCopy

public Intersection deepCopy()

toString

public String toString()

Overrides:

toString in class Object