com.openinventor.inventor.viewercomponents

Class SoEventBuilder

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.viewercomponents.SoEventBuilder

public class SoEventBuilder
extends Inventor

Utility class that generates Open Inventor events. This class is used to generate an Open Inventor event object from a system independent event description.

Note: The same SoEvent object is returned each time. This object is owned by the SoEventBuilder instance and must not be modified or destroyed by the application.

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoEventBuilder() Constructor.
SoEventBuilder(SoEventBuilder copyFrom)

Method Summary

Modifier and Type	Method and Description
SoKeyboardEvent	getKeyPressEvent(SoKeyboardEvent.Keys key, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoKeyboardEvent corresponding to given parameters.
SoKeyboardEvent	getKeyReleaseEvent(SoKeyboardEvent.Keys key, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoKeyboardEvent corresponding to given parameters.
SoMouseButtonEvent	getMouseDoubleClickEvent(int x, int y, SoMouseButtonEvent.Buttons buttonId, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoMouseButtonEvent corresponding to given parameters.
SoLocation2Event	getMouseEnterEvent(int x, int y, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoLocation2Event corresponding to given parameters.
SoLocation2Event	getMouseLeaveEvent(int x, int y, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoLocation2Event corresponding to given parameters.
SoLocation2Event	getMouseMoveEvent(int x, int y, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoLocation2Event corresponding to given parameters.
SoMouseButtonEvent	getMousePressEvent(int x, int y, SoMouseButtonEvent.Buttons buttonId, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoMouseButtonEvent corresponding to given parameters.
SoMouseButtonEvent	getMouseReleaseEvent(int x, int y, SoMouseButtonEvent.Buttons buttonId, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoMouseButtonEvent corresponding to given parameters.
SoMouseWheelEvent	getMouseWheelEvent(int delta, boolean isAltDown, boolean isCtrlDown, boolean isShiftDown) Return an SoMouseWheelEvent corresponding to given parameters.
java.util.ArrayList<SoEvent>	getTouchDownEvent(int x, int y, long fingerId) Return a list of SoEvent corresponding to given parameters.
SoTouchManager	getTouchManager() Get the touch manager instance used by this event builder to build touch events.
java.util.ArrayList<SoEvent>	getTouchMoveEvent(int x, int y, long fingerId) Return a list of SoEvent corresponding to given parameters.
java.util.ArrayList<SoEvent>	getTouchUpEvent(int x, int y, long fingerId) Return a list of SoEvent corresponding to given parameters.
void	setValue(SoEventBuilder copyFrom)
static SoEventBuilder[]	toArray(long nativeArray, long length)

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Constructor Detail

SoEventBuilder

public SoEventBuilder(SoEventBuilder copyFrom)

SoEventBuilder

public SoEventBuilder()

Constructor.

Method Detail

getTouchMoveEvent

public java.util.ArrayList<SoEvent> getTouchMoveEvent(int x,
                                                      int y,
                                                      long fingerId)

Return a list of SoEvent corresponding to given parameters. This list may contain some recognized SoGestureEvent. The returned events should not be destroyed.

Parameters:

x - X coordinate in pixel of the finger position.

y - Y coordinate in pixel of the finger position.

fingerId - id of the finger used.

getTouchManager

public SoTouchManager getTouchManager()

Get the touch manager instance used by this event builder to build touch events.

getMouseLeaveEvent

public SoLocation2Event getMouseLeaveEvent(int x,
                                           int y,
                                           boolean isAltDown,
                                           boolean isCtrlDown,
                                           boolean isShiftDown)

Return an SoLocation2Event corresponding to given parameters. A MouseLeave event correspond to a mouse leaving some GUI area like a panel or a window. The returned object should not be destroyed.

Parameters:

x - X coordinate in pixel.

y - Y coordinate in pixel.

isAltDown - Specify if Alt key was down when mouse has leaved area.

isCtrlDown - Specify if Ctrl key was down when mouse has leaved area.

isShiftDown - Specify if Shift key was down when mouse has leaved area.

toArray

public static SoEventBuilder[] toArray(long nativeArray,
                                       long length)

setValue

public void setValue(SoEventBuilder copyFrom)

getMouseDoubleClickEvent

public SoMouseButtonEvent getMouseDoubleClickEvent(int x,
                                                   int y,
                                                   SoMouseButtonEvent.Buttons buttonId,
                                                   boolean isAltDown,
                                                   boolean isCtrlDown,
                                                   boolean isShiftDown)

Return an SoMouseButtonEvent corresponding to given parameters. The returned object should not be destroyed.

Parameters:

x - X coordinate in pixel.

y - Y coordinate in pixel.

buttonId - Which mouse button has been double clicked.

isAltDown - Specify if Alt key was down when mouse has been double clicked.

isCtrlDown - Specify if Ctrl key was down when mouse has been double clicked.

isShiftDown - Specify if Shift key was down when mouse has been double clicked.

getKeyPressEvent

public SoKeyboardEvent getKeyPressEvent(SoKeyboardEvent.Keys key,
                                        boolean isAltDown,
                                        boolean isCtrlDown,
                                        boolean isShiftDown)

Return an SoKeyboardEvent corresponding to given parameters. The returned object should not be destroyed.

Parameters:

key - key that have been pressed.

isAltDown - Specify if Alt key was down when key has been pressed.

isCtrlDown - Specify if Ctrl key was down when key has been pressed.

isShiftDown - Specify if Shift key was down when key has been pressed.

getKeyReleaseEvent

public SoKeyboardEvent getKeyReleaseEvent(SoKeyboardEvent.Keys key,
                                          boolean isAltDown,
                                          boolean isCtrlDown,
                                          boolean isShiftDown)

Return an SoKeyboardEvent corresponding to given parameters. The returned object should not be destroyed.

Parameters:

key - key that have been released.

isAltDown - Specify if Alt key was down when key has been released.

isCtrlDown - Specify if Ctrl key was down when key has been released.

isShiftDown - Specify if Shift key was down when key has been released.

getMouseMoveEvent

public SoLocation2Event getMouseMoveEvent(int x,
                                          int y,
                                          boolean isAltDown,
                                          boolean isCtrlDown,
                                          boolean isShiftDown)

Return an SoLocation2Event corresponding to given parameters. The returned object should not be destroyed.

Parameters:

x - X coordinate in pixel.

y - Y coordinate in pixel.

isAltDown - Specify if Alt key was down when mouse has been moved.

isCtrlDown - Specify if Ctrl key was down when mouse has been moved.

isShiftDown - Specify if Shift key was down when mouse has been moved.

getMouseWheelEvent

public SoMouseWheelEvent getMouseWheelEvent(int delta,
                                            boolean isAltDown,
                                            boolean isCtrlDown,
                                            boolean isShiftDown)

Return an SoMouseWheelEvent corresponding to given parameters. The returned object should not be destroyed.

Parameters:

delta - Number of tick mouse wheel has done. For most of mice, one tick correspond to 15 degree on the wheel but it may change depending on hardware.

isAltDown - Specify if Alt key was down when wheel has been activated.

isCtrlDown - Specify if Ctrl key was down when when wheel has been activated.

isShiftDown - Specify if Shift key was down when when wheel has been activated.

getTouchUpEvent

public java.util.ArrayList<SoEvent> getTouchUpEvent(int x,
                                                    int y,
                                                    long fingerId)

Return a list of SoEvent corresponding to given parameters. This list may contain some recognized SoGestureEvent. The returned events should not be destroyed.

Parameters:

x - X coordinate in pixel of the finger position.

y - Y coordinate in pixel of the finger position.

fingerId - id of the finger used.

getMouseEnterEvent

public SoLocation2Event getMouseEnterEvent(int x,
                                           int y,
                                           boolean isAltDown,
                                           boolean isCtrlDown,
                                           boolean isShiftDown)

Return an SoLocation2Event corresponding to given parameters. A MouseEnter event correspond to a mouse entering some GUI area like a panel or a window. The returned object should not be destroyed.

Parameters:

x - X coordinate in pixel.

y - Y coordinate in pixel.

isAltDown - Specify if Alt key was down when mouse has entered area.

isCtrlDown - Specify if Ctrl key was down when mouse has entered area.

isShiftDown - Specify if Shift key was down when mouse has entered area.

getMouseReleaseEvent

public SoMouseButtonEvent getMouseReleaseEvent(int x,
                                               int y,
                                               SoMouseButtonEvent.Buttons buttonId,
                                               boolean isAltDown,
                                               boolean isCtrlDown,
                                               boolean isShiftDown)

Return an SoMouseButtonEvent corresponding to given parameters. The returned object should not be destroyed.

Parameters:

x - X coordinate in pixel.

y - Y coordinate in pixel.

buttonId - Which mouse button has been released.

isAltDown - Specify if Alt key was down when mouse has been released.

isCtrlDown - Specify if Ctrl key was down when mouse has been released.

isShiftDown - Specify if Shift key was down when mouse has been released.

getMousePressEvent

public SoMouseButtonEvent getMousePressEvent(int x,
                                             int y,
                                             SoMouseButtonEvent.Buttons buttonId,
                                             boolean isAltDown,
                                             boolean isCtrlDown,
                                             boolean isShiftDown)

Return an SoMouseButtonEvent corresponding to given parameters. The returned object should not be destroyed.

Parameters:

x - X coordinate in pixel.

y - Y coordinate in pixel.

buttonId - Which mouse button has been pressed.

isAltDown - Specify if Alt key was down when mouse has been pressed.

isCtrlDown - Specify if Ctrl key was down when mouse has been pressed.

isShiftDown - Specify if Shift key was down when mouse has been pressed.

getTouchDownEvent

public java.util.ArrayList<SoEvent> getTouchDownEvent(int x,
                                                      int y,
                                                      long fingerId)

Return a list of SoEvent corresponding to given parameters. This list may contain some recognized SoGestureEvent. The returned events should not be destroyed.

Parameters:

x - X coordinate in pixel of the finger position.

y - Y coordinate in pixel of the finger position.

fingerId - id of the finger used.