Warning, /education/kstars/doc/commands.docbook is written in an unsupported language. File is not indexed.
0001 <chapter id="commands"> 0002 <title>Command Reference</title> 0003 0004 <sect1 id="kstars-menus"> 0005 <title>Menu Commands</title> 0006 <indexterm><primary>Commands</primary><secondary>Menu</secondary></indexterm> 0007 0008 <sect2 id="filemenu"> 0009 <title>File Menu</title> 0010 0011 <variablelist> 0012 <varlistentry> 0013 <term><menuchoice> 0014 <shortcut> 0015 <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> 0016 </shortcut> 0017 <guimenu>File</guimenu> 0018 <guimenuitem>Open Image...</guimenuitem> 0019 </menuchoice></term> 0020 <listitem><para>Open an image in the FITS Viewer. 0021 </para></listitem> 0022 </varlistentry> 0023 0024 <varlistentry> 0025 <term><menuchoice> 0026 <guimenu>File</guimenu> 0027 <guimenuitem>Save Sky Image...</guimenuitem> 0028 </menuchoice></term> 0029 <listitem><para>Create image on disk from current display. 0030 </para></listitem> 0031 </varlistentry> 0032 0033 <varlistentry> 0034 <term><menuchoice> 0035 <shortcut> 0036 <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> 0037 </shortcut> 0038 <guimenu>File</guimenu> 0039 <guimenuitem>Run Script...</guimenuitem> 0040 </menuchoice></term> 0041 <listitem><para>Run the specified &kstars; script. 0042 </para></listitem> 0043 </varlistentry> 0044 0045 <varlistentry> 0046 <term><menuchoice> 0047 <guimenu>File</guimenu> 0048 <guimenuitem>Printing Wizard...</guimenuitem> 0049 </menuchoice></term> 0050 <listitem><para>Starts a wizard to configure capturing sky objects images using telescope and printing the results as a good looking printout for further use or catalogization. 0051 </para></listitem> 0052 </varlistentry> 0053 0054 <varlistentry> 0055 <term><menuchoice> 0056 <shortcut> 0057 <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> 0058 </shortcut> 0059 <guimenu>File</guimenu> 0060 <guimenuitem>Print...</guimenuitem> 0061 </menuchoice></term> 0062 <listitem><para>Send the current sky map to the printer (or to a 0063 &PostScript;/&PDF; file). 0064 </para></listitem> 0065 </varlistentry> 0066 0067 <varlistentry> 0068 <term><menuchoice> 0069 <shortcut> 0070 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> 0071 </shortcut> 0072 <guimenu>File</guimenu> 0073 <guimenuitem>Quit</guimenuitem> 0074 </menuchoice></term> 0075 <listitem><para>Quit &kstars;. 0076 </para></listitem> 0077 </varlistentry> 0078 </variablelist> 0079 0080 </sect2> 0081 0082 <sect2 id="timemenu"> 0083 <title>Time Menu</title> 0084 0085 <variablelist> 0086 <varlistentry> 0087 <term><menuchoice> 0088 <shortcut> 0089 <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> 0090 </shortcut> 0091 <guimenu>Time</guimenu> 0092 <guimenuitem>Set Time to Now</guimenuitem> 0093 </menuchoice></term> 0094 <listitem><para>Sync time to system clock.</para></listitem> 0095 </varlistentry> 0096 0097 <varlistentry> 0098 <term><menuchoice> 0099 <shortcut> 0100 <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> 0101 </shortcut> 0102 <guimenu>Time</guimenu> 0103 <guimenuitem>Set Time...</guimenuitem> 0104 </menuchoice></term> 0105 <listitem><para>Set time and date.</para></listitem> 0106 </varlistentry> 0107 <varlistentry> 0108 <term><menuchoice> 0109 <shortcut> 0110 <keycap><</keycap> 0111 </shortcut> 0112 <guimenu>Time</guimenu> 0113 <guimenuitem>Advance One Step Backward in Time</guimenuitem> 0114 </menuchoice></term> 0115 <listitem><para>Advance one step backward in time in the &kstars; simulation of the sky chart. The duration of the time step can be configured after pressing the little <guilabel>></guilabel> button on the &kstars; toolbar. 0116 </para></listitem> 0117 </varlistentry> 0118 <varlistentry> 0119 <term><menuchoice> 0120 <guimenu>Time</guimenu> 0121 <guimenuitem>Stop Clock</guimenuitem> 0122 </menuchoice></term> 0123 <listitem><para>Toggle whether time passes.</para></listitem> 0124 </varlistentry> 0125 <varlistentry> 0126 <term><menuchoice> 0127 <shortcut> 0128 <keycap>></keycap> 0129 </shortcut> 0130 <guimenu>Time</guimenu> 0131 <guimenuitem>Advance One Step Forward in Time</guimenuitem> 0132 </menuchoice></term> 0133 <listitem><para>Advance one step forward in time in the &kstars; simulation of the sky chart. The duration of the time step can be configured after pressing the little <guilabel>></guilabel> button on the &kstars; toolbar. 0134 </para></listitem> 0135 </varlistentry> 0136 </variablelist> 0137 0138 </sect2> 0139 0140 <sect2 id="pointmenu"> 0141 <title>Pointing Menu</title> 0142 0143 <variablelist> 0144 <varlistentry> 0145 <term><menuchoice> 0146 <shortcut> 0147 <keycap>Z</keycap> 0148 </shortcut> 0149 <guimenu>Pointing</guimenu> 0150 <guimenuitem>Zenith</guimenuitem> 0151 </menuchoice></term> 0152 <listitem><para>Center the display at the 0153 <link linkend="ai-zenith">Zenith</link> point (straight up). 0154 </para></listitem> 0155 </varlistentry> 0156 0157 <varlistentry> 0158 <term><menuchoice> 0159 <shortcut> 0160 <keycap>N</keycap> 0161 </shortcut> 0162 <guimenu>Pointing</guimenu> 0163 <guimenuitem>North</guimenuitem> 0164 </menuchoice></term> 0165 <listitem><para>Center the display above the North point on the 0166 horizon.</para></listitem> 0167 </varlistentry> 0168 0169 <varlistentry> 0170 <term><menuchoice> 0171 <shortcut> 0172 <keycap>E</keycap> 0173 </shortcut> 0174 <guimenu>Pointing</guimenu> 0175 <guimenuitem>East</guimenuitem> 0176 </menuchoice></term> 0177 <listitem><para>Center the display above the East point on the 0178 horizon.</para></listitem> 0179 </varlistentry> 0180 0181 <varlistentry> 0182 <term><menuchoice> 0183 <shortcut> 0184 <keycap>S</keycap> 0185 </shortcut> 0186 <guimenu>Pointing</guimenu> 0187 <guimenuitem>South</guimenuitem> 0188 </menuchoice></term> 0189 <listitem><para>Center the display above the South point on the 0190 horizon.</para></listitem> 0191 </varlistentry> 0192 0193 <varlistentry> 0194 <term><menuchoice> 0195 <shortcut> 0196 <keycap>W</keycap> 0197 </shortcut> 0198 <guimenu>Pointing</guimenu> 0199 <guimenuitem>West</guimenuitem> 0200 </menuchoice></term> 0201 <listitem><para>Center the display above the West point on the 0202 horizon.</para></listitem> 0203 </varlistentry> 0204 0205 <varlistentry> 0206 <term><menuchoice> 0207 <shortcut> 0208 <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo> 0209 </shortcut> 0210 <guimenu>Pointing</guimenu> 0211 <guimenuitem>Set Coordinates Manually...</guimenuitem> 0212 </menuchoice></term> 0213 <listitem><para>Center the display on specific 0214 <link linkend="ai-skycoords">sky coordinates</link>. 0215 </para></listitem> 0216 </varlistentry> 0217 0218 <varlistentry> 0219 <term><menuchoice> 0220 <shortcut> 0221 <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo> 0222 </shortcut> 0223 <guimenu>Pointing</guimenu> 0224 <guimenuitem>Find Object...</guimenuitem> 0225 </menuchoice></term> 0226 <listitem><para>Locate an object by name using the 0227 <link linkend="findobjects">Find Object Window</link>.</para></listitem> 0228 </varlistentry> 0229 0230 <varlistentry> 0231 <term><menuchoice> 0232 <shortcut> 0233 <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo> 0234 </shortcut> 0235 <guimenu>Pointing</guimenu> 0236 <guimenuitem>Engage/Stop Tracking</guimenuitem> 0237 </menuchoice></term> 0238 <listitem><para>Toggle tracking on/off. While tracking, 0239 the display will remain centered on the current position or 0240 object.</para></listitem> 0241 </varlistentry> 0242 </variablelist> 0243 0244 </sect2> 0245 0246 <sect2 id="viewmenu"> 0247 <title>View Menu</title> 0248 0249 <variablelist> 0250 <varlistentry> 0251 <term><menuchoice> 0252 <shortcut><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut> 0253 <guimenu>View</guimenu> 0254 <guimenuitem>Zoom In</guimenuitem> 0255 </menuchoice></term> 0256 <listitem><para>Zooms view in.</para></listitem> 0257 </varlistentry> 0258 0259 <varlistentry> 0260 <term><menuchoice> 0261 <shortcut><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></shortcut> 0262 <guimenu>View</guimenu> 0263 <guimenuitem>Zoom Out</guimenuitem> 0264 </menuchoice></term> 0265 <listitem><para>Zooms view out.</para></listitem> 0266 </varlistentry> 0267 0268 <varlistentry> 0269 <term><menuchoice> 0270 <shortcut> 0271 <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> 0272 </shortcut> 0273 <guimenu>View</guimenu> 0274 <guimenuitem>Default Zoom</guimenuitem> 0275 </menuchoice></term> 0276 <listitem><para>Restore the default Zoom setting.</para></listitem> 0277 </varlistentry> 0278 0279 <varlistentry> 0280 <term><menuchoice> 0281 <shortcut> 0282 <keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo> 0283 </shortcut> 0284 <guimenu>View</guimenu> 0285 <guimenuitem>Zoom to Angular Size...</guimenuitem> 0286 </menuchoice></term> 0287 <listitem><para>Zoom to specified field-of-view angle.</para></listitem> 0288 </varlistentry> 0289 0290 <varlistentry> 0291 <term><menuchoice> 0292 <shortcut> 0293 <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo> 0294 </shortcut> 0295 <guimenu>View</guimenu> 0296 <guimenuitem>Full Screen Mode</guimenuitem> 0297 </menuchoice></term> 0298 <listitem><para>Toggle full-screen mode.</para></listitem> 0299 </varlistentry> 0300 0301 <varlistentry> 0302 <term><menuchoice> 0303 <shortcut> 0304 &Space; 0305 </shortcut> 0306 <guimenu>View</guimenu> 0307 <guimenuitem>Switch to Star Globe View / Switch to Horizontal View</guimenuitem> 0308 </menuchoice></term> 0309 <listitem><para>Toggle between the 0310 <link linkend="horizontal">Horizontal</link> and 0311 <link linkend="equatorial">Equatorial</link> 0312 <link linkend="ai-skycoords">Coordinate Systems</link>.</para></listitem> 0313 </varlistentry> 0314 0315 <varlistentry> 0316 <term><menuchoice> 0317 <shortcut> 0318 <keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo> 0319 </shortcut> 0320 <guimenu>View</guimenu> 0321 <guimenuitem>Show Terrain</guimenuitem> 0322 </menuchoice></term> 0323 <listitem><para>Toggle the <link linkend="terrain">terrain image</link> visibility.</para></listitem> 0324 </varlistentry> 0325 </variablelist> 0326 0327 <variablelist> 0328 <varlistentry> 0329 <term><menuchoice><guimenu>View</guimenu> <guisubmenu>Projection</guisubmenu></menuchoice></term> 0330 <listitem><para>A submenu that lists all projections. 0331 <variablelist> 0332 <varlistentry> 0333 <term><menuchoice><shortcut><keycap>F5</keycap></shortcut><guimenuitem>Lambert Azimuthal Equal-area</guimenuitem></menuchoice></term> 0334 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Lambert_azimuthal_equal-area_projection">Lambert azimuthal equal-area</ulink> projection.</para></listitem> 0335 </varlistentry> 0336 0337 <varlistentry> 0338 <term><menuchoice><shortcut><keycap>F6</keycap></shortcut><guimenuitem>Azimuthal Equidistant</guimenuitem></menuchoice></term> 0339 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Azimuthal_equidistant_projection">azimuthal equidistant</ulink> projection.</para></listitem> 0340 </varlistentry> 0341 0342 <varlistentry> 0343 <term><menuchoice><shortcut><keycap>F7</keycap></shortcut><guimenuitem>Orthographic</guimenuitem></menuchoice></term> 0344 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Orthographic_projection_(cartography)">orthographic</ulink> projection.</para></listitem> 0345 </varlistentry> 0346 0347 <varlistentry> 0348 <term><menuchoice><shortcut><keycap>F8</keycap></shortcut><guimenuitem>Equirectangular</guimenuitem></menuchoice></term> 0349 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Equirectangular_projection">equirectangular</ulink> projection.</para></listitem> 0350 </varlistentry> 0351 0352 <varlistentry> 0353 <term><menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenuitem>Stereographic</guimenuitem></menuchoice></term> 0354 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Stereographic_projection">stereographic</ulink> projection.</para></listitem> 0355 </varlistentry> 0356 0357 <varlistentry> 0358 <term><menuchoice><shortcut><keycap>F10</keycap></shortcut><guimenuitem>Gnomonic</guimenuitem></menuchoice></term> 0359 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Gnomonic_projection">gnomonic</ulink> projection.</para></listitem> 0360 </varlistentry> 0361 </variablelist></para></listitem> 0362 </varlistentry> 0363 0364 <varlistentry> 0365 <term><menuchoice> 0366 <guimenu>View</guimenu> 0367 <guisubmenu>HiPS All Sky Overlay</guisubmenu> 0368 </menuchoice></term> 0369 <listitem><para>A submenu that lists the enabled surveys. Select the <guimenuitem>HiPS Settings...</guimenuitem> menu item for configure the <link linkend="hips">HiPS</link> sky overlays.</para></listitem> 0370 </varlistentry> 0371 0372 </variablelist> 0373 </sect2> 0374 0375 <sect2 id="toolmenu"> 0376 <title>Tools Menu</title> 0377 0378 <variablelist> 0379 <varlistentry> 0380 <term><menuchoice> 0381 <shortcut> 0382 <keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo> 0383 </shortcut> 0384 <guimenu>Tools</guimenu> 0385 <guimenuitem>Calculator</guimenuitem> 0386 </menuchoice></term> 0387 <listitem> 0388 <para> 0389 Opens the <link linkend="tool-calculator">AstroCalculator</link> Tool, 0390 which provides full access to many of the mathematical functions used by 0391 &kstars;. 0392 </para> 0393 </listitem> 0394 </varlistentry> 0395 </variablelist> 0396 0397 <variablelist> 0398 <varlistentry> 0399 <term><menuchoice><guimenu>Tools</guimenu> <guisubmenu>Devices</guisubmenu></menuchoice></term> 0400 <listitem><para>A submenu for control supported devices. 0401 <variablelist> 0402 0403 <varlistentry> 0404 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo></shortcut> <guimenuitem>List your Equipment...</guimenuitem></menuchoice></term> 0405 <listitem><para>Allows you to define your equipment characteristics for observation logs. The Configure Equipment window is divided into four tabs: <guilabel>Telescope</guilabel>, <guilabel>Eyepiece</guilabel>, <guilabel>Lens</guilabel> and <guilabel>Filter</guilabel>. You can add a new equipment by completing its characteristics and pressing <guibutton>Add New...</guibutton> button. You can also save or remove an equipment from the list.</para></listitem> 0406 </varlistentry> 0407 <!-- 0408 <varlistentry> 0409 <term><menuchoice><guimenuitem>Telescope Wizard...</guimenuitem></menuchoice></term> 0410 <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> 0411 </varlistentry> 0412 --> 0413 0414 <varlistentry> 0415 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></shortcut> <guimenuitem>Device Manager...</guimenuitem></menuchoice></term> 0416 <listitem><para>Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers.</para></listitem> 0417 </varlistentry> 0418 0419 <varlistentry> 0420 <term><guimenuitem>Custom Drivers...</guimenuitem></term> 0421 <listitem><para>A dialog to customize the drivers.</para></listitem> 0422 </varlistentry> 0423 0424 <varlistentry> 0425 <term><guimenuitem>INDI Control Panel...</guimenuitem></term> 0426 <listitem><para>Opens up INDI Control Panel, which allows you to control all the features supported by a device.</para></listitem> 0427 </varlistentry> 0428 </variablelist></para></listitem> 0429 </varlistentry> 0430 0431 <varlistentry> 0432 <term><menuchoice> 0433 <guimenu>Tools</guimenu> 0434 <guimenuitem>Sky Calendar</guimenuitem> 0435 </menuchoice></term> 0436 <listitem> 0437 <para> 0438 Opens the <guilabel>Sky Calendar</guilabel> Tool, which allows you to plan observations 0439 of Solar System planets by giving graphical data on sets and rises of these objects. 0440 </para> 0441 </listitem> 0442 </varlistentry> 0443 0444 <varlistentry> 0445 <term><menuchoice> 0446 <shortcut> 0447 <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> 0448 </shortcut> 0449 <guimenu>Tools</guimenu> 0450 <guimenuitem>Altitude vs. Time</guimenuitem> 0451 </menuchoice></term> 0452 <listitem> 0453 <para> 0454 Opens the <link linkend="tool-altvstime">Altitude vs. Time</link> Tool, which 0455 can plot curves representing the altitude of any object as a function of time. 0456 This is useful for planning observing sessions. 0457 </para> 0458 </listitem> 0459 </varlistentry> 0460 0461 <varlistentry> 0462 <term><menuchoice> 0463 <shortcut> 0464 <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> 0465 </shortcut> 0466 <guimenu>Tools</guimenu> 0467 <guimenuitem>What's up Tonight</guimenuitem> 0468 </menuchoice></term> 0469 <listitem> 0470 <para> 0471 Opens the <link linkend="tool-whatsup">What's up Tonight</link> Tool, 0472 which presents a summary of the objects which are observable 0473 from your location on a given date. 0474 </para> 0475 </listitem> 0476 </varlistentry> 0477 0478 <varlistentry> 0479 <term><menuchoice> 0480 <shortcut> 0481 <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo> 0482 </shortcut> 0483 <guimenu>Tools</guimenu> 0484 <guimenuitem>What's Interesting...</guimenuitem> 0485 </menuchoice></term> 0486 <listitem> 0487 <para> 0488 Opens the <guilabel>What's Interesting</guilabel> Tool, which allows you to be 0489 informed about the most interesting observations that can be made from your 0490 current location using the given equipment. 0491 </para> 0492 </listitem> 0493 </varlistentry> 0494 0495 <varlistentry> 0496 <term><menuchoice> 0497 <shortcut> 0498 <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> 0499 </shortcut> 0500 <guimenu>Tools</guimenu> 0501 <guimenuitem>XPlanet Solar System Simulator</guimenuitem> 0502 </menuchoice></term> 0503 <listitem> 0504 <para> 0505 This menu item will appear only if you have installed the <application>XPlanet</application> optional package. 0506 </para> 0507 </listitem> 0508 </varlistentry> 0509 0510 <varlistentry> 0511 <term><menuchoice> 0512 <shortcut> 0513 <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> 0514 </shortcut> 0515 <guimenu>Tools</guimenu> 0516 <guimenuitem>Script Builder</guimenuitem> 0517 </menuchoice></term> 0518 <listitem> 0519 <para> 0520 Opens the <link linkend="tool-scriptbuilder">Script Builder</link> Tool, 0521 which provides a GUI interface for building &kstars; &DBus; scripts. 0522 </para> 0523 </listitem> 0524 </varlistentry> 0525 0526 <varlistentry> 0527 <term><menuchoice> 0528 <shortcut> 0529 <keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo> 0530 </shortcut> 0531 <guimenu>Tools</guimenu> 0532 <guimenuitem>Solar System</guimenuitem> 0533 </menuchoice></term> 0534 <listitem> 0535 <para> 0536 Opens the <link linkend="tool-solarsys">Solar System Viewer</link>, 0537 which displays an overhead view of the solar system on the 0538 current simulation date. 0539 </para> 0540 </listitem> 0541 </varlistentry> 0542 0543 <varlistentry> 0544 <term><menuchoice> 0545 <shortcut> 0546 <keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo> 0547 </shortcut> 0548 <guimenu>Tools</guimenu> 0549 <guimenuitem>Ekos</guimenuitem> 0550 </menuchoice></term> 0551 <listitem> 0552 <para> 0553 Opens <link linkend="ekos">Ekos</link>, a complete and powerful tool for astrophotography. 0554 With Ekos, you can align and guide your telescope, focus your CCD, and capture 0555 images using an easy intuitive interface. 0556 </para> 0557 </listitem> 0558 </varlistentry> 0559 0560 <varlistentry> 0561 <term><menuchoice> 0562 <shortcut> 0563 <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo> 0564 </shortcut> 0565 <guimenu>Tools</guimenu> 0566 <guimenuitem>Jupiter's Moons</guimenuitem> 0567 </menuchoice></term> 0568 <listitem> 0569 <para> 0570 Opens the <link linkend="tool-jmoons">Jupiter Moons Tool</link>, 0571 which displays the positions of Jupiter's four brightest 0572 moons as a function of time. 0573 </para> 0574 </listitem> 0575 </varlistentry> 0576 0577 <varlistentry> 0578 <term><menuchoice> 0579 <guimenu>Tools</guimenu> 0580 <guimenuitem>Flags</guimenuitem> 0581 </menuchoice></term> 0582 <listitem> 0583 <para> 0584 Opens the <guilabel>Flag manager</guilabel> Tool, which can be used to assign 0585 color labels and icons to the given positions on the sky chart. 0586 </para> 0587 </listitem> 0588 </varlistentry> 0589 0590 </variablelist> 0591 </sect2> 0592 0593 <sect2 id="datamenu"> 0594 <title>Data Menu</title> 0595 0596 <variablelist> 0597 <varlistentry> 0598 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut> 0599 <guimenu>Data</guimenu> <guimenuitem>Download New Data...</guimenuitem></menuchoice></term> 0600 <listitem><para>Open the <guilabel>Get Hot New Stuff</guilabel> dialog to download additional data 0601 for &kstars;.</para></listitem> 0602 </varlistentry> 0603 0604 <varlistentry> 0605 <term><menuchoice> 0606 <guimenu>Data</guimenu> <guimenuitem>Manage DSO Catalogs</guimenuitem></menuchoice></term> 0607 <listitem><para>Open the <guilabel>DSO Catalogs</guilabel> dialog for manage the catalog database 0608 of &kstars;.</para></listitem> 0609 </varlistentry> 0610 0611 <varlistentry> 0612 <term><menuchoice><guimenu>Data</guimenu> <guisubmenu>Updates</guisubmenu></menuchoice></term> 0613 <listitem><para>This submenu can be used to update various object data, namely asteroids, comets 0614 and satellites orbital elements as well as recent supernovae data from the Internet. The data will 0615 be downloaded for the current user account only. If you use &kstars; from different account you 0616 should download them for every account separately.</para> 0617 0618 <para>&kstars; tries to download recent supernovae list automatically by default. You can switch 0619 the download off using <guilabel>Supernovae</guilabel> page of &kstars; Settings window.</para></listitem> 0620 </varlistentry> 0621 </variablelist> 0622 0623 </sect2> 0624 0625 <sect2 id="observationmenu"> 0626 <title>Observation Menu</title> 0627 0628 <variablelist> 0629 <varlistentry> 0630 <term><menuchoice> 0631 <shortcut><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></shortcut> 0632 <guimenu>Observation</guimenu> 0633 <guimenuitem>Observation Planner</guimenuitem> 0634 </menuchoice></term> 0635 <listitem><para>Open the <link linkend="tool-obsplanner">Observation Planner</link> tool.</para></listitem> 0636 </varlistentry> 0637 0638 <varlistentry> 0639 <term><menuchoice> 0640 <shortcut><keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo></shortcut> 0641 <guimenu>Observation</guimenu> 0642 <guimenuitem>Execute the Session Plan...</guimenuitem> 0643 </menuchoice></term> 0644 <listitem><para>Opens <link linkend="tool-obsplanner">session plan wizard</link> or execute 0645 the planned session.</para></listitem> 0646 </varlistentry> 0647 0648 <varlistentry> 0649 <term><menuchoice> 0650 <guimenu>Observation</guimenu> 0651 <guimenuitem>Polaris Hour Angle...</guimenuitem> 0652 </menuchoice></term> 0653 <listitem><para>Opens the <guilabel>Polaris Hour Angle</guilabel> tool.</para></listitem> 0654 </varlistentry> 0655 </variablelist> 0656 </sect2> 0657 0658 <sect2 id="settingmenu"> 0659 <title>Settings Menu</title> 0660 0661 <variablelist> 0662 <varlistentry> 0663 <term><menuchoice> 0664 <guimenu>Settings</guimenu> 0665 <guisubmenu>Info Boxes</guisubmenu> 0666 </menuchoice></term> 0667 <listitem><para>A submenu that lists the different info boxes. 0668 0669 <variablelist> 0670 <varlistentry> 0671 <term><guimenuitem>Show Info Boxes</guimenuitem></term> 0672 <listitem><para>Toggle display of all three Info Boxes: 0673 <itemizedlist> 0674 <listitem><para><guiicon>Time Box</guiicon></para></listitem> 0675 <listitem><para><guiicon>Focus Box</guiicon></para></listitem> 0676 <listitem><para><guiicon>Location Box</guiicon></para></listitem> 0677 </itemizedlist> 0678 </para></listitem> 0679 </varlistentry> 0680 0681 <varlistentry> 0682 <term><guimenuitem>Show Time Box</guimenuitem></term> 0683 <listitem><para>Toggle display of the Time Info Box. By default, the Time Info 0684 Box is located in the top left side of the screen. You can change the position 0685 of Time Info Box by holding the left-click mouse button and dragging it to the 0686 new position.</para></listitem> 0687 </varlistentry> 0688 0689 <varlistentry> 0690 <term><guimenuitem>Show Focus Box</guimenuitem></term> 0691 <listitem><para>Toggle display of the Focus Info Box. By default, the Focus Info 0692 Box is located in the top right side of the screen. You can change the position 0693 of Focus Info Box by holding the left-click mouse button and dragging it to the 0694 new position.</para></listitem> 0695 </varlistentry> 0696 0697 <varlistentry> 0698 <term><guimenuitem>Show Location Box</guimenuitem></term> 0699 <listitem><para>Toggle display of the Location Info Box. By default, the Location 0700 Info Box is located in the bottom left side of the screen. You can change the 0701 position of Location Info Box by holding the left-click mouse button and dragging 0702 it to the new position.</para></listitem> 0703 </varlistentry> 0704 </variablelist></para></listitem> 0705 </varlistentry> 0706 0707 <varlistentry> 0708 <term><menuchoice> 0709 <guimenu>Settings</guimenu> 0710 <guisubmenu>Toolbars Shown</guisubmenu> 0711 </menuchoice></term> 0712 <listitem><para>A submenu that lists the different toolbars. 0713 0714 <variablelist> 0715 <varlistentry> 0716 <term><guimenuitem>Main Toolbar</guimenuitem></term> 0717 <listitem><para>Toggle display of the Main Toolbar. By default, the Main Toolbar 0718 provides useful shortcuts for controlling the sky map view (&ie; Zoom in and Zoom out) 0719 and for controlling &kstars; clock as well. You can Start / Stop the clock, advance 0720 one step backward / forward in time and also you can easily set the time step used 0721 by &kstars;' clock. The time step is the rate at which time flows in the simulation. 0722 For setting the time step, you can use the spin box used for establishing the time step 0723 units and the spin box used for increasing / decreasing the time step value. 0724 Using the Main Toolbar you can quickly open the <guilabel>Find Object</guilabel>, 0725 <guilabel>Set Time</guilabel> or <guilabel>Set Geographic Location</guilabel> window. 0726 Main Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 0727 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 0728 </varlistentry> 0729 0730 <varlistentry> 0731 <term><guimenuitem>View Toolbar</guimenuitem></term> 0732 <listitem><para>Toggle display of the View Toolbar. View Toolbar controls which sky 0733 objects are drawn on &kstars; Sky Map (stars, deep sky objects, Solar system objects, 0734 supernovae or satellites) as well as what constellation information is included 0735 (constellation lines, constellation names, constellation art or constellation boundaries). 0736 It also provides icon shortcuts for: showing milky way (drawn with dark grey color), 0737 showing equatorial/horizontal coordinate grid and for showing the green opaque ground. 0738 Note that when the horizon is switched off, refraction effects are temporarily disabled. 0739 View Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 0740 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 0741 </varlistentry> 0742 0743 <varlistentry> 0744 <term><guimenuitem>INDI Toolbar</guimenuitem></term> 0745 <listitem><para>Toggle display of the INDI Toolbar. By default, INDI Toolbar contains 0746 five shortcut icons:</para> 0747 <itemizedlist> 0748 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="kstars_ekos.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Ekos</guiicon></para></listitem> 0749 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="kstars_indi.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle INDI Control Panel</guiicon></para></listitem> 0750 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="kstars_fitsviewer.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle FITS Viewer</guiicon></para></listitem> 0751 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="archive-extract.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Sensor FOV</guiicon></para></listitem> 0752 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="center_telescope.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Lock Telescope Center</guiicon></para></listitem> 0753 </itemizedlist> 0754 <para>INDI Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 0755 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 0756 </varlistentry> 0757 0758 <varlistentry> 0759 <term><guimenuitem>Telescope Toolbar</guimenuitem></term> 0760 <listitem><para>Toggle display of the Telescope Toolbar. By default, Telescope Toolbar contains 0761 seven shortcut icons:</para> 0762 <itemizedlist> 0763 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="draw-text.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Mount Control Panel</guiicon></para></listitem> 0764 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="lock-open.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Telescope Tracking</guiicon></para></listitem> 0765 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="object-rotate-right.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Slew telescope to the focused object</guiicon></para></listitem> 0766 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="media-record.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Sync telescope to the focused object</guiicon></para></listitem> 0767 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="flag-red.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Park telescope</guiicon></para></listitem> 0768 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="flag-green.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Unpark telescope</guiicon></para></listitem> 0769 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="process-stop.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Abort telescope motions</guiicon></para></listitem> 0770 </itemizedlist> 0771 <para>Telescope Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 0772 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 0773 </varlistentry> 0774 0775 <varlistentry> 0776 <term><guimenuitem>Dome Toolbar</guimenuitem></term> 0777 <listitem><para>Toggle display of the Dome Toolbar. By default, Dome Toolbar contains 0778 two shortcut icons:</para> 0779 <itemizedlist> 0780 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="dome-park.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Park dome</guiicon></para></listitem> 0781 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="dome-unpark.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Unpark dome</guiicon></para></listitem> 0782 </itemizedlist> 0783 <para>Dome Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 0784 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 0785 </varlistentry> 0786 0787 </variablelist></para></listitem> 0788 </varlistentry> 0789 0790 <varlistentry> 0791 <term><menuchoice> 0792 <guimenu>Settings</guimenu> 0793 <guisubmenu>Statusbar</guisubmenu> 0794 </menuchoice></term> 0795 <listitem><para>A submenu that lists the different statusbars. 0796 0797 <variablelist> 0798 <varlistentry> 0799 <term><guimenuitem>Show Statusbar</guimenuitem></term> 0800 <listitem><para>Toggle display of the Statusbar. It is located in the bottom of &kstars; window.</para></listitem> 0801 </varlistentry> 0802 0803 <varlistentry> 0804 <term><guimenuitem>Show Az/Alt Field</guimenuitem></term> 0805 <listitem><para>Toggle display of the mouse cursor's horizontal coordinates in the statusbar.</para></listitem> 0806 </varlistentry> 0807 0808 <varlistentry> 0809 <term><guimenuitem>Show RA/Dec Field</guimenuitem></term> 0810 <listitem><para>Toggle display of the mouse cursor's equatorial coordinates in the statusbar.</para></listitem> 0811 </varlistentry> 0812 0813 <varlistentry> 0814 <term><guimenuitem>Show J2000.0 RA/Dec Field</guimenuitem></term> 0815 <listitem><para>Toggle display of the mouse cursor's equatorial J2000 coordinates in the statusbar.</para></listitem> 0816 </varlistentry> 0817 </variablelist></para></listitem> 0818 </varlistentry> 0819 0820 <varlistentry> 0821 <term><menuchoice> 0822 <guimenu>Settings</guimenu> 0823 <guisubmenu>Themes</guisubmenu> 0824 </menuchoice></term> 0825 <listitem><para>Lists the available Theme items.</para></listitem> 0826 </varlistentry> 0827 0828 <varlistentry> 0829 <term><menuchoice> 0830 <guimenu>Settings</guimenu> 0831 <guisubmenu>Color Schemes</guisubmenu> 0832 </menuchoice></term> 0833 <listitem><para>This submenu contains all of the defined color schemes: Classic, Star Chart, 0834 Night Vision and Moonless Night. It can also include your custom color schemes. Select any 0835 item to set that color scheme.</para></listitem> 0836 </varlistentry> 0837 0838 <varlistentry> 0839 <term><menuchoice> 0840 <guimenu>Settings</guimenu> 0841 <guisubmenu>FOV Symbols</guisubmenu> 0842 </menuchoice></term> 0843 <listitem><para>This submenu lists the available field-of-view (FOV) Symbols. The FOV Symbol is 0844 drawn at the center of the display. You may choose one or more from the list of predefined symbols 0845 (7x35 Binoculars, Telrad, One Degree, HST WFPC2 or 30m at 1.3cm) by checking their specific 0846 checkbox, or you may use no symbol by unchecking all the items from the symbols list. You can also 0847 define your own symbols (or modify existing symbols) using the <guimenuitem>Edit FOV Symbols...</guimenuitem> 0848 menu item.</para></listitem> 0849 </varlistentry> 0850 0851 <varlistentry> 0852 <term><menuchoice> 0853 <guimenu>Settings</guimenu> 0854 <guisubmenu>Artificial Horizon...</guisubmenu> 0855 </menuchoice></term> 0856 <listitem><para>If you select this submenu, then Artificial Horizon Manager will be opened. Artificial 0857 Horizon Manager is used to define on the skymap one or more regions that are blocked from view from your 0858 current location (&ie; tall trees or building). The window is split in two sections: in the left side is 0859 the Regions section while in the right side is the Points section. You can add a new region by pressing 0860 the <guibutton>+</guibutton> (Add Region) button or you can remove a region by selecting it in the regions 0861 list and then pressing the <guibutton>-</guibutton> (Remove Region) button. In order to draw a region you 0862 need to define a list of points that encompasses the blocked area. You can add a new point by pressing the 0863 <guibutton>+</guibutton> (Add Point) button from the right Points section. You can also remove a highlighted 0864 point from the list of points or you can clear all the points. There are two ways to add a new point to a 0865 selected region: manually by entering the point's coordinates or by selecting the point from the skymap 0866 after clicking <guibutton>Select Points</guibutton> button. Note that each point is described by a set of 0867 horizontal coordinates: Az (Azimuth) and Alt (Altitude). If you want to modify a point's coordinates, just 0868 double click on its Az/Alt text box value and enter the new value. First and Last points must be on the 0869 horizon. Polygons must be closed to be considered valid regions. Artificial Horizon Manager provides a easy 0870 way to rename your regions. By default, regions are named as: <quote>Region </quote> plus an index (&ie; 0871 <quote>Region 1</quote> or <quote>Region 2</quote>). For renaming a region, just double click on its name 0872 and then you will be invited to complete a new region name. You can also control which regions are enabled 0873 or disabled for marking on the map by a simple click on the checkbox in front of each region. After you 0874 defined your desired regions you can apply them by pressing the <guibutton>Apply</guibutton> button. If you 0875 want to use these regions again, in further astronomy sessions, you can save them such that next time when 0876 you will open &kstars; they will be automatically marked on the skymap.</para></listitem> 0877 </varlistentry> 0878 0879 <varlistentry> 0880 <term><menuchoice> 0881 <shortcut><keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo></shortcut> 0882 <guimenu>Settings</guimenu> 0883 <guimenuitem>Manage Observer...</guimenuitem> 0884 </menuchoice></term> 0885 <listitem><para>Selecting this will open Manage Observers window that enables you to register a number 0886 of observers which are using &kstars; on this computer. You can add a new entry to observers list by 0887 completing the mandatory fields: <guilabel>Name:</guilabel> and <guilabel>Surname:</guilabel> and then 0888 pressing the <guibutton>+</guibutton> (Add observer) button. Note that <guilabel>Contact:</guilabel> 0889 field is optional, &kstars; allowing you to add a new observer even though <guilabel>Contact:</guilabel> 0890 text box is empty. You can also remove an observer from the list using <guibutton>-</guibutton> (Remove 0891 observer) button.</para></listitem> 0892 </varlistentry> 0893 0894 <varlistentry> 0895 <term><menuchoice> 0896 <shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut> 0897 <guimenu>Settings</guimenu> 0898 <guimenuitem>Geographic...</guimenuitem> 0899 </menuchoice></term> 0900 <listitem><para>Select a new <link linkend="setgeo">geographic location</link>.</para></listitem> 0901 </varlistentry> 0902 0903 <varlistentry> 0904 <term><menuchoice> 0905 <guimenu>Settings</guimenu> 0906 <guimenuitem>Configure Keyboard Shortcuts...</guimenuitem> 0907 </menuchoice></term> 0908 <listitem><para>Open the Configure Shortcuts window which allows you to modify &kstars; shortcuts. 0909 You can use &kstars; default shortcuts scheme or define your own shortcuts scheme. In order to add 0910 a new custom shortcut to an action, you need to click on action's name and then press the 0911 <guibutton>Custom:</guibutton> checkbox. Then click on the button next to <guibutton>Custom:</guibutton> 0912 checkbox and enter the shortcut you would like to use in &kstars;. You can also remove a shortcut by 0913 pressing the <guibutton>Delete</guibutton> button after you select an action from the list. &kstars; 0914 helps you to find an action by providing its search method; just enter the name of the action and the 0915 list will be reduced to its best matches. For example, I will give you a brief example on how to use 0916 &kstars; Configure Shortcuts feature: 0917 <itemizedlist> 0918 <listitem><para>Firstly, open the Configure Shortcuts window from the <guimenu>Settings</guimenu> menu.</para></listitem> 0919 <listitem><para>Then select the action you would like to add a shortcut (&ie; Artificial Horizon). 0920 You can use the search method provided by &kstars;. Just type <quote>art</quote> in the search text 0921 box and the list will be reduced to only four actions. The Artificial Horizon is the first action 0922 in the list.</para></listitem> 0923 <listitem><para>Now that you find your desired action, you can add a new shortcut by clicking on 0924 its name. After you click on the action name, press the <guibutton>Custom</guibutton> checkbox. 0925 There is a button next to <guibutton>Custom</guibutton> checkbox used for adding new shortcuts. 0926 By default, if an action has no custom shortcut, the <quote>None</quote> tag will be assigned to 0927 this button. Press this button and then add your custom shortcut. For example, for Artificial 0928 Horizon, you can use &Ctrl;+H shortcut. Hold the &Ctrl; key and press H. Your shortcut be 0929 automatically saved, thus you can use it next time when you open &kstars;.</para></listitem> 0930 </itemizedlist> 0931 </para></listitem> 0932 </varlistentry> 0933 0934 <varlistentry> 0935 <term><menuchoice> 0936 <guimenu>Settings</guimenu> 0937 <guimenuitem>Configure &kstars;...</guimenuitem> 0938 </menuchoice></term> 0939 <listitem><para>Modify <link linkend="config">configuration options</link>.</para></listitem> 0940 </varlistentry> 0941 0942 <varlistentry> 0943 <term><menuchoice> 0944 <guimenu>Settings</guimenu> 0945 <guimenuitem>Startup Wizard...</guimenuitem> 0946 </menuchoice></term> 0947 <listitem><para>Shows the <guilabel>Setup Wizard</guilabel> dialog. It is the same window that you saw 0948 when you ran &kstars; for the very first time. &kstars; Setup Wizard will help you set up some basic 0949 options, such as your location on Earth. The first page of Setup Wizard is a welcome page and if you press 0950 <guibutton>Next</guibutton> button, you will get the <guilabel>Choose Your Home Location</guilabel> page. 0951 Here you can select your exact home location or a city near your home location if your accurate location 0952 is not present in &kstars; cities database. Browsing the entire list is not so efficient and thus, &kstars; 0953 provides you a easy-to-use method for selecting your desired city in a short time. You may filter the list 0954 of cities by the name of your city, province and country. By giving more details about your location, the 0955 list's size will reduced only to its best matches. When you highlight a city in the cities list, the 0956 <guilabel>Longitude:</guilabel> and <guilabel>Latitude:</guilabel> boxes will be updated, containing the 0957 accurate information of your selected location. When you hit the <guibutton>Next</guibutton> button, you 0958 will get the last page of &kstars; Setup Wizard: <quote>Download Extra Data Files</quote> page. Here you 0959 may download optional data files via the Internet, in order to enhance &kstars;, such as Messier object 0960 images, or a more complete NGC/IC catalog. Press the <guibutton>Download Extra Data...</guibutton> button 0961 to proceed. After you pressed this button, the <guilabel>Get Hot New Stuff</guilabel> dialog will appear. 0962 It is &kstars; Add-On Installer, which will help you to manage what extra information you added to 0963 &kstars;. Firstly, you can choose how the add-ons list is displayed, by pressing the <guibutton>Details 0964 view mode</guibutton> or <guibutton>Icons view mode</guibutton> button. You may also order the list by 0965 various criteria like: newest, rating, most downloads or installed. This can be easily done by selecting 0966 an option using the radio button. You can also make searches using the <guilabel>Search:</guilabel> text 0967 box. Regarding the list of add-ons, you may perform several actions by selecting an add-on from the list: 0968 you can install or uninstall an add-on using the <guibutton>Install</guibutton> / <guibutton>Uninstall</guibutton> 0969 button, you can open the Details window using the <guibutton>Details</guibutton> button or you can rate 0970 an add-on by giving a number of gold stars, up to five stars. If you want to send an email to the author 0971 of an add-on, you are able to do that by clicking on his e-mail address. Then, your default e-mail 0972 application will guide you through the sending process. After you managed your &kstars; add-ons, then you 0973 can close the window by pressing the <guibutton>Close</guibutton> button. You can also use the Download 0974 Extra Data Files tool later, by selecting the <menuchoice><guimenu>Data</guimenu> 0975 <guimenuitem>Download New Data...</guimenuitem></menuchoice> menu item.</para></listitem> 0976 </varlistentry> 0977 </variablelist> 0978 0979 <para> 0980 Additionally &kstars; has the common &kde; <guimenu>Settings</guimenu> menu items, for more information 0981 read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> 0982 of the &kde; Fundamentals. 0983 </para> 0984 0985 </sect2> 0986 0987 <sect2 id="helpmenu"> 0988 <title>Help Menu</title> 0989 <para> 0990 &kstars; has the common &kde; <guimenu>Help</guimenu> menu items, for more information read the section 0991 about the <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink> of the &kde; Fundamentals. 0992 </para> 0993 0994 </sect2> 0995 0996 <sect2 id="popup-menu"> 0997 <title>Popup Menu</title> 0998 <indexterm><primary>Popup Menu</primary><secondary>Description</secondary></indexterm> 0999 1000 <para> 1001 The <mousebutton>right</mousebutton> click popup menu is 1002 context-sensitive, meaning its content varies depending on what kind of 1003 object you click on. We list all possible popup menu items here, with 1004 the relevant object type [in brackets].</para> 1005 1006 <variablelist> 1007 <varlistentry> 1008 <term>[All]</term> 1009 <listitem><para> Identification and quick info: The top several lines 1010 are devoted to the name(s) of the object, its type and the 1011 constellation in which it lies. The magnitude is shown with the 1012 superscript 'm' if it is available. For stars, the Spectral Type is 1013 also shown here. For deep-sky objects, the dimensions, if known, are 1014 shown in arcminutes (eg: 6'×3') and the source catalog is also shown. 1015 </para></listitem> 1016 </varlistentry> 1017 1018 <varlistentry> 1019 <term>[All]</term> 1020 <listitem><para> 1021 Rise, Transit, and Set times for the object on the current simulation 1022 date are shown on the next three lines. 1023 </para></listitem> 1024 </varlistentry> 1025 1026 <varlistentry> 1027 <term>[All]</term> 1028 <listitem><para> 1029 <guimenuitem>Center & Track</guimenuitem>: Center the display 1030 on this location, and engage tracking. Equivalent to double-clicking. 1031 </para></listitem> 1032 </varlistentry> 1033 1034 <varlistentry> 1035 <term>[All]</term> 1036 <listitem><para> 1037 <guimenuitem>Add flag...</guimenuitem>: Open &kstars; <quote>Flag manager</quote> window. 1038 Here you can manage your flags and use some of &kstars; features. When <quote>Flag manager</quote> 1039 window is open for a selected object, <guilabel>Right ascension</guilabel> and 1040 <guilabel>Declination</guilabel> text boxes will be automatically filled with the coordinate values 1041 of the selected object on the Sky Map. Besides these two text boxes, you can set the 1042 <guilabel>Epoch</guilabel>, add a <guilabel>Label</guilabel>, set the <guilabel>Label color</guilabel> 1043 or even add an <guilabel>Icon</guilabel>. To add custom icons, just add images in 1044 <filename class="directory">`qtpaths --paths GenericDataLocation`/kstars/</filename>. File names must 1045 begin with the <quote>flag</quote> keyword. For example, 1046 the file <quote>flagSmall_red_cross.gif</quote> will be shown as Small red cross in the combo box. After 1047 you set up the information of the new flag, you can add it to the flags list using the 1048 <guibutton>Add</guibutton> button. You may also change flags details (&ie; RA/Dec, label or icon) and 1049 then save the new ones by pressing the <guibutton>Save changes</guibutton> button. Using the Flag manager, 1050 you can easily center an object in Map or in Telescope, by pressing <guibutton>Center in Map</guibutton> 1051 or <guibutton>Center in Telescope</guibutton> button. In order to delete a value from the list, just 1052 select it in the list and then press <guibutton>Delete</guibutton> button. Your flags are saved after you 1053 close current session and thus you will be able to see them everytime you will use &kstars; again. 1054 </para></listitem> 1055 </varlistentry> 1056 1057 <varlistentry> 1058 <term>[All]</term> 1059 <listitem><para> 1060 <guimenuitem>Angular Distance To...</guimenuitem>: Enter "angular distance 1061 mode". In this mode, a dotted line is drawn from the first target object 1062 to the current mouse position. When you click with the &RMB; on a second 1063 object, this will display the angular distance between the two 1064 objects near the second object. You can press the &Esc; key to 1065 exit angular distance mode without measuring an angle. 1066 </para></listitem> 1067 </varlistentry> 1068 1069 <!-- Starhop: --> 1070 <varlistentry> 1071 <term>[All]</term> 1072 <listitem><para> 1073 <guimenuitem>Starhop from here to</guimenuitem>: will enable you to find a path between two points in 1074 the sky. Star hopping is a technique that uses bright stars as a guide for finding fainter objects. So if 1075 you have a bright star, you can use it as a reference to find a fainter object. Starting from your reference 1076 star, &kstars; will find a route to the destination, traversing a sequence of stars/patterns of stars. The 1077 object for which you called <guilabel>Starhop from here to</guilabel> tool will be your starting point. When 1078 your starting point is established, a dotted line will appear, allowing you to decide which will be your 1079 end point. You have to move the mouse cursor to your destination object position and right click on it. 1080 Then, a dialog box will pop up, requiring you to set the FOV used for star hopping. For selecting a FOV, 1081 you need to make a choice from the FOV combo box list of values. The values you can choose include 1082 default FOV values (7x35 Binoculars, Telrad, One Degree, HST WFPC2 and 30m at 1.3cm) plus your customized 1083 FOVs. After you selected the FOV, &kstars; will find a route for you. Thus, the dialog box will contain a 1084 list of object used in the starhop. If &kstars; did not manage to find a route, then an error dialog box 1085 will be displayed, giving you a helping hand. When the Star-Hopper algorithm ends, the dialog box will 1086 contain a list of objects used in starhop route. For every object from the list, you can perform a set of 1087 actions: you can ask for details using the <guibutton>Details</guibutton> button, center selected object in 1088 the map using <guibutton>Center on map</guibutton> button or you can go to next star by pressing the 1089 <guibutton>Next</guibutton> button. Note that when go to next star, it will be automatically centered on 1090 the map. Also, Star-Hopper tool provides directions to star hop for every object of the list. 1091 </para></listitem> 1092 </varlistentry> 1093 1094 <varlistentry> 1095 <term>[All]</term> 1096 <listitem><para> 1097 <guimenuitem>Details</guimenuitem>: Open the 1098 <link linkend="tool-details">Object Details window</link> for this object. 1099 </para></listitem> 1100 </varlistentry> 1101 1102 <varlistentry> 1103 <term>[All]</term> 1104 <listitem><para> 1105 <guimenuitem>Attach Label</guimenuitem>: Attach a permanent name label 1106 to the object. If the object already has a label attached, this item 1107 will read <guilabel>Remove Label</guilabel>. 1108 </para></listitem> 1109 </varlistentry> 1110 1111 <varlistentry> 1112 <term>[All]</term> 1113 <listitem><para> 1114 <guimenuitem>Add to Observing WishList</guimenuitem>: Add the selected object to 1115 <guimenu>Observation Planner</guimenu>'s Wish List. You can see the Wish List, by 1116 selecting the <menuchoice><guimenu>Observation</guimenu> <guimenuitem>Observation 1117 Planner</guimenuitem></menuchoice> menu item. 1118 If the object is already in the Observing WishList, then this item will become 1119 <guilabel>Remove Label</guilabel>. 1120 </para></listitem> 1121 </varlistentry> 1122 1123 <varlistentry> 1124 <term>[Solar system objects]</term> 1125 <listitem><para> 1126 <guimenuitem>Add Trail</guimenuitem>: Add a trail to current Solar system object. A star trail is the 1127 continuous path created by the star in the night sky due to the rotation of the Earth. 1128 If the object already has a trail, this item will become <guilabel>Remove Trail</guilabel>. 1129 </para></listitem> 1130 </varlistentry> 1131 1132 <varlistentry> 1133 <term>[All]</term> 1134 <listitem><para> 1135 <guimenuitem>Simulate eyepiece view</guimenuitem>: Eyepiece View feature renders the 1136 view through the eyepiece of various telescope types. Firstly, an input dialog is shown, 1137 which asks you to select one of the visible FOVs to use as a FOV for the eyepiece view. 1138 The user also has the option of trying to determine it from the image (accurate if 1139 image has metadata, otherwise it will be random). After you set the FOV, 1140 the "Eyepiece Field View" window will pop up. 1141 You can easily rotate the view using the "Rotation" slider. You can 1142 also flip and invert the view to help match the view through a telescope/camera. 1143 "Eyepiece view" tool can help you locate many objects with ease, instead of 1144 trying to work with relative positions and relative orientations. 1145 This is an important advantage, especially when you are star hopping. 1146 Note that for getting best results, time must be synced with current 1147 time in &kstars;, and &kstars; must be in horizontal coordinates mode. 1148 </para></listitem> 1149 </varlistentry> 1150 1151 <varlistentry> 1152 <term>[Solar system objects]</term> 1153 <listitem><para> 1154 <guimenuitem>Image Resources</guimenuitem>: gives a list of image links for current Solar 1155 system object. The images are displayed in &kstars; Image Viewer tool. Image Viewer tool 1156 allows you to invert the colors and save the image in your computer. 1157 </para></listitem> 1158 </varlistentry> 1159 1160 <varlistentry> 1161 <term>[Solar system objects]</term> 1162 <listitem><para> 1163 <guimenuitem>Information Resources</guimenuitem>: gives a list of documentation links for 1164 current Solar system object. The links are opened in your default browser. 1165 </para></listitem> 1166 </varlistentry> 1167 1168 <varlistentry> 1169 <term>[All objects without Solar system objects]</term> 1170 <listitem><para> 1171 <guimenuitem>Show SDSS Image</guimenuitem>: download a SDSS (Sloan Digital Sky Survey) 1172 image of the object from the Internet, and display it in the Image Viewer tool. 1173 </para></listitem> 1174 </varlistentry> 1175 1176 <varlistentry> 1177 <term>[All objects without Solar system objects]</term> 1178 <listitem><para> 1179 <guimenuitem>Show DSS Image</guimenuitem>: download a DSS (Digitized Sky Survey) image of 1180 the object from the Internet, and display it in the Image Viewer tool. 1181 </para></listitem> 1182 </varlistentry> 1183 1184 </variablelist> 1185 1186 </sect2> 1187 </sect1> 1188 1189 <sect1 id="kstars-keys"> 1190 <title>Keyboard Commands</title> 1191 <indexterm><primary>Commands</primary> 1192 <secondary>Keyboard</secondary></indexterm> 1193 1194 <sect2 id="nav-keys"> 1195 <title>Navigation Keys</title> 1196 <indexterm><primary>Navigation Controls</primary> 1197 <secondary>Keyboard</secondary></indexterm> 1198 1199 <variablelist> 1200 <varlistentry><term>Arrow Keys</term> 1201 <listitem><para> 1202 Use the arrow keys to pan the display. Holding down the &Shift; 1203 key doubles the scrolling speed. 1204 </para></listitem></varlistentry> 1205 1206 <varlistentry> 1207 <term><keycap>+</keycap> / <keycap>-</keycap></term> 1208 <listitem><para>Zoom In/Out.</para></listitem> 1209 </varlistentry> 1210 1211 <varlistentry> 1212 <term><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></term> 1213 <listitem><para>Restore the default Zoom setting.</para></listitem> 1214 </varlistentry> 1215 1216 <varlistentry> 1217 <term><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></term> 1218 <listitem><para>Zoom to specified field-of-view angle.</para></listitem> 1219 </varlistentry> 1220 1221 <varlistentry> 1222 <term><keycap>0</keycap>–<keycap>9</keycap></term> 1223 <listitem><para>Center Display on a major Solar System body: 1224 <itemizedlist> 1225 <listitem><para><keycap>0</keycap>: Sun</para></listitem> 1226 <listitem><para><keycap>1</keycap>: Mercury</para></listitem> 1227 <listitem><para><keycap>2</keycap>: Venus</para></listitem> 1228 <listitem><para><keycap>3</keycap>: Moon</para></listitem> 1229 <listitem><para><keycap>4</keycap>: Mars</para></listitem> 1230 <listitem><para><keycap>5</keycap>: Jupiter</para></listitem> 1231 <listitem><para><keycap>6</keycap>: Saturn</para></listitem> 1232 <listitem><para><keycap>7</keycap>: Uranus</para></listitem> 1233 <listitem><para><keycap>8</keycap>: Neptune</para></listitem> 1234 <listitem><para><keycap>9</keycap>: Pluto</para></listitem> 1235 </itemizedlist> 1236 </para></listitem> 1237 </varlistentry> 1238 1239 <varlistentry> 1240 <term><keycap>Z</keycap></term> 1241 <listitem><para>Center the display at the <link linkend="ai-zenith">Zenith</link> 1242 Point (straight up).</para></listitem> 1243 </varlistentry> 1244 1245 <varlistentry> 1246 <term><keycap>N</keycap></term> 1247 <listitem><para>Center the display above the North point on the horizon.</para></listitem> 1248 </varlistentry> 1249 1250 <varlistentry> 1251 <term><keycap>E</keycap></term> 1252 <listitem><para>Center the display above the East point on the horizon.</para></listitem> 1253 </varlistentry> 1254 1255 <varlistentry> 1256 <term><keycap>S</keycap></term> 1257 <listitem><para>Center the display above the South point on the horizon.</para> 1258 </listitem> 1259 </varlistentry> 1260 1261 <varlistentry> 1262 <term><keycap>W</keycap></term> 1263 <listitem><para>Center the display above the West point on the horizon.</para></listitem> 1264 </varlistentry> 1265 1266 <varlistentry> 1267 <term><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></term> 1268 <listitem><para>Toggle tracking mode.</para></listitem> 1269 </varlistentry> 1270 1271 <varlistentry> 1272 <term><keycap><</keycap></term> 1273 <listitem><para>Advance the simulation clock backwards by one time step.</para> 1274 </listitem> 1275 </varlistentry> 1276 1277 <varlistentry> 1278 <term><keycap>></keycap></term> 1279 <listitem><para>Advance the simulation clock forwards by one time step.</para> 1280 </listitem> 1281 </varlistentry> 1282 1283 </variablelist> 1284 </sect2> 1285 1286 <sect2 id="menu-keys"> 1287 <title>Menu Shortcuts</title> 1288 <indexterm><primary>Commands</primary> 1289 <secondary>Menu</secondary> 1290 <tertiary>Keyboard Shortcuts</tertiary> 1291 </indexterm> 1292 <variablelist> 1293 1294 <varlistentry> 1295 <term><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></term> 1296 <listitem><para>Download extra data.</para></listitem> 1297 </varlistentry> 1298 1299 <varlistentry> 1300 <term><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></term> 1301 <listitem><para>Open a FITS image in the FITS Editor.</para></listitem> 1302 </varlistentry> 1303 1304 <varlistentry> 1305 <term><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></term> 1306 <listitem><para>Export sky image to a file.</para></listitem> 1307 </varlistentry> 1308 1309 <varlistentry> 1310 <term><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></term> 1311 <listitem><para>Run a &kstars; <link linkend="tool-obsplanner">Observation Planner</link>. 1312 </para></listitem> 1313 </varlistentry> 1314 1315 <varlistentry> 1316 <term><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></term> 1317 <listitem><para>Run a &kstars; &DBus; script.</para></listitem> 1318 </varlistentry> 1319 1320 <varlistentry> 1321 <term><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></term> 1322 <listitem><para>Print the current sky map.</para></listitem> 1323 </varlistentry> 1324 1325 <varlistentry> 1326 <term><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></term> 1327 <listitem><para>Quit &kstars;.</para></listitem> 1328 </varlistentry> 1329 1330 <varlistentry> 1331 <term><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></term> 1332 <listitem><para>Sync the simulation clock with the current system time.</para></listitem> 1333 </varlistentry> 1334 1335 <varlistentry> 1336 <term><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></term> 1337 <listitem><para>Set the simulation clock to a specified Time and Date.</para></listitem> 1338 </varlistentry> 1339 1340 <varlistentry> 1341 <term><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></term> 1342 <listitem><para>Toggle full-screen mode.</para></listitem> 1343 </varlistentry> 1344 1345 <varlistentry> 1346 <term><keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo></term> 1347 <listitem><para> 1348 Define equipment (telescope, eyepiece, lens and filter) characteristics for observation logs. 1349 </para></listitem> 1350 </varlistentry> 1351 1352 <varlistentry> 1353 <term><keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo></term> 1354 <listitem><para>Add a new observer item for your observation logs.</para></listitem> 1355 </varlistentry> 1356 1357 <varlistentry><term>&Space;</term> 1358 <listitem><para>Toggle between the 1359 <link linkend="horizontal">Horizontal</link> and 1360 <link linkend="equatorial">Equatorial</link> 1361 <link linkend="ai-skycoords">Coordinate Systems</link>. 1362 </para></listitem></varlistentry> 1363 1364 <varlistentry> 1365 <term><keycap>F1</keycap></term> 1366 <listitem><para>Open the &kstars; Handbook.</para></listitem> 1367 </varlistentry> 1368 1369 <varlistentry> 1370 <term><keycap>F5</keycap></term> 1371 <listitem><para>Switch sky chart view to the 1372 <ulink url="https://en.wikipedia.org/wiki/Lambert_azimuthal_equal-area_projection">Lambert azimuthal equal-area</ulink> projection. 1373 </para></listitem> 1374 </varlistentry> 1375 1376 <varlistentry> 1377 <term><keycap>F6</keycap></term> 1378 <listitem><para>Switch sky chart view to the 1379 <ulink url="https://en.wikipedia.org/wiki/Azimuthal_equidistant_projection">azimuthal equidistant</ulink> projection. 1380 </para></listitem> 1381 </varlistentry> 1382 1383 <varlistentry> 1384 <term><keycap>F7</keycap></term> 1385 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Orthographic_projection_(cartography)">orthographic</ulink> projection.</para></listitem> 1386 </varlistentry> 1387 1388 <varlistentry> 1389 <term><keycap>F8</keycap></term> 1390 <listitem><para>Switch sky chart view to the 1391 <ulink url="https://en.wikipedia.org/wiki/Equirectangular_projection">equirectangular</ulink> projection. 1392 </para></listitem> 1393 </varlistentry> 1394 1395 <varlistentry> 1396 <term><keycap>F9</keycap></term> 1397 <listitem><para>Switch sky chart view to the 1398 <ulink url="https://en.wikipedia.org/wiki/Stereographic_projection">stereographic</ulink> projection. 1399 </para></listitem> 1400 </varlistentry> 1401 1402 <varlistentry> 1403 <term><keycap>F10</keycap></term> 1404 <listitem><para>Switch sky chart view to the 1405 <ulink url="https://en.wikipedia.org/wiki/Gnomonic_projection">gnomonic</ulink> projection. 1406 </para></listitem> 1407 </varlistentry> 1408 </variablelist> 1409 </sect2> 1410 1411 1412 <sect2 id="object-actions"> 1413 <title>Actions for the Selected Object</title> 1414 <indexterm><primary>Objects in the Sky</primary> 1415 <secondary>Keyboard Actions</secondary></indexterm> 1416 1417 <para>Each of the following keystrokes performs an action on the 1418 <firstterm>selected object</firstterm>. The selected object is the last 1419 object which was clicked on (identified in the status bar). Alternatively, 1420 if you hold down the &Shift; key, then the action is 1421 performed on the centered object instead.</para> 1422 1423 <variablelist> 1424 <varlistentry> 1425 <term><keycap>C</keycap></term> 1426 <listitem><para>Center and Track on the selected object.</para></listitem> 1427 </varlistentry> 1428 1429 <varlistentry> 1430 <term><keycap>D</keycap></term> 1431 <listitem><para>Open the Details window for the selected object.</para></listitem> 1432 </varlistentry> 1433 1434 <varlistentry> 1435 <term><keycap>L</keycap></term> 1436 <listitem><para>Toggle a name label for the selected object.</para></listitem> 1437 </varlistentry> 1438 1439 <varlistentry> 1440 <term><keycap>O</keycap></term> 1441 <listitem><para>Add the selected object to the observing list.</para></listitem> 1442 </varlistentry> 1443 1444 <varlistentry> 1445 <term><keycap>P</keycap></term> 1446 <listitem><para>Open the selected object's popup menu.</para></listitem> 1447 </varlistentry> 1448 1449 <varlistentry> 1450 <term><keycap>T</keycap></term> 1451 <listitem><para>Toggle a trail on the selected object (solar system bodies only).</para></listitem> 1452 </varlistentry> 1453 1454 </variablelist> 1455 </sect2> 1456 1457 <sect2 id="tools-keys"> 1458 <title>Tools Shortcuts</title> 1459 1460 <variablelist> 1461 <varlistentry> 1462 <term><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></term> 1463 <listitem><para>Open the <link linkend="findobjects">Find Object window</link>, 1464 for specifying a sky object on which to center.</para></listitem> 1465 </varlistentry> 1466 1467 <varlistentry><term><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo> 1468 </term> 1469 <listitem><para>Open the <guilabel>Set Coordinates Manually</guilabel> tool, 1470 for specifying RA/Dec or Az/Alt coordinates on which to center. The tool defaults to <link linkend="ai-epoch">J2000 epoch</link> for the RA/Dec.</para></listitem> 1471 </varlistentry> 1472 1473 <varlistentry> 1474 <term><keycap>[</keycap></term> 1475 <listitem><para>Start an Angular Distance measurement at the current mouse 1476 cursor position. The angular distance between start and end points is displayed 1477 at the endpoint.</para></listitem> 1478 </varlistentry> 1479 1480 <varlistentry> 1481 <term><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></term> 1482 <listitem><para>Open the <link linkend="setgeo">Set Geographic Location</link> 1483 window.</para></listitem> 1484 </varlistentry> 1485 1486 <varlistentry> 1487 <term><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></term> 1488 <listitem><para>Open the <link linkend="tool-calculator">AstroCalculator</link>. 1489 </para></listitem> 1490 </varlistentry> 1491 1492 <varlistentry> 1493 <term><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></term> 1494 <listitem><para>Open the <link linkend="tool-altvstime">Altitude vs. Time</link> 1495 tool.</para></listitem> 1496 </varlistentry> 1497 1498 <varlistentry> 1499 <term><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></term> 1500 <listitem><para>Open the <link linkend="tool-whatsup">What's up Tonight?</link> 1501 tool.</para></listitem> 1502 </varlistentry> 1503 1504 <varlistentry> 1505 <term><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></term> 1506 <listitem><para>Open the <quote>What's Interesting</quote> 1507 tool.</para></listitem> 1508 </varlistentry> 1509 1510 <varlistentry> 1511 <term><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></term> 1512 <listitem><para>Open the <link linkend="tool-scriptbuilder">Script Builder</link> 1513 tool.</para></listitem> 1514 </varlistentry> 1515 1516 <varlistentry> 1517 <term><keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo></term> 1518 <listitem><para>Open the <link linkend="tool-solarsys">Solar System Viewer</link>. 1519 </para></listitem> 1520 </varlistentry> 1521 1522 <varlistentry> 1523 <term><keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo></term> 1524 <listitem><para>Open the <link linkend="tool-jmoons">Jupiter Moons</link> 1525 tool.</para></listitem> 1526 </varlistentry> 1527 1528 </variablelist> 1529 </sect2> 1530 </sect1> 1531 1532 <sect1 id="kstars-mouse"> 1533 <title>Mouse Commands</title> 1534 <indexterm><primary>Commands</primary> 1535 <secondary>Mouse</secondary></indexterm> 1536 <indexterm><primary>Navigation Controls</primary> 1537 <secondary>Mouse</secondary></indexterm> 1538 1539 <variablelist> 1540 <varlistentry><term>Moving the mouse</term> 1541 <listitem><para> 1542 The sky coordinates (Az/Alt, RA/Dec and J2000.0 RA/Dec) of the mouse cursor are updated 1543 in the status bar. The status bar is located in the right bottom corner of the screen. 1544 The status bar can be customized by selecting <menuchoice><guimenu>Settings</guimenu> 1545 <guimenuitem>Statusbar</guimenuitem></menuchoice> submenu. Here you may choose what coordinates 1546 systems &kstars; will display in the status bar. Furthermore, you can hide the status bar by 1547 unchecking the <guilabel>Show Statusbar</guilabel> checkbox. 1548 </para></listitem> 1549 </varlistentry> 1550 1551 <varlistentry><term>"Hovering" the mouse</term> 1552 <listitem><para> 1553 A temporary name label is attached to the object nearest to the mouse cursor. 1554 </para></listitem> 1555 </varlistentry> 1556 1557 <varlistentry><term>Left-clicking</term> 1558 <listitem> 1559 <para> 1560 <indexterm><primary>Objects in the Sky</primary> 1561 <secondary>Identifying</secondary></indexterm> 1562 The object nearest the mouse click is identified in the 1563 status bar. 1564 </para></listitem> 1565 </varlistentry> 1566 1567 <varlistentry><term>Double-clicking</term> 1568 <listitem> 1569 <para> 1570 <indexterm><primary>Objects in the Sky</primary> 1571 <secondary>Centering</secondary></indexterm> 1572 Center and track on the location or object 1573 nearest the mouse click. Double-clicking on an Info Box will 1574 <quote>shade</quote> it to show/hide extra information. 1575 </para></listitem> 1576 </varlistentry> 1577 1578 <varlistentry><term>Right-clicking</term> 1579 <listitem> 1580 <para> 1581 <indexterm><primary>Objects in the Sky</primary> 1582 <secondary>Invoking Popup Menu for</secondary></indexterm> 1583 Open the <link linkend="popup-menu">popup menu</link> for the 1584 location or object nearest the mouse cursor. 1585 </para></listitem> 1586 </varlistentry> 1587 1588 <varlistentry><term>Scrolling the mouse wheel</term> 1589 <listitem><para>Zoom the display in or out. If you do not 1590 have a mouse <mousebutton>wheel</mousebutton>, you can hold the middle mouse button and 1591 drag vertically. 1592 </para></listitem> 1593 </varlistentry> 1594 1595 <varlistentry><term>Click-and-dragging</term> 1596 <listitem><para> 1597 <variablelist> 1598 <varlistentry><term>Dragging the sky map</term> 1599 <listitem><para>Pan the display, following the drag motion. 1600 </para></listitem></varlistentry> 1601 1602 <varlistentry><term>&Ctrl;+dragging the sky map</term> 1603 <listitem><para>Define a rectangle in the map. When the 1604 mouse button is released, the display is zoomed in to match the 1605 field-of-view to the bounds of the rectangle. 1606 </para></listitem></varlistentry> 1607 1608 <varlistentry><term>Dragging an Info Box</term> 1609 <listitem><para>The Info Box is repositioned in the map. Info 1610 Boxes will <quote>stick</quote> to window edges, so that they 1611 remain on the edge when the window is resized. 1612 </para></listitem></varlistentry> 1613 </variablelist> 1614 </para></listitem> 1615 </varlistentry> 1616 </variablelist> 1617 1618 </sect1> 1619 </chapter>