org.hfbk.vis.visnode.VisNodeMousable Class Reference

Inheritance diagram for org.hfbk.vis.visnode.VisNodeMousable:

[legend]Collaboration diagram for org.hfbk.vis.visnode.VisNodeMousable:


Public Attributes
float	w = 12
float	h = 4
Protected Attributes
boolean	isHoovered = false
boolean	isDragged = false
Package Functions
	VisNodeMousable (Node node, Vector3f position)
abstract void	handleEvent (VisMouseEvent evt)
boolean	hit (Ray mouseray, Vector3f hit)
Ray	buildRay (Vector4f raystart, Vector4f rayend)
Ray	buildRay (float x, float y)
void	handleEvents (List< AWTEvent > events)
float	getExtends ()
Package Attributes
final float	MINDEPTH = 12
Classes
class	Ray
class	VisMouseEvent

Detailed Description

A mouseable node, which reacts to the mouse in some kind. the default geometry for receiving clicks is a flat rectangle along the x-y-plane, ranging from -w/2,h/2 to w/2,h/2.

handleEvent() will be called upon a hit and must be overridden.

hit should be overriden to define another hitable geometry.

As the node doesn't know about others (maybe obscuring ones), the hit is detected in two phases: 1. All nodes who receive mouse clicks challenge the previous ones click event for the foremost position 2. At the next frame, only the one click event survivor is feed back to invoke the event handler.

So we have a two frame latency from click to reaction. Maybe we replace this by a separate event processing facility called in the same frame.

Definition at line 40 of file VisNodeMousable.java.

Constructor & Destructor Documentation

org.hfbk.vis.visnode.VisNodeMousable.VisNodeMousable	(	Node	node,
		Vector3f	position
	)			`[package]`

Definition at line 53 of file VisNodeMousable.java.

References org.hfbk.vis.visnode.VisNode.node.

Member Function Documentation

abstract void org.hfbk.vis.visnode.VisNodeMousable.handleEvent ( VisMouseEvent evt ) [package, pure virtual]

a mouse event occured on this node. implement this to handle it.

Referenced by org.hfbk.vis.visnode.VisNodeMousable.handleEvents().

Here is the caller graph for this function:

boolean org.hfbk.vis.visnode.VisNodeMousable.hit	(	Ray	mouseray,
		Vector3f	hit
	)			`[package]`

checks wether a ray hits this node and returns the intersection. the intersection should be returned if possible, even if not hit, for example a plane could be intersected even if the rectangular hit zone in it is not hit. This allows for extending the object space for dragging etc.

default behaveiour tests against a rectangle ranging from -w/2,-h/2 to w/2,h/2. This should be overridden for other geometry.

Parameters:

	mouseray
	hit	the position of hit

Returns:: if hit

Definition at line 92 of file VisNodeMousable.java.

References org.hfbk.vis.visnode.VisNodeMousable.Ray.dir, org.hfbk.vis.visnode.VisNodeMousable.h, org.hfbk.vis.visnode.VisNodeMousable.Ray.start, and org.hfbk.vis.visnode.VisNodeMousable.w.

Referenced by org.hfbk.vis.visnode.VisNodeMousable.handleEvents().

Here is the caller graph for this function:

Ray org.hfbk.vis.visnode.VisNodeMousable.buildRay	(	Vector4f	raystart,
		Vector4f	rayend
	)			`[package]`

build a Ray by projecting the given positions into local space. this can then be checked against collision with this object via hit(), resulting in a hit to this object.

Returns:: a ray originating from raystart towards rayend

Definition at line 118 of file VisNodeMousable.java.

References org.hfbk.vis.visnode.VisNode.currentTransform, and org.hfbk.vis.visnode.VisNode.transform().

Referenced by org.hfbk.vis.visnode.VisNodeMousable.buildRay(), and org.hfbk.vis.visnode.VisNodeMousable.handleEvents().

Here is the call graph for this function:

Here is the caller graph for this function:

Ray org.hfbk.vis.visnode.VisNodeMousable.buildRay	(	float	x,
		float	y
	)			`[package]`

build a Ray by projecting the given screen position into local space.

See also:: buildRay(Vector3f raystart, Vector3f rayend)

Returns:: a ray originating from the viewer towards the given screen coordinates

Definition at line 145 of file VisNodeMousable.java.

References org.hfbk.vis.visnode.VisNodeMousable.buildRay(), org.hfbk.vis.visnode.VisRoot.client, org.hfbk.vis.visnode.VisNode.getRoot(), and org.hfbk.vis.VisClient.panel.

Here is the call graph for this function:

void org.hfbk.vis.visnode.VisNodeMousable.handleEvents ( List< AWTEvent > events ) [package]

extract a mouse click and calls event handlers if we got hit. This is a two phased model: 1. a MouseEvent that hits this object is converted to a VisMouseEvent, challengeing the ones issued earlier. 2. Second, only the frontmost VisMouseEvent of each type is feed back and received here, invoking the appropriate handler.

The resson for this is we don't know about other nodes, so this one cannot decide if it is frontmost on its own.

Reimplemented from org.hfbk.vis.visnode.VisNode.

Definition at line 173 of file VisNodeMousable.java.