com.jme3.system

Interface SystemListener

All Known Implementing Classes:

AndroidHarness, AndroidHarnessFragment, JmeSurfaceView, LegacyApplication, SimpleApplication, VRApplication

public interface SystemListener

The SystemListener provides a means for an application to receive events relating to a context.

Method Summary

Modifier and Type	Method and Description
void	destroy() Callback to indicate that the context has been destroyed (either by the user or requested by the application itself).
void	gainFocus() Called when the application gained focus.
void	handleError(java.lang.String errorMsg, java.lang.Throwable t) Called when an error has occurred.
void	initialize() Callback to indicate the application to initialize.
void	loseFocus() Called when the application lost focus.
void	requestClose(boolean esc) Called when the user requests to close the application.
default void	rescale(float x, float y) Called to notify the application that the scale has changed.
void	reshape(int width, int height) Called to notify the application that the resolution has changed.
void	update() Callback to update the application state, and render the scene to the back buffer.

Method Detail

initialize

void initialize()

Callback to indicate the application to initialize. This method is called in the GL/Rendering thread so any GL-dependent resources can be initialized.

reshape

void reshape(int width,
             int height)

Called to notify the application that the resolution has changed.

Parameters:

width - the new width of the display (in pixels, ≥0)

height - the new height of the display (in pixels, ≥0)

rescale

default void rescale(float x,
                     float y)

Called to notify the application that the scale has changed.

Parameters:

x - the new horizontal scale of the display

y - the new vertical scale of the display

update

void update()

Callback to update the application state, and render the scene to the back buffer.

requestClose

void requestClose(boolean esc)

Called when the user requests to close the application. This could happen when he clicks the X button on the window, presses the Alt-F4 combination, attempts to shut down the process from the task manager, or presses ESC.

Parameters:

esc - If true, the user pressed ESC to close the application.

gainFocus

void gainFocus()

Called when the application gained focus. The display implementation is not allowed to call this method before initialize() has been called or after destroy() has been called.

loseFocus

void loseFocus()

Called when the application lost focus. The display implementation is not allowed to call this method before initialize() has been called or after destroy() has been called.

handleError

void handleError(java.lang.String errorMsg,
                 java.lang.Throwable t)

Called when an error has occurred. This is typically invoked when an uncaught exception is thrown in the render thread.

Parameters:

errorMsg - The error message, if any, or null.

t - Throwable object, or null.

destroy

void destroy()

Callback to indicate that the context has been destroyed (either by the user or requested by the application itself). Typically cleanup of native resources should happen here. This method is called in the GL/Rendering thread.