com.openinventor.inventor.awt

Class SwRenderArea

java.lang.Object

java.awt.Component

java.awt.Canvas

com.openinventor.inventor.awt.SwDrawingArea

com.openinventor.inventor.awt.SwRenderArea

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

Direct Known Subclasses:

SwActiveArea

Deprecated.

As of Open Inventor 9.8.0, use components provided in Viewer Components libraries instead.

@Deprecated
public class SwRenderArea
extends SwDrawingArea

This class provides Inventor rendering and event handling inside an awt component. There is a routine to specify the scene to render. The scene is automatically rendered whenever anything under it changes (a data sensor is attached to the root of the scene), unless explicitly told not to do so (manual redraws). Users can also set Inventor rendering attributes such as the transparency type, antialiasing on or off, etc. This class employs an SoSceneManager to manage rendering and event handling.

Events that occur in the render area can be handled by the application or by the nodes in the scene graph. When an event occurs, it is first passed to the application event listeners objects registered with the add***Listeners methods on the RenderArea. If these listeners do not exist or do not set the passed event to consumed (to set an event consumed, use the method event.consume()) the event is translated to an SoEvent for further processing. The SoEvent is sent to that scene graph by way of an SoHandleEventAction.

See Also:

SoSceneManager, SoEvent, SwDrawingArea, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SwRenderArea.FloatColorBufferSize Deprecated.

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.BaselineResizeBehavior

Field Summary

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
SwRenderArea() Deprecated. create an SwRenderArea
SwRenderArea(boolean mouseInput, boolean keybordInput) Deprecated. create an SwRenderArea

Method Summary

Modifier and Type	Method and Description
void	addNotify() Deprecated. Creates the peer of the drawing area.
void	getAntialiasing(boolean[] smoothing, int[] numPasses) Deprecated. Get Anti-aliasing methods.
SbColor	getBackgroundColor() Deprecated. Gets the window background color when in RGB mode.
int	getBackgroundIndex() Deprecated. Gets the window background color when in color index mode.
static long	getDefaultRedrawPriority() Deprecated. get the default priority number.
SwRenderArea.FloatColorBufferSize	getFloatingPointRenderingPrecision() Deprecated. Returns the floating point rendering precision.
SoGLRenderAction	getGLRenderAction() Deprecated. This method return the SoGLRenderAction which is current in SceneManager
SoGLRenderAction.InvalidateCacheModes	getInvalidateCacheMode() Deprecated. Returns the current cache invalidation mode.
SoMPEGRenderer	getMPEGRecorder() Deprecated. Returns the recorder used for MPEG encoding.
long	getRedrawPriority() Deprecated. Gets the priority of the redraw sensor
SoNode	getSceneGraph() Deprecated. Gets the scene graph to render
SoSceneManager	getSceneManager() Deprecated. Gets the scene manager
int	getSortedTrianglesNumCaches() Deprecated. Get Sorted Triangles Num Caches
int	getSortedTrianglesSortFrequency() Deprecated. Get Sorted Triangles Sort Frequency
SoGLRenderAction.TransparencyTypes	getTransparencyType() Deprecated. Get Transparency type
SbViewportRegion	getViewportRegion() Deprecated. Gets current viewport region to use for rendering
boolean	isAutoRedraw() Deprecated. get whether render area will automatically redraw
boolean	isClearBeforeRender() Deprecated. Get whether window clearing is Enable
static boolean	isFloatingColorBufferSupported() Deprecated. Returns true if floating point rendering is available.
boolean	isInteractive() Deprecated.
void	processSoEvent(SoEvent e) Deprecated. This method allows RenderArea to process SoEvents.
void	redraw() Deprecated. Calling this forces the render area to be redrawn as soon as possible.
void	redrawOnSelectionChange(SoSelection s) Deprecated. Call this convenience method to have this render area redraw whenever the selection list changes in the passed node.
void	redrawOverlay() Deprecated.
void	removeNotify() Deprecated. Destroys the peer of the drawing area.
void	scheduleRedraw() Deprecated. Schedule a redraw to happen when necessary or as soon as possible depending of the auto redraw mode (see setAutoRedraw ).
void	setAntialiasing(boolean smoothing, int numPasses) Deprecated. Set Anti-aliasing methods.
void	setAutoRedraw(boolean trueOrFalse) Deprecated. The render area will automatically redraw whenever something in the scene graph changes.
void	setBackgroundColor(SbColor c) Deprecated. Sets the window background color when in RGB mode.
void	setBackgroundIndex(int index) Deprecated. Sets the window background color when in color index mode.
void	setClearBeforeRender(boolean trueOrFalse) Deprecated. Enable/prevent window clearing from happening before a rendering starts (default is clearBeforeRender true).
void	setFloatingColorBuffer(boolean enable, SwRenderArea.FloatColorBufferSize size) Deprecated. Enables/disables floating point rendering using 16- or 32-bit components.
void	setGLRenderAction(SoGLRenderAction ra) Deprecated. Access to GL render action
void	setInvalidateCacheMode(SoGLRenderAction.InvalidateCacheModes cache_mode) Deprecated. Set the current cache invalidation mode.
void	setMPEGRecorder(SoMPEGRenderer recorder) Deprecated. Sets the recorder used for MPEG encoding.
void	setOverlayColorMap(int startIndex, int num, SbColor[] colors) Deprecated.
void	setRedrawPriority(long priority) Deprecated. Sets the priority of the redraw sensor.
void	setSceneGraph(SoNode newScene) Deprecated. Sets the scene graph to render
void	setSize(SbVec2s v) Deprecated. set the size of the SwRenderArea form a SbVec2s
void	setTransparencyType(SoGLRenderAction.TransparencyTypes type) Deprecated. Transparency level setting methods which specifies how transparent objects are rendered (quality/speed trade off).
void	setViewportRegion(SbViewportRegion newRegion) Deprecated. Sets current viewport region to use for rendering

