path: root/doc/kstars/commands.docbook

<chapter id="commands">
<title>Command Reference</title>

<sect1 id="kstars-menus">
<title>Menu Commands</title>
<indexterm><primary>Commands</primary><secondary>Menu</secondary></indexterm>

<sect2 id="filemenu">
<title><guimenu>File</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>New Window</guimenuitem>
</menuchoice></term>
<listitem><para>Open another &kstars; window
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Close Window</guimenuitem>
</menuchoice></term>
<listitem><para>Close &kstars; window
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Download Data...</guimenuitem>
</menuchoice></term>
<listitem><para>Open the <guilabel>Download Extra Data</guilabel> tool
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Open FITS...</guimenuitem>
</menuchoice></term>
<listitem><para>Open a FITS image in the FITS Editor tool
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Save Sky Image...</guimenuitem>
</menuchoice></term>
<listitem><para>Create image on disk from current display
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Run Script...</guimenuitem>
</menuchoice></term>
<listitem><para>Run the specified KStars script
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Print...</guimenuitem>
</menuchoice></term>
<listitem><para>Send the current sky map to the printer (or to a
PostScript/PDF file)
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para>Quit &kstars;
</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="timemenu">
<title><guimenu>Time</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
</shortcut>
<guimenu>Time</guimenu>
<guimenuitem>Set Time to Now</guimenuitem>
</menuchoice></term>
<listitem><para>Sync time to system clock</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
</shortcut>
<guimenu>Time</guimenu>
<guimenuitem>Set Time...</guimenuitem>
</menuchoice></term>
<listitem><para>Set time and date</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Time</guimenu>
<guimenuitem>Start/Stop Clock</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle whether time passes</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="pointmenu">
<title><guimenu>Pointing</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Z</keycap>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>Zenith</guimenuitem>
</menuchoice></term>
<listitem><para>Center the display at the
<link linkend="ai-zenith">Zenith</link> point (straight up)
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>N</keycap>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>North</guimenuitem>
</menuchoice></term>
<listitem><para>Center the display above the North point on the
horizon</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>E</keycap>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>East</guimenuitem>
</menuchoice></term>
<listitem><para>Center the display above the East point on the
horizon</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>S</keycap>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>South</guimenuitem>
</menuchoice></term>
<listitem><para>Center the display above the South point on the
horizon</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>W</keycap>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>West</guimenuitem>
</menuchoice></term>
<listitem><para>Center the display above the West point on the
horizon</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>Set Focus Manually...</guimenuitem>
</menuchoice></term>
<listitem><para>Center the display on specific
<link linkend="ai-skycoords">sky coordinates</link>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>Find Object</guimenuitem>
</menuchoice></term>
<listitem><para>Locate an object by name using the
<link linkend="findobjects">Find Object Window</link></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
</shortcut>
<guimenu>Pointing</guimenu>
<guimenuitem>Engage/Stop Tracking</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle tracking on/off.  While tracking,
the display will remain centered on the current position or
object.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="viewmenu">
<title><guimenu>View</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>+</keycap>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom in</guimenuitem>
</menuchoice></term>
<listitem><para>Zooms view in</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>-</keycap>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom out</guimenuitem>
</menuchoice></term>
<listitem><para>Zooms view out</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Default Zoom</guimenuitem>
</menuchoice></term>
<listitem><para>Restore the default Zoom setting</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom to Angular Size...</guimenuitem>
</menuchoice></term>
<listitem><para>Zoom to specified field-of-view angle</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Full Screen Mode</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle full-screen mode</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Space</keycap>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Horizontal/Equatorial Coordinates</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle between the
<link linkend="horizontal">Horizontal</link> and
<link linkend="equatorial">Equatorial</link>
<link linkend="ai-skycoords">Coordinate Systems</link></para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="devicemenu">
<title><guimenu>Devices</guimenu> Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Devices</guimenu>
<guimenuitem>Telescope Wizard...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the <guilabel>Telescope Wizard</guilabel>, which
provides a step-by-step guide to help you connect to your telescope and
control it with &kstars;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Devices</guimenu>
<guimenuitem>Device Manager</guimenuitem>
</menuchoice></term>
<listitem><para>Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Devices</guimenu>
<guimenuitem>INDI Control Panel</guimenuitem>
</menuchoice></term>
<listitem><para>Opens up INDI Control Panel, which allows you to control all the features supported by a device.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Devices</guimenu>
<guimenuitem>Capture Image Sequence...</guimenuitem>
</menuchoice></term>
<listitem><para>Acquire images from a CCD camera or webcam device</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Devices</guimenu>
<guimenuitem>Configure INDI</guimenuitem>
</menuchoice></term>
<listitem><para>Opens up a dialog to configure INDI-related features such as automatic device updates.</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="toolmenu">
<title><guimenu>Tools</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Calculator...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Opens the <link linkend="tool-calculator">AstroCalculator</link> Tool,
which provides full access to many of the mathematical functions used by
&kstars;.
</para>
</listitem>
</varlistentry>

