com.openinventor.inventor.viewercomponents

Class SoRenderAreaCore

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.viewercomponents.SoRenderAreaCore

All Implemented Interfaces:

SafeDisposable, SiRenderArea, SiRenderAreaAntialiasing, SiRenderAreaInteractive, SiRenderAreaStereo, SiRenderAreaStillSuperSampling, SiRenderAreaTransparency

public class SoRenderAreaCore
extends Inventor
implements SiRenderAreaAntialiasing, SiRenderAreaTransparency, SiRenderAreaStereo, SiRenderAreaInteractive, SiRenderArea, SiRenderAreaStillSuperSampling, SafeDisposable

(Preview Feature) Utility class to render a scene with an OpenGl context.

Preview Feature means this class is fully supported and can be used in Open Inventor applications. Being tagged as a Preview Feature just means that the implementation is still subject to API changes and adjustments based on feedback from early adopters. Please be also aware that source compatibility might be broken regardless of the Open Inventor compatibility changes policy due to our commitment to bring needed changes to be sure the specifications of this Preview Feature match the expectations of our customers.

See also:

RenderArea

Nested Class Summary

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

Inventor.ConstructorCommand

Nested classes/interfaces inherited from interface com.openinventor.inventor.viewercomponents.SiRenderArea

SiRenderArea.ClearPolicies, SiRenderArea.RenderEventArg, SiRenderArea.RenderStatus

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoRenderAreaCore(SoGLContext glContext) Build a new SoRenderAreaCore that uses an existing glContext.

Method Summary

Modifier and Type	Method and Description
void	activateStereo(boolean activate) Activate (or deactivate) stereo rendering with specified parameters (see setStereoParameters).
boolean	dispose() Explicitly call this method to force object to dispose its unmanaged resources.
SoSceneManager.AntialiasingModes	getAntialiasingMode()
float	getAntialiasingQuality()
SbColorRGBA	getClearColor()
float	getClearDepth()
SiRenderArea.ClearPolicies	getClearPolicy()
SoInteractiveComplexity.InteractiveModes	getInteractiveMode()
SoNode	getSceneGraph()
SoSceneManager	getSceneManager() Returns the scene manager.
SbVec2i32	getSize()
SoStereoParameters	getStereoParameters()
int	getStillSuperSamplingDelay()
float	getStillSuperSamplingQuality()
SoGLRenderAction.TransparencyTypes	getTransparencyType()
SbViewportRegion	getViewportRegion()
boolean	isDisposable() Returns a boolean flag which indicates if it is safe to call SafeDisposable.dispose() on the object.
boolean	isStereoActivated()
SbEventHandler<SiRenderArea.RenderEventArg>	onStartRender() Returns the event handler that raises when a new render starts.
boolean	processEvent(SoEvent event) Processes the passed event by applying an SoHandleEventAction to the scene graph managed here.
boolean	processEvents(java.util.Collection<SoEvent> eventList) Processes the passed event by applying an SoHandleEventAction to the scene graph managed here.
SiRenderArea.RenderStatus	render() Applies an SoGLRenderAction to the scene graph managed here.
void	setAntialiasingMode(SoSceneManager.AntialiasingModes mode) Define the antialiasing mode.
void	setAntialiasingQuality(float quality) Define the antialiasing quality value.
void	setClearColor(SbColorRGBA color) Defines the RGBA value used when the color buffer is cleared.
void	setClearDepth(float depth) Defines the depth value used when the depth buffer is cleared.
void	setClearPolicy(SiRenderArea.ClearPolicies policy) Defines the color buffer and depth buffer clear policy.
void	setInteractiveMode(SoInteractiveComplexity.InteractiveModes mode) Set the current interactive mode.
void	setSceneGraph(SoNode newScene) Defines the scene graph which is managed here.
void	setSize(SbVec2i32 size) Defines the size to use for rendering.
void	setStereoParameters(SoStereoParameters parameters) Defines the stereo parameters.
void	setStillSuperSamplingDelay(int delay) Set delay for supersampling when "still" (not interacting).
void	setStillSuperSamplingQuality(float quality) Set quality for supersampling when "still" (not interacting).
void	setTransparencyType(SoGLRenderAction.TransparencyTypes type) Defines the algorithm for rendering transparent objects.

Methods inherited from class com.openinventor.inventor.Inventor

getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Constructor Detail

SoRenderAreaCore

public SoRenderAreaCore(SoGLContext glContext)

Build a new SoRenderAreaCore that uses an existing glContext.

