159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/* 259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Copyright (c) 2009-2010 jMonkeyEngine 359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * All rights reserved. 459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Redistribution and use in source and binary forms, with or without 659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * modification, are permitted provided that the following conditions are 759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * met: 859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions of source code must retain the above copyright 1059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer. 1159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions in binary form must reproduce the above copyright 1359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer in the 1459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * documentation and/or other materials provided with the distribution. 1559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Neither the name of 'jMonkeyEngine' nor the names of its contributors 1759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * may be used to endorse or promote products derived from this software 1859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * without specific prior written permission. 1959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 2059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 2259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 2359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 2459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 2559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 2659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 2759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 2859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 2959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 3059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 3259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3359b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapackage com.jme3.system; 3459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/** 3659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * The <code>ContextListener> provides a means for an application 3759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * to receive events relating to a context. 3859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 3959b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapublic interface SystemListener { 4059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 4159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 4259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Callback to indicate the application to initialize. This method 4359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * is called in the GL/Rendering thread so any GL-dependent resources 4459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * can be initialized. 4559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 4659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void initialize(); 4759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 4859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 4959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Called to notify the application that the resolution has changed. 5059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param width 5159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param height 5259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 5359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void reshape(int width, int height); 5459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 5659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Callback to update the application state, and render the scene 5759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * to the back buffer. 5859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 5959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void update(); 6059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 6159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 6259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Called when the user requests to close the application. This 6359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * could happen when he clicks the X button on the window, presses 6459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the Alt-F4 combination, attempts to shutdown the process from 6559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the task manager, or presses ESC. 6659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param esc If true, the user pressed ESC to close the application. 6759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void requestClose(boolean esc); 6959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 7159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Called when the application gained focus. The display 7259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * implementation is not allowed to call this method before 7359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * initialize() has been called or after destroy() has been called. 7459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 7559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void gainFocus(); 7659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 7859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Called when the application lost focus. The display 7959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * implementation is not allowed to call this method before 8059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * initialize() has been called or after destroy() has been called. 8159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 8259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void loseFocus(); 8359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 8459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 8559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Called when an error has occured. This is typically 8659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * invoked when an uncought exception is thrown in the render thread. 8759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param errorMsg The error message, if any, or null. 8859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param t Throwable object, or null. 8959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 9059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void handleError(String errorMsg, Throwable t); 9159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 9359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Callback to indicate that the context has been destroyed (either 9459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * by the user or requested by the application itself). Typically 9559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * cleanup of native resources should happen here. This method is called 9659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * in the GL/Rendering thread. 9759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 9859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void destroy(); 9959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta} 100