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>File Menu</title> 10 11<variablelist> 12<varlistentry> 13<term><menuchoice> 14<shortcut> 15<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> 16</shortcut> 17<guimenu>File</guimenu> 18<guimenuitem>Open Image...</guimenuitem> 19</menuchoice></term> 20<listitem><para>Open a image in the FITS Viewer tool. 21</para></listitem> 22</varlistentry> 23 24<varlistentry> 25<term><menuchoice> 26<guimenu>File</guimenu> 27<guimenuitem>Save Sky Image...</guimenuitem> 28</menuchoice></term> 29<listitem><para>Create image on disk from current display. 30</para></listitem> 31</varlistentry> 32 33<varlistentry> 34<term><menuchoice> 35<shortcut> 36<keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> 37</shortcut> 38<guimenu>File</guimenu> 39<guimenuitem>Run Script...</guimenuitem> 40</menuchoice></term> 41<listitem><para>Run the specified &kstars; script. 42</para></listitem> 43</varlistentry> 44 45<varlistentry> 46<term><menuchoice> 47<guimenu>File</guimenu> 48<guimenuitem>Printing Wizard...</guimenuitem> 49</menuchoice></term> 50<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. 51</para></listitem> 52</varlistentry> 53 54<varlistentry> 55<term><menuchoice> 56<shortcut> 57<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> 58</shortcut> 59<guimenu>File</guimenu> 60<guimenuitem>Print...</guimenuitem> 61</menuchoice></term> 62<listitem><para>Send the current sky map to the printer (or to a 63&PostScript;/&PDF; file). 64</para></listitem> 65</varlistentry> 66 67<varlistentry> 68<term><menuchoice> 69<shortcut> 70<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> 71</shortcut> 72<guimenu>File</guimenu> 73<guimenuitem>Quit</guimenuitem> 74</menuchoice></term> 75<listitem><para>Quit &kstars;. 76</para></listitem> 77</varlistentry> 78</variablelist> 79 80</sect2> 81 82<sect2 id="timemenu"> 83<title>Time Menu</title> 84 85<variablelist> 86<varlistentry> 87<term><menuchoice> 88<shortcut> 89<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> 90</shortcut> 91<guimenu>Time</guimenu> 92<guimenuitem>Set Time to Now</guimenuitem> 93</menuchoice></term> 94<listitem><para>Sync time to system clock.</para></listitem> 95</varlistentry> 96 97<varlistentry> 98<term><menuchoice> 99<shortcut> 100<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> 101</shortcut> 102<guimenu>Time</guimenu> 103<guimenuitem>Set Time...</guimenuitem> 104</menuchoice></term> 105<listitem><para>Set time and date.</para></listitem> 106</varlistentry> 107<varlistentry> 108<term><menuchoice> 109<shortcut> 110<keycap><</keycap> 111</shortcut> 112<guimenu>Time</guimenu> 113<guimenuitem>Advance One Step Backward in Time</guimenuitem> 114</menuchoice></term> 115<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. 116</para></listitem> 117</varlistentry> 118<varlistentry> 119<term><menuchoice> 120<guimenu>Time</guimenu> 121<guimenuitem>Stop Clock</guimenuitem> 122</menuchoice></term> 123<listitem><para>Toggle whether time passes.</para></listitem> 124</varlistentry> 125<varlistentry> 126<term><menuchoice> 127<shortcut> 128<keycap>></keycap> 129</shortcut> 130<guimenu>Time</guimenu> 131<guimenuitem>Advance One Step Forward in Time</guimenuitem> 132</menuchoice></term> 133<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. 134</para></listitem> 135</varlistentry> 136</variablelist> 137 138</sect2> 139 140<sect2 id="pointmenu"> 141<title>Pointing Menu</title> 142 143<variablelist> 144<varlistentry> 145<term><menuchoice> 146<shortcut> 147<keycap>Z</keycap> 148</shortcut> 149<guimenu>Pointing</guimenu> 150<guimenuitem>Zenith</guimenuitem> 151</menuchoice></term> 152<listitem><para>Center the display at the 153<link linkend="ai-zenith">Zenith</link> point (straight up). 154</para></listitem> 155</varlistentry> 156 157<varlistentry> 158<term><menuchoice> 159<shortcut> 160<keycap>N</keycap> 161</shortcut> 162<guimenu>Pointing</guimenu> 163<guimenuitem>North</guimenuitem> 164</menuchoice></term> 165<listitem><para>Center the display above the North point on the 166horizon.</para></listitem> 167</varlistentry> 168 169<varlistentry> 170<term><menuchoice> 171<shortcut> 172<keycap>E</keycap> 173</shortcut> 174<guimenu>Pointing</guimenu> 175<guimenuitem>East</guimenuitem> 176</menuchoice></term> 177<listitem><para>Center the display above the East point on the 178horizon.</para></listitem> 179</varlistentry> 180 181<varlistentry> 182<term><menuchoice> 183<shortcut> 184<keycap>S</keycap> 185</shortcut> 186<guimenu>Pointing</guimenu> 187<guimenuitem>South</guimenuitem> 188</menuchoice></term> 189<listitem><para>Center the display above the South point on the 190horizon.</para></listitem> 191</varlistentry> 192 193<varlistentry> 194<term><menuchoice> 195<shortcut> 196<keycap>W</keycap> 197</shortcut> 198<guimenu>Pointing</guimenu> 199<guimenuitem>West</guimenuitem> 200</menuchoice></term> 201<listitem><para>Center the display above the West point on the 202horizon.</para></listitem> 203</varlistentry> 204 205<varlistentry> 206<term><menuchoice> 207<shortcut> 208<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo> 209</shortcut> 210<guimenu>Pointing</guimenu> 211<guimenuitem>Set Coordinates Manually...</guimenuitem> 212</menuchoice></term> 213<listitem><para>Center the display on specific 214<link linkend="ai-skycoords">sky coordinates</link>. 215</para></listitem> 216</varlistentry> 217 218<varlistentry> 219<term><menuchoice> 220<shortcut> 221<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo> 222</shortcut> 223<guimenu>Pointing</guimenu> 224<guimenuitem>Find Object...</guimenuitem> 225</menuchoice></term> 226<listitem><para>Locate an object by name using the 227<link linkend="findobjects">Find Object Window</link>.</para></listitem> 228</varlistentry> 229 230<varlistentry> 231<term><menuchoice> 232<shortcut> 233<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo> 234</shortcut> 235<guimenu>Pointing</guimenu> 236<guimenuitem>Engage/Stop Tracking</guimenuitem> 237</menuchoice></term> 238<listitem><para>Toggle tracking on/off. While tracking, 239the display will remain centered on the current position or 240object.</para></listitem> 241</varlistentry> 242</variablelist> 243 244</sect2> 245 246<sect2 id="viewmenu"> 247<title>View Menu</title> 248 249<variablelist> 250<varlistentry> 251<term><menuchoice> 252<shortcut><keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo></shortcut> 253<guimenu>View</guimenu> 254<guimenuitem>Zoom In</guimenuitem> 255</menuchoice></term> 256<listitem><para>Zooms view in.</para></listitem> 257</varlistentry> 258 259<varlistentry> 260<term><menuchoice> 261<shortcut><keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo></shortcut> 262<guimenu>View</guimenu> 263<guimenuitem>Zoom Out</guimenuitem> 264</menuchoice></term> 265<listitem><para>Zooms view out.</para></listitem> 266</varlistentry> 267 268<varlistentry> 269<term><menuchoice> 270<shortcut> 271<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> 272</shortcut> 273<guimenu>View</guimenu> 274<guimenuitem>Default Zoom</guimenuitem> 275</menuchoice></term> 276<listitem><para>Restore the default Zoom setting.</para></listitem> 277</varlistentry> 278 279<varlistentry> 280<term><menuchoice> 281<shortcut> 282<keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo> 283</shortcut> 284<guimenu>View</guimenu> 285<guimenuitem>Zoom to Angular Size...</guimenuitem> 286</menuchoice></term> 287<listitem><para>Zoom to specified field-of-view angle.</para></listitem> 288</varlistentry> 289 290<varlistentry> 291<term><menuchoice> 292<shortcut> 293<keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo> 294</shortcut> 295<guimenu>View</guimenu> 296<guimenuitem>Full Screen Mode</guimenuitem> 297</menuchoice></term> 298<listitem><para>Toggle full-screen mode.</para></listitem> 299</varlistentry> 300 301<varlistentry> 302<term><menuchoice> 303<shortcut> 304&Space; 305</shortcut> 306<guimenu>View</guimenu> 307<guimenuitem>Switch to Star Globe View / Switch to Horizontal View</guimenuitem> 308</menuchoice></term> 309<listitem><para>Toggle between the 310<link linkend="horizontal">Horizontal</link> and 311<link linkend="equatorial">Equatorial</link> 312<link linkend="ai-skycoords">Coordinate Systems</link>.</para></listitem> 313</varlistentry> 314 315<varlistentry> 316<term><menuchoice> 317<shortcut> 318 <keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo> 319</shortcut> 320<guimenu>View</guimenu> 321<guimenuitem>Show Terrain</guimenuitem> 322</menuchoice></term> 323<listitem><para>Toggle the <link linkend="terrain">terrain image</link> visibility.</para></listitem> 324</varlistentry> 325</variablelist> 326 327<variablelist> 328<varlistentry> 329<term><menuchoice><guimenu>View</guimenu> <guisubmenu>Projection</guisubmenu></menuchoice></term> 330<listitem><para>A submenu that lists all projections. 331<variablelist> 332 <varlistentry> 333 <term><menuchoice><shortcut><keycap>F5</keycap></shortcut><guimenuitem>Lambert Azimuthal Equal-area</guimenuitem></menuchoice></term> 334 <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> 335 </varlistentry> 336 337 <varlistentry> 338 <term><menuchoice><shortcut><keycap>F6</keycap></shortcut><guimenuitem>Azimuthal Equidistant</guimenuitem></menuchoice></term> 339 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Azimuthal_equidistant_projection">azimuthal equidistant</ulink> projection.</para></listitem> 340 </varlistentry> 341 342 <varlistentry> 343 <term><menuchoice><shortcut><keycap>F7</keycap></shortcut><guimenuitem>Orthographic</guimenuitem></menuchoice></term> 344 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Orthographic_projection_(cartography)">orthographic</ulink> projection.</para></listitem> 345 </varlistentry> 346 347 <varlistentry> 348 <term><menuchoice><shortcut><keycap>F8</keycap></shortcut><guimenuitem>Equirectangular</guimenuitem></menuchoice></term> 349 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Equirectangular_projection">equirectangular</ulink> projection.</para></listitem> 350 </varlistentry> 351 352 <varlistentry> 353 <term><menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenuitem>Stereographic</guimenuitem></menuchoice></term> 354 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Stereographic_projection">stereographic</ulink> projection.</para></listitem> 355 </varlistentry> 356 357 <varlistentry> 358 <term><menuchoice><shortcut><keycap>F10</keycap></shortcut><guimenuitem>Gnomonic</guimenuitem></menuchoice></term> 359 <listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Gnomonic_projection">gnomonic</ulink> projection.</para></listitem> 360 </varlistentry> 361</variablelist></para></listitem> 362</varlistentry> 363 364<varlistentry> 365<term><menuchoice> 366<guimenu>View</guimenu> 367<guisubmenu>HiPS All Sky Overlay</guisubmenu> 368</menuchoice></term> 369<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> 370</varlistentry> 371 372</variablelist> 373</sect2> 374 375<sect2 id="toolmenu"> 376<title>Tools Menu</title> 377 378<variablelist> 379<varlistentry> 380<term><menuchoice> 381<shortcut> 382<keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo> 383</shortcut> 384<guimenu>Tools</guimenu> 385<guimenuitem>Calculator</guimenuitem> 386</menuchoice></term> 387<listitem> 388<para> 389Opens the <link linkend="tool-calculator">AstroCalculator</link> Tool, 390which provides full access to many of the mathematical functions used by 391&kstars;. 392</para> 393</listitem> 394</varlistentry> 395</variablelist> 396 397<variablelist> 398<varlistentry> 399<term><menuchoice><guimenu>Tools</guimenu> <guisubmenu>Devices</guisubmenu></menuchoice></term> 400<listitem><para>A submenu for control supported devices. 401<variablelist> 402 403 <varlistentry> 404 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo></shortcut> <guimenuitem>List your Equipment...</guimenuitem></menuchoice></term> 405 <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> 406 </varlistentry> 407<!-- 408 <varlistentry> 409 <term><menuchoice><guimenuitem>Telescope Wizard...</guimenuitem></menuchoice></term> 410 <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> 411 </varlistentry> 412--> 413 414 <varlistentry> 415 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></shortcut> <guimenuitem>Device Manager...</guimenuitem></menuchoice></term> 416 <listitem><para>Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers.</para></listitem> 417 </varlistentry> 418 419 <varlistentry> 420 <term><guimenuitem>Custom Drivers...</guimenuitem></term> 421 <listitem><para>A dialog to customize the drivers.</para></listitem> 422 </varlistentry> 423 424 <varlistentry> 425 <term><guimenuitem>INDI Control Panel...</guimenuitem></term> 426 <listitem><para>Opens up INDI Control Panel, which allows you to control all the features supported by a device.</para></listitem> 427 </varlistentry> 428</variablelist></para></listitem> 429</varlistentry> 430 431<varlistentry> 432<term><menuchoice> 433<guimenu>Tools</guimenu> 434<guimenuitem>Sky Calendar</guimenuitem> 435</menuchoice></term> 436<listitem> 437<para> 438Opens the <guilabel>Sky Calendar</guilabel> Tool, which allows you to plan observations 439of Solar System planets by giving graphical data on sets and rises of these objects. 440</para> 441</listitem> 442</varlistentry> 443 444<varlistentry> 445<term><menuchoice> 446<shortcut> 447<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> 448</shortcut> 449<guimenu>Tools</guimenu> 450<guimenuitem>Altitude vs. Time</guimenuitem> 451</menuchoice></term> 452<listitem> 453<para> 454Opens the <link linkend="tool-altvstime">Altitude vs. Time</link> Tool, which 455can plot curves representing the altitude of any object as a function of time. 456This is useful for planning observing sessions. 457</para> 458</listitem> 459</varlistentry> 460 461<varlistentry> 462<term><menuchoice> 463<shortcut> 464<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo> 465</shortcut> 466<guimenu>Tools</guimenu> 467<guimenuitem>What's up Tonight</guimenuitem> 468</menuchoice></term> 469<listitem> 470<para> 471Opens the <link linkend="tool-whatsup">What's up Tonight</link> Tool, 472which presents a summary of the objects which are observable 473from your location on a given date. 474</para> 475</listitem> 476</varlistentry> 477 478<varlistentry> 479<term><menuchoice> 480<shortcut> 481<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo> 482</shortcut> 483<guimenu>Tools</guimenu> 484<guimenuitem>What's Interesting...</guimenuitem> 485</menuchoice></term> 486<listitem> 487<para> 488Opens the <guilabel>What's Interesting</guilabel> Tool, which allows you to be 489informed about the most interesting observations that can be made from your 490current location using the given equipment. 491</para> 492</listitem> 493</varlistentry> 494 495<varlistentry> 496<term><menuchoice> 497<shortcut> 498<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo> 499</shortcut> 500<guimenu>Tools</guimenu> 501<guimenuitem>XPlanet Solar System Simulator</guimenuitem> 502</menuchoice></term> 503<listitem> 504<para> 505This menu item will appear only if you have installed the <application>XPlanet</application> optional package. 506</para> 507</listitem> 508</varlistentry> 509 510<varlistentry> 511<term><menuchoice> 512<shortcut> 513<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> 514</shortcut> 515<guimenu>Tools</guimenu> 516<guimenuitem>Script Builder</guimenuitem> 517</menuchoice></term> 518<listitem> 519<para> 520Opens the <link linkend="tool-scriptbuilder">Script Builder</link> Tool, 521which provides a GUI interface for building &kstars; &DBus; scripts. 522</para> 523</listitem> 524</varlistentry> 525 526<varlistentry> 527<term><menuchoice> 528<shortcut> 529<keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo> 530</shortcut> 531<guimenu>Tools</guimenu> 532<guimenuitem>Solar System</guimenuitem> 533</menuchoice></term> 534<listitem> 535<para> 536Opens the <link linkend="tool-solarsys">Solar System Viewer</link>, 537which displays an overhead view of the solar system on the 538current simulation date. 539</para> 540</listitem> 541</varlistentry> 542 543<varlistentry> 544<term><menuchoice> 545<shortcut> 546<keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo> 547</shortcut> 548<guimenu>Tools</guimenu> 549<guimenuitem>Ekos</guimenuitem> 550</menuchoice></term> 551<listitem> 552<para> 553Opens <link linkend="tool-ekos">Ekos</link>, a complete and powerful tool for astrophotography. 554With Ekos, you can align and guide your telescope, focus your CCD, and capture 555images using an easy intuitive interface. 556</para> 557</listitem> 558</varlistentry> 559 560<varlistentry> 561<term><menuchoice> 562<shortcut> 563<keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo> 564</shortcut> 565<guimenu>Tools</guimenu> 566<guimenuitem>Jupiter's Moons</guimenuitem> 567</menuchoice></term> 568<listitem> 569<para> 570Opens the <link linkend="tool-jmoons">Jupiter Moons Tool</link>, 571which displays the positions of Jupiter's four brightest 572moons as a function of time. 573</para> 574</listitem> 575</varlistentry> 576 577<varlistentry> 578<term><menuchoice> 579<guimenu>Tools</guimenu> 580<guimenuitem>Flags</guimenuitem> 581</menuchoice></term> 582<listitem> 583<para> 584Opens the <guilabel>Flag manager</guilabel> Tool, which can be used to assign 585color labels and icons to the given positions on the sky chart. 586</para> 587</listitem> 588</varlistentry> 589 590</variablelist> 591</sect2> 592 593<sect2 id="datamenu"> 594<title>Data Menu</title> 595 596<variablelist> 597 <varlistentry> 598 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut> 599 <guimenu>Data</guimenu> <guimenuitem>Download New Data...</guimenuitem></menuchoice></term> 600 <listitem><para>Open the <guilabel>Get Hot New Stuff</guilabel> dialog to download additional data 601 for &kstars;.</para></listitem> 602 </varlistentry> 603 604 <varlistentry> 605 <term><menuchoice> 606 <guimenu>Data</guimenu> <guimenuitem>Manage DSO Catalogs</guimenuitem></menuchoice></term> 607 <listitem><para>Open the <guilabel>DSO Catalogs</guilabel> dialog for manage the catalog database 608 of &kstars;.</para></listitem> 609 </varlistentry> 610 611 <varlistentry> 612 <term><menuchoice><guimenu>Data</guimenu> <guisubmenu>Updates</guisubmenu></menuchoice></term> 613 <listitem><para>This submenu can be used to update various object data, namely asteroids, comets 614 and satellites orbital elements as well as recent supernovae data from the Internet. The data will 615 be downloaded for the current user account only. If you use &kstars; from different account you 616 should download them for every account separately.</para> 617 618 <para>&kstars; tries to download recent supernovae list automatically by default. You can switch 619 the download off using <guilabel>Supernovae</guilabel> page of &kstars; Settings window.</para></listitem> 620 </varlistentry> 621</variablelist> 622 623</sect2> 624 625<sect2 id="observationmenu"> 626<title>Observation Menu</title> 627 628<variablelist> 629 <varlistentry> 630 <term><menuchoice> 631 <shortcut><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></shortcut> 632 <guimenu>Observation</guimenu> 633 <guimenuitem>Observation Planner</guimenuitem> 634 </menuchoice></term> 635 <listitem><para>Open the <link linkend="tool-obsplanner">Observation Planner</link> tool.</para></listitem> 636 </varlistentry> 637 638 <varlistentry> 639 <term><menuchoice> 640 <shortcut><keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo></shortcut> 641 <guimenu>Observation</guimenu> 642 <guimenuitem>Execute the Session Plan...</guimenuitem> 643 </menuchoice></term> 644 <listitem><para>Opens <link linkend="tool-obsplanner">session plan wizard</link> or execute 645 the planned session.</para></listitem> 646 </varlistentry> 647 648 <varlistentry> 649 <term><menuchoice> 650 <guimenu>Observation</guimenu> 651 <guimenuitem>Polaris Hour Angle...</guimenuitem> 652 </menuchoice></term> 653 <listitem><para>Opens the <guilabel>Polaris Hour Angle</guilabel> tool.</para></listitem> 654 </varlistentry> 655</variablelist> 656</sect2> 657 658<sect2 id="settingmenu"> 659<title>Settings Menu</title> 660 661<variablelist> 662 <varlistentry> 663 <term><menuchoice> 664 <guimenu>Settings</guimenu> 665 <guisubmenu>Info Boxes</guisubmenu> 666 </menuchoice></term> 667 <listitem><para>A submenu that lists the different info boxes. 668 669 <variablelist> 670 <varlistentry> 671 <term><guimenuitem>Show Info Boxes</guimenuitem></term> 672 <listitem><para>Toggle display of all three Info Boxes: 673 <itemizedlist> 674 <listitem><para><guiicon>Time Box</guiicon></para></listitem> 675 <listitem><para><guiicon>Focus Box</guiicon></para></listitem> 676 <listitem><para><guiicon>Location Box</guiicon></para></listitem> 677 </itemizedlist> 678 </para></listitem> 679 </varlistentry> 680 681 <varlistentry> 682 <term><guimenuitem>Show Time Box</guimenuitem></term> 683 <listitem><para>Toggle display of the Time Info Box. By default, the Time Info 684 Box is located in the top left side of the screen. You can change the position 685 of Time Info Box by holding the left-click mouse button and dragging it to the 686 new position.</para></listitem> 687 </varlistentry> 688 689 <varlistentry> 690 <term><guimenuitem>Show Focus Box</guimenuitem></term> 691 <listitem><para>Toggle display of the Focus Info Box. By default, the Focus Info 692 Box is located in the top right side of the screen. You can change the position 693 of Focus Info Box by holding the left-click mouse button and dragging it to the 694 new position.</para></listitem> 695 </varlistentry> 696 697 <varlistentry> 698 <term><guimenuitem>Show Location Box</guimenuitem></term> 699 <listitem><para>Toggle display of the Location Info Box. By default, the Location 700 Info Box is located in the bottom left side of the screen. You can change the 701 position of Location Info Box by holding the left-click mouse button and dragging 702 it to the new position.</para></listitem> 703 </varlistentry> 704 </variablelist></para></listitem> 705 </varlistentry> 706 707 <varlistentry> 708 <term><menuchoice> 709 <guimenu>Settings</guimenu> 710 <guisubmenu>Toolbars Shown</guisubmenu> 711 </menuchoice></term> 712 <listitem><para>A submenu that lists the different toolbars. 713 714 <variablelist> 715 <varlistentry> 716 <term><guimenuitem>Main Toolbar</guimenuitem></term> 717 <listitem><para>Toggle display of the Main Toolbar. By default, the Main Toolbar 718 provides useful shortcuts for controlling the sky map view (&ie; Zoom in and Zoom out) 719 and for controlling &kstars; clock as well. You can Start / Stop the clock, advance 720 one step backward / forward in time and also you can easily set the time step used 721 by &kstars;' clock. The time step is the rate at which time flows in the simulation. 722 For setting the time step, you can use the spin box used for establishing the time step 723 units and the spin box used for increasing / decreasing the time step value. 724 Using the Main Toolbar you can quickly open the <guilabel>Find Object</guilabel>, 725 <guilabel>Set Time</guilabel> or <guilabel>Set Geographic Location</guilabel> window. 726 Main Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 727 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 728 </varlistentry> 729 730 <varlistentry> 731 <term><guimenuitem>View Toolbar</guimenuitem></term> 732 <listitem><para>Toggle display of the View Toolbar. View Toolbar controls which sky 733 objects are drawn on &kstars; Sky Map (stars, deep sky objects, Solar system objects, 734 supernovae or satellites) as well as what constellation information is included 735 (constellation lines, constellation names, constellation art or constellation boundaries). 736 It also provides icon shortcuts for: showing milky way (drawn with dark grey color), 737 showing equatorial/horizontal coordinate grid and for showing the green opaque ground. 738 Note that when the horizon is switched off, refraction effects are temporarily disabled. 739 View Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 740 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 741 </varlistentry> 742 743 <varlistentry> 744 <term><guimenuitem>INDI Toolbar</guimenuitem></term> 745 <listitem><para>Toggle display of the INDI Toolbar. By default, INDI Toolbar contains 746 five shortcut icons:</para> 747 <itemizedlist> 748 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="kstars_ekos.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Ekos</guiicon></para></listitem> 749 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="kstars_indi.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle INDI Control Panel</guiicon></para></listitem> 750 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="kstars_fitsviewer.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle FITS Viewer</guiicon></para></listitem> 751 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="archive-extract.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Sensor FOV</guiicon></para></listitem> 752 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="center_telescope.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Lock Telescope Center</guiicon></para></listitem> 753 </itemizedlist> 754 <para>INDI Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 755 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 756 </varlistentry> 757 758 <varlistentry> 759 <term><guimenuitem>Telescope Toolbar</guimenuitem></term> 760 <listitem><para>Toggle display of the Telescope Toolbar. By default, Telescope Toolbar contains 761 seven shortcut icons:</para> 762 <itemizedlist> 763 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="draw-text.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Mount Control Panel</guiicon></para></listitem> 764 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="lock-open.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Toggle Telescope Tracking</guiicon></para></listitem> 765 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="object-rotate-right.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Slew telescope to the focused object</guiicon></para></listitem> 766 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="media-record.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Sync telescope to the focused object</guiicon></para></listitem> 767 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="flag-red.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Park telescope</guiicon></para></listitem> 768 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="flag-green.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Unpark telescope</guiicon></para></listitem> 769 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="process-stop.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Abort telescope motions</guiicon></para></listitem> 770 </itemizedlist> 771 <para>Telescope Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 772 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 773 </varlistentry> 774 775 <varlistentry> 776 <term><guimenuitem>Dome Toolbar</guimenuitem></term> 777 <listitem><para>Toggle display of the Dome Toolbar. By default, Dome Toolbar contains 778 two shortcut icons:</para> 779 <itemizedlist> 780 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="dome-park.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Park dome</guiicon></para></listitem> 781 <listitem><para><inlinemediaobject><imageobject><imagedata fileref="dome-unpark.png" format="PNG"/></imageobject></inlinemediaobject> <guiicon>Unpark dome</guiicon></para></listitem> 782 </itemizedlist> 783 <para>Dome Toolbar can be configured using the <menuchoice><guimenu>Settings</guimenu> 784 <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> menu item.</para></listitem> 785 </varlistentry> 786 787 </variablelist></para></listitem> 788 </varlistentry> 789 790 <varlistentry> 791 <term><menuchoice> 792 <guimenu>Settings</guimenu> 793 <guisubmenu>Statusbar</guisubmenu> 794 </menuchoice></term> 795 <listitem><para>A submenu that lists the different statusbars. 796 797 <variablelist> 798 <varlistentry> 799 <term><guimenuitem>Show Statusbar</guimenuitem></term> 800 <listitem><para>Toggle display of the Statusbar. It is located in the bottom of &kstars; window.</para></listitem> 801 </varlistentry> 802 803 <varlistentry> 804 <term><guimenuitem>Show Az/Alt Field</guimenuitem></term> 805 <listitem><para>Toggle display of the mouse cursor's horizontal coordinates in the statusbar.</para></listitem> 806 </varlistentry> 807 808 <varlistentry> 809 <term><guimenuitem>Show RA/Dec Field</guimenuitem></term> 810 <listitem><para>Toggle display of the mouse cursor's equatorial coordinates in the statusbar.</para></listitem> 811 </varlistentry> 812 813 <varlistentry> 814 <term><guimenuitem>Show J2000.0 RA/Dec Field</guimenuitem></term> 815 <listitem><para>Toggle display of the mouse cursor's equatorial J2000 coordinates in the statusbar.</para></listitem> 816 </varlistentry> 817 </variablelist></para></listitem> 818 </varlistentry> 819 820 <varlistentry> 821 <term><menuchoice> 822 <guimenu>Settings</guimenu> 823 <guisubmenu>Themes</guisubmenu> 824 </menuchoice></term> 825 <listitem><para>Lists the available Theme items.</para></listitem> 826 </varlistentry> 827 828 <varlistentry> 829 <term><menuchoice> 830 <guimenu>Settings</guimenu> 831 <guisubmenu>Color Schemes</guisubmenu> 832 </menuchoice></term> 833 <listitem><para>This submenu contains all of the defined color schemes: Classic, Star Chart, 834 Night Vision and Moonless Night. It can also include your custom color schemes. Select any 835 item to set that color scheme.</para></listitem> 836 </varlistentry> 837 838 <varlistentry> 839 <term><menuchoice> 840 <guimenu>Settings</guimenu> 841 <guisubmenu>FOV Symbols</guisubmenu> 842 </menuchoice></term> 843 <listitem><para>This submenu lists the available field-of-view (FOV) Symbols. The FOV Symbol is 844 drawn at the center of the display. You may choose one or more from the list of predefined symbols 845 (7x35 Binoculars, Telrad, One Degree, HST WFPC2 or 30m at 1.3cm) by checking their specific 846 checkbox, or you may use no symbol by unchecking all the items from the symbols list. You can also 847 define your own symbols (or modify existing symbols) using the <guimenuitem>Edit FOV Symbols...</guimenuitem> 848 menu item.</para></listitem> 849 </varlistentry> 850 851 <varlistentry> 852 <term><menuchoice> 853 <guimenu>Settings</guimenu> 854 <guisubmenu>Artificial Horizon...</guisubmenu> 855 </menuchoice></term> 856 <listitem><para>If you select this submenu, then Artificial Horizon Manager will be opened. Artificial 857 Horizon Manager is used to define on the skymap one or more regions that are blocked from view from your 858 current location (&ie; tall trees or building). The window is split in two sections: in the left side is 859 the Regions section while in the right side is the Points section. You can add a new region by pressing 860 the <guibutton>+</guibutton> (Add Region) button or you can remove a region by selecting it in the regions 861 list and then pressing the <guibutton>-</guibutton> (Remove Region) button. In order to draw a region you 862 need to define a list of points that encompasses the blocked area. You can add a new point by pressing the 863 <guibutton>+</guibutton> (Add Point) button from the right Points section. You can also remove a highlighted 864 point from the list of points or you can clear all the points. There are two ways to add a new point to a 865 selected region: manually by entering the point's coordinates or by selecting the point from the skymap 866 after clicking <guibutton>Select Points</guibutton> button. Note that each point is described by a set of 867 horizontal coordinates: Az (Azimuth) and Alt (Altitude). If you want to modify a point's coordinates, just 868 double click on its Az/Alt text box value and enter the new value. First and Last points must be on the 869 horizon. Polygons must be closed to be considered valid regions. Artificial Horizon Manager provides a easy 870 way to rename your regions. By default, regions are named as: <quote>Region </quote> plus an index (&ie; 871 <quote>Region 1</quote> or <quote>Region 2</quote>). For renaming a region, just double click on its name 872 and then you will be invited to complete a new region name. You can also control which regions are enabled 873 or disabled for marking on the map by a simple click on the checkbox in front of each region. After you 874 defined your desired regions you can apply them by pressing the <guibutton>Apply</guibutton> button. If you 875 want to use these regions again, in further astronomy sessions, you can save them such that next time when 876 you will open &kstars; they will be automatically marked on the skymap.</para></listitem> 877 </varlistentry> 878 879 <varlistentry> 880 <term><menuchoice> 881 <shortcut><keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo></shortcut> 882 <guimenu>Settings</guimenu> 883 <guimenuitem>Manage Observer...</guimenuitem> 884 </menuchoice></term> 885 <listitem><para>Selecting this will open Manage Observers window that enables you to register a number 886 of observers which are using &kstars; on this computer. You can add a new entry to observers list by 887 completing the mandatory fields: <guilabel>Name:</guilabel> and <guilabel>Surname:</guilabel> and then 888 pressing the <guibutton>+</guibutton> (Add observer) button. Note that <guilabel>Contact:</guilabel> 889 field is optional, &kstars; allowing you to add a new observer even though <guilabel>Contact:</guilabel> 890 text box is empty. You can also remove an observer from the list using <guibutton>-</guibutton> (Remove 891 observer) button.</para></listitem> 892 </varlistentry> 893 894 <varlistentry> 895 <term><menuchoice> 896 <shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut> 897 <guimenu>Settings</guimenu> 898 <guimenuitem>Geographic...</guimenuitem> 899 </menuchoice></term> 900 <listitem><para>Select a new <link linkend="setgeo">geographic location</link>.</para></listitem> 901 </varlistentry> 902 903 <varlistentry> 904 <term><menuchoice> 905 <guimenu>Settings</guimenu> 906 <guimenuitem>Configure Keyboard Shortcuts...</guimenuitem> 907 </menuchoice></term> 908 <listitem><para>Open the Configure Shortcuts window which allows you to modify &kstars; shortcuts. 909 You can use &kstars; default shortcuts scheme or define your own shortcuts scheme. In order to add 910 a new custom shortcut to an action, you need to click on action's name and then press the 911 <guibutton>Custom:</guibutton> checkbox. Then click on the button next to <guibutton>Custom:</guibutton> 912 checkbox and enter the shortcut you would like to use in &kstars;. You can also remove a shortcut by 913 pressing the <guibutton>Delete</guibutton> button after you select an action from the list. &kstars; 914 helps you to find an action by providing its search method; just enter the name of the action and the 915 list will be reduced to its best matches. For example, I will give you a brief example on how to use 916 &kstars; Configure Shortcuts feature: 917 <itemizedlist> 918 <listitem><para>Firstly, open the Configure Shortcuts window from the <guimenu>Settings</guimenu> menu.</para></listitem> 919 <listitem><para>Then select the action you would like to add a shortcut (&ie; Artificial Horizon). 920 You can use the search method provided by &kstars;. Just type <quote>art</quote> in the search text 921 box and the list will be reduced to only four actions. The Artificial Horizon is the first action 922 in the list.</para></listitem> 923 <listitem><para>Now that you find your desired action, you can add a new shortcut by clicking on 924 its name. After you click on the action name, press the <guibutton>Custom</guibutton> checkbox. 925 There is a button next to <guibutton>Custom</guibutton> checkbox used for adding new shortcuts. 926 By default, if an action has no custom shortcut, the <quote>None</quote> tag will be assigned to 927 this button. Press this button and then add your custom shortcut. For example, for Artificial 928 Horizon, you can use &Ctrl;+H shortcut. Hold the &Ctrl; key and press H. Your shortcut be 929 automatically saved, thus you can use it next time when you open &kstars;.</para></listitem> 930 </itemizedlist> 931 </para></listitem> 932 </varlistentry> 933 934 <varlistentry> 935 <term><menuchoice> 936 <guimenu>Settings</guimenu> 937 <guimenuitem>Configure &kstars;...</guimenuitem> 938 </menuchoice></term> 939 <listitem><para>Modify <link linkend="config">configuration options</link>.</para></listitem> 940 </varlistentry> 941 942 <varlistentry> 943 <term><menuchoice> 944 <guimenu>Settings</guimenu> 945 <guimenuitem>Startup Wizard...</guimenuitem> 946 </menuchoice></term> 947 <listitem><para>Shows the <guilabel>Setup Wizard</guilabel> dialog. It is the same window that you saw 948 when you ran &kstars; for the very first time. &kstars; Setup Wizard will help you set up some basic 949 options, such as your location on Earth. The first page of Setup Wizard is a welcome page and if you press 950 <guibutton>Next</guibutton> button, you will get the <guilabel>Choose Your Home Location</guilabel> page. 951 Here you can select your exact home location or a city near your home location if your accurate location 952 is not present in &kstars; cities database. Browsing the entire list is not so efficient and thus, &kstars; 953 provides you a easy-to-use method for selecting your desired city in a short time. You may filter the list 954 of cities by the name of your city, province and country. By giving more details about your location, the 955 list's size will reduced only to its best matches. When you highlight a city in the cities list, the 956 <guilabel>Longitude:</guilabel> and <guilabel>Latitude:</guilabel> boxes will be updated, containing the 957 accurate information of your selected location. When you hit the <guibutton>Next</guibutton> button, you 958 will get the last page of &kstars; Setup Wizard: <quote>Download Extra Data Files</quote> page. Here you 959 may download optional data files via the Internet, in order to enhance &kstars;, such as Messier object 960 images, or a more complete NGC/IC catalog. Press the <guibutton>Download Extra Data...</guibutton> button 961 to proceed. After you pressed this button, the <guilabel>Get Hot New Stuff</guilabel> dialog will appear. 962 It is &kstars; Add-On Installer, which will help you to manage what extra information you added to 963 &kstars;. Firstly, you can choose how the add-ons list is displayed, by pressing the <guibutton>Details 964 view mode</guibutton> or <guibutton>Icons view mode</guibutton> button. You may also order the list by 965 various criteria like: newest, rating, most downloads or installed. This can be easily done by selecting 966 an option using the radio button. You can also make searches using the <guilabel>Search:</guilabel> text 967 box. Regarding the list of add-ons, you may perform several actions by selecting an add-on from the list: 968 you can install or uninstall an add-on using the <guibutton>Install</guibutton> / <guibutton>Uninstall</guibutton> 969 button, you can open the Details window using the <guibutton>Details</guibutton> button or you can rate 970 an add-on by giving a number of gold stars, up to five stars. If you want to send an email to the author 971 of an add-on, you are able to do that by clicking on his e-mail address. Then, your default e-mail 972 application will guide you through the sending process. After you managed your &kstars; add-ons, then you 973 can close the window by pressing the <guibutton>Close</guibutton> button. You can also use the Download 974 Extra Data Files tool later, by selecting the <menuchoice><guimenu>Data</guimenu> 975 <guimenuitem>Download New Data...</guimenuitem></menuchoice> menu item.</para></listitem> 976 </varlistentry> 977</variablelist> 978 979<para> 980Additionally &kstars; has the common &kde; <guimenu>Settings</guimenu> menu items, for more information 981read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> 982of the &kde; Fundamentals. 983</para> 984 985</sect2> 986 987<sect2 id="helpmenu"> 988<title>Help Menu</title> 989<para> 990&kstars; has the common &kde; <guimenu>Help</guimenu> menu items, for more information read the section 991about the <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink> of the &kde; Fundamentals. 992</para> 993 994</sect2> 995 996<sect2 id="popup-menu"> 997<title>Popup Menu</title> 998<indexterm><primary>Popup Menu</primary><secondary>Description</secondary></indexterm> 999 1000<para> 1001The <mousebutton>right</mousebutton> click popup menu is 1002context-sensitive, meaning its content varies depending on what kind of 1003object you click on. We list all possible popup menu items here, with 1004the relevant object type [in brackets].</para> 1005 1006<variablelist> 1007<varlistentry> 1008<term>[All]</term> 1009<listitem><para> 1010Identification and type: The top one to three lines are devoted to the 1011name(s) of the object, and its type. For stars, the Spectral Type 1012is also shown here. 1013</para></listitem> 1014</varlistentry> 1015 1016<varlistentry> 1017<term>[All]</term> 1018<listitem><para> 1019Rise, Transit, and Set times for the object on the current simulation 1020date are shown on the next three lines. 1021</para></listitem> 1022</varlistentry> 1023 1024<varlistentry> 1025<term>[All]</term> 1026<listitem><para> 1027<guimenuitem>Center & Track</guimenuitem>: Center the display 1028on this location, and engage tracking. Equivalent to double-clicking. 1029</para></listitem> 1030</varlistentry> 1031 1032<varlistentry> 1033<term>[All]</term> 1034<listitem><para> 1035<guimenuitem>Add flag...</guimenuitem>: Open &kstars; <quote>Flag manager</quote> window. 1036Here you can manage your flags and use some of &kstars; features. When <quote>Flag manager</quote> 1037window is open for a selected object, <guilabel>Right ascension</guilabel> and 1038<guilabel>Declination</guilabel> text boxes will be automatically filled with the coordinate values 1039of the selected object on the Sky Map. Besides these two text boxes, you can set the 1040<guilabel>Epoch</guilabel>, add a <guilabel>Label</guilabel>, set the <guilabel>Label color</guilabel> 1041or even add an <guilabel>Icon</guilabel>. To add custom icons, just add images in 1042<filename class="directory">`qtpaths --paths GenericDataLocation`/kstars/</filename>. File names must 1043begin with the <quote>flag</quote> keyword. For example, 1044the file <quote>flagSmall_red_cross.gif</quote> will be shown as Small red cross in the combo box. After 1045you set up the information of the new flag, you can add it to the flags list using the 1046<guibutton>Add</guibutton> button. You may also change flags details (&ie; RA/Dec, label or icon) and 1047then save the new ones by pressing the <guibutton>Save changes</guibutton> button. Using the Flag manager, 1048you can easily center an object in Map or in Telescope, by pressing <guibutton>Center in Map</guibutton> 1049or <guibutton>Center in Telescope</guibutton> button. In order to delete a value from the list, just 1050select it in the list and then press <guibutton>Delete</guibutton> button. Your flags are saved after you 1051close current session and thus you will be able to see them everytime you will use &kstars; again. 1052</para></listitem> 1053</varlistentry> 1054 1055<varlistentry> 1056<term>[All]</term> 1057<listitem><para> 1058<guimenuitem>Angular Distance To...</guimenuitem>: Enter "angular distance 1059mode". In this mode, a dotted line is drawn from the first target object 1060to the current mouse position. When you click with the &RMB; on a second 1061object, this will display the angular distance between the two 1062objects near the second object. You can press the &Esc; key to 1063exit angular distance mode without measuring an angle. 1064</para></listitem> 1065</varlistentry> 1066 1067<!-- Starhop: --> 1068<varlistentry> 1069<term>[All]</term> 1070<listitem><para> 1071<guimenuitem>Starhop from here to</guimenuitem>: will enable you to find a path between two points in 1072the sky. Star hopping is a technique that uses bright stars as a guide for finding fainter objects. So if 1073you have a bright star, you can use it as a reference to find a fainter object. Starting from your reference 1074star, &kstars; will find a route to the destination, traversing a sequence of stars/patterns of stars. The 1075object for which you called <guilabel>Starhop from here to</guilabel> tool will be your starting point. When 1076your starting point is established, a dotted line will appear, allowing you to decide which will be your 1077end point. You have to move the mouse cursor to your destination object position and right click on it. 1078Then, a dialog box will pop up, requiring you to set the FOV used for star hopping. For selecting a FOV, 1079you need to make a choice from the FOV combo box list of values. The values you can choose include 1080default FOV values (7x35 Binoculars, Telrad, One Degree, HST WFPC2 and 30m at 1.3cm) plus your customized 1081FOVs. After you selected the FOV, &kstars; will find a route for you. Thus, the dialog box will contain a 1082list of object used in the starhop. If &kstars; did not manage to find a route, then an error dialog box 1083will be displayed, giving you a helping hand. When the Star-Hopper algorithm ends, the dialog box will 1084contain a list of objects used in starhop route. For every object from the list, you can perform a set of 1085actions: you can ask for details using the <guibutton>Details</guibutton> button, center selected object in 1086the map using <guibutton>Center on map</guibutton> button or you can go to next star by pressing the 1087<guibutton>Next</guibutton> button. Note that when go to next star, it will be automatically centered on 1088the map. Also, Star-Hopper tool provides directions to star hop for every object of the list. 1089</para></listitem> 1090</varlistentry> 1091 1092<varlistentry> 1093<term>[All]</term> 1094<listitem><para> 1095<guimenuitem>Details</guimenuitem>: Open the 1096<link linkend="tool-details">Object Details window</link> for this object. 1097</para></listitem> 1098</varlistentry> 1099 1100<varlistentry> 1101<term>[All]</term> 1102<listitem><para> 1103<guimenuitem>Attach Label</guimenuitem>: Attach a permanent name label 1104to the object. If the object already has a label attached, this item 1105will read <guilabel>Remove Label</guilabel>. 1106</para></listitem> 1107</varlistentry> 1108 1109<varlistentry> 1110<term>[All]</term> 1111<listitem><para> 1112<guimenuitem>Add to Observing WishList</guimenuitem>: Add the selected object to 1113<guimenu>Observation Planner</guimenu>'s Wish List. You can see the Wish List, by 1114selecting the <menuchoice><guimenu>Observation</guimenu> <guimenuitem>Observation 1115Planner</guimenuitem></menuchoice> menu item. 1116If the object is already in the Observing WishList, then this item will become 1117<guilabel>Remove Label</guilabel>. 1118</para></listitem> 1119</varlistentry> 1120 1121<varlistentry> 1122<term>[Solar system objects]</term> 1123<listitem><para> 1124<guimenuitem>Add Trail</guimenuitem>: Add a trail to current Solar system object. A star trail is the 1125continuous path created by the star in the night sky due to the rotation of the Earth. 1126If the object already has a trail, this item will become <guilabel>Remove Trail</guilabel>. 1127</para></listitem> 1128</varlistentry> 1129 1130<varlistentry> 1131<term>[All]</term> 1132<listitem><para> 1133<guimenuitem>Simulate eyepiece view</guimenuitem>: Eyepiece View feature renders the 1134view through the eyepiece of various telescope types. Firstly, an input dialog is shown, 1135which asks you to select one of the visible FOVs to use as a FOV for the eyepiece view. 1136The user also has the option of trying to determine it from the image (accurate if 1137image has metadata, otherwise it will be random). After you set the FOV, 1138the "Eyepiece Field View" window will pop up. 1139You can easily rotate the view using the "Rotation" slider. You can 1140also flip and invert the view to help match the view through a telescope/camera. 1141"Eyepiece view" tool can help you locate many objects with ease, instead of 1142trying to work with relative positions and relative orientations. 1143This is an important advantage, especially when you are star hopping. 1144Note that for getting best results, time must be synced with current 1145time in &kstars;, and &kstars; must be in horizontal coordinates mode. 1146</para></listitem> 1147</varlistentry> 1148 1149<varlistentry> 1150<term>[Solar system objects]</term> 1151<listitem><para> 1152<guimenuitem>Image Resources</guimenuitem>: gives a list of image links for current Solar 1153system object. The images are displayed in &kstars; Image Viewer tool. Image Viewer tool 1154allows you to invert the colors and save the image in your computer. 1155</para></listitem> 1156</varlistentry> 1157 1158<varlistentry> 1159<term>[Solar system objects]</term> 1160<listitem><para> 1161<guimenuitem>Information Resources</guimenuitem>: gives a list of documentation links for 1162current Solar system object. The links are opened in your default browser. 1163</para></listitem> 1164</varlistentry> 1165 1166<varlistentry> 1167<term>[All objects without Solar system objects]</term> 1168<listitem><para> 1169<guimenuitem>Show SDSS Image</guimenuitem>: download a SDSS (Sloan Digital Sky Survey) 1170image of the object from the Internet, and display it in the Image Viewer tool. 1171</para></listitem> 1172</varlistentry> 1173 1174<varlistentry> 1175<term>[All objects without Solar system objects]</term> 1176<listitem><para> 1177<guimenuitem>Show DSS Image</guimenuitem>: download a DSS (Digitized Sky Survey) image of 1178the object from the Internet, and display it in the Image Viewer tool. 1179</para></listitem> 1180</varlistentry> 1181 1182</variablelist> 1183 1184</sect2> 1185</sect1> 1186 1187<sect1 id="kstars-keys"> 1188<title>Keyboard Commands</title> 1189<indexterm><primary>Commands</primary> 1190<secondary>Keyboard</secondary></indexterm> 1191 1192<sect2 id="nav-keys"> 1193<title>Navigation Keys</title> 1194<indexterm><primary>Navigation Controls</primary> 1195<secondary>Keyboard</secondary></indexterm> 1196 1197<variablelist> 1198<varlistentry><term>Arrow Keys</term> 1199<listitem><para> 1200Use the arrow keys to pan the display. Holding down the &Shift; 1201key doubles the scrolling speed. 1202</para></listitem></varlistentry> 1203 1204<varlistentry> 1205<term><keycap>+</keycap> / <keycap>-</keycap></term> 1206<listitem><para>Zoom In/Out.</para></listitem> 1207</varlistentry> 1208 1209<varlistentry> 1210<term><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></term> 1211<listitem><para>Restore the default Zoom setting.</para></listitem> 1212</varlistentry> 1213 1214<varlistentry> 1215<term><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></term> 1216<listitem><para>Zoom to specified field-of-view angle.</para></listitem> 1217</varlistentry> 1218 1219<varlistentry> 1220<term><keycap>0</keycap>–<keycap>9</keycap></term> 1221<listitem><para>Center Display on a major Solar System body: 1222<itemizedlist> 1223<listitem><para><keycap>0</keycap>: Sun</para></listitem> 1224<listitem><para><keycap>1</keycap>: Mercury</para></listitem> 1225<listitem><para><keycap>2</keycap>: Venus</para></listitem> 1226<listitem><para><keycap>3</keycap>: Moon</para></listitem> 1227<listitem><para><keycap>4</keycap>: Mars</para></listitem> 1228<listitem><para><keycap>5</keycap>: Jupiter</para></listitem> 1229<listitem><para><keycap>6</keycap>: Saturn</para></listitem> 1230<listitem><para><keycap>7</keycap>: Uranus</para></listitem> 1231<listitem><para><keycap>8</keycap>: Neptune</para></listitem> 1232<listitem><para><keycap>9</keycap>: Pluto</para></listitem> 1233</itemizedlist> 1234</para></listitem> 1235</varlistentry> 1236 1237<varlistentry> 1238<term><keycap>Z</keycap></term> 1239<listitem><para>Center the display at the <link linkend="ai-zenith">Zenith</link> 1240Point (straight up).</para></listitem> 1241</varlistentry> 1242 1243<varlistentry> 1244<term><keycap>N</keycap></term> 1245<listitem><para>Center the display above the North point on the horizon.</para></listitem> 1246</varlistentry> 1247 1248<varlistentry> 1249<term><keycap>E</keycap></term> 1250<listitem><para>Center the display above the East point on the horizon.</para></listitem> 1251</varlistentry> 1252 1253<varlistentry> 1254<term><keycap>S</keycap></term> 1255<listitem><para>Center the display above the South point on the horizon.</para> 1256</listitem> 1257</varlistentry> 1258 1259<varlistentry> 1260<term><keycap>W</keycap></term> 1261<listitem><para>Center the display above the West point on the horizon.</para></listitem> 1262</varlistentry> 1263 1264<varlistentry> 1265<term><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></term> 1266<listitem><para>Toggle tracking mode.</para></listitem> 1267</varlistentry> 1268 1269<varlistentry> 1270<term><keycap><</keycap></term> 1271<listitem><para>Advance the simulation clock backwards by one time step.</para> 1272</listitem> 1273</varlistentry> 1274 1275<varlistentry> 1276<term><keycap>></keycap></term> 1277<listitem><para>Advance the simulation clock forwards by one time step.</para> 1278</listitem> 1279</varlistentry> 1280 1281</variablelist> 1282</sect2> 1283 1284<sect2 id="menu-keys"> 1285<title>Menu Shortcuts</title> 1286<indexterm><primary>Commands</primary> 1287<secondary>Menu</secondary> 1288<tertiary>Keyboard Shortcuts</tertiary> 1289</indexterm> 1290<variablelist> 1291 1292<varlistentry> 1293<term><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></term> 1294<listitem><para>Download extra data.</para></listitem> 1295</varlistentry> 1296 1297<varlistentry> 1298<term><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></term> 1299<listitem><para>Open a FITS image in the FITS Editor.</para></listitem> 1300</varlistentry> 1301 1302<varlistentry> 1303<term><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></term> 1304<listitem><para>Export sky image to a file.</para></listitem> 1305</varlistentry> 1306 1307<varlistentry> 1308<term><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></term> 1309<listitem><para>Run a &kstars; <link linkend="tool-obsplanner">Observation Planner</link>. 1310</para></listitem> 1311</varlistentry> 1312 1313<varlistentry> 1314<term><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></term> 1315<listitem><para>Run a &kstars; &DBus; script.</para></listitem> 1316</varlistentry> 1317 1318<varlistentry> 1319<term><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></term> 1320<listitem><para>Print the current sky map.</para></listitem> 1321</varlistentry> 1322 1323<varlistentry> 1324<term><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></term> 1325<listitem><para>Quit &kstars;.</para></listitem> 1326</varlistentry> 1327 1328<varlistentry> 1329<term><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></term> 1330<listitem><para>Sync the simulation clock with the current system time.</para></listitem> 1331</varlistentry> 1332 1333<varlistentry> 1334<term><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></term> 1335<listitem><para>Set the simulation clock to a specified Time and Date.</para></listitem> 1336</varlistentry> 1337 1338<varlistentry> 1339<term><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></term> 1340<listitem><para>Toggle full-screen mode.</para></listitem> 1341</varlistentry> 1342 1343<varlistentry> 1344<term><keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo></term> 1345<listitem><para> 1346Define equipment (telescope, eyepiece, lens and filter) characteristics for observation logs. 1347</para></listitem> 1348</varlistentry> 1349 1350<varlistentry> 1351<term><keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo></term> 1352<listitem><para>Add a new observer item for your observation logs.</para></listitem> 1353</varlistentry> 1354 1355<varlistentry><term>&Space;</term> 1356<listitem><para>Toggle between the 1357<link linkend="horizontal">Horizontal</link> and 1358<link linkend="equatorial">Equatorial</link> 1359<link linkend="ai-skycoords">Coordinate Systems</link>. 1360</para></listitem></varlistentry> 1361 1362<varlistentry> 1363<term><keycap>F1</keycap></term> 1364<listitem><para>Open the &kstars; Handbook.</para></listitem> 1365</varlistentry> 1366 1367<varlistentry> 1368<term><keycap>F5</keycap></term> 1369<listitem><para>Switch sky chart view to the 1370<ulink url="https://en.wikipedia.org/wiki/Lambert_azimuthal_equal-area_projection">Lambert azimuthal equal-area</ulink> projection. 1371</para></listitem> 1372</varlistentry> 1373 1374<varlistentry> 1375<term><keycap>F6</keycap></term> 1376<listitem><para>Switch sky chart view to the 1377<ulink url="https://en.wikipedia.org/wiki/Azimuthal_equidistant_projection">azimuthal equidistant</ulink> projection. 1378</para></listitem> 1379</varlistentry> 1380 1381<varlistentry> 1382<term><keycap>F7</keycap></term> 1383<listitem><para>Switch sky chart view to the <ulink url="https://en.wikipedia.org/wiki/Orthographic_projection_(cartography)">orthographic</ulink> projection.</para></listitem> 1384</varlistentry> 1385 1386<varlistentry> 1387<term><keycap>F8</keycap></term> 1388<listitem><para>Switch sky chart view to the 1389<ulink url="https://en.wikipedia.org/wiki/Equirectangular_projection">equirectangular</ulink> projection. 1390</para></listitem> 1391</varlistentry> 1392 1393<varlistentry> 1394<term><keycap>F9</keycap></term> 1395<listitem><para>Switch sky chart view to the 1396<ulink url="https://en.wikipedia.org/wiki/Stereographic_projection">stereographic</ulink> projection. 1397</para></listitem> 1398</varlistentry> 1399 1400<varlistentry> 1401<term><keycap>F10</keycap></term> 1402<listitem><para>Switch sky chart view to the 1403<ulink url="https://en.wikipedia.org/wiki/Gnomonic_projection">gnomonic</ulink> projection. 1404</para></listitem> 1405</varlistentry> 1406</variablelist> 1407</sect2> 1408 1409 1410<sect2 id="object-actions"> 1411<title>Actions for the Selected Object</title> 1412<indexterm><primary>Objects in the Sky</primary> 1413<secondary>Keyboard Actions</secondary></indexterm> 1414 1415<para>Each of the following keystrokes performs an action on the 1416<firstterm>selected object</firstterm>. The selected object is the last 1417object which was clicked on (identified in the status bar). Alternatively, 1418if you hold down the &Shift; key, then the action is 1419performed on the centered object instead.</para> 1420 1421<variablelist> 1422<varlistentry> 1423<term><keycap>C</keycap></term> 1424<listitem><para>Center and Track on the selected object.</para></listitem> 1425</varlistentry> 1426 1427<varlistentry> 1428<term><keycap>D</keycap></term> 1429<listitem><para>Open the Details window for the selected object.</para></listitem> 1430</varlistentry> 1431 1432<varlistentry> 1433<term><keycap>L</keycap></term> 1434<listitem><para>Toggle a name label for the selected object.</para></listitem> 1435</varlistentry> 1436 1437<varlistentry> 1438<term><keycap>O</keycap></term> 1439<listitem><para>Add the selected object to the observing list.</para></listitem> 1440</varlistentry> 1441 1442<varlistentry> 1443<term><keycap>P</keycap></term> 1444<listitem><para>Open the selected object's popup menu.</para></listitem> 1445</varlistentry> 1446 1447<varlistentry> 1448<term><keycap>T</keycap></term> 1449<listitem><para>Toggle a trail on the selected object (solar system bodies only).</para></listitem> 1450</varlistentry> 1451 1452</variablelist> 1453</sect2> 1454 1455<sect2 id="tools-keys"> 1456<title>Tools Shortcuts</title> 1457 1458<variablelist> 1459<varlistentry> 1460<term><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></term> 1461<listitem><para>Open the <link linkend="findobjects">Find Object window</link>, 1462for specifying a sky object on which to center.</para></listitem> 1463</varlistentry> 1464 1465<varlistentry><term><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo> 1466</term> 1467<listitem><para>Open the <guilabel>Set Coordinates Manually</guilabel> tool, 1468for specifying RA/Dec or Az/Alt coordinates on which to center.</para></listitem> 1469</varlistentry> 1470 1471<varlistentry> 1472<term><keycap>[</keycap></term> 1473<listitem><para>Start an Angular Distance measurement at the current mouse 1474cursor position. The angular distance between start and end points is displayed 1475at the endpoint.</para></listitem> 1476</varlistentry> 1477 1478<varlistentry> 1479<term><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></term> 1480<listitem><para>Open the <link linkend="setgeo">Set Geographic Location</link> 1481window.</para></listitem> 1482</varlistentry> 1483 1484<varlistentry> 1485<term><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></term> 1486<listitem><para>Open the <link linkend="tool-calculator">AstroCalculator</link>. 1487</para></listitem> 1488</varlistentry> 1489 1490<varlistentry> 1491<term><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></term> 1492<listitem><para>Open the <link linkend="tool-altvstime">Altitude vs. Time</link> 1493tool.</para></listitem> 1494</varlistentry> 1495 1496<varlistentry> 1497<term><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></term> 1498<listitem><para>Open the <link linkend="tool-whatsup">What's up Tonight?</link> 1499tool.</para></listitem> 1500</varlistentry> 1501 1502<varlistentry> 1503<term><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></term> 1504<listitem><para>Open the <quote>What's Interesting</quote> 1505tool.</para></listitem> 1506</varlistentry> 1507 1508<varlistentry> 1509<term><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></term> 1510<listitem><para>Open the <link linkend="tool-scriptbuilder">Script Builder</link> 1511tool.</para></listitem> 1512</varlistentry> 1513 1514<varlistentry> 1515<term><keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo></term> 1516<listitem><para>Open the <link linkend="tool-solarsys">Solar System Viewer</link>. 1517</para></listitem> 1518</varlistentry> 1519 1520<varlistentry> 1521<term><keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo></term> 1522<listitem><para>Open the <link linkend="tool-jmoons">Jupiter Moons</link> 1523tool.</para></listitem> 1524</varlistentry> 1525 1526</variablelist> 1527</sect2> 1528</sect1> 1529 1530<sect1 id="kstars-mouse"> 1531<title>Mouse Commands</title> 1532<indexterm><primary>Commands</primary> 1533<secondary>Mouse</secondary></indexterm> 1534<indexterm><primary>Navigation Controls</primary> 1535<secondary>Mouse</secondary></indexterm> 1536 1537<variablelist> 1538<varlistentry><term>Moving the mouse</term> 1539<listitem><para> 1540The sky coordinates (Az/Alt, RA/Dec and J2000.0 RA/Dec) of the mouse cursor are updated 1541in the status bar. The status bar is located in the right bottom corner of the screen. 1542The status bar can be customized by selecting <menuchoice><guimenu>Settings</guimenu> 1543<guimenuitem>Statusbar</guimenuitem></menuchoice> submenu. Here you may choose what coordinates 1544systems &kstars; will display in the status bar. Furthermore, you can hide the status bar by 1545unchecking the <guilabel>Show Statusbar</guilabel> checkbox. 1546</para></listitem> 1547</varlistentry> 1548 1549<varlistentry><term>"Hovering" the mouse</term> 1550<listitem><para> 1551A temporary name label is attached to the object nearest to the mouse cursor. 1552</para></listitem> 1553</varlistentry> 1554 1555<varlistentry><term>Left-clicking</term> 1556<listitem> 1557<para> 1558<indexterm><primary>Objects in the Sky</primary> 1559<secondary>Identifying</secondary></indexterm> 1560The object nearest the mouse click is identified in the 1561status bar. 1562</para></listitem> 1563</varlistentry> 1564 1565<varlistentry><term>Double-clicking</term> 1566<listitem> 1567<para> 1568<indexterm><primary>Objects in the Sky</primary> 1569<secondary>Centering</secondary></indexterm> 1570Center and track on the location or object 1571nearest the mouse click. Double-clicking on an Info Box will 1572<quote>shade</quote> it to show/hide extra information. 1573</para></listitem> 1574</varlistentry> 1575 1576<varlistentry><term>Right-clicking</term> 1577<listitem> 1578<para> 1579<indexterm><primary>Objects in the Sky</primary> 1580<secondary>Invoking Popup Menu for</secondary></indexterm> 1581Open the <link linkend="popup-menu">popup menu</link> for the 1582location or object nearest the mouse cursor. 1583</para></listitem> 1584</varlistentry> 1585 1586<varlistentry><term>Scrolling the mouse wheel</term> 1587<listitem><para>Zoom the display in or out. If you do not 1588have a mouse <mousebutton>wheel</mousebutton>, you can hold the middle mouse button and 1589drag vertically. 1590</para></listitem> 1591</varlistentry> 1592 1593<varlistentry><term>Click-and-dragging</term> 1594<listitem><para> 1595 <variablelist> 1596 <varlistentry><term>Dragging the sky map</term> 1597 <listitem><para>Pan the display, following the drag motion. 1598 </para></listitem></varlistentry> 1599 1600 <varlistentry><term>&Ctrl;+dragging the sky map</term> 1601 <listitem><para>Define a rectangle in the map. When the 1602 mouse button is released, the display is zoomed in to match the 1603 field-of-view to the bounds of the rectangle. 1604 </para></listitem></varlistentry> 1605 1606 <varlistentry><term>Dragging an Info Box</term> 1607 <listitem><para>The Info Box is repositioned in the map. Info 1608 Boxes will <quote>stick</quote> to window edges, so that they 1609 remain on the edge when the window is resized. 1610 </para></listitem></varlistentry> 1611 </variablelist> 1612</para></listitem> 1613</varlistentry> 1614</variablelist> 1615 1616</sect1> 1617</chapter> 1618