From ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kstars/commands.docbook | 1192 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1192 insertions(+) create mode 100644 doc/kstars/commands.docbook (limited to 'doc/kstars/commands.docbook') diff --git a/doc/kstars/commands.docbook b/doc/kstars/commands.docbook new file mode 100644 index 00000000..0efacac9 --- /dev/null +++ b/doc/kstars/commands.docbook @@ -0,0 +1,1192 @@ + +Command Reference + + +Menu Commands +CommandsMenu + + +<guimenu>File</guimenu> Menu + + + + + +&Ctrl;N + +File +New Window + +Open another &kstars; window + + + + + + +&Ctrl;W + +File +Close Window + +Close &kstars; window + + + + + + +&Ctrl;D + +File +Download Data... + +Open the Download Extra Data tool + + + + + + +&Ctrl;O + +File +Open FITS... + +Open a FITS image in the FITS Editor tool + + + + + + +&Ctrl;I + +File +Save Sky Image... + +Create image on disk from current display + + + + + + +&Ctrl;R + +File +Run Script... + +Run the specified KStars script + + + + + + +&Ctrl;P + +File +Print... + +Send the current sky map to the printer (or to a +PostScript/PDF file) + + + + + + +&Ctrl;Q + +File +Quit + +Quit &kstars; + + + + + + + +<guimenu>Time</guimenu> Menu + + + + + +&Ctrl;E + +Time +Set Time to Now + +Sync time to system clock + + + + + +&Ctrl;S + +Time +Set Time... + +Set time and date + + + + +Time +Start/Stop Clock + +Toggle whether time passes + + + + + + +<guimenu>Pointing</guimenu> Menu + + + + + +Z + +Pointing +Zenith + +Center the display at the +Zenith point (straight up) + + + + + + +N + +Pointing +North + +Center the display above the North point on the +horizon + + + + + +E + +Pointing +East + +Center the display above the East point on the +horizon + + + + + +S + +Pointing +South + +Center the display above the South point on the +horizon + + + + + +W + +Pointing +West + +Center the display above the West point on the +horizon + + + + + +&Ctrl;M + +Pointing +Set Focus Manually... + +Center the display on specific +sky coordinates + + + + + + +&Ctrl;F + +Pointing +Find Object + +Locate an object by name using the +Find Object Window + + + + + +&Ctrl;T + +Pointing +Engage/Stop Tracking + +Toggle tracking on/off. While tracking, +the display will remain centered on the current position or +object. + + + + + + +<guimenu>View</guimenu> Menu + + + + + ++ + +View +Zoom in + +Zooms view in + + + + + +- + +View +Zoom out + +Zooms view out + + + + + +&Ctrl;Z + +View +Default Zoom + +Restore the default Zoom setting + + + + + +&Ctrl;&Shift;Z + +View +Zoom to Angular Size... + +Zoom to specified field-of-view angle + + + + + +&Ctrl;&Shift;F + +View +Full Screen Mode + +Toggle full-screen mode + + + + + +Space + +View +Horizontal/Equatorial Coordinates + +Toggle between the +Horizontal and +Equatorial +Coordinate Systems + + + + + +<guimenu>Devices</guimenu> Menu + + + + + +Devices +Telescope Wizard... + +Opens the Telescope Wizard, which +provides a step-by-step guide to help you connect to your telescope and +control it with &kstars;. + + + + +Devices +Device Manager + +Opens up the device manager, which allows you to start/shutdown device drivers and connect to remote INDI servers. + + + + +Devices +INDI Control Panel + +Opens up INDI Control Panel, which allows you to control all the features supported by a device. + + + + +Devices +Capture Image Sequence... + +Acquire images from a CCD camera or webcam device + + + + +Devices +Configure INDI + +Opens up a dialog to configure INDI-related features such as automatic device updates. + + + + + + +<guimenu>Tools</guimenu> Menu + + + + + +&Ctrl;C + +Tools +Calculator... + + + +Opens the AstroCalculator Tool, +which provides full access to many of the mathematical functions used by +&kstars;. + + + + + + + +&Ctrl;L + +Tools +Observing List... + + +Opens the Observing List +Tool, which provide convenient access to some common functions for a list of +objects chosen by you. + + + + + + +&Ctrl;V + +Tools +AAVSO Light Curves... + + + +Opens the AAVSO Light Curve Generator +Tool, which allows you to download a light curve for any variable +star from the American Association of Variable Star Observers. + + + + + + + +&Ctrl;A + +Tools +Altitude vs. Time... + + + +Opens the Altitude vs. Time Tool, which +can plot curves representing the altitude of any object as a +function of time. This is useful for planning observing +sessions. + + + + + + + +&Ctrl;U + +Tools +What's Up Tonight... + + + +Opens the What's Up Tonight Tool, +which presents a summary of the objects which are observable +from your location on a given date. + + + + + + + +&Ctrl;B + +Tools +Script Builder... + + + +Opens the Script Builder Tool, +which provides a GUI interface for building &kstars; DCOP scripts. + + + + + + + +&Ctrl;Y + +Tools +Solar System... + + + +Opens the Solar System Viewer, +which displays an overhead view of the solar system on the +current simulation date. + + + + + + + +&Ctrl;J + +Tools +Jupiter's Moons... + + + +Opens the Jupiter Moons Tool, +which displays the positions of Jupiter's four brightest +moons as a function of time. + + + + + + + + +<guimenu>Settings</guimenu> Menu + + + + +Settings +Info Boxes +Hide/Show Info Boxes + +Toggle display of all three Info Boxes + + + + + +Settings +Info Boxes +Hide/Show Time + +Toggle display of the Time Info Box + + + + + +Settings +Info Boxes +Hide/Show Focus + +Toggle display of the Focus Info Box + + + + + +Settings +Info Boxes +Hide/Show Location + +Toggle display of the Location Info Box + + + + + +Settings +Toolbars +Hide/Show Main Toolbar + +Toggle display of the Main Toolbar + + + + + +Settings +Toolbars +Hide/Show View Toolbar + +Toggle display of the View Toolbar + + + + + +Settings +Statusbar +Hide/Show Statusbar + +Toggle display of the Statusbar + + + + + +Settings +Statusbar +Hide/Show Az/Alt field + +Toggle display of the mouse cursor's horizontal +coordinates in the statusbar + + + + + +Settings +Statusbar +Hide/Show RA/Dec field + +Toggle display of the mouse cursor's horizontal +coordinates in the statusbar + + + + + +Settings +Color Schemes + + +This submenu contains all of the defined color schemes, including your +custom schemes. Select any item to set that color scheme. + + + + + +Settings +FOV Symbols + + +This submenu lists the available field-of-view (FOV) Symbols. +The FOV Symbol is drawn at the center of the display. You +may choose from the list of predefined symbols (No symbol, +7x35 Binoculars, One degree, HST WFPC2 or 30m at 1.3cm), or you may define +your own symbols (or modify existing symbols) using the +Edit FOV symbols... item. + + + + + + +&Ctrl;G + +Settings +Geographic... + + + +Select a new geographic +location + + + + + + +Settings +Configure &kstars;... + +Modify configuration +options + + + + +Settings +Startup Wizard... + +Opens the Setup Wizard, +which allows you to easily set your geographic location and download some +extra data files. + + + + + + + +<guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + +Popup Menu +Popup MenuDescription + + +The right 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]. + + + +[All] + +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. + + + + +[All] + +Rise, Transit, and Set times for the object on the current simulation +date are shown on the next three lines. + + + + +[All] + +Center and Track: Center the display +on this location, and engage tracking. Equivalent to double-clicking. + + + + +[All] + +Angular Distance To...: 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 Compute Angular Distance. +Selecting this item will display the angular distance between the two +objects in the statusbar. You can press the Esc key to +exit angular distance mode without measuring an angle. + + + + +[All] + +Details: Open the +Object Details window for this object. + + + + +[All] + +Attach Label: Attach a permanent name label +to the object. If the object already has a label attached, this item +will read Remove Label. + + + + +[All] + +Show ... Image: 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. + + + + +[All] + +... Page: 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. + + + + +[All Named Objects] + +Objects in the Sky +Internet Links +Customizing +Add Link...: 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 +HTML 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 ~/.kde/share/apps/kstars/, in files +myimage_url.dat and +myinfo_url.dat. 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;! + + + + + + + + + +Keyboard Commands +Commands +Keyboard + + +Navigation Keys +Navigation Controls +Keyboard + + +Arrow Keys + +Use the arrow keys to pan the display. Holding down the &Shift; +key doubles the scrolling speed. + + + ++ / - +Zoom In/Out + + + +&Ctrl;Z +Restore the default Zoom setting + + + +&Ctrl;&Shift;Z +Zoom to specified field-of-view angle + + + +0–9 +Center Display on a major Solar System body: + +0: Sun +1: Mercury +2: Venus +3: Moon +4: Mars +5: Jupiter +6: Saturn +7: Uranus +8: Neptune +9: Pluto + + + + + +Z +Center the display at the Zenith +Point (straight up) + + + +N +Center the display above the North point on the horizon + + + +E +Center the display above the East point on the horizon + + + +S +Center the display above the South point on the horizon + + + + +W +Center the display above the West point on the horizon + + + +&Ctrl;T +Toggle tracking mode + + + +< +Advance the simulation clock backwards by one time step + + + + +> +Advance the simulation clock forwards by one time step + + + + + + + +Menu Shortcuts +Commands +Menu +Keyboard Shortcuts + + + + +&Ctrl;N +Open a new &kstars; window + + + +&Ctrl;W +Close a &kstars; window + + + +&Ctrl;D +Download extra data + + + +&Ctrl;O +Open a FITS image in the FITS Editor + + + +&Ctrl;I +Export sky image to a file + + + +&Ctrl;R +Run a &kstars; DCOP script + + + +&Ctrl;P +Print the current sky map + + + +&Ctrl;Q +Quit &kstars; + + + +&Ctrl;E +Sync the simulation clock with the current system time + + + +&Ctrl;S +Set the simulation clock to a specified Time and Date + + + +&Ctrl;&Shift;F +Toggle full-screen mode + + +Space +Toggle between the +Horizontal and +Equatorial +Coordinate Systems + + + +F1 +Open the &kstars; Handbook + + + + + + +Actions for the Selected Object +Objects in the Sky +Keyboard Actions + +Each of the following keystrokes performs an action on the +selected object. The selected object is the last +object which was clicked on (identified in the status bar). Alternatively, +if you hold down the Shift key, then the action is +performed on the centered object instead. + + + + +D +Open the Details window for the selected object + + + +L +Toggle a name label for the selected object + + + +O +Add the selected object to the observing list + + + +P +Open the selected object's popup menu + + + +T +Toggle a trail on the selected object (solar system bodies only) + + + + + + +Tools Shortcuts + + + +&Ctrl;F +Open the Find Object window, +for specifying a sky object on which to center + + +&Ctrl;M + +Open the Set Focus Manually... tool, +for specifying RA/Dec or Az/Alt coordinates on which to center + + + +[ / ] +Start/End an Angular Distance measurement at the current mouse +cursor position. The angular distance between start and end points is displayed +in the statusbar. + + + +&Ctrl;G +Open the Set Geographic Location +window + + + +&Ctrl;C +Open the AstroCalculator + + + + +&Ctrl;V +Open the AAVSO Lightcurve Generator + + + + +&Ctrl;A +Open the Altitude vs. Time +tool + + + +&Ctrl;U +Open the What's Up Tonight? +tool + + + +&Ctrl;B +Open the Script Builder +tool + + + +&Ctrl;Y +Open the Solar System Viewer + + + + +&Ctrl;J +Open the Jupiter Moons +tool + + + +&Ctrl;L +Open the Observing List +tool + + + + + + + +Mouse Commands +Commands +Mouse +Navigation Controls +Mouse + + +Moving the mouse + +The sky coordinates (RA/Dec and Az/Alt) of the mouse cursor are updated +in the status bar + + + +"Hovering" the mouse + +A temporary name label is attached to the object nearest to the mouse cursor. + + + +Left-clicking + + +Objects in the Sky +Identifying +The object nearest the mouse click is identified in the +status bar. + + + +Double-clicking + + +Objects in the Sky +Centering +Center and track on the location or object +nearest the mouse click. Double-clicking on an Info Box will +shade it to show/hide extra information. + + + +Right-clicking + + +Objects in the Sky +Invoking Popup Menu for +Open the popup menu for the +location or object nearest the mouse cursor. + + + +Scrolling the mouse wheel +Zoom the display in or out. If you do not +have a mouse wheel, you can hold the middle mouse button and +drag vertically. + + + +Click-and-dragging + + + Dragging the sky map + Pan the display, following the drag motion. + + + &Ctrl;+dragging the sky map + 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. + + + Dragging an Info Box + The Info Box is repositioned in the map. Info + Boxes will stick to window edges, so that they + remain on the edge when the window is resized. + + + + + + + + -- cgit v1.2.1