====== Usage and controls ======

The reference application has a wide range of options for both up-front user configuration and interactive features to be used as the forest is rendering.

===== Navigation =====

Navigation on a PC is handled with the standard **WASD** + mouse navigation. Press and hold the middle mouse button for free-look mode. Use the right mouse button to raise and lower the camera (must deactivate terrain following). Other navigation-related keys include:

^ **Key** ^ **Behavior** ^
| **Control** | Hold to move more slowly |
| **Shift** | Hold to move more quickly |
| **Space** | Toggle terrain following |
| **C** | Toggle collision (will allow the camera to move through the terrain if terrain following off) |

===== Keyboard shortcuts ====

There are numerous keyboard shortcuts that can be used to adjust the scene and rendering style on the fly. This list will print in the console when the application starts.

^ **Key** ^ **Behavior** ^
| **~ (tilde)** | Toggle output console |
| **O** | Toggle control panel |
| **P** | Toggle performance panel |
| **T** | Toggle 3D tree geometry |
| **B** | Toggle billboard geometry |
| **L** | Toggle terrain (think "Land") |
| **G** | Toggle grass |
| **Y** | Toggle sky |
| **Q** | Print resource usage to console |
| **X** | Print CPU timing report, if enabled during compile |
| **V (+ mouse motion)** | Move sun position |
| **F (+ mouse motion)** | Change wind direction (think "Fan") |
| **0-9** | Go to preset camera position |
| **Shift + 0-9** | Record preset camera position |
| **Ctrl + R** | Go in camera demo mode |
| **ESC** | Quit/exit|


===== Command-line options =====

If you run the reference application with "-help" it will print the extensive command-line options to the console.