com.openinventor.remoteviz.rendering

Class RenderArea

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.remoteviz.rendering.RenderArea

public class RenderArea
extends Inventor

Defines the rendering area.
The implementation of the class RenderAreaListener allows managing the renderArea events.
When using ServiceSettings.INVENTOR_SERVICE or ServiceSettings.INVENTOR_APPLICATION service mode, this class provides access to the scene manager and the touch manager to modify the rendering.

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
void	addListener(RenderAreaListener listener) Adds a RenderAreaListener to manage the renderArea.
void	closeConnectionsAndDispose() Closes all connections of the renderArea and disposes it.
Connection	getConnection(int index) Gets a Connection to the renderArea.
Connection	getConnection(java.lang.String id) Gets a Connection to the renderArea.
SoGLContext	getGLContext() Gets the OpenGL context of the renderArea.
java.lang.String	getGpu() Gets the Graphics Processing Unit (GPU) used to compute the render.
int	getHeight() Gets the renderArea height.
java.lang.String	getId() Gets the renderArea id.
int	getNumConnections() Gets the connections number of the renderArea.
int	getNumListeners() Gets the number of RenderAreaListener.
SoSceneManager	getSceneManager() Gets the Scene manager of the renderArea.
SoTouchManager	getTouchManager() Gets the Touch Manager of the renderArea.
int	getWidth() Gets the renderArea width.
void	removeAllListeners() Removes all RenderAreaListeners.
void	removeListener(RenderAreaListener listener) Removes a RenderAreaListener.
void	resize(int width, int height) Resizes the renderArea at a specific size.
boolean	sendMessage(byte[] buffer) Calls sendMessage(buffer, (com.openinventor.remoteviz.rendering.Connection[])null).
boolean	sendMessage(byte[] buffer, Connection[] excludedConnections) Sends a binary message to the renderArea connections.
boolean	sendMessage(java.lang.String message) Calls sendMessage(message, (com.openinventor.remoteviz.rendering.Connection[])null).
boolean	sendMessage(java.lang.String message, Connection[] excludedConnections) Sends a text message to the renderArea connections.

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

sendMessage

public boolean sendMessage(java.lang.String message)

Calls sendMessage(message, (com.openinventor.remoteviz.rendering.Connection[])null).

sendMessage

public boolean sendMessage(byte[] buffer)

Calls sendMessage(buffer, (com.openinventor.remoteviz.rendering.Connection[])null).

getNumConnections

public int getNumConnections()

Gets the connections number of the renderArea.

Returns:

the number of connections

getGpu

public java.lang.String getGpu()

Gets the Graphics Processing Unit (GPU) used to compute the render.
GPU can be defined in ServiceListener.onPendingCreateRenderArea.

Returns:

gpu used to compute the render.

See Also:

RenderAreaHardware.setGpu

getSceneManager

public SoSceneManager getSceneManager()

Gets the Scene manager of the renderArea.
In the ServiceSettings.INDEPENDENT_SERVICE mode, this method returns nullptr.

Returns:

a pointer to the sceneManager

getNumListeners

public int getNumListeners()

Gets the number of RenderAreaListener.

Returns:

number of RenderAreaListener.

getId

public java.lang.String getId()

Gets the renderArea id.

Returns:

the ID identifying the renderArea

getHeight

public int getHeight()

Gets the renderArea height.

Returns:

the renderArea height

getConnection

public Connection getConnection(int index)

Gets a Connection to the renderArea.

Parameters:

index - : index identifying the Connection

Returns:

a pointer to the connection if the index exists, otherwise returns nullptr.

getConnection

public Connection getConnection(java.lang.String id)

Gets a Connection to the renderArea.

Parameters:

id - : ID identifying the Connection

Returns:

a pointer to the connection if the id exists, otherwise returns nullptr.

closeConnectionsAndDispose

public void closeConnectionsAndDispose()

Closes all connections of the renderArea and disposes it. If connections are still open, this method will close them and dispose the renderArea. While executing this method, the listeners ServiceListener.onDisposingRenderArea and ServiceListener.onDisposedRenderArea will be triggered and a DISPOSED disconnect message will be sent to all clients of the renderArea. The listener RenderAreaListener.onClosedConnection will not be triggered after closing connections.

sendMessage

public boolean sendMessage(java.lang.String message,
                           Connection[] excludedConnections)

Sends a text message to the renderArea connections.

Parameters:

message - : the message to be sent to all connections of the renderArea

excludedConnections - : pointer to an excluded connections array

num - : number of excluded connections

Returns:

true if the message has been successfully sent to all connections, otherwise returns false.

sendMessage

public boolean sendMessage(byte[] buffer,
                           Connection[] excludedConnections)

Sends a binary message to the renderArea connections.

Parameters:

buffer - : the binary buffer to be sent to all connections of the renderArea

size - : the buffer size

excludedConnections - : pointer to an excluded connections array

num - : number of excluded connections

Returns:

true if the message has been successfully sent to all connections, otherwise returns false.

getWidth

public int getWidth()

Gets the renderArea width.

Returns:

the renderArea width

resize

public void resize(int width,
                   int height)

Resizes the renderArea at a specific size. After resizing, a notification will be sent to all the renderArea clients. The minimum size is (128, 128) and the maximum size is (3840, 2160). If the size is inferior or superior to the limit, it will be adjusted automatically.

Parameters:

width - : new width of the renderArea

height - : new height of the renderArea

See Also:

RenderAreaListener.onResize

getTouchManager

public SoTouchManager getTouchManager()

Gets the Touch Manager of the renderArea.
In the ServiceSettings.INDEPENDENT_SERVICE mode, this method returns nullptr.

Returns:

a pointer to the sceneManager

removeAllListeners

public void removeAllListeners()

Removes all RenderAreaListeners.

removeListener

public void removeListener(RenderAreaListener listener)

Removes a RenderAreaListener.

Parameters:

listener - : shared_ptr pointer to the class that implements RenderAreaListener

addListener

public void addListener(RenderAreaListener listener)

Adds a RenderAreaListener to manage the renderArea.

Parameters:

listener - : shared_ptr pointer to the class that implements RenderAreaListener

getGLContext

public SoGLContext getGLContext()

Gets the OpenGL context of the renderArea.
In the ServiceSettings.INDEPENDENT_SERVICE mode, this method returns nullptr.

Returns:

a pointer to the SoGLContext