mitm001 5 år sedan
förälder
incheckning
c78c32d29d

+ 4 - 4
docs/modules/core/pages/gui/nifty_gui_java_interaction.adoc

@@ -5,9 +5,9 @@
 
 
 .  xref:gui/nifty_gui.adoc[Nifty GUI Concepts]
-.  <<jme3/advanced/nifty_gui_best_practices#,Nifty GUI Best Practices>>
-.  <<jme3/advanced/nifty_gui_xml_layout#,Nifty GUI XML Layout>> or <<jme3/advanced/nifty_gui_java_layout#,Nifty GUI Java Layout>>
-.  <<jme3/advanced/nifty_gui_overlay#,Nifty GUI Overlay>> or <<jme3/advanced/nifty_gui_projection#,Nifty GUI Projection>>
+.  xref:gui/nifty_gui_best_practices.adoc[Nifty GUI Best Practices]
+.  xref:gui/nifty_gui_xml_layout.adoc[Nifty GUI XML Layout] or xref:gui/nifty_gui_java_layout.adoc[Nifty GUI Java Layout]
+.  xref:gui/nifty_gui_overlay.adoc[Nifty GUI Overlay] or xref:gui/nifty_gui_projection.adoc[Nifty GUI Projection]
 .  *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ Java Interaction*
 
 In the previous parts of the tutorial, you created a two-screen user interface. But it is still static, and when you click the buttons, nothing happens yet. The purpose of the +++<abbr title="Graphical User Interface">GUI</abbr>+++ is to communicate with your Java classes: Your game needs to know what the users clicked, which settings they chose, which values they entered into a field, etc. Similarly, the user needs to know what the currently game state is (score, health, etc).
@@ -345,6 +345,6 @@ For this to work, there already needs to be a (possibly inactive) `<interact />`
 
 You're done with the basic Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ for jME3 tutorial. You can proceed to advanced topics and learn how add controls and effects:
 
-*  <<jme3/advanced/nifty_gui_scenarios#, Nifty GUI Scenarios>>
+*  xref:gui/nifty_gui_scenarios.adoc[ Nifty GUI Scenarios]
 *  link:https://github.com/nifty-gui/nifty-gui/raw/1.4/nifty-core/manual/nifty-gui-the-manual-1.3.2.pdf[Nifty GUI - the Manual]
 *  link:https://github.com/nifty-gui/nifty-gui/wiki/Controls[Controls]

+ 7 - 7
docs/modules/core/pages/gui/nifty_gui_java_layout.adoc

@@ -5,10 +5,10 @@
 
 
 .  xref:gui/nifty_gui.adoc[Nifty GUI Concepts]
