|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.jme3.app.Application
public class Application
The Application
class represents an instance of a
real-time 3D rendering jME application.
An Application
provides all the tools that are commonly used in jME3
applications.
jME3 applications should extend this class and call start() to begin the
application.
Field Summary | |
---|---|
protected AssetManager |
assetManager
|
protected AudioRenderer |
audioRenderer
|
protected Camera |
cam
|
protected JmeContext |
context
|
protected ViewPort |
guiViewPort
|
protected boolean |
inputEnabled
|
protected InputManager |
inputManager
|
protected JoyInput |
joyInput
|
protected KeyInput |
keyInput
|
protected Listener |
listener
|
protected MouseInput |
mouseInput
|
protected boolean |
paused
|
protected boolean |
pauseOnFocus
|
protected Renderer |
renderer
|
protected RenderManager |
renderManager
|
protected AppSettings |
settings
|
protected float |
speed
|
protected AppStateManager |
stateManager
|
protected Timer |
timer
|
protected TouchInput |
touchInput
|
protected ViewPort |
viewPort
|
Constructor Summary | |
---|---|
Application()
Create a new instance of Application . |
Method Summary | ||
---|---|---|
void |
createCanvas()
Initializes the application's canvas for use. |
|
void |
destroy()
Do not call manually. |
|
protected void |
destroyInput()
|
|
|
enqueue(java.util.concurrent.Callable<V> callable)
Enqueues a task/callable object to execute in the jME3 rendering thread. |
|
void |
gainFocus()
Internal use only. |
|
AssetManager |
getAssetManager()
|
|
AudioRenderer |
getAudioRenderer()
|
|
Camera |
getCamera()
|
|
JmeContext |
getContext()
|
|
ViewPort |
getGuiViewPort()
|
|
InputManager |
getInputManager()
|
|
Listener |
getListener()
|
|
Renderer |
getRenderer()
|
|
RenderManager |
getRenderManager()
|
|
AppStateManager |
getStateManager()
|
|
Timer |
getTimer()
|
|
ViewPort |
getViewPort()
|
|
void |
handleError(java.lang.String errMsg,
java.lang.Throwable t)
Internal use only. |
|
void |
initialize()
Do not call manually. |
|
boolean |
isPauseOnLostFocus()
Returns true if pause on lost focus is enabled, false otherwise. |
|
void |
loseFocus()
Internal use only. |
|
void |
requestClose(boolean esc)
Internal use only. |
|
void |
reshape(int w,
int h)
Internal use only. |
|
void |
restart()
Restarts the context, applying any changed settings. |
|
protected void |
runQueuedTasks()
Runs tasks enqueued via enqueue(Callable) |
|
void |
setAssetManager(AssetManager assetManager)
Deprecated. |
|
void |
setPauseOnLostFocus(boolean pauseOnLostFocus)
Enable or disable pause on lost focus. |
|
void |
setSettings(AppSettings settings)
Set the display settings to define the display created. |
|
void |
setTimer(Timer timer)
Sets the Timer implementation that will be used for calculating frame times. |
|
void |
start()
Starts the application in display mode. |
|
void |
start(JmeContext.Type contextType)
Starts the application. |
|
void |
startCanvas()
Starts the rendering thread after createCanvas() has been called. |
|
void |
startCanvas(boolean waitFor)
Starts the rendering thread after createCanvas() has been called. |
|
void |
stop()
Requests the context to close, shutting down the main loop and making necessary cleanup operations. |
|
void |
stop(boolean waitFor)
Requests the context to close, shutting down the main loop and making necessary cleanup operations. |
|
void |
update()
Do not call manually. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected AssetManager assetManager
protected AudioRenderer audioRenderer
protected Renderer renderer
protected RenderManager renderManager
protected ViewPort viewPort
protected ViewPort guiViewPort
protected JmeContext context
protected AppSettings settings
protected Timer timer
protected Camera cam
protected Listener listener
protected boolean inputEnabled
protected boolean pauseOnFocus
protected float speed
protected boolean paused
protected MouseInput mouseInput
protected KeyInput keyInput
protected JoyInput joyInput
protected TouchInput touchInput
protected InputManager inputManager
protected AppStateManager stateManager
Constructor Detail |
---|
public Application()
Application
.
Method Detail |
---|
public boolean isPauseOnLostFocus()
setPauseOnLostFocus(boolean)
public void setPauseOnLostFocus(boolean pauseOnLostFocus)
By default, pause on lost focus is enabled. If enabled, the application will stop updating when it loses focus or becomes inactive (e.g. alt-tab). For online or real-time applications, this might not be preferable, so this feature should be set to disabled. For other applications, it is best to keep it on so that CPU usage is not used when not necessary.
pauseOnLostFocus
- True to enable pause on lost focus, false
otherwise.@Deprecated public void setAssetManager(AssetManager assetManager)
public void setSettings(AppSettings settings)
Examples of display parameters include display pixel width and height,
color bit depth, z-buffer bits, anti-aliasing samples, and update frequency.
If this method is called while the application is already running, then
restart()
must be called to apply the settings to the display.
settings
- The settings to set.public void setTimer(Timer timer)
public Timer getTimer()
public AssetManager getAssetManager()
asset manager
for this application.public InputManager getInputManager()
input manager
.public AppStateManager getStateManager()
app state manager
public RenderManager getRenderManager()
render manager
public Renderer getRenderer()
renderer
for the applicationpublic AudioRenderer getAudioRenderer()
audio renderer
for the applicationpublic Listener getListener()
listener
object for audiopublic JmeContext getContext()
display context
for the applicationpublic Camera getCamera()
camera
for the applicationpublic void start()
display
mode.
start(com.jme3.system.JmeContext.Type)
public void start(JmeContext.Type contextType)
public void createCanvas()
After calling this method, cast the context
to
JmeCanvasContext
,
then acquire the canvas with JmeCanvasContext.getCanvas()
and attach it to an AWT/Swing Frame.
The rendering thread will start when the canvas becomes visible on
screen, however if you wish to start the context immediately you
may call startCanvas()
to force the rendering thread
to start.
JmeCanvasContext
,
JmeContext.Type.Canvas
public void startCanvas()
Same as calling startCanvas(false)
startCanvas(boolean)
public void startCanvas(boolean waitFor)
Calling this method is optional, the canvas will start automatically when it becomes visible.
waitFor
- If true, the current thread will block until the
rendering thread is runningpublic void reshape(int w, int h)
reshape
in interface SystemListener
public void restart()
Changes to the AppSettings
of this Application are not
applied immediately; calling this method forces the context
to restart, applying the new settings.
public void stop()
stop(boolean)
public void stop(boolean waitFor)
public void initialize()
Initializes the Application
, by creating a display and
default camera. If display settings are not specified, a default
640x480 display is created. Default values are used for the camera;
perspective projection with 45° field of view, with near
and far values 1 and 1000 units respectively.
initialize
in interface SystemListener
public void handleError(java.lang.String errMsg, java.lang.Throwable t)
handleError
in interface SystemListener
errMsg
- The error message, if any, or null.t
- Throwable object, or null.public void gainFocus()
gainFocus
in interface SystemListener
public void loseFocus()
loseFocus
in interface SystemListener
public void requestClose(boolean esc)
requestClose
in interface SystemListener
esc
- If true, the user pressed ESC to close the application.public <V> java.util.concurrent.Future<V> enqueue(java.util.concurrent.Callable<V> callable)
Callables are executed right at the beginning of the main loop. They are executed even if the application is currently paused or out of focus.
protected void runQueuedTasks()
enqueue(Callable)
public void update()
update
in interface SystemListener
protected void destroyInput()
public void destroy()
destroy
in interface SystemListener
public ViewPort getGuiViewPort()
public ViewPort getViewPort()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |