1<chapter id="commands"> 2<title 3>Command Reference</title> 4 5<sect1 id="kstars-menus"> 6<title 7>Menu Commands</title> 8<indexterm 9><primary 10>Commands</primary 11><secondary 12>Menu</secondary 13></indexterm> 14 15<sect2 id="filemenu"> 16<title 17><guimenu 18>File</guimenu 19> Menu</title> 20 21<variablelist> 22<varlistentry> 23<term 24><menuchoice 25><shortcut 26> <keycombo action="simul" 27>&Ctrl;<keycap 28>N</keycap 29></keycombo 30> </shortcut 31> <guimenu 32>File</guimenu 33> <guimenuitem 34>New Window</guimenuitem 35> </menuchoice 36></term> 37<listitem 38><para 39>Open another &kstars; window </para 40></listitem> 41</varlistentry> 42 43<varlistentry> 44<term 45><menuchoice 46><shortcut 47> <keycombo action="simul" 48>&Ctrl;<keycap 49>W</keycap 50></keycombo 51> </shortcut 52> <guimenu 53>File</guimenu 54> <guimenuitem 55>Close Window</guimenuitem 56> </menuchoice 57></term> 58<listitem 59><para 60>Close &kstars; window </para 61></listitem> 62</varlistentry> 63 64<varlistentry> 65<term 66><menuchoice 67><shortcut 68> <keycombo action="simul" 69>&Ctrl;<keycap 70>D</keycap 71></keycombo 72> </shortcut 73> <guimenu 74>File</guimenu 75> <guimenuitem 76>Download Data...</guimenuitem 77> </menuchoice 78></term> 79<listitem 80><para 81>Open the <guilabel 82>Download Extra Data</guilabel 83> tool </para 84></listitem> 85</varlistentry> 86 87<varlistentry> 88<term 89><menuchoice 90><shortcut 91> <keycombo action="simul" 92>&Ctrl;<keycap 93>O</keycap 94></keycombo 95> </shortcut 96> <guimenu 97>File</guimenu 98> <guimenuitem 99>Open FITS...</guimenuitem 100> </menuchoice 101></term> 102<listitem 103><para 104>Open a FITS image in the FITS Editor tool </para 105></listitem> 106</varlistentry> 107 108<varlistentry> 109<term 110><menuchoice 111><shortcut 112> <keycombo action="simul" 113>&Ctrl;<keycap 114>I</keycap 115></keycombo 116> </shortcut 117> <guimenu 118>File</guimenu 119> <guimenuitem 120>Save Sky Image...</guimenuitem 121> </menuchoice 122></term> 123<listitem 124><para 125>Create image on disk from current display </para 126></listitem> 127</varlistentry> 128 129<varlistentry> 130<term 131><menuchoice 132><shortcut 133> <keycombo action="simul" 134>&Ctrl;<keycap 135>R</keycap 136></keycombo 137> </shortcut 138> <guimenu 139>File</guimenu 140> <guimenuitem 141>Run Script...</guimenuitem 142> </menuchoice 143></term> 144<listitem 145><para 146>Run the specified KStars script </para 147></listitem> 148</varlistentry> 149 150<varlistentry> 151<term 152><menuchoice 153><shortcut 154> <keycombo action="simul" 155>&Ctrl;<keycap 156>P</keycap 157></keycombo 158> </shortcut 159> <guimenu 160>File</guimenu 161> <guimenuitem 162>Print...</guimenuitem 163> </menuchoice 164></term> 165<listitem 166><para 167>Send the current sky map to the printer (or to a PostScript/PDF file) </para 168></listitem> 169</varlistentry> 170 171<varlistentry> 172<term 173><menuchoice 174><shortcut 175> <keycombo action="simul" 176>&Ctrl;<keycap 177>Q</keycap 178></keycombo 179> </shortcut 180> <guimenu 181>File</guimenu 182> <guimenuitem 183>Quit</guimenuitem 184> </menuchoice 185></term> 186<listitem 187><para 188>Quit &kstars; </para 189></listitem> 190</varlistentry> 191</variablelist> 192 193</sect2> 194 195<sect2 id="timemenu"> 196<title 197><guimenu 198>Time</guimenu 199> Menu</title> 200 201<variablelist> 202<varlistentry> 203<term 204><menuchoice 205><shortcut 206> <keycombo action="simul" 207>&Ctrl;<keycap 208>E</keycap 209></keycombo 210> </shortcut 211> <guimenu 212>Time</guimenu 213> <guimenuitem 214>Set Time to Now</guimenuitem 215> </menuchoice 216></term> 217<listitem 218><para 219>Sync time to system clock</para 220></listitem> 221</varlistentry> 222 223<varlistentry> 224<term 225><menuchoice 226><shortcut 227> <keycombo action="simul" 228>&Ctrl;<keycap 229>S</keycap 230></keycombo 231> </shortcut 232> <guimenu 233>Time</guimenu 234> <guimenuitem 235>Set Time...</guimenuitem 236> </menuchoice 237></term> 238<listitem 239><para 240>Set time and date</para 241></listitem> 242</varlistentry> 243 244<varlistentry> 245<term 246><menuchoice 247><guimenu 248>Time</guimenu 249> <guimenuitem 250>Start/Stop Clock</guimenuitem 251> </menuchoice 252></term> 253<listitem 254><para 255>Toggle whether time passes</para 256></listitem> 257</varlistentry> 258</variablelist> 259 260</sect2> 261 262<sect2 id="pointmenu"> 263<title 264><guimenu 265>Pointing</guimenu 266> Menu</title> 267 268<variablelist> 269<varlistentry> 270<term 271><menuchoice 272><shortcut 273> <keycap 274>Z</keycap 275> </shortcut 276> <guimenu 277>Pointing</guimenu 278> <guimenuitem 279>Zenith</guimenuitem 280> </menuchoice 281></term> 282<listitem 283><para 284>Centre the display at the <link linkend="ai-zenith" 285>Zenith</link 286> point (straight up) </para 287></listitem> 288</varlistentry> 289 290<varlistentry> 291<term 292><menuchoice 293><shortcut 294> <keycap 295>N</keycap 296> </shortcut 297> <guimenu 298>Pointing</guimenu 299> <guimenuitem 300>North</guimenuitem 301> </menuchoice 302></term> 303<listitem 304><para 305>Centre the display above the North point on the horizon</para 306></listitem> 307</varlistentry> 308 309<varlistentry> 310<term 311><menuchoice 312><shortcut 313> <keycap 314>E</keycap 315> </shortcut 316> <guimenu 317>Pointing</guimenu 318> <guimenuitem 319>East</guimenuitem 320> </menuchoice 321></term> 322<listitem 323><para 324>Centre the display above the East point on the horizon</para 325></listitem> 326</varlistentry> 327 328<varlistentry> 329<term 330><menuchoice 331><shortcut 332> <keycap 333>S</keycap 334> </shortcut 335> <guimenu 336>Pointing</guimenu 337> <guimenuitem 338>South</guimenuitem 339> </menuchoice 340></term> 341<listitem 342><para 343>Centre the display above the South point on the horizon</para 344></listitem> 345</varlistentry> 346 347<varlistentry> 348<term 349><menuchoice 350><shortcut 351> <keycap 352>W</keycap 353> </shortcut 354> <guimenu 355>Pointing</guimenu 356> <guimenuitem 357>West</guimenuitem 358> </menuchoice 359></term> 360<listitem 361><para 362>Centre the display above the West point on the horizon</para 363></listitem> 364</varlistentry> 365 366<varlistentry> 367<term 368><menuchoice 369><shortcut 370> <keycombo action="simul" 371>&Ctrl;<keycap 372>M</keycap 373></keycombo 374> </shortcut 375> <guimenu 376>Pointing</guimenu 377> <guimenuitem 378>Set Focus Manually...</guimenuitem 379> </menuchoice 380></term> 381<listitem 382><para 383>Centre the display on specific <link linkend="ai-skycoords" 384>sky coordinates</link 385> </para 386></listitem> 387</varlistentry> 388 389<varlistentry> 390<term 391><menuchoice 392><shortcut 393> <keycombo action="simul" 394>&Ctrl;<keycap 395>F</keycap 396></keycombo 397> </shortcut 398> <guimenu 399>Pointing</guimenu 400> <guimenuitem 401>Find Object</guimenuitem 402> </menuchoice 403></term> 404<listitem 405><para 406>Locate an object by name using the <link linkend="findobjects" 407>Find Object Window</link 408></para 409></listitem> 410</varlistentry> 411 412<varlistentry> 413<term 414><menuchoice 415><shortcut 416> <keycombo action="simul" 417>&Ctrl;<keycap 418>T</keycap 419></keycombo 420> </shortcut 421> <guimenu 422>Pointing</guimenu 423> <guimenuitem 424>Engage/Stop Tracking</guimenuitem 425> </menuchoice 426></term> 427<listitem 428><para 429>Toggle tracking on/off. While tracking, the display will remain centred on the current position or object.</para 430></listitem> 431</varlistentry> 432</variablelist> 433 434</sect2> 435 436<sect2 id="viewmenu"> 437<title 438><guimenu 439>View</guimenu 440> Menu</title> 441 442<variablelist> 443<varlistentry> 444<term 445><menuchoice 446><shortcut 447> <keycap 448>+</keycap 449> </shortcut 450> <guimenu 451>View</guimenu 452> <guimenuitem 453>Zoom in</guimenuitem 454> </menuchoice 455></term> 456<listitem 457><para 458>Zooms view in</para 459></listitem> 460</varlistentry> 461 462<varlistentry> 463<term 464><menuchoice 465><shortcut 466> <keycap 467>-</keycap 468> </shortcut 469> <guimenu 470>View</guimenu 471> <guimenuitem 472>Zoom out</guimenuitem 473> </menuchoice 474></term> 475<listitem 476><para 477>Zooms view out</para 478></listitem> 479</varlistentry> 480 481<varlistentry> 482<term 483><menuchoice 484><shortcut 485> <keycombo action="simul" 486>&Ctrl;<keycap 487>Z</keycap 488></keycombo 489> </shortcut 490> <guimenu 491>View</guimenu 492> <guimenuitem 493>Default Zoom</guimenuitem 494> </menuchoice 495></term> 496<listitem 497><para 498>Restore the default Zoom setting</para 499></listitem> 500</varlistentry> 501 502<varlistentry> 503<term 504><menuchoice 505><shortcut 506> <keycombo action="simul" 507>&Ctrl;&Shift;<keycap 508>Z</keycap 509></keycombo 510> </shortcut 511> <guimenu 512>View</guimenu 513> <guimenuitem 514>Zoom to Angular Size...</guimenuitem 515> </menuchoice 516></term> 517<listitem 518><para 519>Zoom to specified field-of-view angle</para 520></listitem> 521</varlistentry> 522 523<varlistentry> 524<term 525><menuchoice 526><shortcut 527> <keycombo action="simul" 528>&Ctrl;&Shift;<keycap 529>F</keycap 530></keycombo 531> </shortcut 532> <guimenu 533>View</guimenu 534> <guimenuitem 535>Full Screen Mode</guimenuitem 536> </menuchoice 537></term> 538<listitem 539><para 540>Toggle full-screen mode</para 541></listitem> 542</varlistentry> 543 544<varlistentry> 545<term 546><menuchoice 547><shortcut 548> <keycap 549>Space</keycap 550> </shortcut 551> <guimenu 552>View</guimenu 553> <guimenuitem 554>Horizontal/Equatorial Coordinates</guimenuitem 555> </menuchoice 556></term> 557<listitem 558><para 559>Toggle between the <link linkend="horizontal" 560>Horizontal</link 561> and <link linkend="equatorial" 562>Equatorial</link 563> <link linkend="ai-skycoords" 564>Coordinate Systems</link 565></para 566></listitem> 567</varlistentry> 568</variablelist> 569</sect2> 570 571<sect2 id="devicemenu"> 572<title 573><guimenu 574>Devices</guimenu 575> Menu</title> 576 577<variablelist> 578 579<varlistentry> 580<term 581><menuchoice 582><guimenu 583>Devices</guimenu 584> <guimenuitem 585>Telescope Wizard...</guimenuitem 586> </menuchoice 587></term> 588<listitem 589><para 590>Opens the <guilabel 591>Telescope Wizard</guilabel 592>, which provides a step-by-step guide to help you connect to your telescope and control it with &kstars;.</para 593></listitem> 594</varlistentry> 595 596<varlistentry> 597<term 598><menuchoice 599><guimenu 600>Devices</guimenu 601> <guimenuitem 602>Capture Image Sequence...</guimenuitem 603> </menuchoice 604></term> 605<listitem 606><para 607>Acquire images from a CCD camera or webcam device</para 608></listitem> 609</varlistentry> 610 611<varlistentry> 612<term 613><menuchoice 614><guimenu 615>Devices</guimenu 616> <guimenuitem 617>Device Manager</guimenuitem 618> </menuchoice 619></term> 620<listitem 621><para 622>Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers.</para 623></listitem> 624</varlistentry> 625 626<varlistentry> 627<term 628><menuchoice 629><guimenu 630>Devices</guimenu 631> <guimenuitem 632>INDI Control Panel</guimenuitem 633> </menuchoice 634></term> 635<listitem 636><para 637>Opens up INDI Control Panel, which allows you to control all the features supported by a device.</para 638></listitem> 639</varlistentry> 640 641<varlistentry> 642<term 643><menuchoice 644><guimenu 645>Devices</guimenu 646> <guimenuitem 647>Configure INDI</guimenuitem 648> </menuchoice 649></term> 650<listitem 651><para 652>Opens up a dialogue to configure INDI-related features such as automatic device updates.</para 653></listitem> 654</varlistentry> 655 656</variablelist> 657</sect2> 658 659<sect2 id="toolmenu"> 660<title 661><guimenu 662>Tools</guimenu 663> Menu</title> 664 665<variablelist> 666<varlistentry> 667<term 668><menuchoice 669><shortcut 670> <keycombo action="simul" 671>&Ctrl;<keycap 672>C</keycap 673></keycombo 674> </shortcut 675> <guimenu 676>Tools</guimenu 677> <guimenuitem 678>Calculator...</guimenuitem 679> </menuchoice 680></term> 681<listitem> 682<para 683>Opens the <link linkend="tool-calculator" 684>AstroCalculator</link 685> Tool, which provides full access to many of the mathematical functions used by &kstars;. </para> 686</listitem> 687</varlistentry> 688 689<varlistentry> 690<term 691><menuchoice 692><shortcut 693> <keycombo action="simul" 694>&Ctrl;<keycap 695>V</keycap 696></keycombo 697> </shortcut 698> <guimenu 699>Tools</guimenu 700> <guimenuitem 701>AAVSO Light Curves...</guimenuitem 702> </menuchoice 703></term> 704<listitem> 705<para 706>Opens the <link linkend="tool-aavso" 707>AAVSO Light Curve Generator</link 708> Tool, which allows you to download a light curve for any variable star from the American Association of Variable Star Observers. </para> 709</listitem> 710</varlistentry> 711 712<varlistentry> 713<term 714><menuchoice 715><shortcut 716> <keycombo action="simul" 717>&Ctrl;<keycap 718>A</keycap 719></keycombo 720> </shortcut 721> <guimenu 722>Tools</guimenu 723> <guimenuitem 724>Altitude vs. Time...</guimenuitem 725> </menuchoice 726></term> 727<listitem> 728<para 729>Opens the <link linkend="tool-altvstime" 730>Altitude vs. Time</link 731> Tool, which can plot curves representing the altitude of any object as a function of time. This is useful for planning observing sessions. </para> 732</listitem> 733</varlistentry> 734 735<varlistentry> 736<term 737><menuchoice 738><shortcut 739> <keycombo action="simul" 740>&Ctrl;<keycap 741>U</keycap 742></keycombo 743> </shortcut 744> <guimenu 745>Tools</guimenu 746> <guimenuitem 747>What's Up Tonight...</guimenuitem 748> </menuchoice 749></term> 750<listitem> 751<para 752>Opens the <link linkend="tool-whatsup" 753>What's Up Tonight</link 754> Tool, which presents a summary of the objects which are observable from your location on a given date. </para> 755</listitem> 756</varlistentry> 757 758<varlistentry> 759<term 760><menuchoice 761><shortcut 762> <keycombo action="simul" 763>&Ctrl;<keycap 764>B</keycap 765></keycombo 766> </shortcut 767> <guimenu 768>Tools</guimenu 769> <guimenuitem 770>Script Builder...</guimenuitem 771> </menuchoice 772></term> 773<listitem> 774<para 775>Opens the <link linkend="tool-scriptbuilder" 776>Script Builder</link 777> Tool, which provides a GUI interface for building &kstars; DCOP scripts. </para> 778</listitem> 779</varlistentry> 780 781<varlistentry> 782<term 783><menuchoice 784><shortcut 785> <keycombo action="simul" 786>&Ctrl;<keycap 787>Y</keycap 788></keycombo 789> </shortcut 790> <guimenu 791>Tools</guimenu 792> <guimenuitem 793>Solar System...</guimenuitem 794> </menuchoice 795></term> 796<listitem> 797<para 798>Opens the <link linkend="tool-solarsys" 799>Solar System Viewer</link 800>, which displays an overhead view of the solar system on the current simulation date. </para> 801</listitem> 802</varlistentry> 803 804<varlistentry> 805<term 806><menuchoice 807><shortcut 808> <keycombo action="simul" 809>&Ctrl;<keycap 810>J</keycap 811></keycombo 812> </shortcut 813> <guimenu 814>Tools</guimenu 815> <guimenuitem 816>Jupiter's Moons...</guimenuitem 817> </menuchoice 818></term> 819<listitem> 820<para 821>Opens the <link linkend="tool-jmoons" 822>Jupiter Moons Tool</link 823>, which displays the positions of Jupiter's four brightest moons as a function of time. </para> 824</listitem> 825</varlistentry> 826 827</variablelist> 828</sect2> 829 830<sect2 id="settingmenu"> 831<title 832><guimenu 833>Settings</guimenu 834> Menu</title> 835 836<variablelist> 837<varlistentry> 838<term 839><menuchoice 840><guimenu 841>Settings</guimenu 842> <guisubmenu 843>Info Boxes</guisubmenu 844> <guimenuitem 845>Hide/Show Info Boxes</guimenuitem 846> </menuchoice 847></term> 848<listitem 849><para 850>Toggle display of all three Info Boxes </para 851></listitem> 852</varlistentry> 853 854<varlistentry> 855<term 856><menuchoice 857><guimenu 858>Settings</guimenu 859> <guisubmenu 860>Info Boxes</guisubmenu 861> <guimenuitem 862>Hide/Show Time</guimenuitem 863> </menuchoice 864></term> 865<listitem 866><para 867>Toggle display of the Time Info Box </para 868></listitem> 869</varlistentry> 870 871<varlistentry> 872<term 873><menuchoice 874><guimenu 875>Settings</guimenu 876> <guisubmenu 877>Info Boxes</guisubmenu 878> <guimenuitem 879>Hide/Show Focus</guimenuitem 880> </menuchoice 881></term> 882<listitem 883><para 884>Toggle display of the Focus Info Box </para 885></listitem> 886</varlistentry> 887 888<varlistentry> 889<term 890><menuchoice 891><guimenu 892>Settings</guimenu 893> <guisubmenu 894>Info Boxes</guisubmenu 895> <guimenuitem 896>Hide/Show Location</guimenuitem 897> </menuchoice 898></term> 899<listitem 900><para 901>Toggle display of the Location Info Box </para 902></listitem> 903</varlistentry> 904 905<varlistentry> 906<term 907><menuchoice 908><guimenu 909>Settings</guimenu 910> <guisubmenu 911>Toolbars</guisubmenu 912> <guimenuitem 913>Hide/Show Main Toolbar</guimenuitem 914> </menuchoice 915></term> 916<listitem 917><para 918>Toggle display of the Main Toolbar </para 919></listitem> 920</varlistentry> 921 922<varlistentry> 923<term 924><menuchoice 925><guimenu 926>Settings</guimenu 927> <guisubmenu 928>Toolbars</guisubmenu 929> <guimenuitem 930>Hide/Show View Toolbar</guimenuitem 931> </menuchoice 932></term> 933<listitem 934><para 935>Toggle display of the View Toolbar </para 936></listitem> 937</varlistentry> 938 939<varlistentry> 940<term 941><menuchoice 942><guimenu 943>Settings</guimenu 944> <guisubmenu 945>Statusbar</guisubmenu 946> <guimenuitem 947>Hide/Show Statusbar</guimenuitem 948> </menuchoice 949></term> 950<listitem 951><para 952>Toggle display of the Statusbar </para 953></listitem> 954</varlistentry> 955 956<varlistentry> 957<term 958><menuchoice 959><guimenu 960>Settings</guimenu 961> <guisubmenu 962>Statusbar</guisubmenu 963> <guimenuitem 964>Hide/Show Az/Alt field</guimenuitem 965> </menuchoice 966></term> 967<listitem 968><para 969>Toggle display of the mouse cursor's horizontal coordinates in the statusbar </para 970></listitem> 971</varlistentry> 972 973<varlistentry> 974<term 975><menuchoice 976><guimenu 977>Settings</guimenu 978> <guisubmenu 979>Statusbar</guisubmenu 980> <guimenuitem 981>Hide/Show RA/Dec field</guimenuitem 982> </menuchoice 983></term> 984<listitem 985><para 986>Toggle display of the mouse cursor's horizontal coordinates in the statusbar </para 987></listitem> 988</varlistentry> 989 990<varlistentry> 991<term 992><menuchoice 993><guimenu 994>Settings</guimenu 995> <guisubmenu 996>Colour Schemes</guisubmenu 997> </menuchoice 998></term> 999<listitem 1000><para 1001>This submenu contains all of the defined colour schemes, including your custom schemes. Select any item to set that colour scheme. </para 1002></listitem> 1003</varlistentry> 1004 1005<varlistentry> 1006<term 1007><menuchoice 1008><guimenu 1009>Settings</guimenu 1010> <guisubmenu 1011>FOV Symbols</guisubmenu 1012> </menuchoice 1013></term> 1014<listitem 1015><para 1016>This submenu lists the available field-of-view (FOV) Symbols. The FOV Symbol is drawn at the centre of the display. You may choose from the list of predefined symbols (No symbol, 7x35 Binoculars, One degree, or HST WFPC2), or you may define your own symbols (or modify existing symbols) using the <guimenuitem 1017>Edit FOV symbols...</guimenuitem 1018> item. </para 1019></listitem> 1020</varlistentry> 1021 1022<varlistentry> 1023<term 1024><menuchoice 1025><shortcut 1026> <keycombo action="simul" 1027>&Ctrl;<keycap 1028>G</keycap 1029></keycombo 1030> </shortcut 1031> <guimenu 1032>Settings</guimenu 1033> <guimenuitem 1034>Set Geographic Location...</guimenuitem 1035> </menuchoice 1036></term> 1037<listitem> 1038<para 1039>Select a new <link linkend="setgeo" 1040>geographic location</link 1041> </para> 1042</listitem> 1043</varlistentry> 1044 1045<varlistentry> 1046<term 1047><menuchoice 1048><guimenu 1049>Settings</guimenu 1050> <guimenuitem 1051>Configure &kstars;...</guimenuitem 1052> </menuchoice 1053></term> 1054<listitem 1055><para 1056>Modify <link linkend="config" 1057>configuration options</link 1058></para 1059></listitem> 1060</varlistentry> 1061</variablelist> 1062</sect2> 1063 1064<sect2 id="helpmenu"> 1065<title 1066><guimenu 1067>Help</guimenu 1068> Menu</title> 1069&help.menu.documentation; </sect2> 1070 1071<sect2 id="popup-menu"> 1072<title 1073>Popup Menu</title> 1074<indexterm 1075><primary 1076>Popup Menu</primary 1077><secondary 1078>Description</secondary 1079></indexterm> 1080 1081<para 1082>The <mousebutton 1083>right</mousebutton 1084> click popup menu is context-sensitive, meaning its content varies depending on what kind of object you click on. We list all possible popup menu items here, with the relevant object type [in brackets].</para> 1085 1086<variablelist> 1087<varlistentry> 1088<term 1089>[All]</term> 1090<listitem 1091><para 1092>Identification and type: The top one to three lines are devoted to the name(s) of the object and its type. For stars, the Spectral Type is also shown here. </para 1093></listitem> 1094</varlistentry> 1095 1096<varlistentry> 1097<term 1098>[All]</term> 1099<listitem 1100><para 1101>Rise, Transit and Set times for the object on the current simulation date are shown on the next three lines. </para 1102></listitem> 1103</varlistentry> 1104 1105<varlistentry> 1106<term 1107>[All]</term> 1108<listitem 1109><para 1110><guimenuitem 1111>Centre and Track</guimenuitem 1112>: Centre the display on this location, and engage tracking. Equivalent to double-clicking. </para 1113></listitem> 1114</varlistentry> 1115 1116<varlistentry> 1117<term 1118>[All]</term> 1119<listitem 1120><para 1121><guimenuitem 1122>Angular Distance To...</guimenuitem 1123>: Enter "angular distance mode". In this mode, a dotted line is drawn from the first target object to the current mouse position. When you invoke the popup menu of a second object, this item will read <guilabel 1124>Compute Angular Distance</guilabel 1125>. Selecting this item will display the angular distance between the two objects in the statusbar. You can press the <keycap 1126>Esc</keycap 1127> key to exit angular distance mode without measuring an angle. </para 1128></listitem> 1129</varlistentry> 1130 1131<varlistentry> 1132<term 1133>[All]</term> 1134<listitem 1135><para 1136><guimenuitem 1137>Details</guimenuitem 1138>: Open the <link linkend="tool-details" 1139>Object Details window</link 1140> for this object. </para 1141></listitem> 1142</varlistentry> 1143 1144<varlistentry> 1145<term 1146>[All]</term> 1147<listitem 1148><para 1149><guimenuitem 1150>Attach Label</guimenuitem 1151>: Attach a permanent name label to the object. If the object already has a label attached, this item will read <guilabel 1152>Remove Label</guilabel 1153>. </para 1154></listitem> 1155</varlistentry> 1156 1157<varlistentry> 1158<term 1159>[All]</term> 1160<listitem 1161><para 1162><guimenuitem 1163>Show ... Image</guimenuitem 1164>: download an image of the object from the internet, and display it in the Image Viewer tool. The "..." text is replaced by a short description of the image's source. An object may have multiple image links available in its popup menu. </para 1165></listitem> 1166</varlistentry> 1167 1168<varlistentry> 1169<term 1170>[All]</term> 1171<listitem 1172><para 1173><guimenuitem 1174>... Page</guimenuitem 1175>: Display a webpage about the object in your default web browser. The "..." text is replaced by a short description of the page. An object may have multiple web links available in its popup menu. </para 1176></listitem> 1177</varlistentry> 1178 1179<varlistentry> 1180<term 1181>[All Named Objects]</term> 1182<listitem 1183><para> 1184<indexterm 1185><primary 1186>Objects in the Sky</primary> 1187<secondary 1188>Internet Links</secondary> 1189<tertiary 1190>Customising</tertiary 1191></indexterm> 1192<guimenuitem 1193>Add Link...</guimenuitem 1194>: This allows you to add your own custom links to the popup menu of any object. It opens a small window in which you enter the &URL; of the link, and the text you want to appear in the popup menu. There is also a pair of radio buttons which allow you to specify whether the &URL; is an image or an <acronym 1195>HTML</acronym 1196> document, so &kstars; knows whether to launch the web browser or the image viewer. You can use this to add links to files on your local disk, so this feature could be used to attach observing logs or other custom information to objects in &kstars;. Your custom links are automatically loaded whenever &kstars; starts up, and they are stored in the folder <filename class="directory" 1197>~/.kde/share/apps/kstars/</filename 1198>, in files <filename 1199>myimage_url.dat</filename 1200> and <filename 1201>myinfo_url.dat</filename 1202>. If you build an extensive list of custom links, consider submitting them to us, we would like to include them in the next version of &kstars;! </para> 1203</listitem> 1204</varlistentry> 1205</variablelist> 1206 1207</sect2> 1208</sect1> 1209 1210<sect1 id="kstars-keys"> 1211<title 1212>Keyboard Commands</title> 1213<indexterm 1214><primary 1215>Commands</primary> 1216<secondary 1217>Keyboard</secondary 1218></indexterm> 1219 1220<sect2 id="nav-keys"> 1221<title 1222>Navigation Keys</title> 1223<indexterm 1224><primary 1225>Navigation Controls</primary> 1226<secondary 1227>Keyboard</secondary 1228></indexterm> 1229 1230<variablelist> 1231<varlistentry 1232><term 1233>Arrow Keys</term> 1234<listitem 1235><para 1236>Use the arrow keys to pan the display. Holding down the &Shift; key doubles the scrolling speed. </para 1237></listitem 1238></varlistentry> 1239 1240<varlistentry> 1241<term 1242><keycap 1243>+</keycap 1244> / <keycap 1245>-</keycap 1246></term> 1247<listitem 1248><para 1249>Zoom In/Out</para 1250></listitem> 1251</varlistentry> 1252 1253<varlistentry> 1254<term 1255><keycombo action="simul" 1256>&Ctrl;<keycap 1257>Z</keycap 1258></keycombo 1259></term> 1260<listitem 1261><para 1262>Restore the default Zoom setting</para 1263></listitem> 1264</varlistentry> 1265 1266<varlistentry> 1267<term 1268><keycombo action="simul" 1269>&Ctrl;&Shift;<keycap 1270>Z</keycap 1271></keycombo 1272></term> 1273<listitem 1274><para 1275>Zoom to specified field-of-view angle</para 1276></listitem> 1277</varlistentry> 1278 1279<varlistentry> 1280<term 1281>0–9</term> 1282<listitem 1283><para 1284>Center Display on a major Solar System body: <itemizedlist> 1285<listitem 1286><para 1287>0: Sun</para 1288></listitem> 1289<listitem 1290><para 1291>1: Mercury</para 1292></listitem> 1293<listitem 1294><para 1295>2: Venus</para 1296></listitem> 1297<listitem 1298><para 1299>3: Moon</para 1300></listitem> 1301<listitem 1302><para 1303>4: Mars</para 1304></listitem> 1305<listitem 1306><para 1307>5: Jupiter</para 1308></listitem> 1309<listitem 1310><para 1311>6: Saturn</para 1312></listitem> 1313<listitem 1314><para 1315>7: Uranus</para 1316></listitem> 1317<listitem 1318><para 1319>8: Neptune</para 1320></listitem> 1321<listitem 1322><para 1323>9: Pluto</para 1324></listitem> 1325</itemizedlist> 1326</para 1327></listitem> 1328</varlistentry> 1329 1330<varlistentry> 1331<term 1332><keycap 1333>Z</keycap 1334></term> 1335<listitem 1336><para 1337>Centre the display at the <link linkend="ai-zenith" 1338>Zenith</link 1339> Point (straight up)</para 1340></listitem> 1341</varlistentry> 1342 1343<varlistentry> 1344<term 1345><keycap 1346>N</keycap 1347></term> 1348<listitem 1349><para 1350>Centre the display above the North point on the horizon</para 1351></listitem> 1352</varlistentry> 1353 1354<varlistentry> 1355<term 1356><keycap 1357>E</keycap 1358></term> 1359<listitem 1360><para 1361>Centre the display above the East point on the horizon</para 1362></listitem> 1363</varlistentry> 1364 1365<varlistentry> 1366<term 1367><keycap 1368>S</keycap 1369></term> 1370<listitem 1371><para 1372>Centre the display above the South point on the horizon</para> 1373</listitem> 1374</varlistentry> 1375 1376<varlistentry> 1377<term 1378><keycap 1379>W</keycap 1380></term> 1381<listitem 1382><para 1383>Centre the display above the West point on the horizon</para 1384></listitem> 1385</varlistentry> 1386 1387<varlistentry> 1388<term 1389><keycombo action="simul" 1390>&Ctrl;<keycap 1391>F</keycap 1392></keycombo 1393></term> 1394<listitem 1395><para 1396>Open the <link linkend="findobjects" 1397>Find Object window</link 1398>, for specifying a sky object on which to centre</para 1399></listitem> 1400</varlistentry> 1401 1402<varlistentry 1403><term 1404><keycombo action="simul" 1405>&Ctrl;<keycap 1406>M</keycap 1407></keycombo> 1408</term> 1409<listitem 1410><para 1411>Open the <guilabel 1412>Set Manual Focus</guilabel 1413> tool, for specifying RA/Dec or Az/Alt coordinates on which to centre</para 1414></listitem> 1415</varlistentry> 1416 1417<varlistentry> 1418<term 1419><keycombo action="simul" 1420>&Ctrl;<keycap 1421>T</keycap 1422></keycombo 1423></term> 1424<listitem 1425><para 1426>Toggle tracking mode</para 1427></listitem> 1428</varlistentry> 1429 1430<varlistentry> 1431<term 1432><keycap 1433><</keycap 1434></term> 1435<listitem 1436><para 1437>Advance the simulation clock backwards by one time step</para> 1438</listitem> 1439</varlistentry> 1440 1441<varlistentry> 1442<term 1443><keycap 1444>></keycap 1445></term> 1446<listitem 1447><para 1448>Advance the simulation clock forwards by one time step</para> 1449</listitem> 1450</varlistentry> 1451 1452</variablelist> 1453 1454</sect2> 1455 1456<sect2 id="menu-keys"> 1457<title 1458>Menu Shortcuts</title> 1459 1460<variablelist> 1461<varlistentry> 1462<term 1463><keycombo action="simul" 1464>&Ctrl;<keycap 1465>N</keycap 1466></keycombo 1467></term> 1468<listitem 1469><para 1470>Open a new &kstars; window</para 1471></listitem> 1472</varlistentry> 1473 1474<varlistentry> 1475<term 1476><keycombo action="simul" 1477>&Ctrl;<keycap 1478>W</keycap 1479></keycombo 1480></term> 1481<listitem 1482><para 1483>Close a &kstars; window</para 1484></listitem> 1485</varlistentry> 1486 1487<varlistentry> 1488<term 1489><keycombo action="simul" 1490>&Ctrl;<keycap 1491>D</keycap 1492></keycombo 1493></term> 1494<listitem 1495><para 1496>Download extra data</para 1497></listitem> 1498</varlistentry> 1499 1500<varlistentry> 1501<term 1502><keycombo action="simul" 1503>&Ctrl;<keycap 1504>O</keycap 1505></keycombo 1506></term> 1507<listitem 1508><para 1509>Open a FITS image in the FITS Editor</para 1510></listitem> 1511</varlistentry> 1512 1513<varlistentry> 1514<term 1515><keycombo action="simul" 1516>&Ctrl;<keycap 1517>I</keycap 1518></keycombo 1519></term> 1520<listitem 1521><para 1522>Export sky image to a file</para 1523></listitem> 1524</varlistentry> 1525 1526<varlistentry> 1527<term 1528><keycombo action="simul" 1529>&Ctrl;<keycap 1530>R</keycap 1531></keycombo 1532></term> 1533<listitem 1534><para 1535>Run a &kstars; DCOP script</para 1536></listitem> 1537</varlistentry> 1538 1539<varlistentry> 1540<term 1541><keycombo action="simul" 1542>&Ctrl;<keycap 1543>P</keycap 1544></keycombo 1545></term> 1546<listitem 1547><para 1548>Print the current sky map</para 1549></listitem> 1550</varlistentry> 1551 1552<varlistentry> 1553<term 1554><keycombo action="simul" 1555>&Ctrl;<keycap 1556>Q</keycap 1557></keycombo 1558></term> 1559<listitem 1560><para 1561>Quit &kstars;</para 1562></listitem> 1563</varlistentry> 1564 1565<varlistentry> 1566<term 1567><keycombo action="simul" 1568>&Ctrl;<keycap 1569>E</keycap 1570></keycombo 1571></term> 1572<listitem 1573><para 1574>Sync the simulation clock with the current system time</para 1575></listitem> 1576</varlistentry> 1577 1578<varlistentry> 1579<term 1580><keycombo action="simul" 1581>&Ctrl;<keycap 1582>S</keycap 1583></keycombo 1584></term> 1585<listitem 1586><para 1587>Set the simulation clock to a specified Time and Date</para 1588></listitem> 1589</varlistentry> 1590 1591<varlistentry> 1592<term 1593><keycombo action="simul" 1594>&Ctrl;&Shift;<keycap 1595>F</keycap 1596></keycombo 1597></term> 1598<listitem 1599><para 1600>Toggle full-screen mode</para 1601></listitem> 1602</varlistentry> 1603 1604<varlistentry 1605><term 1606><keycap 1607>Space</keycap 1608></term> 1609<listitem 1610><para 1611>Toggle between the <link linkend="horizontal" 1612>Horizontal</link 1613> and <link linkend="equatorial" 1614>Equatorial</link 1615> <link linkend="ai-skycoords" 1616>Coordinate Systems</link 1617> </para 1618></listitem 1619></varlistentry> 1620 1621<varlistentry> 1622<term 1623><keycap 1624>F1</keycap 1625></term> 1626<listitem 1627><para 1628>Open the &kstars; Handbook</para 1629></listitem> 1630</varlistentry> 1631</variablelist> 1632</sect2> 1633 1634<sect2 id="tools-keys"> 1635<title 1636>Opening Tools</title> 1637 1638<variablelist> 1639<varlistentry> 1640<term 1641><keycombo action="simul" 1642>&Ctrl;<keycap 1643>G</keycap 1644></keycombo 1645></term> 1646<listitem 1647><para 1648>Open the <link linkend="setgeo" 1649>Set Geographic Location</link 1650> window</para 1651></listitem> 1652</varlistentry> 1653 1654<varlistentry> 1655<term 1656><keycombo action="simul" 1657>&Ctrl;<keycap 1658>C</keycap 1659></keycombo 1660></term> 1661<listitem 1662><para 1663>Open the <link linkend="tool-calculator" 1664>AstroCalculator</link 1665> </para 1666></listitem> 1667</varlistentry> 1668 1669<varlistentry> 1670<term 1671><keycombo action="simul" 1672>&Ctrl;<keycap 1673>V</keycap 1674></keycombo 1675></term> 1676<listitem 1677><para 1678>Open the <link linkend="tool-aavso" 1679>AAVSO Lightcurve Generator</link 1680></para 1681></listitem> 1682</varlistentry> 1683 1684<varlistentry> 1685<term 1686><keycombo action="simul" 1687>&Ctrl;<keycap 1688>A</keycap 1689></keycombo 1690></term> 1691<listitem 1692><para 1693>Open the <link linkend="tool-altvstime" 1694>Altitude vs. Time</link 1695> tool</para 1696></listitem> 1697</varlistentry> 1698 1699<varlistentry> 1700<term 1701><keycombo action="simul" 1702>&Ctrl;<keycap 1703>U</keycap 1704></keycombo 1705></term> 1706<listitem 1707><para 1708>Open the <link linkend="tool-whatsup" 1709>What's Up Tonight?</link 1710> tool </para 1711></listitem> 1712</varlistentry> 1713 1714<varlistentry> 1715<term 1716><keycombo action="simul" 1717>&Ctrl;<keycap 1718>B</keycap 1719></keycombo 1720></term> 1721<listitem 1722><para 1723>Open the <link linkend="tool-scriptbuilder" 1724>Script Builder</link 1725> tool</para 1726></listitem> 1727</varlistentry> 1728 1729<varlistentry> 1730<term 1731><keycombo action="simul" 1732>&Ctrl;<keycap 1733>Y</keycap 1734></keycombo 1735></term> 1736<listitem 1737><para 1738>Open the <link linkend="tool-solarsys" 1739>Solar System Viewer</link 1740> </para 1741></listitem> 1742</varlistentry> 1743 1744<varlistentry> 1745<term 1746><keycombo action="simul" 1747>&Ctrl;<keycap 1748>J</keycap 1749></keycombo 1750></term> 1751<listitem 1752><para 1753>Open the <link linkend="tool-jmoons" 1754>Jupiter Moons</link 1755> tool</para 1756></listitem> 1757</varlistentry> 1758 1759</variablelist> 1760</sect2> 1761</sect1> 1762 1763<sect1 id="kstars-mouse"> 1764<title 1765>Mouse Commands</title> 1766<indexterm 1767><primary 1768>Commands</primary> 1769<secondary 1770>Mouse</secondary 1771></indexterm> 1772<indexterm 1773><primary 1774>Navigation Controls</primary> 1775<secondary 1776>Mouse</secondary 1777></indexterm> 1778 1779<variablelist> 1780<varlistentry 1781><term 1782>Moving the mouse</term> 1783<listitem 1784><para 1785>The sky coordinates (RA/Dec and Az/Alt) of the mouse cursor are updated in the status bar </para 1786></listitem> 1787</varlistentry> 1788 1789<varlistentry 1790><term 1791>"Hovering" the mouse</term> 1792<listitem 1793><para 1794>A temporary name label is attached to the object nearest to the mouse cursor. </para 1795></listitem> 1796</varlistentry> 1797 1798<varlistentry 1799><term 1800>Left-clicking</term> 1801<listitem> 1802<para> 1803<indexterm 1804><primary 1805>Objects in the Sky</primary> 1806<secondary 1807>Identifying</secondary 1808></indexterm> 1809The object nearest the mouse click is identified in the status bar. </para 1810></listitem> 1811</varlistentry> 1812 1813<varlistentry 1814><term 1815>Double-clicking</term> 1816<listitem> 1817<para> 1818<indexterm 1819><primary 1820>Objects in the Sky</primary> 1821<secondary 1822>Centring</secondary 1823></indexterm> 1824Centre and track on the location or object nearest the mouse click. Double-clicking on an Info Box will <quote 1825>shade</quote 1826> it to show/hide extra information. </para 1827></listitem> 1828</varlistentry> 1829 1830<varlistentry 1831><term 1832>Right-clicking</term> 1833<listitem> 1834<para> 1835<indexterm 1836><primary 1837>Objects in the Sky</primary> 1838<secondary 1839>Invoking Popup Menu for</secondary 1840></indexterm> 1841Open the <link linkend="popup-menu" 1842>popup menu</link 1843> for the location or object nearest the mouse cursor. </para 1844></listitem> 1845</varlistentry> 1846 1847<varlistentry 1848><term 1849>Scrolling the mouse wheel</term> 1850<listitem 1851><para 1852>Zoom the display in or out. If you do not have a mouse wheel, you can hold the middle mouse button and drag vertically. </para 1853></listitem> 1854</varlistentry> 1855 1856<varlistentry 1857><term 1858>Click-and-dragging</term> 1859<listitem 1860><para> 1861 <variablelist> 1862 <varlistentry 1863><term 1864>Dragging the sky map</term> 1865 <listitem 1866><para 1867>Pan the display, following the drag motion. </para 1868></listitem 1869></varlistentry> 1870 <varlistentry 1871><term 1872>&Ctrl;+dragging the sky map</term> 1873 <listitem 1874><para 1875>Define a rectangle in the map. When the mouse button is released, the display is zoomed in to match the field-of-view to the bounds of the rectangle. </para 1876></listitem 1877></varlistentry> 1878 <varlistentry 1879><term 1880>Dragging an Info Box</term> 1881 <listitem 1882><para 1883>The Info Box is repositioned in the map. Info Boxes will <quote 1884>stick</quote 1885> to window edges, so that they remain on the edge when the window is resized. </para 1886></listitem 1887></varlistentry> 1888 </variablelist> 1889</para 1890></listitem> 1891</varlistentry> 1892</variablelist> 1893 1894</sect1> 1895</chapter> 1896