doc/kstars/commands.docbook

   1 <chapter id="commands">
   2 <title>Command Reference</title>
   3
   4 <sect1 id="kstars-menus">
   5 <title>Menu Commands</title>
   6 <indexterm><primary>Commands</primary><secondary>Menu</secondary></indexterm>
   7
   8 <sect2 id="filemenu">
   9 <title><guimenu>File</guimenu> Menu</title>
  10
  11 <variablelist>
  12 <varlistentry>
  13 <term><menuchoice>
  14 <shortcut>
  15 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
  16 </shortcut>
  17 <guimenu>File</guimenu>
  18 <guimenuitem>New Window</guimenuitem>
  19 </menuchoice></term>
  20 <listitem><para>Open another &kstars; window
  21 </para></listitem>
  22 </varlistentry>
  23
  24 <varlistentry>
  25 <term><menuchoice>
  26 <shortcut>
  27 <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
  28 </shortcut>
  29 <guimenu>File</guimenu>
  30 <guimenuitem>Close Window</guimenuitem>
  31 </menuchoice></term>
  32 <listitem><para>Close &kstars; window
  33 </para></listitem>
  34 </varlistentry>
  35
  36 <varlistentry>
  37 <term><menuchoice>
  38 <shortcut>
  39 <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
  40 </shortcut>
  41 <guimenu>File</guimenu>
  42 <guimenuitem>Download Data...</guimenuitem>
  43 </menuchoice></term>
  44 <listitem><para>Open the <guilabel>Download Extra Data</guilabel> tool
  45 </para></listitem>
  46 </varlistentry>
  47
  48 <varlistentry>
  49 <term><menuchoice>
  50 <shortcut>
  51 <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
  52 </shortcut>
  53 <guimenu>File</guimenu>
  54 <guimenuitem>Open FITS...</guimenuitem>
  55 </menuchoice></term>
  56 <listitem><para>Open a FITS image in the FITS Editor tool
  57 </para></listitem>
  58 </varlistentry>
  59
  60 <varlistentry>
  61 <term><menuchoice>
  62 <shortcut>
  63 <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
  64 </shortcut>
  65 <guimenu>File</guimenu>
  66 <guimenuitem>Save Sky Image...</guimenuitem>
  67 </menuchoice></term>
  68 <listitem><para>Create image on disk from current display
  69 </para></listitem>
  70 </varlistentry>
  71
  72 <varlistentry>
  73 <term><menuchoice>
  74 <shortcut>
  75 <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
  76 </shortcut>
  77 <guimenu>File</guimenu>
  78 <guimenuitem>Run Script...</guimenuitem>
  79 </menuchoice></term>
  80 <listitem><para>Run the specified KStars script
  81 </para></listitem>
  82 </varlistentry>
  83
  84 <varlistentry>
  85 <term><menuchoice>
  86 <shortcut>
  87 <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
  88 </shortcut>
  89 <guimenu>File</guimenu>
  90 <guimenuitem>Print...</guimenuitem>
  91 </menuchoice></term>
  92 <listitem><para>Send the current sky map to the printer (or to a
  93 PostScript/PDF file)
  94 </para></listitem>
  95 </varlistentry>
  96
  97 <varlistentry>
  98 <term><menuchoice>
  99 <shortcut>
 100 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 101 </shortcut>
 102 <guimenu>File</guimenu>
 103 <guimenuitem>Quit</guimenuitem>
 104 </menuchoice></term>
 105 <listitem><para>Quit &kstars;
 106 </para></listitem>
 107 </varlistentry>
 108 </variablelist>
 109
 110 </sect2>
 111
 112 <sect2 id="timemenu">
 113 <title><guimenu>Time</guimenu> Menu</title>
 114
 115 <variablelist>
 116 <varlistentry>
 117 <term><menuchoice>
 118 <shortcut>
 119 <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
 120 </shortcut>
 121 <guimenu>Time</guimenu>
 122 <guimenuitem>Set Time to Now</guimenuitem>
 123 </menuchoice></term>
 124 <listitem><para>Sync time to system clock</para></listitem>
 125 </varlistentry>
 126
 127 <varlistentry>
 128 <term><menuchoice>
 129 <shortcut>
 130 <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
 131 </shortcut>
 132 <guimenu>Time</guimenu>
 133 <guimenuitem>Set Time...</guimenuitem>
 134 </menuchoice></term>
 135 <listitem><para>Set time and date</para></listitem>
 136 </varlistentry>
 137
 138 <varlistentry>
 139 <term><menuchoice>
 140 <guimenu>Time</guimenu>
 141 <guimenuitem>Start/Stop Clock</guimenuitem>
 142 </menuchoice></term>
 143 <listitem><para>Toggle whether time passes</para></listitem>
 144 </varlistentry>
 145 </variablelist>
 146
 147 </sect2>
 148
 149 <sect2 id="pointmenu">
 150 <title><guimenu>Pointing</guimenu> Menu</title>
 151
 152 <variablelist>
 153 <varlistentry>
 154 <term><menuchoice>
 155 <shortcut>
 156 <keycap>Z</keycap>
 157 </shortcut>
 158 <guimenu>Pointing</guimenu>
 159 <guimenuitem>Zenith</guimenuitem>
 160 </menuchoice></term>
 161 <listitem><para>Center the display at the
 162 <link linkend="ai-zenith">Zenith</link> point (straight up)
 163 </para></listitem>
 164 </varlistentry>
 165
 166 <varlistentry>
 167 <term><menuchoice>
 168 <shortcut>
 169 <keycap>N</keycap>
 170 </shortcut>
 171 <guimenu>Pointing</guimenu>
 172 <guimenuitem>North</guimenuitem>
 173 </menuchoice></term>
 174 <listitem><para>Center the display above the North point on the
 175 horizon</para></listitem>
 176 </varlistentry>
 177
 178 <varlistentry>
 179 <term><menuchoice>
 180 <shortcut>
 181 <keycap>E</keycap>
 182 </shortcut>
 183 <guimenu>Pointing</guimenu>
 184 <guimenuitem>East</guimenuitem>
 185 </menuchoice></term>
 186 <listitem><para>Center the display above the East point on the
 187 horizon</para></listitem>
 188 </varlistentry>
 189
 190 <varlistentry>
 191 <term><menuchoice>
 192 <shortcut>
 193 <keycap>S</keycap>
 194 </shortcut>
 195 <guimenu>Pointing</guimenu>
 196 <guimenuitem>South</guimenuitem>
 197 </menuchoice></term>
 198 <listitem><para>Center the display above the South point on the
 199 horizon</para></listitem>
 200 </varlistentry>
 201
 202 <varlistentry>
 203 <term><menuchoice>
 204 <shortcut>
 205 <keycap>W</keycap>
 206 </shortcut>
 207 <guimenu>Pointing</guimenu>
 208 <guimenuitem>West</guimenuitem>
 209 </menuchoice></term>
 210 <listitem><para>Center the display above the West point on the
 211 horizon</para></listitem>
 212 </varlistentry>
 213
 214 <varlistentry>
 215 <term><menuchoice>
 216 <shortcut>
 217 <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
 218 </shortcut>
 219 <guimenu>Pointing</guimenu>
 220 <guimenuitem>Set Focus Manually...</guimenuitem>
 221 </menuchoice></term>
 222 <listitem><para>Center the display on specific
 223 <link linkend="ai-skycoords">sky coordinates</link>
 224 </para></listitem>
 225 </varlistentry>
 226
 227 <varlistentry>
 228 <term><menuchoice>
 229 <shortcut>
 230 <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
 231 </shortcut>
 232 <guimenu>Pointing</guimenu>
 233 <guimenuitem>Find Object</guimenuitem>
 234 </menuchoice></term>
 235 <listitem><para>Locate an object by name using the
 236 <link linkend="findobjects">Find Object Window</link></para></listitem>
 237 </varlistentry>
 238
 239 <varlistentry>
 240 <term><menuchoice>
 241 <shortcut>
 242 <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
 243 </shortcut>
 244 <guimenu>Pointing</guimenu>
 245 <guimenuitem>Engage/Stop Tracking</guimenuitem>
 246 </menuchoice></term>
 247 <listitem><para>Toggle tracking on/off.  While tracking,
 248 the display will remain centered on the current position or
 249 object.</para></listitem>
 250 </varlistentry>
 251 </variablelist>
 252
 253 </sect2>
 254
 255 <sect2 id="viewmenu">
 256 <title><guimenu>View</guimenu> Menu</title>
 257
 258 <variablelist>
 259 <varlistentry>
 260 <term><menuchoice>
 261 <shortcut>
 262 <keycap>+</keycap>
 263 </shortcut>
 264 <guimenu>View</guimenu>
 265 <guimenuitem>Zoom in</guimenuitem>
 266 </menuchoice></term>
 267 <listitem><para>Zooms view in</para></listitem>
 268 </varlistentry>
 269
 270 <varlistentry>
 271 <term><menuchoice>
 272 <shortcut>
 273 <keycap>-</keycap>
 274 </shortcut>
 275 <guimenu>View</guimenu>
 276 <guimenuitem>Zoom out</guimenuitem>
 277 </menuchoice></term>
 278 <listitem><para>Zooms view out</para></listitem>
 279 </varlistentry>
 280
 281 <varlistentry>
 282 <term><menuchoice>
 283 <shortcut>
 284 <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 285 </shortcut>
 286 <guimenu>View</guimenu>
 287 <guimenuitem>Default Zoom</guimenuitem>
 288 </menuchoice></term>
 289 <listitem><para>Restore the default Zoom setting</para></listitem>
 290 </varlistentry>
 291
 292 <varlistentry>
 293 <term><menuchoice>
 294 <shortcut>
 295 <keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
 296 </shortcut>
 297 <guimenu>View</guimenu>
 298 <guimenuitem>Zoom to Angular Size...</guimenuitem>
 299 </menuchoice></term>
 300 <listitem><para>Zoom to specified field-of-view angle</para></listitem>
 301 </varlistentry>
 302
 303 <varlistentry>
 304 <term><menuchoice>
 305 <shortcut>
 306 <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
 307 </shortcut>
 308 <guimenu>View</guimenu>
 309 <guimenuitem>Full Screen Mode</guimenuitem>
 310 </menuchoice></term>
 311 <listitem><para>Toggle full-screen mode</para></listitem>
 312 </varlistentry>
 313
 314 <varlistentry>
 315 <term><menuchoice>
 316 <shortcut>
 317 <keycap>Space</keycap>
 318 </shortcut>
 319 <guimenu>View</guimenu>
 320 <guimenuitem>Horizontal/Equatorial Coordinates</guimenuitem>
 321 </menuchoice></term>
 322 <listitem><para>Toggle between the
 323 <link linkend="horizontal">Horizontal</link> and
 324 <link linkend="equatorial">Equatorial</link>
 325 <link linkend="ai-skycoords">Coordinate Systems</link></para></listitem>
 326 </varlistentry>
 327 </variablelist>
 328 </sect2>
 329
 330 <sect2 id="devicemenu">
 331 <title><guimenu>Devices</guimenu> Menu</title>
 332
 333 <variablelist>
 334
 335 <varlistentry>
 336 <term><menuchoice>
 337 <guimenu>Devices</guimenu>
 338 <guimenuitem>Telescope Wizard...</guimenuitem>
 339 </menuchoice></term>
 340 <listitem><para>Opens the <guilabel>Telescope Wizard</guilabel>, which
 341 provides a step-by-step guide to help you connect to your telescope and
 342 control it with &kstars;.</para></listitem>
 343 </varlistentry>
 344
 345 <varlistentry>
 346 <term><menuchoice>
 347 <guimenu>Devices</guimenu>
 348 <guimenuitem>Capture Image Sequence...</guimenuitem>
 349 </menuchoice></term>
 350 <listitem><para>Acquire images from a CCD camera or webcam device</para></listitem>
 351 </varlistentry>
 352
 353 <varlistentry>
 354 <term><menuchoice>
 355 <guimenu>Devices</guimenu>
 356 <guimenuitem>Device Manager</guimenuitem>
 357 </menuchoice></term>
 358 <listitem><para>Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers.</para></listitem>
 359 </varlistentry>
 360
 361 <varlistentry>
 362 <term><menuchoice>
 363 <guimenu>Devices</guimenu>
 364 <guimenuitem>INDI Control Panel</guimenuitem>
 365 </menuchoice></term>
 366 <listitem><para>Opens up INDI Control Panel, which allows you to control all the features supported by a device.</para></listitem>
 367 </varlistentry>
 368
 369 <varlistentry>
 370 <term><menuchoice>
 371 <guimenu>Devices</guimenu>
 372 <guimenuitem>Configure INDI</guimenuitem>
 373 </menuchoice></term>
 374 <listitem><para>Opens up a dialog to configure INDI-related features such as automatic device updates.</para></listitem>
 375 </varlistentry>
 376
 377 </variablelist>
 378 </sect2>
 379
 380 <sect2 id="toolmenu">
 381 <title><guimenu>Tools</guimenu> Menu</title>
 382
 383 <variablelist>
 384 <varlistentry>
 385 <term><menuchoice>
 386 <shortcut>
 387 <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
 388 </shortcut>
 389 <guimenu>Tools</guimenu>
 390 <guimenuitem>Calculator...</guimenuitem>
 391 </menuchoice></term>
 392 <listitem>
 393 <para>
 394 Opens the <link linkend="tool-calculator">AstroCalculator</link> Tool,
 395 which provides full access to many of the mathematical functions used by
 396 &kstars;.
 397 </para>
 398 </listitem>
 399 </varlistentry>
 400
 401 <varlistentry>
 402 <term><menuchoice>
 403 <shortcut>
 404 <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
 405 </shortcut>
 406 <guimenu>Tools</guimenu>
 407 <guimenuitem>AAVSO Light Curves...</guimenuitem>
 408 </menuchoice></term>
 409 <listitem>
 410 <para>
 411 Opens the <link linkend="tool-aavso">AAVSO Light Curve Generator</link>
 412 Tool, which allows you to download a light curve for any variable
 413 star from the American Association of Variable Star Observers.
 414 </para>
 415 </listitem>
 416 </varlistentry>
 417
 418 <varlistentry>
 419 <term><menuchoice>
 420 <shortcut>
 421 <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
 422 </shortcut>
 423 <guimenu>Tools</guimenu>
 424 <guimenuitem>Altitude vs. Time...</guimenuitem>
 425 </menuchoice></term>
 426 <listitem>
 427 <para>
 428 Opens the <link linkend="tool-altvstime">Altitude vs. Time</link> Tool, which
 429 can plot curves representing the altitude of any object as a
 430 function of time.  This is useful for planning observing
 431 sessions.
 432 </para>
 433 </listitem>
 434 </varlistentry>
 435
 436 <varlistentry>
 437 <term><menuchoice>
 438 <shortcut>
 439 <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
 440 </shortcut>
 441 <guimenu>Tools</guimenu>
 442 <guimenuitem>What's Up Tonight...</guimenuitem>
 443 </menuchoice></term>
 444 <listitem>
 445 <para>
 446 Opens the <link linkend="tool-whatsup">What's Up Tonight</link> Tool,
 447 which presents a summary of the objects which are observable
 448 from your location on a given date.
 449 </para>
 450 </listitem>
 451 </varlistentry>
 452
 453 <varlistentry>
 454 <term><menuchoice>
 455 <shortcut>
 456 <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo>
 457 </shortcut>
 458 <guimenu>Tools</guimenu>
 459 <guimenuitem>Script Builder...</guimenuitem>
 460 </menuchoice></term>
 461 <listitem>
 462 <para>
 463 Opens the <link linkend="tool-scriptbuilder">Script Builder</link> Tool,
 464 which provides a GUI interface for building &kstars; DCOP scripts.
 465 </para>
 466 </listitem>
 467 </varlistentry>
 468
 469 <varlistentry>
 470 <term><menuchoice>
 471 <shortcut>
 472 <keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo>
 473 </shortcut>
 474 <guimenu>Tools</guimenu>
 475 <guimenuitem>Solar System...</guimenuitem>
 476 </menuchoice></term>
 477 <listitem>
 478 <para>
 479 Opens the <link linkend="tool-solarsys">Solar System Viewer</link>,
 480 which displays an overhead view of the solar system on the
 481 current simulation date.
 482 </para>
 483 </listitem>
 484 </varlistentry>
 485
 486 <varlistentry>
 487 <term><menuchoice>
 488 <shortcut>
 489 <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo>
 490 </shortcut>
 491 <guimenu>Tools</guimenu>
 492 <guimenuitem>Jupiter's Moons...</guimenuitem>
 493 </menuchoice></term>
 494 <listitem>
 495 <para>
 496 Opens the <link linkend="tool-jmoons">Jupiter Moons Tool</link>,
 497 which displays the positions of Jupiter's four brightest
 498 moons as a function of time.
 499 </para>
 500 </listitem>
 501 </varlistentry>
 502
 503 </variablelist>
 504 </sect2>
 505
 506 <sect2 id="settingmenu">
 507 <title><guimenu>Settings</guimenu> Menu</title>
 508
 509 <variablelist>
 510 <varlistentry>
 511 <term><menuchoice>
 512 <guimenu>Settings</guimenu>
 513 <guisubmenu>Info Boxes</guisubmenu>
 514 <guimenuitem>Hide/Show Info Boxes</guimenuitem>
 515 </menuchoice></term>
 516 <listitem><para>Toggle display of all three Info Boxes
 517 </para></listitem>
 518 </varlistentry>
 519
 520 <varlistentry>
 521 <term><menuchoice>
 522 <guimenu>Settings</guimenu>
 523 <guisubmenu>Info Boxes</guisubmenu>
 524 <guimenuitem>Hide/Show Time</guimenuitem>
 525 </menuchoice></term>
 526 <listitem><para>Toggle display of the Time Info Box
 527 </para></listitem>
 528 </varlistentry>
 529
 530 <varlistentry>
 531 <term><menuchoice>
 532 <guimenu>Settings</guimenu>
 533 <guisubmenu>Info Boxes</guisubmenu>
 534 <guimenuitem>Hide/Show Focus</guimenuitem>
 535 </menuchoice></term>
 536 <listitem><para>Toggle display of the Focus Info Box
 537 </para></listitem>
 538 </varlistentry>
 539
 540 <varlistentry>
 541 <term><menuchoice>
 542 <guimenu>Settings</guimenu>
 543 <guisubmenu>Info Boxes</guisubmenu>
 544 <guimenuitem>Hide/Show Location</guimenuitem>
 545 </menuchoice></term>
 546 <listitem><para>Toggle display of the Location Info Box
 547 </para></listitem>
 548 </varlistentry>
 549
 550 <varlistentry>
 551 <term><menuchoice>
 552 <guimenu>Settings</guimenu>
 553 <guisubmenu>Toolbars</guisubmenu>
 554 <guimenuitem>Hide/Show Main Toolbar</guimenuitem>
 555 </menuchoice></term>
 556 <listitem><para>Toggle display of the Main Toolbar
 557 </para></listitem>
 558 </varlistentry>
 559
 560 <varlistentry>
 561 <term><menuchoice>
 562 <guimenu>Settings</guimenu>
 563 <guisubmenu>Toolbars</guisubmenu>
 564 <guimenuitem>Hide/Show View Toolbar</guimenuitem>
 565 </menuchoice></term>
 566 <listitem><para>Toggle display of the View Toolbar
 567 </para></listitem>
 568 </varlistentry>
 569
 570 <varlistentry>
 571 <term><menuchoice>
 572 <guimenu>Settings</guimenu>
 573 <guisubmenu>Statusbar</guisubmenu>
 574 <guimenuitem>Hide/Show Statusbar</guimenuitem>
 575 </menuchoice></term>
 576 <listitem><para>Toggle display of the Statusbar
 577 </para></listitem>
 578 </varlistentry>
 579
 580 <varlistentry>
 581 <term><menuchoice>
 582 <guimenu>Settings</guimenu>
 583 <guisubmenu>Statusbar</guisubmenu>
 584 <guimenuitem>Hide/Show Az/Alt field</guimenuitem>
 585 </menuchoice></term>
 586 <listitem><para>Toggle display of the mouse cursor's horizontal
 587 coordinates in the statusbar
 588 </para></listitem>
 589 </varlistentry>
 590
 591 <varlistentry>
 592 <term><menuchoice>
 593 <guimenu>Settings</guimenu>
 594 <guisubmenu>Statusbar</guisubmenu>
 595 <guimenuitem>Hide/Show RA/Dec field</guimenuitem>
 596 </menuchoice></term>
 597 <listitem><para>Toggle display of the mouse cursor's horizontal
 598 coordinates in the statusbar
 599 </para></listitem>
 600 </varlistentry>
 601
 602 <varlistentry>
 603 <term><menuchoice>
 604 <guimenu>Settings</guimenu>
 605 <guisubmenu>Color Schemes</guisubmenu>
 606 </menuchoice></term>
 607 <listitem><para>
 608 This submenu contains all of the defined color schemes, including your
 609 custom schemes.  Select any item to set that color scheme.
 610 </para></listitem>
 611 </varlistentry>
 612
 613 <varlistentry>
 614 <term><menuchoice>
 615 <guimenu>Settings</guimenu>
 616 <guisubmenu>FOV Symbols</guisubmenu>
 617 </menuchoice></term>
 618 <listitem><para>
 619 This submenu lists the available field-of-view (FOV) Symbols.
 620 The FOV Symbol is drawn at the center of the display.  You
 621 may choose from the list of predefined symbols (No symbol,
 622 7x35 Binoculars, One degree, or HST WFPC2), or you may define
 623 your own symbols (or modify existing symbols) using the
 624 <guimenuitem>Edit FOV symbols...</guimenuitem> item.
 625 </para></listitem>
 626 </varlistentry>
 627
 628 <varlistentry>
 629 <term><menuchoice>
 630 <shortcut>
 631 <keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
 632 </shortcut>
 633 <guimenu>Settings</guimenu>
 634 <guimenuitem>Set Geographic Location...</guimenuitem>
 635 </menuchoice></term>
 636 <listitem>
 637 <para>
 638 Select a new <link linkend="setgeo">geographic
 639 location</link>
 640 </para>
 641 </listitem>
 642 </varlistentry>
 643
 644 <varlistentry>
 645 <term><menuchoice>
 646 <guimenu>Settings</guimenu>
 647 <guimenuitem>Configure &kstars;...</guimenuitem>
 648 </menuchoice></term>
 649 <listitem><para>Modify <link linkend="config">configuration
 650 options</link></para></listitem>
 651 </varlistentry>
 652 </variablelist>
 653 </sect2>
 654
 655 <sect2 id="helpmenu">
 656 <title><guimenu>Help</guimenu> Menu</title>
 657
 658 &help.menu.documentation;
 659
 660 </sect2>
 661
 662 <sect2 id="popup-menu">
 663 <title>Popup Menu</title>
 664 <indexterm><primary>Popup Menu</primary><secondary>Description</secondary></indexterm>
 665
 666 <para>
 667 The <mousebutton>right</mousebutton> click popup menu is
 668 context-sensitive, meaning its content varies depending on what kind of
 669 object you click on.  We list all possible popup menu items here, with
 670 the relevant object type [in brackets].</para>
 671
 672 <variablelist>
 673 <varlistentry>
 674 <term>[All]</term>
 675 <listitem><para>
 676 Identification and type:  The top one to three lines are devoted to the
 677 name(s) of the object, and its type.  For stars, the Spectral Type
 678 is also shown here.
 679 </para></listitem>
 680 </varlistentry>
 681
 682 <varlistentry>
 683 <term>[All]</term>
 684 <listitem><para>
 685 Rise, Transit, and Set times for the object on the current simulation
 686 date are shown on the next three lines.
 687 </para></listitem>
 688 </varlistentry>
 689
 690 <varlistentry>
 691 <term>[All]</term>
 692 <listitem><para>
 693 <guimenuitem>Center and Track</guimenuitem>: Center the display
 694 on this location, and engage tracking.  Equivalent to double-clicking.
 695 </para></listitem>
 696 </varlistentry>
 697
 698 <varlistentry>
 699 <term>[All]</term>
 700 <listitem><para>
 701 <guimenuitem>Angular Distance To...</guimenuitem>: Enter "angular distance
 702 mode".  In this mode, a dotted line is drawn from the first target object
 703 to the current mouse position.  When you invoke the popup menu of a second
 704 object, this item will read <guilabel>Compute Angular Distance</guilabel>.
 705 Selecting this item will display the angular distance between the two
 706 objects in the statusbar.  You can press the <keycap>Esc</keycap> key to
 707 exit angular distance mode without measuring an angle.
 708 </para></listitem>
 709 </varlistentry>
 710
 711 <varlistentry>
 712 <term>[All]</term>
 713 <listitem><para>
 714 <guimenuitem>Details</guimenuitem>: Open the
 715 <link linkend="tool-details">Object Details window</link> for this object.
 716 </para></listitem>
 717 </varlistentry>
 718
 719 <varlistentry>
 720 <term>[All]</term>
 721 <listitem><para>
 722 <guimenuitem>Attach Label</guimenuitem>: Attach a permanent name label
 723 to the object.  If the object already has a label attached, this item
 724 will read <guilabel>Remove Label</guilabel>.
 725 </para></listitem>
 726 </varlistentry>
 727
 728 <varlistentry>
 729 <term>[All]</term>
 730 <listitem><para>
 731 <guimenuitem>Show ... Image</guimenuitem>: download an image of the
 732 object from the internet, and display it in the Image Viewer tool.
 733 The "..." text is replaced by a short description of the image's
 734 source.  An object may have multiple image links available in its
 735 popup menu.
 736 </para></listitem>
 737 </varlistentry>
 738
 739 <varlistentry>
 740 <term>[All]</term>
 741 <listitem><para>
 742 <guimenuitem>... Page</guimenuitem>: Display a webpage about the object
 743 in your default web browser.  The "..." text is replaced by a short
 744 description of the page.  An object may have multiple web links available
 745 in its popup menu.
 746 </para></listitem>
 747 </varlistentry>
 748
 749 <varlistentry>
 750 <term>[All Named Objects]</term>
 751 <listitem><para>
 752 <indexterm><primary>Objects in the Sky</primary>
 753 <secondary>Internet Links</secondary>
 754 <tertiary>Customizing</tertiary></indexterm>
 755 <guimenuitem>Add Link...</guimenuitem>: This allows you to add your own
 756 custom links to the popup menu of any object.  It opens a small window
 757 in which you enter the &URL; of the link, and the text you want to
 758 appear in the popup menu.  There is also a pair of radio buttons which
 759 allow you to specify whether the &URL; is an image or an
 760 <acronym>HTML</acronym> document, so &kstars; knows whether to launch
 761 the web browser or the image viewer.  You can use this to add links to
 762 files on your local disk, so this feature could be used to attach
 763 observing logs or other custom information to objects in &kstars;.
 764 Your custom links are automatically loaded whenever &kstars; starts up,
 765 and they are stored in the folder <filename
 766 class="directory">~/.kde/share/apps/kstars/</filename>, in files
 767 <filename>myimage_url.dat</filename> and
 768 <filename>myinfo_url.dat</filename>.  If you build an extensive list
 769 of custom links, consider submitting them to us, we would like to
 770 include them in the next version of &kstars;!
 771 </para>
 772 </listitem>
 773 </varlistentry>
 774 </variablelist>
 775
 776 </sect2>
 777 </sect1>
 778
 779 <sect1 id="kstars-keys">
 780 <title>Keyboard Commands</title>
 781 <indexterm><primary>Commands</primary>
 782 <secondary>Keyboard</secondary></indexterm>
 783
 784 <sect2 id="nav-keys">
 785 <title>Navigation Keys</title>
 786 <indexterm><primary>Navigation Controls</primary>
 787 <secondary>Keyboard</secondary></indexterm>
 788
 789 <variablelist>
 790 <varlistentry><term>Arrow Keys</term>
 791 <listitem><para>
 792 Use the arrow keys to pan the display.  Holding down the &Shift;
 793 key doubles the scrolling speed.
 794 </para></listitem></varlistentry>
 795
 796 <varlistentry>
 797 <term><keycap>+</keycap> / <keycap>-</keycap></term>
 798 <listitem><para>Zoom In/Out</para></listitem>
 799 </varlistentry>
 800
 801 <varlistentry>
 802 <term><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></term>
 803 <listitem><para>Restore the default Zoom setting</para></listitem>
 804 </varlistentry>
 805
 806 <varlistentry>
 807 <term><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></term>
 808 <listitem><para>Zoom to specified field-of-view angle</para></listitem>
 809 </varlistentry>
 810
 811 <varlistentry>
 812 <term>0&ndash;9</term>
 813 <listitem><para>Center Display on a major Solar System body:
 814 <itemizedlist>
 815 <listitem><para>0: Sun</para></listitem>
 816 <listitem><para>1: Mercury</para></listitem>
 817 <listitem><para>2: Venus</para></listitem>
 818 <listitem><para>3: Moon</para></listitem>
 819 <listitem><para>4: Mars</para></listitem>
 820 <listitem><para>5: Jupiter</para></listitem>
 821 <listitem><para>6: Saturn</para></listitem>
 822 <listitem><para>7: Uranus</para></listitem>
 823 <listitem><para>8: Neptune</para></listitem>
 824 <listitem><para>9: Pluto</para></listitem>
 825 </itemizedlist>
 826 </para></listitem>
 827 </varlistentry>
 828
 829 <varlistentry>
 830 <term><keycap>Z</keycap></term>
 831 <listitem><para>Center the display at the <link linkend="ai-zenith">Zenith</link>
 832 Point (straight up)</para></listitem>
 833 </varlistentry>
 834
 835 <varlistentry>
 836 <term><keycap>N</keycap></term>
 837 <listitem><para>Center the display above the North point on the  horizon</para></listitem>
 838 </varlistentry>
 839
 840 <varlistentry>
 841 <term><keycap>E</keycap></term>
 842 <listitem><para>Center the display above the East point on the  horizon</para></listitem>
 843 </varlistentry>
 844
 845 <varlistentry>
 846 <term><keycap>S</keycap></term>
 847 <listitem><para>Center the display above the South point on the horizon</para>
 848 </listitem>
 849 </varlistentry>
 850
 851 <varlistentry>
 852 <term><keycap>W</keycap></term>
 853 <listitem><para>Center the display above the West point on the  horizon</para></listitem>
 854 </varlistentry>
 855
 856 <varlistentry>
 857 <term><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></term>
 858 <listitem><para>Toggle tracking mode</para></listitem>
 859 </varlistentry>
 860
 861 <varlistentry>
 862 <term><keycap>&lt;</keycap></term>
 863 <listitem><para>Advance the simulation clock backwards by one time step</para>
 864 </listitem>
 865 </varlistentry>
 866
 867 <varlistentry>
 868 <term><keycap>&gt;</keycap></term>
 869 <listitem><para>Advance the simulation clock forwards by one time step</para>
 870 </listitem>
 871 </varlistentry>
 872
 873 </variablelist>
 874 </sect2>
 875
 876 <sect2 id="menu-keys">
 877 <title>Menu Shortcuts</title>
 878 <indexterm><primary>Commands</primary>
 879 <secondary>Menu</secondary>
 880 <tertiary>Keyboard Shortcuts</tertiary>
 881 </indexterm>
 882
 883 <variablelist>
 884 <varlistentry>
 885 <term><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></term>
 886 <listitem><para>Open a new &kstars; window</para></listitem>
 887 </varlistentry>
 888
 889 <varlistentry>
 890 <term><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></term>
 891 <listitem><para>Close a &kstars; window</para></listitem>
 892 </varlistentry>
 893
 894 <varlistentry>
 895 <term><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></term>
 896 <listitem><para>Download extra data</para></listitem>
 897 </varlistentry>
 898
 899 <varlistentry>
 900 <term><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></term>
 901 <listitem><para>Open a FITS image in the FITS Editor</para></listitem>
 902 </varlistentry>
 903
 904 <varlistentry>
 905 <term><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></term>
 906 <listitem><para>Export sky image to a file</para></listitem>
 907 </varlistentry>
 908
 909 <varlistentry>
 910 <term><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></term>
 911 <listitem><para>Run a &kstars; DCOP script</para></listitem>
 912 </varlistentry>
 913
 914 <varlistentry>
 915 <term><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></term>
 916 <listitem><para>Print the current sky map</para></listitem>
 917 </varlistentry>
 918
 919 <varlistentry>
 920 <term><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></term>
 921 <listitem><para>Quit &kstars;</para></listitem>
 922 </varlistentry>
 923
 924 <varlistentry>
 925 <term><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></term>
 926 <listitem><para>Sync the simulation clock with the current system time</para></listitem>
 927 </varlistentry>
 928
 929 <varlistentry>
 930 <term><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></term>
 931 <listitem><para>Set the simulation clock to a specified Time and Date</para></listitem>
 932 </varlistentry>
 933
 934 <varlistentry>
 935 <term><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></term>
 936 <listitem><para>Toggle full-screen mode</para></listitem>
 937 </varlistentry>
 938
 939 <varlistentry><term><keycap>Space</keycap></term>
 940 <listitem><para>Toggle between the
 941 <link linkend="horizontal">Horizontal</link> and
 942 <link linkend="equatorial">Equatorial</link>
 943 <link linkend="ai-skycoords">Coordinate Systems</link>
 944 </para></listitem></varlistentry>
 945
 946 <varlistentry>
 947 <term><keycap>F1</keycap></term>
 948 <listitem><para>Open the &kstars; Handbook</para></listitem>
 949 </varlistentry>
 950 </variablelist>
 951 </sect2>
 952
 953
 954 <sect2 id="object-actions">
 955 <title>Actions for the Selected Object</title>
 956 <indexterm><primary>Objects in the Sky</primary>
 957 <secondary>Keyboard Actions</secondary></indexterm>
 958
 959 <para>Each of the following keystrokes performs an action on the
 960 <firstterm>selected object</firstterm>.  The selected object is the last
 961 object which was clicked on (identified in the status bar).  Alternatively,
 962 if you hold down the <keycap>Shift</keycap> key, then the action is
 963 performed on the centered object instead.</para>
 964
 965 <!-- FIXME: this feature does not exist yet; to be added after feature thaw
 966 <variablelist>
 967 <varlistentry>
 968 <term><keycap>C</keycap></term>
 969 <listitem><para>Center and Track on the selected object</para></listitem>
 970 </varlistentry>
 971 -->
 972 <variablelist>
 973 <varlistentry>
 974 <term><keycap>D</keycap></term>
 975 <listitem><para>Open the Details window for the selected object</para></listitem>
 976 </varlistentry>
 977
 978 <varlistentry>
 979 <term><keycap>L</keycap></term>
 980 <listitem><para>Toggle a name label for the selected object</para></listitem>
 981 </varlistentry>
 982
 983 <varlistentry>
 984 <term><keycap>O</keycap></term>
 985 <listitem><para>Add the selected object to the observing list</para></listitem>
 986 </varlistentry>
 987
 988 <varlistentry>
 989 <term><keycap>P</keycap></term>
 990 <listitem><para>Open the selected object's popup menu</para></listitem>
 991 </varlistentry>
 992
 993 <varlistentry>
 994 <term><keycap>T</keycap></term>
 995 <listitem><para>Toggle a trail on the selected object (solar system bodies only)</para></listitem>
 996 </varlistentry>
 997
 998 </variablelist>
 999 </sect2>