Methods inherited from class com.openinventor.inventor.awt.SwDrawingArea

getAreaPeer, getFullSceneAntialiasingQuality, getGLGraphicsConfig, getGLSharedContext, hasOpenGlStereoConfiguration, haveContext, isDoubleBuffer, isFullSceneAntialiasingEnabled, paint, setDoubleBuffer, setFullSceneAntialiasing, setFullSceneAntialiasing, setGLGraphicsConfigTemplate, setOpenGlStereoConfiguration, update

Methods inherited from class java.awt.Canvas

createBufferStrategy, createBufferStrategy, getAccessibleContext, getBufferStrategy

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, dispatchEvent, doLayout, enable, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

SwRenderArea

public SwRenderArea()

Deprecated.

create an SwRenderArea

SwRenderArea

public SwRenderArea(boolean mouseInput,
                    boolean keybordInput)

Deprecated.

create an SwRenderArea

Parameters:

mouseInput - true to register the mouse listener

keybordInput - true to register the keyboard listener

Method Detail

addNotify

public void addNotify()

Deprecated.

Description copied from class: SwDrawingArea

Creates the peer of the drawing area.

Overrides:

addNotify in class SwDrawingArea

See Also:

Canvas

removeNotify

public void removeNotify()

Deprecated.

Description copied from class: SwDrawingArea

Destroys the peer of the drawing area.

Overrides:

removeNotify in class SwDrawingArea

See Also:

Component

processSoEvent

public void processSoEvent(SoEvent e)

Deprecated.

This method allows RenderArea to process SoEvents. Note that Java events have already been transformed into SoEvents.

setSize

public void setSize(SbVec2s v)

Deprecated.

set the size of the SwRenderArea form a SbVec2s

Parameters:

v - new dimension

setSceneGraph

public void setSceneGraph(SoNode newScene)

Deprecated.

Sets the scene graph to render

getSceneGraph

public SoNode getSceneGraph()

Deprecated.

Gets the scene graph to render

setBackgroundColor

public void setBackgroundColor(SbColor c)

Deprecated.

Sets the window background color when in RGB mode. Default to black (0,0,0)

getBackgroundColor

public SbColor getBackgroundColor()

Deprecated.

Gets the window background color when in RGB mode.

setBackgroundIndex

public void setBackgroundIndex(int index)

Deprecated.

Sets the window background color when in color index mode. Default to black (index 0).

getBackgroundIndex

public int getBackgroundIndex()

Deprecated.

Gets the window background color when in color index mode.

setViewportRegion

public void setViewportRegion(SbViewportRegion newRegion)

Deprecated.

Sets current viewport region to use for rendering

getViewportRegion

public SbViewportRegion getViewportRegion()

Deprecated.

Gets current viewport region to use for rendering

setTransparencyType

public void setTransparencyType(SoGLRenderAction.TransparencyTypes type)

Deprecated.

Transparency level setting methods which specifies how transparent objects are rendered (quality/speed trade off).

Parameters:

type - see SoGLRenderAction.setTransparencyType(com.openinventor.inventor.actions.SoGLRenderAction.TransparencyTypes) for the possible values

getSortedTrianglesSortFrequency

public int getSortedTrianglesSortFrequency()

Deprecated.

Get Sorted Triangles Sort Frequency

getSortedTrianglesNumCaches

public int getSortedTrianglesNumCaches()

Deprecated.

Get Sorted Triangles Num Caches

getTransparencyType

public SoGLRenderAction.TransparencyTypes getTransparencyType()

Deprecated.

Get Transparency type

setAntialiasing

public void setAntialiasing(boolean smoothing,
                            int numPasses)

Deprecated.

Set Anti-aliasing methods.