Method Detail

onStartRender

public SbEventHandler<SiRenderArea.RenderEventArg> onStartRender()

Returns the event handler that raises when a new render starts.

Specified by:

onStartRender in interface SiRenderArea

isDisposable

public boolean isDisposable()

Description copied from interface: SafeDisposable

Returns a boolean flag which indicates if it is safe to call SafeDisposable.dispose() on the object.

Specified by:

isDisposable in interface SafeDisposable

Returns:

true if the object can be disposed in a safe manner

dispose

public boolean dispose()

Description copied from class: Inventor

Explicitly call this method to force object to dispose its unmanaged resources. The object may not be reused in the application code after this call.

Specified by:

dispose in interface SafeDisposable

Overrides:

dispose in class Inventor

Returns:

true if this object native resources were successfully disposed; false if it was already disposed or no native resources has been registered for this object.

getStillSuperSamplingQuality

public float getStillSuperSamplingQuality()

Specified by:

getStillSuperSamplingQuality in interface SiRenderAreaStillSuperSampling

See Also:

setStillSuperSamplingQuality()

setStillSuperSamplingDelay

public void setStillSuperSamplingDelay(int delay)

Set delay for supersampling when "still" (not interacting). If greater than 0, images will be supersampled after the specified delay.

Specified by:

setStillSuperSamplingDelay in interface SiRenderAreaStillSuperSampling

Parameters:

delay - The delay is in seconds.
If greater than 0, images will be supersampled after the specified delay See also setStillSuperSamplingQuality.

setSize

public void setSize(SbVec2i32 size)

Defines the size to use for rendering. Typically this method must be called when the render area has been resized or moved.

Specified by:

setSize in interface SiRenderArea

getSize

public SbVec2i32 getSize()

Specified by:

getSize in interface SiRenderArea

See Also:

setSize()

setTransparencyType

public void setTransparencyType(SoGLRenderAction.TransparencyTypes type)

Defines the algorithm for rendering transparent objects. Default is NO_SORT. See SoGLRenderAction for possible transparency types. See also SoGLRenderAction.TransparencyType.

Note: When using transparency types with DELAYED in the name, the depth buffer is not updated (depth buffer writes are disabled) while rendering transparent objects. As a result complex 3D shapes may not be rendered correctly.

Specified by:

setTransparencyType in interface SiRenderAreaTransparency

getTransparencyType

public SoGLRenderAction.TransparencyTypes getTransparencyType()

Specified by:

getTransparencyType in interface SiRenderAreaTransparency

See Also:

setTransparencyType()

setStillSuperSamplingQuality

public void setStillSuperSamplingQuality(float quality)

Set quality for supersampling when "still" (not interacting). When quality is greater than 0, still images will be automatically supersampled.

Specified by:

setStillSuperSamplingQuality in interface SiRenderAreaStillSuperSampling

Parameters:

quality - The quality is a factor in the range [0.0,1.0].
Default value is 0.0. Use the value 0.0 to turn off still supersampling. 0.5 is a typical value. See also setStillSuperSamplingDelay.

getViewportRegion

public SbViewportRegion getViewportRegion()

setViewportRegion().

setSceneGraph

public void setSceneGraph(SoNode newScene)

Defines the scene graph which is managed here. This is the Open Inventor scene which will be traversed for rendering and event processing.

Specified by:

setSceneGraph in interface SiRenderArea

getSceneGraph

public SoNode getSceneGraph()

Specified by:

getSceneGraph in interface SiRenderArea

See Also:

setSceneGraph()

activateStereo

public void activateStereo(boolean activate)

Activate (or deactivate) stereo rendering with specified parameters (see setStereoParameters). The stereo mode is determined by which subclass is used to set the parameters. For example, passing an SoRawStereoParameters object activates OpenGL "quad buffered" stereo (if possible on the current graphics board).

NOTES

• Stereo rendering needs a SoStereoCamera to be activated. The edited camera is the first stereo camera found in the current scene graph. If no stereo camera is found, a warning is displayed. This method must be called to update the edited camera if the scene graph changed.

Specified by:

activateStereo in interface SiRenderAreaStereo

getStillSuperSamplingDelay

public int getStillSuperSamplingDelay()

Specified by:

getStillSuperSamplingDelay in interface SiRenderAreaStillSuperSampling

See Also:

setStillSuperSamplingDelay()

render

public SiRenderArea.RenderStatus render()