1000
1001 <sect2 id="tools-keys">
1002 <title>Tools Shortcuts</title>
1003
1004 <variablelist>
1005 <varlistentry>
1006 <term><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></term>
1007 <listitem><para>Open the <link linkend="findobjects">Find Object window</link>,
1008 for specifying a sky object on which to center</para></listitem>
1009 </varlistentry>
1010
1011 <varlistentry><term><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
1012 </term>
1013 <listitem><para>Open the <guilabel>Set Manual Focus</guilabel> tool,
1014 for specifying RA/Dec or Az/Alt coordinates on which to center</para></listitem>
1015 </varlistentry>
1016
1017 <varlistentry>
1018 <term><keycap>[</keycap> / <keycap>]</keycap></term>
1019 <listitem><para>Start/End an Angular Distance measurement at the current mouse
1020 cursor position.  The angular distance between start and end points is displayed
1021 in the statusbar.</para></listitem>
1022 </varlistentry>
1023
1024 <varlistentry>
1025 <term><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></term>
1026 <listitem><para>Open the <link linkend="setgeo">Set Geographic Location</link>
1027 window</para></listitem>
1028 </varlistentry>
1029
1030 <varlistentry>
1031 <term><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></term>
1032 <listitem><para>Open the <link linkend="tool-calculator">AstroCalculator</link>
1033 </para></listitem>
1034 </varlistentry>
1035
1036 <varlistentry>
1037 <term><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></term>
1038 <listitem><para>Open the <link linkend="tool-aavso">AAVSO Lightcurve Generator</link>
1039 </para></listitem>
1040 </varlistentry>
1041
1042 <varlistentry>
1043 <term><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></term>
1044 <listitem><para>Open the <link linkend="tool-altvstime">Altitude vs. Time</link>
1045 tool</para></listitem>
1046 </varlistentry>
1047
1048 <varlistentry>
1049 <term><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></term>
1050 <listitem><para>Open the <link linkend="tool-whatsup">What's Up Tonight?</link>
1051 tool</para></listitem>
1052 </varlistentry>
1053
1054 <varlistentry>
1055 <term><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></term>
1056 <listitem><para>Open the <link linkend="tool-scriptbuilder">Script Builder</link>
1057 tool</para></listitem>
1058 </varlistentry>
1059
1060 <varlistentry>
1061 <term><keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo></term>
1062 <listitem><para>Open the <link linkend="tool-solarsys">Solar System Viewer</link>
1063 </para></listitem>
1064 </varlistentry>
1065
1066 <varlistentry>
1067 <term><keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo></term>
1068 <listitem><para>Open the <link linkend="tool-jmoons">Jupiter Moons</link>
1069 tool</para></listitem>
1070 </varlistentry>
1071
1072 <varlistentry>
1073 <term><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></term>
1074 <listitem><para>Open the <link linkend="tool-observinglist">Observing List</link>
1075 tool</para></listitem>
1076 </varlistentry>
1077
1078 </variablelist>
1079 </sect2>
1080 </sect1>
1081
1082 <sect1 id="kstars-mouse">
1083 <title>Mouse Commands</title>
1084 <indexterm><primary>Commands</primary>
1085 <secondary>Mouse</secondary></indexterm>
1086 <indexterm><primary>Navigation Controls</primary>
1087 <secondary>Mouse</secondary></indexterm>
1088
1089 <variablelist>
1090 <varlistentry><term>Moving the mouse</term>
1091 <listitem><para>
1092 The sky coordinates (RA/Dec and Az/Alt) of the mouse cursor are updated
1093 in the status bar
1094 </para></listitem>
1095 </varlistentry>
1096
1097 <varlistentry><term>"Hovering" the mouse</term>
1098 <listitem><para>
1099 A temporary name label is attached to the object nearest to the mouse cursor.
1100 </para></listitem>
1101 </varlistentry>
1102
1103 <varlistentry><term>Left-clicking</term>
1104 <listitem>
1105 <para>
1106 <indexterm><primary>Objects in the Sky</primary>
1107 <secondary>Identifying</secondary></indexterm>
1108 The object nearest the mouse click is identified in the
1109 status bar.
1110 </para></listitem>
1111 </varlistentry>
1112
1113 <varlistentry><term>Double-clicking</term>
1114 <listitem>
1115 <para>
1116 <indexterm><primary>Objects in the Sky</primary>
1117 <secondary>Centering</secondary></indexterm>
1118 Center and track on the location or object
1119 nearest the mouse click.  Double-clicking on an Info Box will
1120 <quote>shade</quote> it to show/hide extra information.
1121 </para></listitem>
1122 </varlistentry>
1123
1124 <varlistentry><term>Right-clicking</term>
1125 <listitem>
1126 <para>
1127 <indexterm><primary>Objects in the Sky</primary>
1128 <secondary>Invoking Popup Menu for</secondary></indexterm>
1129 Open the <link linkend="popup-menu">popup menu</link> for the
1130 location or object nearest the mouse cursor.
1131 </para></listitem>
1132 </varlistentry>
1133
1134 <varlistentry><term>Scrolling the mouse wheel</term>
1135 <listitem><para>Zoom the display in or out.  If you do not
1136 have a mouse wheel, you can hold the middle mouse button and
1137 drag vertically.
1138 </para></listitem>
1139 </varlistentry>
1140
1141 <varlistentry><term>Click-and-dragging</term>
1142 <listitem><para>
1143         <variablelist>
1144         <varlistentry><term>Dragging the sky map</term>
1145         <listitem><para>Pan the display, following the drag motion.
1146         </para></listitem></varlistentry>
1147
1148         <varlistentry><term>&Ctrl;+dragging the sky map</term>
1149         <listitem><para>Define a rectangle in the map.  When the
1150         mouse button is released, the display is zoomed in to match the
1151         field-of-view to the bounds of the rectangle.
1152         </para></listitem></varlistentry>
1153
1154         <varlistentry><term>Dragging an Info Box</term>
1155         <listitem><para>The Info Box is repositioned in the map.  Info
1156         Boxes will <quote>stick</quote> to window edges, so that they
1157         remain on the edge when the window is resized.
1158         </para></listitem></varlistentry>
1159         </variablelist>
1160 </para></listitem>
1161 </varlistentry>
1162 </variablelist>
1163
1164 </sect1>
1165 </chapter>