Package 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
    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(String errorMsg, 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 Details

    • 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(String errorMsg, 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.