<varlistentry> 
<term><menuchoice> 
<shortcut> 
<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo> 
</shortcut> 
<guimenu>Tools</guimenu> 
<guimenuitem>Observing List...</guimenuitem> 
</menuchoice></term> 
<listitem> 
<para>Opens the <link linkend="tool-observinglist">Observing List</link>
Tool, which provide convenient access to some common functions for a list of
objects chosen by you.</para>
</listitem> 
</varlistentry> 

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>AAVSO Light Curves...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Opens the <link linkend="tool-aavso">AAVSO Light Curve Generator</link>
Tool, which allows you to download a light curve for any variable
star from the American Association of Variable Star Observers.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Altitude vs. Time...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Opens the <link linkend="tool-altvstime">Altitude vs. Time</link> Tool, which
can plot curves representing the altitude of any object as a
function of time.  This is useful for planning observing
sessions.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>What's Up Tonight...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Opens the <link linkend="tool-whatsup">What's Up Tonight</link> Tool,
which presents a summary of the objects which are observable
from your location on a given date.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Script Builder...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Opens the <link linkend="tool-scriptbuilder">Script Builder</link> Tool,
which provides a GUI interface for building &kstars; DCOP scripts.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Solar System...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Opens the <link linkend="tool-solarsys">Solar System Viewer</link>,
which displays an overhead view of the solar system on the
current simulation date.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Jupiter's Moons...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Opens the <link linkend="tool-jmoons">Jupiter Moons Tool</link>,
which displays the positions of Jupiter's four brightest
moons as a function of time.
</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="settingmenu">
<title><guimenu>Settings</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Info Boxes</guisubmenu>
<guimenuitem>Hide/Show Info Boxes</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of all three Info Boxes
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Info Boxes</guisubmenu>
<guimenuitem>Hide/Show Time</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the Time Info Box
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Info Boxes</guisubmenu>
<guimenuitem>Hide/Show Focus</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the Focus Info Box
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Info Boxes</guisubmenu>
<guimenuitem>Hide/Show Location</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the Location Info Box
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Toolbars</guisubmenu>
<guimenuitem>Hide/Show Main Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the Main Toolbar
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Toolbars</guisubmenu>
<guimenuitem>Hide/Show View Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the View Toolbar
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Statusbar</guisubmenu>
<guimenuitem>Hide/Show Statusbar</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the Statusbar
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Statusbar</guisubmenu>
<guimenuitem>Hide/Show Az/Alt field</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the mouse cursor's horizontal
coordinates in the statusbar
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Statusbar</guisubmenu>
<guimenuitem>Hide/Show RA/Dec field</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle display of the mouse cursor's horizontal
coordinates in the statusbar
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>Color Schemes</guisubmenu>
</menuchoice></term>
<listitem><para>
This submenu contains all of the defined color schemes, including your
custom schemes.  Select any item to set that color scheme.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guisubmenu>FOV Symbols</guisubmenu>
</menuchoice></term>
<listitem><para>
This submenu lists the available field-of-view (FOV) Symbols.
The FOV Symbol is drawn at the center of the display.  You
may choose from the list of predefined symbols (No symbol,
7x35 Binoculars, One degree, HST WFPC2 or 30m at 1.3cm), or you may define
your own symbols (or modify existing symbols) using the
<guimenuitem>Edit FOV symbols...</guimenuitem> item.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
</shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Geographic...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Select a new <link linkend="setgeo">geographic
location</link>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure &kstars;...</guimenuitem>
</menuchoice></term>
<listitem><para>Modify <link linkend="config">configuration
options</link></para></listitem>
</varlistentry>