getAntialiasing

public void getAntialiasing(boolean[] smoothing,
                            int[] numPasses)

Deprecated.

Get Anti-aliasing methods.

setClearBeforeRender

public void setClearBeforeRender(boolean trueOrFalse)

Deprecated.

Enable/prevent window clearing from happening before a rendering starts (default is clearBeforeRender true).

isClearBeforeRender

public boolean isClearBeforeRender()

Deprecated.

Get whether window clearing is Enable

setAutoRedraw

public void setAutoRedraw(boolean trueOrFalse)

Deprecated.

The render area will automatically redraw whenever something in the scene graph changes. Passing false to setAutoRedraw() will disable this feature. NOTE: the render area will always redraw in response to window system events (e.g. resize, exposure) regardless of the setting of the auto redraw flag.

See Also:

redraw(), scheduleRedraw(), isAutoRedraw()

isAutoRedraw

public boolean isAutoRedraw()

Deprecated.

get whether render area will automatically redraw

setRedrawPriority

public void setRedrawPriority(long priority)

Deprecated.

Sets the priority of the redraw sensor.

getRedrawPriority

public long getRedrawPriority()

Deprecated.

Gets the priority of the redraw sensor

getDefaultRedrawPriority

public static long getDefaultRedrawPriority()

Deprecated.

get the default priority number.

redraw

public void redraw()

Deprecated.

Calling this forces the render area to be redrawn as soon as possible. It is not necessary to call this method if auto redraw is enabled (which is the default).

See Also:

scheduleRedraw(), setAutoRedraw(boolean), isAutoRedraw()

redrawOverlay

public void redrawOverlay()

Deprecated.

scheduleRedraw

public void scheduleRedraw()

Deprecated.

Schedule a redraw to happen when necessary or as soon as possible depending of the auto redraw mode (see setAutoRedraw ). If auto-redraw is true (default), a redraw is done whenever something in the scene graph changes, otherwise a redraw is done "as soon as possible".

See Also:

redraw(), setAutoRedraw(boolean), isAutoRedraw()

redrawOnSelectionChange

public void redrawOnSelectionChange(SoSelection s)

Deprecated.

Call this convenience method to have this render area redraw whenever the selection list changes in the passed node. This is useful if using a highlight render action like the SoBoxHighlightRenderAction to correctly render whenever the selection changes. Pass null to turn this off.

getSceneManager

public SoSceneManager getSceneManager()

Deprecated.

Gets the scene manager

setGLRenderAction

public void setGLRenderAction(SoGLRenderAction ra)

Deprecated.

Access to GL render action

getGLRenderAction

public SoGLRenderAction getGLRenderAction()

Deprecated.

This method return the SoGLRenderAction which is current in SceneManager

setInvalidateCacheMode

public void setInvalidateCacheMode(SoGLRenderAction.InvalidateCacheModes cache_mode)

Deprecated.

Set the current cache invalidation mode.

See Also:

SoGLRenderAction.setInvalidateCacheMode(com.openinventor.inventor.actions.SoGLRenderAction.InvalidateCacheModes)

getInvalidateCacheMode

public SoGLRenderAction.InvalidateCacheModes getInvalidateCacheMode()

Deprecated.

Returns the current cache invalidation mode.

See Also:

setInvalidateCacheMode(com.openinventor.inventor.actions.SoGLRenderAction.InvalidateCacheModes)

setMPEGRecorder

public void setMPEGRecorder(SoMPEGRenderer recorder)

Deprecated.

Sets the recorder used for MPEG encoding.

Parameters:

recorder - the recorder to be used

getMPEGRecorder

public SoMPEGRenderer getMPEGRecorder()

Deprecated.

Returns the recorder used for MPEG encoding.

Returns:

the recorder

setFloatingColorBuffer

public void setFloatingColorBuffer(boolean enable,
                                   SwRenderArea.FloatColorBufferSize size)

Deprecated.

Enables/disables floating point rendering using 16- or 32-bit components. If true, Open Inventor will automatically render to an offscreen floating point buffer, and copy the resulting image to the screen. To determine if floating point rendering was successfully enabled, use #isFloatingColorBufferEnabled, below. Using floating point rendering can improve image quality, particularly when many objects are being blended, for example, in volume rendering.

Since:

6.0

getFloatingPointRenderingPrecision

public SwRenderArea.FloatColorBufferSize getFloatingPointRenderingPrecision()

Deprecated.

Returns the floating point rendering precision.

Since:

6.0

isFloatingColorBufferSupported

public static boolean isFloatingColorBufferSupported()

Deprecated.

Returns true if floating point rendering is available.

Since:

6.0

isInteractive

public boolean isInteractive()

Deprecated.

setOverlayColorMap

public void setOverlayColorMap(int startIndex,
                               int num,
                               SbColor[] colors)

Deprecated.