.. _user-interface: Control panel ************* .. note:: Since Gaia Sky 3.5.5, Gaia Sky offers two UI modes: the **new UI** and the **old control panel**. The main controls of Gaia Sky are divided into seven panes, `Time <#time>`__, `Camera <#camera>`__, `Type visibility <#type-visibility>`__, `Visual settings <#visual-settings>`__, `Datasets <#datasets>`__, `Objects <#objects>`__, and `Music <#music>`__. The panes are accessed via the control panel (in the old UI), or via buttons anchored to the left of the screen (new UI). +----------------------------------------------------+----------------------------------------------------+-------------------------------------------------------+ | .. image:: img/ui/new-ui.jpg | .. image:: img/ui/control-panel-collapsed.jpg | .. image:: img/ui/control-panel-expanded.jpg | | :width: 75% | :width: 65% | :width: 65% | | :alt: The new UI with its buttons to the left | :alt: User interface with all panes collapsed | :alt: User interface with camera pane expanded | +----------------------------------------------------+----------------------------------------------------+-------------------------------------------------------+ | | The new UI, based on anchored | | Collapsed control panel | | Expanded control panel | | | buttons to the left of the screen. | | (old UI) | | (old UI) | +----------------------------------------------------+----------------------------------------------------+-------------------------------------------------------+ The seven panes, except for the Time pane in the old UI, are hidden at startup. To expand them and reveal its controls just click on the little arrow bottom icon |caret-bottom| at the right of the pane title (in the old UI), or click on the corresponding button (new UI). Use the arrow right icon |caret-right|, or the corresponding button to collapse them again. In the old UI, panes can also be detached to their own window. To do so, use the detach icon |detach-icon|. .. |caret-bottom| image:: img/ui/iconic-caret-bottom.png .. |caret-right| image:: img/ui/iconic-caret-right.png .. |fwd-icon| image:: img/ui/media/iconic-media-skip-forward.png .. |bwd-icon| image:: img/ui/media/iconic-media-skip-backward.png .. |detach-icon| image:: img/ui/detach-icon.png Time ==== Play and pause the simulation using the |play-icon|/|pause-icon| ``Play/Pause`` buttons in the time pane, or toggle using :guilabel:`Space`. You can also change time warp, which is expressed as a scaling factor, using the provided **Warp factor** slider. Use :guilabel:`,` or |bwd-icon| and :guilabel:`.` or |fwd-icon| to divide by 2 and double the value of the time warp respectively. If you keep either of those pressed, the warp factor will increase or decrease steadily. Use the :guilabel:`Reset time and warp` button to reset the time warp to x1, and set the time to the current real world time (UTC). .. figure:: img/ui/time-component.jpg :width: 45% :align: center The time pane in the controls window of Gaia Sky. .. |play-icon| image:: img/ui/media/iconic-media-play.png .. |pause-icon| image:: img/ui/media/iconic-media-pause.png .. |warp-factor| image:: img/ui/time-component.jpg Camera ====== In the camera options pane on the left you can select the type of camera. This can also be done by using the :guilabel:`Numpad 0-3` keys. There are four camera modes: * **Free mode** -- the camera is not linked to any object and its velocity is exponential with respect to the distance to the origin (Sun). * **Focus mode** -- the camera is linked to a focus object and it rotates and rolls with respect to it. * **Game mode** -- a game mode which maps the controls :guilabel:`wasd` + mouse look. * **Spacecraft**-- take control of a spacecraft and navigate around at will. For more information on the camera modes, see the :ref:`camera-modes` section. Additionally, there are a number of sliders for you to control different parameters of the camera: - **Field of view** -- control the field of view angle of the camera. The bigger it is, the larger the portion of the scene represented. - **Camera speed** -- control the longitudinal speed of the camera. - **Rotation speed** -- control the transversal speed of the camera, how fast it rotates around an object. - **Turn speed** -- control the turning speed of the camera. You can **lock the camera** to the focus when in focus mode. Doing so links the reference system of the camera to that of the object and thus it moves with it. .. hint:: **Lock the camera** so that it stays at the same relative position to the focus object. Finally, we can also **lock the orientation** of the camera to that of the focus so that the same transformation matrix is applied to both. .. hint:: **Lock the orientation** so that the camera also rotates with the focus. Additionally, we can also enable the **crosshair**, which will mark the currently focused object. .. _type-visibility: Type visibility =============== Most graphical elements can be turned off and on using these toggles. For example you can hide the stars by clicking on the ``stars`` |stars| toggle. The object types available are the following: - |stars| -- Stars - |planets| -- Planets - |moons| -- Moons - |satellites| -- Satellites - |asteroids| -- Asteroids - |clusters| -- Star clusters - |milkyway| -- Milky Way - |galaxies| -- Galaxies - |nebulae| -- Nebulae - |meshes| -- Meshes - |equatorial| -- Equatorial grid - |ecliptic| -- Ecliptic grid - |galactic| -- Galactic grid - |recgrid| -- Recursive grid - |labels| -- Labels - |titles| -- Titles - |orbits| -- Orbits - |locations| -- Locations - |cosmiclocations| -- Cosmic locations - |countries| -- Countries - |constellations| -- Constellations - |boundaries| -- Constellation boundaries - |ruler| -- Rulers - |effects| -- Particle effects - |atmospheres| -- Atmospheres - |clouds| -- Clouds - |axes| -- Axes - |arrows| -- Velocity vectors - |keyframes| -- Keyframes - |others| -- Others .. |stars| image:: img/ui/ct/icon-elem-stars.png .. |planets| image:: img/ui/ct/icon-elem-planets.png .. |moons| image:: img/ui/ct/icon-elem-moons.png .. |satellites| image:: img/ui/ct/icon-elem-satellites.png .. |asteroids| image:: img/ui/ct/icon-elem-asteroids.png .. |clusters| image:: img/ui/ct/icon-elem-clusters.png .. |milkyway| image:: img/ui/ct/icon-elem-milkyway.png .. |galaxies| image:: img/ui/ct/icon-elem-galaxies.png .. |nebulae| image:: img/ui/ct/icon-elem-nebulae.png .. |meshes| image:: img/ui/ct/icon-elem-meshes.png .. |equatorial| image:: img/ui/ct/icon-elem-equatorial.png .. |ecliptic| image:: img/ui/ct/icon-elem-ecliptic.png .. |galactic| image:: img/ui/ct/icon-elem-galactic.png .. |recgrid| image:: img/ui/ct/icon-elem-recgrid.png .. |labels| image:: img/ui/ct/icon-elem-labels.png .. |titles| image:: img/ui/ct/icon-elem-titles.png .. |orbits| image:: img/ui/ct/icon-elem-orbits.png .. |locations| image:: img/ui/ct/icon-elem-locations.png .. |cosmiclocations| image:: img/ui/ct/icon-elem-cosmiclocations.png .. |countries| image:: img/ui/ct/icon-elem-countries.png .. |constellations| image:: img/ui/ct/icon-elem-constellations.png .. |boundaries| image:: img/ui/ct/icon-elem-boundaries.png .. |ruler| image:: img/ui/ct/icon-elem-ruler.png .. |effects| image:: img/ui/ct/icon-elem-effects.png .. |atmospheres| image:: img/ui/ct/icon-elem-atmospheres.png .. |clouds| image:: img/ui/ct/icon-elem-clouds.png .. |axes| image:: img/ui/ct/icon-elem-axes.png .. |arrows| image:: img/ui/ct/icon-elem-arrows.png .. |keyframes| image:: img/ui/ct/icon-elem-keyframes.png .. |others| image:: img/ui/ct/icon-elem-others.png .. _individual-visibility: Per-object visibility --------------------- This button provides access to controls to manipulate the individual visibility of objects. .. figure:: img/screenshots/per-object-vis.jpg :alt: Individual object visibility :align: center Individual object visibility button and dialog .. raw:: html