You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1193 lines
33 KiB
1193 lines
33 KiB
<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–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><</keycap></term>
|
|
<listitem><para>Advance the simulation clock backwards by one time step</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><keycap>></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>
|