Class RenderArea


  • public class RenderArea
    extends Inventor
    Defines the rendering area for Open Inventor rendering. Implement the class RenderAreaListener to receive 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.

    A RenderArea object may be created automatically by RemoteViz or created explicitly by the application. When a client requests a connection (see RemoteVizRenderArea.connectTo()), it specifies a render area id. If a render area with that id does not exist, RemoteViz will create one and ServiceListener.onPendingCreateRenderArea() will be called. If a render area with the requested id exists, RemoteViz will use that one and ServiceListener.onPendingShareRenderArea() will be called. An application might want to explicitly create a render area, for example, to preload a default scene graph.

    A RenderArea may have zero, one or multiple connections.

    A RenderArea allows the application to send text or binary messages to the associated client. A JavaScript client will receive the message using a listener (see RemoteVizRenderArea.addServiceListener). Messages from a client are received using one of the RenderAreaListener.onReceivedMessage() methods.

    • Method Detail

      • sendMessage

        public boolean sendMessage​(java.lang.String message)
        Calls sendMessage(message, new java.util.ArrayList<>()).
      • sendMessage

        public boolean sendMessage​(java.util.Collection<java.lang.Byte> buffer)
        Calls sendMessage(buffer, new java.util.ArrayList<>()).
      • getGpu

        public java.lang.String getGpu()
        Gets the Graphics Processing Unit (GPU) used to render images. GPU can be defined in ServiceListener.onPendingCreateRenderArea.
        Returns:
        gpu used to compute the render.

        See Also:
        RenderAreaHardware.setGpu
      • getConnection

        public Connection getConnection​(int index)
        Gets an existing Connection to the renderArea.

        Parameters:
        index - : index identifying the Connection

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

      • getNumConnections

        public int getNumConnections()
        Gets the number of connections (see Connection) that exist for this renderArea.

        Returns:
        the number of connections

      • getHeight

        public int getHeight()
        Gets the renderArea height.

        Returns:
        the renderArea height

      • isDisposed

        public boolean isDisposed()
        Gets the state of the RenderArea: alive or disposed. RemoteViz does not keep a reference to the RenderArea object after the object is disposed. If the application kept a reference to the object, this method can be used to query its state.

        The state "disposed" will be set just after triggering the listener ServiceListener.onDisposingRenderArea.

        Returns:
        true if the renderArea is disposed or false if the renderArea is alive.

      • getConnection

        public Connection getConnection​(java.lang.String id)
        Gets an existing Connection to the renderArea.

        Parameters:
        id - : ID identifying the Connection

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

      • getId

        public java.lang.String getId()
        Gets the renderArea id.

        Returns:
        the ID identifying the renderArea

      • sendMessage

        public boolean sendMessage​(java.lang.String message,
                                   java.util.Collection<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

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

      • sendMessage

        public boolean sendMessage​(java.util.Collection<java.lang.Byte> buffer,
                                   java.util.Collection<Connection> excludedConnections)
        Sends a binary message to the renderArea connections.

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

        excludedConnections - : pointer to an excluded connections array

        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
      • removeAllListeners

        public void removeAllListeners()
        Removes all RenderAreaListeners.
      • getSceneManager

        public SoSceneManager getSceneManager()
        Gets the Open Inventor scene manager associated with the renderArea. This object is created automatically by RemoteViz.

        In the ServiceSettings.INDEPENDENT_SERVICE mode, this method returns nullptr.

        Returns:
        a pointer to the sceneManager

      • getTouchManager

        public SoTouchManager getTouchManager()
        Gets the Open Inventor touch manager associated with the renderArea. This object is created automatically by RemoteViz.

        In the ServiceSettings.INDEPENDENT_SERVICE mode, this method returns nullptr.

        Returns:
        a pointer to the sceneManager