-.  <<jme3/advanced/nifty_gui_best_practices#,Nifty GUI Best Practices>>
-.  <<jme3/advanced/nifty_gui_xml_layout#,Nifty GUI XML Layout>> or *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ Java Layout*
-.  <<jme3/advanced/nifty_gui_overlay#,Nifty GUI Overlay>> or <<jme3/advanced/nifty_gui_projection#,Nifty GUI Projection>>
-.  <<jme3/advanced/nifty_gui_java_interaction#,Interact with the GUI from Java>>
+.  xref:gui/nifty_gui_best_practices.adoc[Nifty GUI Best Practices]
+.  xref:gui/nifty_gui_xml_layout.adoc[Nifty GUI XML Layout] or *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ Java Layout*
+.  xref:gui/nifty_gui_overlay.adoc[Nifty GUI Overlay] or xref:gui/nifty_gui_projection.adoc[Nifty GUI Projection]
+.  xref:gui/nifty_gui_java_interaction.adoc[Interact with the GUI from Java]
 
 You can "`draw`" the +++<abbr title="Graphical User Interface">GUI</abbr>+++ to the screen by writing Java code – alternatively to using XML. Typically you lay out the static base +++<abbr title="Graphical User Interface">GUI</abbr>+++ in XML, and use Java commands if you need to change the +++<abbr title="Graphical User Interface">GUI</abbr>+++ dynamically at runtime. In theory, you can also lay out the whole +++<abbr title="Graphical User Interface">GUI</abbr>+++ in Java (but we don't cover that here).
 
@@ -134,7 +134,7 @@ public class MyStartScreen extends BaseAppState {
 image::gui/gui-layout-draft.png[gui-layout-draft.png,width="",height="",align="left"]
 
 
-In this tutorial, you recreate the same screen as in the <<jme3/advanced/nifty_gui_xml_layout#, Laying out the GUI in XML>> example.
+In this tutorial, you recreate the same screen as in the xref:gui/nifty_gui_xml_layout.adoc[ Laying out the GUI in XML] example.
 
 Create an Screen.Java file that extends BaseAppState in the mygame directory of your project. One Java file can contain several, or even all screens. As a reminder: Nifty displays one screen at a time; a screen contains several layers on top of one another; each layer contains panels that are embedded into another; the panels contain the actual content (text, images, or controls).
 
@@ -870,5 +870,5 @@ nifty.registerMouseCursor("hand", "Interface/mouse-cursor-hand.png", 5, 4);
 
 Integrate the +++<abbr title="Graphical User Interface">GUI</abbr>+++ into the game. Typically, you will overlay the +++<abbr title="Graphical User Interface">GUI</abbr>+++.
 
-*  <<jme3/advanced/nifty_gui_overlay#,Nifty GUI Overlay>> (recommended)
-*  <<jme3/advanced/nifty_gui_projection#,Nifty GUI Projection>> (optional)
+*  xref:gui/nifty_gui_overlay.adoc[Nifty GUI Overlay] (recommended)
+*  xref:gui/nifty_gui_projection.adoc[Nifty GUI Projection] (optional)

+ 6 - 6
docs/modules/core/pages/gui/nifty_gui_overlay.adoc

@@ -5,10 +5,10 @@
 
 
 .  xref:gui/nifty_gui.adoc[Nifty GUI Concepts]
-.  <<jme3/advanced/nifty_gui_best_practices#,Nifty GUI Best Practices>>
-.  <<jme3/advanced/nifty_gui_xml_layout#,Nifty GUI XML Layout>> or <<jme3/advanced/nifty_gui_java_layout#,Nifty GUI Java Layout>>
-.  *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ Overlay* or <<jme3/advanced/nifty_gui_projection#,Nifty GUI Projection>>
-.  <<jme3/advanced/nifty_gui_java_interaction#,Interact with the GUI from Java>>
+.  xref:gui/nifty_gui_best_practices.adoc[Nifty GUI Best Practices]
+.  xref:gui/nifty_gui_xml_layout.adoc[Nifty GUI XML Layout] or xref:gui/nifty_gui_java_layout.adoc[Nifty GUI Java Layout]
+.  *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ Overlay* or xref:gui/nifty_gui_projection.adoc[Nifty GUI Projection]
+.  xref:gui/nifty_gui_java_interaction.adoc[Interact with the GUI from Java]
 
 
 image::gui/nifty-gui-example.png[nifty-gui-example.png,width="300",height="200",align="left"]
@@ -16,7 +16,7 @@ image::gui/nifty-gui-example.png[nifty-gui-example.png,width="300",height="200",
 
 Typically, you define a key (for example escape) that switches the +++<abbr title="Graphical User Interface">GUI</abbr>+++ on and off. The +++<abbr title="Graphical User Interface">GUI</abbr>+++ can be a StartScreen, OptionsScreen, CharacterCreationScreen, etc. While the +++<abbr title="Graphical User Interface">GUI</abbr>+++ is up, you pause the running game, and then overlay the +++<abbr title="Graphical User Interface">GUI</abbr>+++. You also must switch to a different set of user inputs while the game is paused, so the player can use the mouse pointer and keyboard to interact with the +++<abbr title="Graphical User Interface">GUI</abbr>+++.
 
-You can also <<jme3/advanced/nifty_gui_projection#,project>> the +++<abbr title="Graphical User Interface">GUI</abbr>+++ as a texture onto a mesh texture (but then you cannot click to select).
+You can also xref:gui/nifty_gui_projection.adoc[project] the +++<abbr title="Graphical User Interface">GUI</abbr>+++ as a texture onto a mesh texture (but then you cannot click to select).
 On this page, we look at the overlay variant, which is more commonly used in games.
 
 
@@ -74,4 +74,4 @@ nifty.addXml("Interface/mysecondscreen.xml");
 
 Now that you have layed out and integrated the +++<abbr title="Graphical User Interface">GUI</abbr>+++ in your app, you want to respond to user input and display the current game. Time to create a ScreenController!
 
-*  <<jme3/advanced/nifty_gui_java_interaction#,Interact with the GUI from Java>>
+*  xref:gui/nifty_gui_java_interaction.adoc[Interact with the GUI from Java]

+ 7 - 7
docs/modules/core/pages/gui/nifty_gui_projection.adoc

@@ -5,16 +5,16 @@
 
 
 .  xref:gui/nifty_gui.adoc[Nifty GUI Concepts]
-.  <<jme3/advanced/nifty_gui_best_practices#,Nifty GUI Best Practices>>
-.  <<jme3/advanced/nifty_gui_xml_layout#,Nifty GUI XML Layout>> or <<jme3/advanced/nifty_gui_java_layout#,Nifty GUI Java Layout>>
-.  <<jme3/advanced/nifty_gui_overlay#,Nifty GUI Overlay>> or *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ Projection*
-.  <<jme3/advanced/nifty_gui_java_interaction#,Interact with the GUI from Java>>
+.  xref:gui/nifty_gui_best_practices.adoc[Nifty GUI Best Practices]
+.  xref:gui/nifty_gui_xml_layout.adoc[Nifty GUI XML Layout] or xref:gui/nifty_gui_java_layout.adoc[Nifty GUI Java Layout]
+.  xref:gui/nifty_gui_overlay.adoc[Nifty GUI Overlay] or *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ Projection*
+.  xref:gui/nifty_gui_java_interaction.adoc[Interact with the GUI from Java]
 
 
 image::gui/nifty-gui.png[nifty-gui.png,width="310",height="250",align="left"]
 
 
-Typically you define a key (for example escape) to switch the +++<abbr title="Graphical User Interface">GUI</abbr>+++ on and off. Then you <<jme3/advanced/nifty_gui_overlay#,overlay>> the running game with the +++<abbr title="Graphical User Interface">GUI</abbr>+++ (you will most likely pause the game then).
+Typically you define a key (for example escape) to switch the +++<abbr title="Graphical User Interface">GUI</abbr>+++ on and off. Then you xref:gui/nifty_gui_overlay.adoc[overlay] the running game with the +++<abbr title="Graphical User Interface">GUI</abbr>+++ (you will most likely pause the game then).
 
 Alternatively, you can also project the +++<abbr title="Graphical User Interface">GUI</abbr>+++ as a texture onto a mesh textures inside the game. Allthough this looks cool and “immersive, this approach is rarely used since it is difficult to record clicks this way. You can only interact with this projected +++<abbr title="Graphical User Interface">GUI</abbr>+++ by keyboard, or programmatically. You can select input fields using the arrow keys, and trigger actions using the return key.
 
@@ -63,7 +63,7 @@ rootNode.attachChild(geom);
 
 ----
 
-The MySettingsScreen class is a custom de.lessvoid.nifty.screen.ScreenController in which you implement your +++<abbr title="Graphical User Interface">GUI</abbr>+++ behaviour.  The variable `data` contains an object that you use to exchange state info with the game. See <<jme3/advanced/nifty_gui_java_interaction#,Nifty GUI Java Interaction>> for details on how to create this class.
+The MySettingsScreen class is a custom de.lessvoid.nifty.screen.ScreenController in which you implement your +++<abbr title="Graphical User Interface">GUI</abbr>+++ behaviour.  The variable `data` contains an object that you use to exchange state info with the game. See xref:gui/nifty_gui_java_interaction.adoc[Nifty GUI Java Interaction] for details on how to create this class.
 
 Run the code sample. You select buttons on this +++<abbr title="Graphical User Interface">GUI</abbr>+++ with the arrow keys and then press return. Note that clicking on the texture will not work!
 
@@ -72,4 +72,4 @@ Run the code sample. You select buttons on this +++<abbr title="Graphical User I
 
 Now that you have layed out and integrated the +++<abbr title="Graphical User Interface">GUI</abbr>+++ in your app, you want to respond to user input and display the current game.
 
-*  <<jme3/advanced/nifty_gui_java_interaction#,Interact with the GUI from Java>>
+*  xref:gui/nifty_gui_java_interaction.adoc[Interact with the GUI from Java]

+ 7 - 7
docs/modules/core/pages/gui/nifty_gui_xml_layout.adoc

@@ -5,10 +5,10 @@
 
 
 .  xref:gui/nifty_gui.adoc[Nifty GUI Concepts]
-.  <<jme3/advanced/nifty_gui_best_practices#,Nifty GUI Best Practices>>
-.  *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ XML Layout* or <<jme3/advanced/nifty_gui_java_layout#,Nifty GUI Java Layout>>
-.  <<jme3/advanced/nifty_gui_overlay#,Nifty GUI Overlay>> or <<jme3/advanced/nifty_gui_projection#,Nifty GUI Projection>>
-.  <<jme3/advanced/nifty_gui_java_interaction#,Interact with the GUI from Java>>
+.  xref:gui/nifty_gui_best_practices.adoc[Nifty GUI Best Practices]
+.  *Nifty +++<abbr title="Graphical User Interface">GUI</abbr>+++ XML Layout* or xref:gui/nifty_gui_java_layout.adoc[Nifty GUI Java Layout]
+.  xref:gui/nifty_gui_overlay.adoc[Nifty GUI Overlay] or xref:gui/nifty_gui_projection.adoc[Nifty GUI Projection]
+.  xref:gui/nifty_gui_java_interaction.adoc[Interact with the GUI from Java]
 
 You can "`draw`" the +++<abbr title="Graphical User Interface">GUI</abbr>+++ to the screen by writing XML code (alternatively you can also use Java).
 
@@ -69,7 +69,7 @@ Afterwards create the directory `assets/Interface/Fonts` and add a new font, e.g
 .  Click the btn:[Next >] button when ready.
 .  Accept the defaults by selecting btn:[Finish].
 
-Lastly, see: <<jme3/advanced/nifty_gui_overlay#,Nifty Gui Overlay>> on how to setup your game to display your GUI.
+Lastly, see: xref:gui/nifty_gui_overlay.adoc[Nifty Gui Overlay] on how to setup your game to display your GUI.
 
 One XML file can contain several, or even all screens. As a reminder: Nifty displays one screen at a time; a screen contains several layers on top of one another; each layer contains panels that are embedded into another; the panels contain the actual content (text, images, or controls).
 
@@ -422,5 +422,5 @@ Compare this result with the layout draft above.
 
 Integrate the +++<abbr title="Graphical User Interface">GUI</abbr>+++ into the game. Typically, you will overlay the +++<abbr title="Graphical User Interface">GUI</abbr>+++.
 
-*  <<jme3/advanced/nifty_gui_overlay#,Nifty GUI Overlay>> (recommended)
-*  <<jme3/advanced/nifty_gui_projection#,Nifty GUI Projection>> (optional)
+*  xref:gui/nifty_gui_overlay.adoc[Nifty GUI Overlay] (recommended)
+*  xref:gui/nifty_gui_projection.adoc[Nifty GUI Projection] (optional)