jv.project

Class PvPickEvent

java.lang.Object

jv.project.PvPickEvent

public final class PvPickEvent
extends java.lang.Object

Pick events on geometries sent to a pick listener from a display.

See Also:

PvPickListenerIf, PjProject, PvDisplayIf

Constructor Summary

Constructors

Constructor and Description
PvPickEvent(int dim) Constructor with dimension of scene in display.

Method Summary

Methods

Modifier and Type	Method and Description
PdBary	getBary() Get barycentric coordinates inside the picked element.
int	getDimOfVertex() Get dimension of scene position of cursor in world coordinate of scene in display.
double	getDistance() Get distance of picked vertex to nearest position on geometry.
int	getElementInd() Get index of element in element array of picked geometry.
int	getElementSubInd() Get the index of a subtringle if element has more than three edges.
int	getElemInd() Deprecated. use #getElementInd() which provides the same functionality.
PgGeometryIf	getGeometry() Get the picked geometry, may be null.
double	getHorDistance() Get distance of picked vertex to nearest position on geometry.
java.awt.Point	getLocation() Get position of cursor in pixel coordinates of drawing canvas of event.
PiVector	getMarkBox() Get bounds of user dragged rectangle with four components in pixel coordinates.
PdVector[]	getMarkBoxWorld() Get bounds of user dragged rectangle with four components converted to world-coordinates.
PdVector	getNormal() Get normal vector at picked surface points.
PvDisplayIf	getSource() Get source display where this event occurred.
PdVector	getVertex() Get the point on the geometry nearest to the picked vertex, i.e. the intersection of the pick ray (viewBase,viewDir) with the geometry.
int	getVertexInd() Get index of vertex in vertex array of picked geometry if pick was close to a vertex.
PdVector	getVertexNearest() Deprecated. use getVertex()
PdVector	getViewBase() Get position of cursor in world coordinate of scene in display.
PdVector	getViewDir() Get normalized viewing direction as the vector pointing from the camera to its interest.
void	set(PdVector pos, int elemInd, int elemSubInd, PdBary bary) Convenient method to assign the four parameters of an event simultaneously.
void	setBary(PdBary bary) Set barycentric coordinates inside the picked element.
void	setDistance(double dist) Set distance of picked vertex to nearest position on geometry.
void	setElementInd(int elem) Set index of element in element array of picked geometry.
void	setElementSubInd(int elemSub) Set the index of a subtringle if element has more than three edges.
void	setGeometry(PgGeometryIf geom) Set the picked geometry from display, may be null.
void	setHorDistance(double horDist) Set distance of picked vertex to nearest position on geometry.
void	setLocation(java.awt.Point pos) Set position of cursor in pixel coordinates of drawing canvas of event.
void	setMarkBox(PiVector box) Set bounds of user dragged rectangle with four components in pixel coordinates.
void	setMarkBoxWorld(PdVector[] box) Set bounds of user dragged rectangle with four components in world-coordinates.
void	setNormal(PdVector normal) Get normal vector at picked surface points.
void	setSource(PvDisplayIf disp) Set source display where this event occurred.
void	setVertex(PdVector vertex) Set the point on the geometry nearest to the picked vertex, i.e. the intersection of the pick ray (viewBase,viewDir) with the geometry.
void	setVertexInd(int ind) Set index of vertex in vertex array of picked geometry if pick was close to a vertex.
void	setVertexNearest(PdVector vertex) Deprecated. use setVertex(PdVector)
void	setViewBase(PdVector base) Set position of cursor in world coordinate of scene in display.
void	setViewDir(PdVector pos) Set viewing direction as the vector pointing from the camera to its interest.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PvPickEvent

public PvPickEvent(int dim)

Constructor with dimension of scene in display. Dimension is used for size of geometric vectors in world coordinates.

Parameters:

dim - Dimension of scene in display

Method Detail

getSource

public PvDisplayIf getSource()

Get source display where this event occurred.

Returns:

display where this event occurred

setSource

public void setSource(PvDisplayIf disp)

Set source display where this event occurred.

Parameters:

disp - display where this event occurred

getDimOfVertex

public int getDimOfVertex()

Get dimension of scene position of cursor in world coordinate of scene in display.

Returns:

Dimension of scene.

getGeometry

public PgGeometryIf getGeometry()

Get the picked geometry, may be null. A geometry must be the active geometry to receive a pick event. Return value may be null.

Returns:

picked geometry

setGeometry

public void setGeometry(PgGeometryIf geom)

Set the picked geometry from display, may be null. A geometry must be the active geometry to receive a pick event.

Parameters:

geom - picked geometry

getMarkBox

public PiVector getMarkBox()

Get bounds of user dragged rectangle with four components in pixel coordinates. Return value may be null.

Returns:

lower left and upper right corner of dragged rectangle in pixel coordinates

setMarkBox

public void setMarkBox(PiVector box)

Set bounds of user dragged rectangle with four components in pixel coordinates.

Parameters:

box - lower left and upper right corner of dragged rectangle in pixel coordinates

getMarkBoxWorld

public PdVector[] getMarkBoxWorld()

Get bounds of user dragged rectangle with four components converted to world-coordinates. Return value may be null.

Returns:

lower left and upper right corner of dragged rectangle in world-coordinates

setMarkBoxWorld

public void setMarkBoxWorld(PdVector[] box)

Set bounds of user dragged rectangle with four components in world-coordinates.

Parameters:

box - lower left and upper right corner of dragged rectangle in world-coordinates

