From 4fda0f5a6b633c4dcdc6c18cbedd980f17cf1184 Mon Sep 17 00:00:00 2001 From: Raphael Cojocaru Date: Mon, 11 Jul 2016 20:06:03 +0300 Subject: [PATCH] Add documentation for Popup Menu --- doc/commands.docbook | 128 +++++++++++++++++++++++++++++++++---------- 1 file changed, 100 insertions(+), 28 deletions(-) diff --git a/doc/commands.docbook b/doc/commands.docbook index c90be0b53..011064a0a 100644 --- a/doc/commands.docbook +++ b/doc/commands.docbook @@ -880,7 +880,8 @@ If you want to modify a point's coordinates, just double click on its Az/Alt tex the new value. First and Last points must be on the horizon. Polygons must be closed to be considered valid regions. Artificial Horizon Manager provides a easy way to rename your regions. By default, regions are -named as: Region plus an index (&ie; Region 1 or Region 2). For renaming a region, all you need +named as: Region plus an index (&ie; Region 1 or Region 2). +For renaming a region, all you need to do is to double click on its name and then you will be invited to complete a new region name. You can also control which regions are enabled or disabled for marking on the map by a simple click on the checkbox in front of each region. After you defined your desired regions you can apply @@ -1043,6 +1044,28 @@ on this location, and engage tracking. Equivalent to double-clicking. + +[All] + +Add flag...: Open &kstars; Flag manager window. +Here you can manage your flags and use some of &kstars; features. When Flag manager +window is open for a selected object, Right ascension and +Declination text boxes will be automatically filled with the coordinate values +of the selected object on the Sky Map. Besides these two text boxes, you can set the +Epoch, add a Label, set the Label color +or even add an Icon. To add custom icons, just add images in /home/user_name/ +.local/share/kstars/. File names must begin with the flag keyword. For example, +the file flagSmall_red_cross.gif will be shown as Small red cross in the combo box. After +you set up the information of the new flag, you can add it to the flags list using the +Add button. You may also change flags details (&ie; RA/Dec, label or icon) and +then save the new ones by pressing the Save changes button. Using the Flag manager, +you can easily center an object in Map or in Telescope, by pressing Center in Map +or Center in Telescope button. In order to delete a value from the list, just +select it in the list and then press Delete button. Your flags are saved after you +close current session and thus you will be able to see them everytime you will use &kstars; again. + + + [All] @@ -1055,7 +1078,30 @@ exit angular distance mode without measuring an angle. - + + +[All] + +Starhop from here to: will enable you to find a path between two points in +the sky. Star hopping is a technique that uses bright stars as a quide for finding fainter objects. So if +you have a bright star, you can use it as a reference to find a fainter object. Starting from your reference +star, &kstars; will find a route to the destination, traversing a sequence of stars/patterns of stars. The +object for which you called Starhop from here to tool will be your starting point. When +your starting point is established, a dotted line will appear, allowing you to decide which will be your +end point. You have to move the mouse cursor to your destination object position and right click on it. +Then, a dialog box will pop up, requiring you to set the FOV used for star hopping. For selecting a FOV, +you need to make a choice from the FOV combo box list of values. The values you can choose include +default FOV values (7x35 Binoculars, Telrad, One Degree, HST WFPC2 and 30m at 1.3cm) plus your customized +FOVs. After you selected the FOV, &kstars; will find a route for you. Thus, the dialog box will contain a +list of object used in the starhop. If &kstars; did not manage to find a route, then an error dialog box +will be displayed, giving you a helping hand. When the Star-Hopper algorithm ends, the dialog box will +contain a list of objects used in starhop route. For every object from the list, you can perform a set of +actions: you can ask for details using the Details button, center selected object in +the map using Center on map button or you can go to next star by pressing the +Next button. Note that when go to next star, it will be automatically centered on +the map. Also, Star-Hopper tool provides directions to star hop for every object of the list. + + [All] @@ -1073,29 +1119,57 @@ 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. +Add to Observing WishList: Add the selected object to +Observation Planner's Wish List. You can see the Wish List, by selecting +ObservationObservation Planner. +If the object is already in the Observing WishList, then this item will become +Remove Label. -[All] +[Solar system objects] + +Add Trail: Add a trail to current Solar system object. A star trail is the +continuous path created by the star in the night sky due to the rotation of the Earth. +If the object already has a trail, this item will become Remove Trail. + + + + +[Solar system objects] -... 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. +Image Resources: gives a list of image links for current Solar system object. The images +are displayed in &kstars; Image Viewer tool. Image Viewer tool allows you to invert the colors and save the image +in your computer. + + + + +[Solar system objects] + +Information Resources: gives a list of documentation links for current Solar system object. +The links are opened in your default browser. + + + + +[All objects without Solar system objects] + +Show SDSS Image: download a SDSS (Sloan Digital Sky Survey) image of the object from the +Internet, and display it in the Image Viewer tool. + + + + +[All objects without Solar system objects] + +Show DSS Image: download a DSS (Digitized Sky Survey) image of the object from the +Internet, and display it in the Image Viewer tool. @@ -1216,11 +1290,11 @@ Point (straight up) &Ctrl;W -Close a &kstars; window +Close a f window --> -&Ctrl;D +&Ctrl;N Download extra data @@ -1403,13 +1477,7 @@ window Open the AstroCalculator - + &Ctrl;A Open the Altitude vs. Time @@ -1460,8 +1528,12 @@ tool Moving the mouse -The sky coordinates (RA/Dec and Az/Alt) of the mouse cursor are updated -in the status bar +The sky coordinates (Az/Alt, RA/Dec and J2000.0 RA/Dec) of the mouse cursor are updated +in the status bar. The status bar is located in the right bottom corner of the screen. +The status bar can be customized by selecting Settings +Statusbar submenu. Here you may choose what coordinates +systems &kstars; will display in the status bar. Furthermore, you can hide the status bar by +unchecking the Show Statusbar checkbox. -- GitLab