com.openinventor.inventor.elements

Class SoUpdateAreaElement

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.elements.SoElement

com.openinventor.inventor.elements.SoUpdateAreaElement

public class SoUpdateAreaElement
extends SoElement

Stores the rectangular area within the current viewport region that needs to be updated when rendering. This element stores the rectangular area within the current viewport region that needs to be updated when rendering. It can be used for partial rendering updates when applications know that only a portion of the objects need to be rerendered. Cameras can use the info in this element to set up a view volume against which culling can be performed.

This element also sets the GL scissor box to limit drawing.

The update area is specified in normalized viewport coordinates, where (0,0) is the lower left corner of the viewport and (1,1) is the upper right corner. The area is given as an origin and a size.

See also:

PoBaseView, SoGLRenderAction

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

Method Summary

Modifier and Type	Method and Description
static SbVec2f[]	get(SoState state) Returns current update area from the state.
static int	getClassStackIndex() Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)
static SbVec2f	getDefaultOrigin() Returns the default update area origin.
static SbVec2f	getDefaultSize() Returns the default update area size.
void	push(SoState state) Overrides push() method to copy values from next instance in the stack.
static void	set(SoState state, SbVec2f origin, SbVec2f size) Sets the current update area in the state.

Methods inherited from class com.openinventor.inventor.elements.SoElement

getClassStackIndex, pop

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Method Detail

getDefaultOrigin

public static SbVec2f getDefaultOrigin()

Returns the default update area origin.

getClassStackIndex

@Deprecated
public static int getClassStackIndex()

Deprecated. As of Open Inventor 9.3 replaced by SoElement.getClassStackIndex(Class)

Returns the stack id for this element.

• *

set

public static void set(SoState state,
                       SbVec2f origin,
                       SbVec2f size)

Sets the current update area in the state.

getDefaultSize

public static SbVec2f getDefaultSize()

Returns the default update area size.

push

public void push(SoState state)

Overrides push() method to copy values from next instance in the stack.

Overrides:

push in class SoElement

get

public static SbVec2f[] get(SoState state)

Returns current update area from the state. Returns true if the update area is the default, namely, the entire viewport.