<varlistentry> 
<term><menuchoice> 
<guimenu>Settings</guimenu> 
<guimenuitem>Startup Wizard...</guimenuitem> 
</menuchoice></term> 
<listitem><para>Opens the <link linkend="startwizard">Setup Wizard</link>, 
which allows you to easily set your geographic location and download some 
extra data files.</para></listitem> 
</varlistentry> 


</variablelist>
</sect2>

<sect2 id="helpmenu">
<title><guimenu>Help</guimenu> Menu</title>

&help.menu.documentation;

</sect2>

<sect2 id="popup-menu">
<title>Popup Menu</title>
<indexterm><primary>Popup Menu</primary><secondary>Description</secondary></indexterm>

<para>
The <mousebutton>right</mousebutton> click popup menu is
context-sensitive, meaning its content varies depending on what kind of
object you click on.  We list all possible popup menu items here, with
the relevant object type [in brackets].</para>

<variablelist>
<varlistentry>
<term>[All]</term>
<listitem><para>
Identification and type:  The top one to three lines are devoted to the
name(s) of the object, and its type.  For stars, the Spectral Type
is also shown here.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All]</term>
<listitem><para>
Rise, Transit, and Set times for the object on the current simulation
date are shown on the next three lines.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All]</term>
<listitem><para>
<guimenuitem>Center and Track</guimenuitem>: Center the display
on this location, and engage tracking.  Equivalent to double-clicking.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All]</term>
<listitem><para>
<guimenuitem>Angular Distance To...</guimenuitem>: In this mode,
a dotted line is drawn from the first target object
to the current mouse position.  When you invoke the popup menu of a second
object, this item will read <guilabel>Compute Angular Distance</guilabel>.
Selecting this item will display the angular distance between the two
objects in the statusbar.  You can press the <keycap>Esc</keycap> key to
exit angular distance mode without measuring an angle.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All]</term>
<listitem><para>
<guimenuitem>Details</guimenuitem>: Open the
<link linkend="tool-details">Object Details window</link> for this object.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All]</term>
<listitem><para>
<guimenuitem>Attach Label</guimenuitem>: Attach a permanent name label
to the object.  If the object already has a label attached, this item
will read <guilabel>Remove Label</guilabel>.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All]</term>
<listitem><para>
<guimenuitem>Show ... Image</guimenuitem>: download an image of the
object from the internet, and display it in the Image Viewer tool.
The "..." text is replaced by a short description of the image's
source.  An object may have multiple image links available in its
popup menu.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All]</term>
<listitem><para>
<guimenuitem>... Page</guimenuitem>: Display a webpage about the object
in your default web browser.  The "..." text is replaced by a short
description of the page.  An object may have multiple web links available
in its popup menu.
</para></listitem>
</varlistentry>

<varlistentry>
<term>[All Named Objects]</term>
<listitem><para>
<indexterm><primary>Objects in the Sky</primary>
<secondary>Internet Links</secondary>
<tertiary>Customizing</tertiary></indexterm>
<guimenuitem>Add Link...</guimenuitem>: This allows you to add your own
custom links to the popup menu of any object.  It opens a small window
in which you enter the &URL; of the link, and the text you want to
appear in the popup menu.  There is also a pair of radio buttons which
allow you to specify whether the &URL; is an image or an
<acronym>HTML</acronym> document, so &kstars; knows whether to launch
the web browser or the image viewer.  You can use this to add links to
files on your local disk, so this feature could be used to attach
observing logs or other custom information to objects in &kstars;.
Your custom links are automatically loaded whenever &kstars; starts up,
and they are stored in the folder <filename
class="directory">~/.trinity/share/apps/kstars/</filename>, in files
<filename>myimage_url.dat</filename> and
<filename>myinfo_url.dat</filename>.  If you build an extensive list
of custom links, consider submitting them to us, we would like to
include them in the next version of &kstars;!
</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>

<sect1 id="kstars-keys">
<title>Keyboard Commands</title>
<indexterm><primary>Commands</primary>
<secondary>Keyboard</secondary></indexterm>

<sect2 id="nav-keys">
<title>Navigation Keys</title>
<indexterm><primary>Navigation Controls</primary>
<secondary>Keyboard</secondary></indexterm>