getLocation

public java.awt.Point getLocation()

Get position of cursor in pixel coordinates of drawing canvas of event.

Returns:

Location of mouse cursor in 2d pixel coordinates

setLocation

public void setLocation(java.awt.Point pos)

Set position of cursor in pixel coordinates of drawing canvas of event.

Parameters:

pos - Location of mouse cursor in 2d pixel coordinates

getVertex

public PdVector getVertex()

Get the point on the geometry nearest to the picked vertex, i.e. the intersection of the pick ray (viewBase,viewDir) with the geometry. If the pick ray does not intersect a geometry, then the vertex is equal to the viewBase.

Returns:

World coordinates of the nearest point on the geometry.

See Also:

getViewBase(), getViewDir()

setVertex

public void setVertex(PdVector vertex)

Set the point on the geometry nearest to the picked vertex, i.e. the intersection of the pick ray (viewBase,viewDir) with the geometry. If the pick ray does not intersect a geometry, then the vertex should be the viewBase.

Parameters:

vertex - World coordinates of the nearest point on the geometry.

See Also:

setViewBase(PdVector), setViewDir(PdVector)

getVertexNearest

public PdVector getVertexNearest()

Deprecated. use getVertex()

Get position of the point on the geometry nearest to the picked vertex. Return value may be null.

Returns:

World coordinates of the nearest point on the geometry.

setVertexNearest

public void setVertexNearest(PdVector vertex)

Deprecated. use setVertex(PdVector)

Set position of the point on the geometry nearest to the picked vertex.

Parameters:

vertex - World coordinates of the nearest point on the geometry.

getVertexInd

public int getVertexInd()

Get index of vertex in vertex array of picked geometry if pick was close to a vertex. Return value -1 indicates that no vertex was close to pick position.

Returns:

index of a vertex

setVertexInd

public void setVertexInd(int ind)

Set index of vertex in vertex array of picked geometry if pick was close to a vertex. Return value -1 indicates that no vertex was close to pick position.

Parameters:

ind - index of a vertex

getDistance

public double getDistance()

Get distance of picked vertex to nearest position on geometry.

Returns:

distance of picked vertex to nearest position on geometry.

setDistance

public void setDistance(double dist)

Set distance of picked vertex to nearest position on geometry. Parameter value may be -1 indicating that no element has been picked.

Parameters:

dist - distance of picked vertex to nearest position on geometry.

getHorDistance

public double getHorDistance()

Get distance of picked vertex to nearest position on geometry.

Returns:

distance of picked vertex to nearest position on geometry.

Since:

JavaView 3.84.016

setHorDistance

public void setHorDistance(double horDist)

Set distance of picked vertex to nearest position on geometry. Parameter value may be -1 indicating that no element has been picked.

Parameters:

horDist - horizontal distance of picked vertex to nearest position on geometry.

Since:

JavaView 3.84.016

getNormal

public PdVector getNormal()

Get normal vector at picked surface points. Return value may be null.

Returns:

World coordinates of normal vector in scene.

setNormal

public void setNormal(PdVector normal)

Get normal vector at picked surface points.

Parameters:

normal - World coordinates of normal vector in scene.

getBary

public PdBary getBary()

Get barycentric coordinates inside the picked element. If element has more that three edges then the barycentric coordinates in a subtriangle of the element is return. Return value may be null.

See Also:

getElementSubInd()

setBary

public void setBary(PdBary bary)

Set barycentric coordinates inside the picked element. If element has more that three edges then the barycentric coordinates in a subtriangle of the element are returned.

See Also:

getElementSubInd()

getElementInd

public int getElementInd()

Get index of element in element array of picked geometry. Return value -1 indicates that no element was picked.

Returns:

index of element

getElemInd

public int getElemInd()

Deprecated. use #getElementInd() which provides the same functionality.

setElementInd

public void setElementInd(int elem)

Set index of element in element array of picked geometry. Parameter value -1 indicates that no element was picked.

Parameters:

elem - index of element

getElementSubInd

public int getElementSubInd()

Get the index of a subtringle if element has more than three edges. The j-th subtriangle is spanned by element entries {[0],[j],[j+1]}.

setElementSubInd

public void setElementSubInd(int elemSub)

Set the index of a subtringle if element has more than three edges. The j-th subtriangle is spanned by element entries {[0],[j],[j+1]}.

Parameters:

elemSub - index of subtriangle

getViewBase

public PdVector getViewBase()

Get position of cursor in world coordinate of scene in display. Return value may be null.

Returns:

World coordinates of mouse position in scene.

See Also:

getVertex(), getViewDir()

setViewBase

public void setViewBase(PdVector base)

Set position of cursor in world coordinate of scene in display.

Parameters:

base - World coordinates of mouse position in scene.

See Also:

setViewDir(PdVector)

getViewDir

public PdVector getViewDir()

Get normalized viewing direction as the vector pointing from the camera to its interest.

Returns:

normalized viewing direction in world coordinates

setViewDir

public void setViewDir(PdVector pos)

Set viewing direction as the vector pointing from the camera to its interest. Length of vector is irrelevant.

Parameters:

pos - viewing direction in world coordinates

set

public void set(PdVector pos,
       int elemInd,
       int elemSubInd,
       PdBary bary)

Convenient method to assign the four parameters of an event simultaneously.

Parameters:

pos - coordinates of picked vertex

elemInd - index of picked element

elemSubInd - index of sub element

bary - barycentric coordinates inside an element