AppStateManager (jMonkeyEngine3)

java.lang.Object
- com.jme3.app.state.AppStateManager

```
public class AppStateManager
extends java.lang.Object
```
The AppStateManager holds a list of AppStates which it will update and render.
When an AppState is attached or detached, the AppState.stateAttached(com.jme3.app.state.AppStateManager) and AppState.stateDetached(com.jme3.app.state.AppStateManager) methods will be called respectively.
The lifecycle for an attached AppState is as follows:
- stateAttached() : called when the state is attached on the thread on which the state was attached.
- initialize() : called ONCE on the render thread at the beginning of the next AppStateManager.update().
- stateDetached() : called when the state is detached on the thread on which the state was detached. This is not necessarily on the render thread and it is not necessarily safe to modify the scene graph, etc..
- cleanup() : called ONCE on the render thread at the beginning of the next update after the state has been detached or when the application is terminating.

Constructor Summary

Constructors
Constructor and Description

AppStateManager(Application app)

Constructors
Constructor and Description
`AppStateManager(Application app)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`attach(AppState state)` Attach a state to the AppStateManager, the same state cannot be attached twice.
`void`	`attachAll(AppState... states)` Attaches many state to the AppStateManager in a way that is guaranteed that they will all get initialized before any of their updates are run.
`void`	`attachAll(java.lang.Iterable<AppState> states)` Attaches many state to the AppStateManager in a way that is guaranteed that they will all get initialized before any of their updates are run.
`void`	`cleanup()` Calls cleanup on attached states, do not call directly.
`boolean`	`detach(AppState state)` Detaches the state from the AppStateManager.
`Application`	`getApplication()` Returns the Application to which this AppStateManager belongs.
`protected AppState[]`	`getInitializing()`
`<T extends AppState> T`	`getState(java.lang.Class<T> stateClass)` Returns the first state that is an instance of subclass of the specified class.
`<T extends AppState> T`	`getState(java.lang.Class<T> stateClass, boolean failOnMiss)` Returns the first state that is an instance of subclass of the specified class.
`<T extends AppState> T`	`getState(java.lang.String id, java.lang.Class<T> stateClass)` Returns the state associated with the specified ID at the time it was attached or null if not state was attached with that ID.
`protected AppState[]`	`getStates()`
`protected AppState[]`	`getTerminating()`
`boolean`	`hasState(AppState state)` Check if a state is attached or not.
`boolean`	`hasState(java.lang.String id)` Returns true if there is currently a state associated with the specified ID.
`protected void`	`initializePending()`
`void`	`postRender()` Calls render for all attached and initialized states, do not call directly.
`void`	`render(RenderManager rm)` Calls render for all attached and initialized states, do not call directly.
`<T extends AppState> T`	`stateForId(java.lang.String id, java.lang.Class<T> stateClass)` Returns the state associated with the specified ID at the time it was attached or throws an IllegalArgumentException if the ID was not found.
`protected void`	`terminatePending()`
`void`	`update(float tpf)` Calls update for attached states, do not call directly.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AppStateManager
```
public AppStateManager(Application app)
```
- Method Detail
  - getApplication
```
public Application getApplication()
```
    Returns the Application to which this AppStateManager belongs.
  - getInitializing
```
protected AppState[] getInitializing()
```
  - getTerminating
```
protected AppState[] getTerminating()
```
  - getStates
```
protected AppState[] getStates()
```
  - attach
```
public boolean attach(AppState state)
```
    Attach a state to the AppStateManager, the same state cannot be attached twice. Throws an IllegalArgumentException if the state has an ID and that ID has already been associated with another AppState.
    
    Parameters:
    
    state - The state to attach
    
    Returns:
    
    True if the state was successfully attached, false if the state was already attached.
  - attachAll
```
public void attachAll(AppState... states)
```
    Attaches many state to the AppStateManager in a way that is guaranteed that they will all get initialized before any of their updates are run. The same state cannot be attached twice and will be ignored.
    
    Parameters:
    
    states - The states to attach
  - attachAll
```
public void attachAll(java.lang.Iterable<AppState> states)
```
    Attaches many state to the AppStateManager in a way that is guaranteed that they will all get initialized before any of their updates are run. The same state cannot be attached twice and will be ignored.
    
    Parameters:
    
    states - The states to attach
  - detach
```
public boolean detach(AppState state)
```
    Detaches the state from the AppStateManager.
    
    Parameters:
    
    state - The state to detach
    
    Returns:
    
    True if the state was detached successfully, false if the state was not attached in the first place.
  - hasState
```
public boolean hasState(AppState state)
```
    Check if a state is attached or not.
    
    Parameters:
    
    state - The state to check
    
    Returns:
    
    True if the state is currently attached to this AppStateManager.
    
    See Also:
    
    attach(com.jme3.app.state.AppState)
  - getState
```
public <T extends AppState> T getState(java.lang.Class<T> stateClass)
```
    Returns the first state that is an instance of subclass of the specified class.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    stateClass -
    
    Returns:
    
    First attached state that is an instance of stateClass
  - getState
```
public <T extends AppState> T getState(java.lang.Class<T> stateClass,
                                       boolean failOnMiss)
```
    Returns the first state that is an instance of subclass of the specified class.
    
    Type Parameters:
    
    T -
    
    Parameters:
    
    stateClass -
    
    failOnMiss -
    
    Returns:
    
    First attached state that is an instance of stateClass. If failOnMiss is true then an IllegalArgumentException is thrown if the state is not attached.
  - getState
```
public <T extends AppState> T getState(java.lang.String id,
                                       java.lang.Class<T> stateClass)
```
    Returns the state associated with the specified ID at the time it was attached or null if not state was attached with that ID.
  - hasState
```
public boolean hasState(java.lang.String id)
```
    Returns true if there is currently a state associated with the specified ID.
  - stateForId
```
public <T extends AppState> T stateForId(java.lang.String id,
                                         java.lang.Class<T> stateClass)
```
    Returns the state associated with the specified ID at the time it was attached or throws an IllegalArgumentException if the ID was not found.
  - initializePending
```
protected void initializePending()
```
  - terminatePending
```
protected void terminatePending()
```
  - update
```
public void update(float tpf)
```
    Calls update for attached states, do not call directly.
    
    Parameters:
    
    tpf - Time per frame.
  - render
```
public void render(RenderManager rm)
```
    Calls render for all attached and initialized states, do not call directly.
    
    Parameters:
    
    rm - The RenderManager
  - postRender
```
public void postRender()
```
    Calls render for all attached and initialized states, do not call directly.
  - cleanup
```
public void cleanup()
```
    Calls cleanup on attached states, do not call directly.

Class AppStateManager

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AppStateManager

Method Detail

getApplication

getInitializing

getTerminating

getStates

attach

attachAll

attachAll

detach

hasState

getState

getState

getState

hasState

stateForId

initializePending

terminatePending

update

render

postRender

cleanup