<variablelist>
<varlistentry><term>Arrow Keys</term>
<listitem><para>
Use the arrow keys to pan the display.  Holding down the &Shift;
key doubles the scrolling speed.
</para></listitem></varlistentry>

<varlistentry>
<term><keycap>+</keycap> / <keycap>-</keycap></term>
<listitem><para>Zoom In/Out</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></term>
<listitem><para>Restore the default Zoom setting</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></term>
<listitem><para>Zoom to specified field-of-view angle</para></listitem>
</varlistentry>

<varlistentry>
<term>0&ndash;9</term>
<listitem><para>Center Display on a major Solar System body:
<itemizedlist>
<listitem><para>0: Sun</para></listitem>
<listitem><para>1: Mercury</para></listitem>
<listitem><para>2: Venus</para></listitem>
<listitem><para>3: Moon</para></listitem>
<listitem><para>4: Mars</para></listitem>
<listitem><para>5: Jupiter</para></listitem>
<listitem><para>6: Saturn</para></listitem>
<listitem><para>7: Uranus</para></listitem>
<listitem><para>8: Neptune</para></listitem>
<listitem><para>9: Pluto</para></listitem>
</itemizedlist>
</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>Z</keycap></term>
<listitem><para>Center the display at the <link linkend="ai-zenith">Zenith</link>
Point (straight up)</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>N</keycap></term>
<listitem><para>Center the display above the North point on the  horizon</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>E</keycap></term>
<listitem><para>Center the display above the East point on the  horizon</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>S</keycap></term>
<listitem><para>Center the display above the South point on the horizon</para>
</listitem>
</varlistentry>

<varlistentry>
<term><keycap>W</keycap></term>
<listitem><para>Center the display above the West point on the  horizon</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></term>
<listitem><para>Toggle tracking mode</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>&lt;</keycap></term>
<listitem><para>Advance the simulation clock backwards by one time step</para>
</listitem>
</varlistentry>

<varlistentry>
<term><keycap>&gt;</keycap></term>
<listitem><para>Advance the simulation clock forwards by one time step</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="menu-keys">
<title>Menu Shortcuts</title>
<indexterm><primary>Commands</primary>
<secondary>Menu</secondary>
<tertiary>Keyboard Shortcuts</tertiary>
</indexterm>

<variablelist>
<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></term>
<listitem><para>Open a new &kstars; window</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></term>
<listitem><para>Close a &kstars; window</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></term>
<listitem><para>Download extra data</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></term>
<listitem><para>Open a FITS image in the FITS Editor</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></term>
<listitem><para>Export sky image to a file</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></term>
<listitem><para>Run a &kstars; DCOP script</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></term>
<listitem><para>Print the current sky map</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></term>
<listitem><para>Quit &kstars;</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></term>
<listitem><para>Sync the simulation clock with the current system time</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></term>
<listitem><para>Set the simulation clock to a specified Time and Date</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></term>
<listitem><para>Toggle full-screen mode</para></listitem>
</varlistentry>

<varlistentry><term><keycap>Space</keycap></term>
<listitem><para>Toggle between the
<link linkend="horizontal">Horizontal</link> and
<link linkend="equatorial">Equatorial</link>
<link linkend="ai-skycoords">Coordinate Systems</link>
</para></listitem></varlistentry>

<varlistentry>
<term><keycap>F1</keycap></term>
<listitem><para>Open the &kstars; Handbook</para></listitem>
</varlistentry>
</variablelist>
</sect2>


<sect2 id="object-actions">
<title>Actions for the Selected Object</title>
<indexterm><primary>Objects in the Sky</primary>
<secondary>Keyboard Actions</secondary></indexterm>

<para>Each of the following keystrokes performs an action on the 
<firstterm>selected object</firstterm>.  The selected object is the last 
object which was clicked on (identified in the status bar).  Alternatively, 
if you hold down the <keycap>Shift</keycap> key, then the action is 
performed on the centered object instead.</para>

<!-- FIXME: this feature does not exist yet; to be added after feature thaw
<variablelist>
<varlistentry>
<term><keycap>C</keycap></term>
<listitem><para>Center and Track on the selected object</para></listitem>
</varlistentry>
-->
<variablelist>
<varlistentry>
<term><keycap>D</keycap></term>
<listitem><para>Open the Details window for the selected object</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>L</keycap></term>
<listitem><para>Toggle a name label for the selected object</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>O</keycap></term>
<listitem><para>Add the selected object to the observing list</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>P</keycap></term>
<listitem><para>Open the selected object's popup menu</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>T</keycap></term>
<listitem><para>Toggle a trail on the selected object (solar system bodies only)</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="tools-keys">
<title>Tools Shortcuts</title>

