.. _user-interface: Control panel ************* The Gaia Sky control panel is divided into seven panes, `Time <#time>`__, `Camera <#camera>`__, `Type visibility <#type-visibility>`__, `Visual settings <#visual-settings>`__, `Datasets <#datasets>`__, `Objects <#objects>`__, and `Music <#music>`__. +----------------------------------------------------+-------------------------------------------------------+ | .. image:: img/ui/control-panel-collapsed.jpg | .. image:: img/ui/control-panel-expanded.jpg | | :width: 65% | :width: 65% | | :alt: User interface with all panes collapsed | :alt: User interface with camera pane expanded | +----------------------------------------------------+-------------------------------------------------------+ | Collapsed control panel | Expanded control panel | +----------------------------------------------------+-------------------------------------------------------+ The seven panes, except for the Time pane, are collapsed 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. Use the arrow right icon |caret-right| to collapse it again. 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-7` keys. There are eight 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. * **Gaia FOV (1, 2, both)** -- the camera simulates either of the fields of view of Gaia, or both. 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