com.openinventor.inventor.drawers

Class SoRectangleScreenDrawer

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.drawers.SoScreenDrawer

com.openinventor.inventor.drawers.SoPolyLineScreenDrawer

com.openinventor.inventor.drawers.SoRectangleScreenDrawer

All Implemented Interfaces:

SafeDisposable

public class SoRectangleScreenDrawer
extends SoPolyLineScreenDrawer

Interactively draws a rectangle in normalized screen space. This class can be used to interactively draw a rectangle on screen.

When the rectangle is finished, an event is raised to notify the application (see SoPolyLineScreenDrawer.onFinish ). Points are returned as normalized coordinates in the range -1..1, which is conveniently the default view volume for an SoOrthographicCamera node.

The line color and simplification threshold are specified by fields in the parent class SoPolyLineScreenDrawer.

Please see SoPolyLineScreenDrawer for general notes and code example.

Rectangle specific notes:

• The rectangle can be specified by 2 corner points (default) or by a center point and one corner point (see CreationMethod).
• The rectangle points are always delivered upper-left corner first, then counter-clockwise.
• The simplificationThreshold field does not apply to this node. A rectangle always has four points.
• The isClosed field does apply to this node (but false is not very useful).
• If user finishes a rectangle, then the next click will automatically clear the polyline (begin a new rectangle).

USAGE

• Press left mouse and drag to draw the rectangle.
• Release to finish it.
• Press Escape to cancel.

File format/default:

RectangleScreenDrawer {

point	[]
color	1 0 0
simplificationThreshold	0
isClosed	true
method	CORNER_CORNER

}

See also:

SoEllipseScreenDrawer, SoLassoScreenDrawer, SoPolyLineScreenDrawer, SoPolygonScreenDrawer,

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoRectangleScreenDrawer.CreationMethods Methods to create rectangle.

Nested classes/interfaces inherited from class com.openinventor.inventor.drawers.SoPolyLineScreenDrawer

SoPolyLineScreenDrawer.EventArg

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	CENTER_CORNER Deprecated. Use SoRectangleScreenDrawer.CreationMethods.CENTER_CORNER instead.
static int	CORNER_CORNER Deprecated. Use SoRectangleScreenDrawer.CreationMethods.CORNER_CORNER instead.
SoSFEnum<SoRectangleScreenDrawer.CreationMethods>	method Method to create rectangle.

Fields inherited from class com.openinventor.inventor.drawers.SoPolyLineScreenDrawer

color, doCCW, isClosed, onFinish, point, simplificationThreshold

Fields inherited from class com.openinventor.inventor.drawers.SoScreenDrawer

sceneGraph

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoRectangleScreenDrawer() Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.drawers.SoPolyLineScreenDrawer

clear, setFinishCallback

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

CORNER_CORNER

@Deprecated
public static final int CORNER_CORNER

Deprecated. Use SoRectangleScreenDrawer.CreationMethods.CORNER_CORNER instead.

CENTER_CORNER

@Deprecated
public static final int CENTER_CORNER

Deprecated. Use SoRectangleScreenDrawer.CreationMethods.CENTER_CORNER instead.

method

public final SoSFEnum<SoRectangleScreenDrawer.CreationMethods> method

Method to create rectangle. . Default is CORNER_CORNER.

Constructor Detail

SoRectangleScreenDrawer

public SoRectangleScreenDrawer()

Constructor.