Applies an SoGLRenderAction to the scene graph managed here. See RenderStatus documentation for details on the returned value. The rendering may have been aborted, so check this function result before calling swap buffer for example

Specified by:

render in interface SiRenderArea

processEvent

public boolean processEvent(SoEvent event)

Processes the passed event by applying an SoHandleEventAction to the scene graph managed here. Returns true if the event was handled by a node.

Specified by:

processEvent in interface SiRenderAreaInteractive

processEvents

public boolean processEvents(java.util.Collection<SoEvent> eventList)

Processes the passed event by applying an SoHandleEventAction to the scene graph managed here. Returns true if at least one event was handled by a node.

Specified by:

processEvents in interface SiRenderAreaInteractive

setClearPolicy

public void setClearPolicy(SiRenderArea.ClearPolicies policy)

Defines the color buffer and depth buffer clear policy. See also setClearColor and setClearDepth. Default is COLORBUFFER_AND_DEPTHBUFFER.

Specified by:

setClearPolicy in interface SiRenderArea

Parameters:

policy - color buffer and depth buffer clear policy.

isStereoActivated

public boolean isStereoActivated()

Specified by:

isStereoActivated in interface SiRenderAreaStereo

See Also:

activateStereo()

getStereoParameters

public SoStereoParameters getStereoParameters()

Specified by:

getStereoParameters in interface SiRenderAreaStereo

See Also:

setStereoParameters()

getClearPolicy

public SiRenderArea.ClearPolicies getClearPolicy()

Specified by:

getClearPolicy in interface SiRenderArea

See Also:

setClearPolicy()

setAntialiasingQuality

public void setAntialiasingQuality(float quality)

Define the antialiasing quality value.

Specified by:

setAntialiasingQuality in interface SiRenderAreaAntialiasing

Parameters:

quality - The quality is a factor in the range [0.0,1.0].
Default is 0.0. The value 0.0 turns off antialiasing.

getAntialiasingMode

public SoSceneManager.AntialiasingModes getAntialiasingMode()

Specified by:

getAntialiasingMode in interface SiRenderAreaAntialiasing

See Also:

setAntialiasingMode()

getAntialiasingQuality

public float getAntialiasingQuality()

Specified by:

getAntialiasingQuality in interface SiRenderAreaAntialiasing

See Also:

setAntialiasingQuality()

setAntialiasingMode

public void setAntialiasingMode(SoSceneManager.AntialiasingModes mode)

Define the antialiasing mode.

Specified by:

setAntialiasingMode in interface SiRenderAreaAntialiasing

Parameters:

mode - The antialiasing algorithm. Default is NO_ANTIALIASING which turns off antialiasing.

setInteractiveMode

public void setInteractiveMode(SoInteractiveComplexity.InteractiveModes mode)

Set the current interactive mode.

Specified by:

setInteractiveMode in interface SiRenderAreaInteractive

Parameters:

mode - interactive mode. Default is AUTO.

setClearDepth

public void setClearDepth(float depth)

Defines the depth value used when the depth buffer is cleared. See also setClearPolicy. Default is 1. Range is 0..1.

Specified by:

setClearDepth in interface SiRenderArea

Parameters:

depth - value used to clear the depth buffer.

getSceneManager

public SoSceneManager getSceneManager()

Returns the scene manager.

getClearDepth

public float getClearDepth()

Specified by:

getClearDepth in interface SiRenderArea

See Also:

setClearDepth()

setStereoParameters

public void setStereoParameters(SoStereoParameters parameters)

Defines the stereo parameters.

Specified by:

setStereoParameters in interface SiRenderAreaStereo

Parameters:

parameters - Provides specific parameters for a stereo mode. Use one of the subclasses of SoStereoParameters.NOTES

• SoRenderAreaCore makes a copy of the parameter values.

setClearColor

public void setClearColor(SbColorRGBA color)

Defines the RGBA value used when the color buffer is cleared. See also setClearPolicy. Default is transparent black (0,0,0,0).

This is equivalent to setBackgroundColor() in the classical view classes.

Specified by:

setClearColor in interface SiRenderArea

Parameters:

color - RGBA value used to clear the color buffer.

getInteractiveMode

public SoInteractiveComplexity.InteractiveModes getInteractiveMode()

Specified by:

getInteractiveMode in interface SiRenderAreaInteractive

See Also:

setInteractiveMode()

getClearColor

public SbColorRGBA getClearColor()

Specified by:

getClearColor in interface SiRenderArea

See Also:

setClearColor()