jMonkeyEngine-wiki/docs/modules/contributions/pages/gui/tonegodgui/screen.adoc

= screen
:revnumber: 2.0
:revdate: 2020/07/25



== The Screen Class

You can create a screen using one of the two provided constructors as shown in the xref:gui/tonegodgui/quickstart.adoc[Quick Start Guide].

[source,java]
----

// this = any JME Application
Screen screen = new Screen(this);
guiNode.addControl(screen);

----

Optionally, you can provide a path to a custom Style theme:

[source,java]
----

// this = any JME Application
Screen screen = new Screen(this, "tonegod/gui/style/def/style_map.xml");
guiNode.addControl(screen);

----

To make use of custom cursors, call this method prior to initializing the screen:

[source,java]
----

screen.setUseCustomCursors(true);

----

You can disable and re-enable custom cursors at any point, but they must be initialized with the screen to be loaded.

Cursor Effects can be enabled/disabled at anytime by calling:

[source,java]
----

screen.setUseCursorEffects(boolean useCursorEffects);

----

Tool Tips can be enabled/disabled at anytime by calling:

[source,java]
----

screen.setUseToolTips(boolean useToolTips);

----

Audio can be enabled/disabled at anytime by calling:

[source,java]
----

screen.setUseUIAudio(boolean useUIAudio);

----



=== Application quick references methods:

[source,java]
----

screen.getApplication();

// Screen dimensions
screen.getWidth();
screen.getHeight();

// Mouse position
screen.getMouseXY(); // returns a Vector2f containing current mouse x/y

----


=== Methods for adding remove base level controls:

[source,java]
----

screen.addElement(Element element);
screen.removeElement(Element element);

----


=== Z-Order Methods:

[source,java]
----

// Bring the specified Element to the front
screen.updateZOrder(Element topMost);

----


=== Accessing the EffectManager:

[source,java]
----

screen.getEffectManager();

----


=== Retrieving a Style:

[source,java]
----

screen.getStyle(String tagName);

----


=== Custom Cursor Related Methods:

[source,java]
----

screen.setCursor(Screen.CursorType cur); // called by controls
screen.setForcedCursor(Screen.CursorType cur); // Overrides control manipulation of cursor.
screen.releaseForcedCursor(); // Release cursor manipulation back to controls

----


=== Retrieving Elements

[source,java]
----

// Recursive search
screen.getElementById(String UID);

----


=== UI Global Alpha Settings:

[source,java]
----

screen.setGlobalAlpha(float globalAlpha);
screen.getGlobalAlpha();

----


=== UI Global Audio Settings:

[source,java]
----

screen.setUseUIAudio(boolean useUIAudio);
screen.getUseUIAudio();
screen.setUIAudioVolume(float uiAudioVolume);
screen.getUIAudioVolume();
screen.playAudioNode(String key, float volume);

----


=== Enabling Global Texture Atlas Use

Keep in mind, that it is possible to enable texture atlas usage per element without enabling global texture atlas use.

[source,java]
----

screen.setUseTextureAtlas(boolean useTextureAtlas, String texturePath);
screen.getUseTextureAtlas();
screen.getAtlasTexture();

----