<variablelist>
<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></term>
<listitem><para>Open the <link linkend="findobjects">Find Object window</link>,
for specifying a sky object on which to center</para></listitem>
</varlistentry>

<varlistentry><term><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
</term>
<listitem><para>Open the <guilabel>Set Focus Manually...</guilabel> tool,
for specifying RA/Dec or Az/Alt coordinates on which to center</para></listitem>
</varlistentry>

<varlistentry>
<term><keycap>[</keycap> / <keycap>]</keycap></term>
<listitem><para>Start/End an Angular Distance measurement at the current mouse 
cursor position.  The angular distance between start and end points is displayed 
in the statusbar.</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></term>
<listitem><para>Open the <link linkend="setgeo">Set Geographic Location</link> 
window</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-calculator">AstroCalculator</link> 
</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-aavso">AAVSO Lightcurve Generator</link>
</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-altvstime">Altitude vs. Time</link> 
tool</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-whatsup">What's Up Tonight?</link> 
tool</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-scriptbuilder">Script Builder</link> 
tool</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-solarsys">Solar System Viewer</link> 
</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-jmoons">Jupiter Moons</link> 
tool</para></listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></term>
<listitem><para>Open the <link linkend="tool-observinglist">Observing List</link> 
tool</para></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kstars-mouse">
<title>Mouse Commands</title>
<indexterm><primary>Commands</primary>
<secondary>Mouse</secondary></indexterm>
<indexterm><primary>Navigation Controls</primary>
<secondary>Mouse</secondary></indexterm>

<variablelist>
<varlistentry><term>Moving the mouse</term>
<listitem><para>
The sky coordinates (RA/Dec and Az/Alt) of the mouse cursor are updated
in the status bar
</para></listitem>
</varlistentry>

<varlistentry><term>"Hovering" the mouse</term>
<listitem><para>
A temporary name label is attached to the object nearest to the mouse cursor.
</para></listitem>
</varlistentry>

<varlistentry><term>Left-clicking</term>
<listitem>
<para>
<indexterm><primary>Objects in the Sky</primary>
<secondary>Identifying</secondary></indexterm>
The object nearest the mouse click is identified in the
status bar.
</para></listitem>
</varlistentry>

<varlistentry><term>Double-clicking</term>
<listitem>
<para>
<indexterm><primary>Objects in the Sky</primary>
<secondary>Centering</secondary></indexterm>
Center and track on the location or object
nearest the mouse click.  Double-clicking on an Info Box will
<quote>shade</quote> it to show/hide extra information.
</para></listitem>
</varlistentry>

<varlistentry><term>Right-clicking</term>
<listitem>
<para>
<indexterm><primary>Objects in the Sky</primary>
<secondary>Invoking Popup Menu for</secondary></indexterm>
Open the <link linkend="popup-menu">popup menu</link> for the
location or object nearest the mouse cursor.
</para></listitem>
</varlistentry>

<varlistentry><term>Scrolling the mouse wheel</term>
<listitem><para>Zoom the display in or out.  If you do not
have a mouse wheel, you can hold the middle mouse button and
drag vertically.
</para></listitem>
</varlistentry>

<varlistentry><term>Click-and-dragging</term>
<listitem><para>
	<variablelist>
	<varlistentry><term>Dragging the sky map</term>
	<listitem><para>Pan the display, following the drag motion.
	</para></listitem></varlistentry>

	<varlistentry><term>&Ctrl;+dragging the sky map</term>
	<listitem><para>Define a rectangle in the map.  When the
	mouse button is released, the display is zoomed in to match the
	field-of-view to the bounds of the rectangle.
	</para></listitem></varlistentry>

	<varlistentry><term>Dragging an Info Box</term>
	<listitem><para>The Info Box is repositioned in the map.  Info
	Boxes will <quote>stick</quote> to window edges, so that they
	remain on the edge when the window is resized.
	</para></listitem></varlistentry>
	</variablelist>
</para></listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>