(→View Menu) |
(→List of expected behaviors for KStars 4.6.) |
||
(60 intermediate revisions by the same user not shown) | |||
Line 14: | Line 14: | ||
=== Mouse Navigation === | === Mouse Navigation === | ||
− | * <font color="#00AA00">Moving the mouse shows the current sky coordinates of the mouse in the statusbar.</font> | + | * <font color="#00AA00">Moving the mouse shows the current sky coordinates of the mouse in the statusbar.</font> |
* <font color="#00AA00">Clicking the mouse identifies the nearest object in the statusbar; the object's "long name" is shown </font> | * <font color="#00AA00">Clicking the mouse identifies the nearest object in the statusbar; the object's "long name" is shown </font> | ||
* <font color="#00AA00">Hovering the mouse attaches a temporary label to the nearest object.</font> | * <font color="#00AA00">Hovering the mouse attaches a temporary label to the nearest object.</font> | ||
* <font color="#00AA00">Hover labels fade out when the mouse moves</font> | * <font color="#00AA00">Hover labels fade out when the mouse moves</font> | ||
* <font color="#00AA00">Hover labels only appear when the map is not in motion</font> | * <font color="#00AA00">Hover labels only appear when the map is not in motion</font> | ||
− | * <font color="#00AA00">Double-clicking attaches a label to the nearest object, centers it in the display, and engages tracking. </font> | + | * <font color="#00AA00">Double-clicking attaches a label to the nearest object, centers it in the display, and engages tracking. </font> |
* <font color="#00AA00">The double-click label is removed when the object is no longer centered</font> | * <font color="#00AA00">The double-click label is removed when the object is no longer centered</font> | ||
− | * <font color="#00AA00">Click-and-drag moves the map such that the cursor remains roughly in the same place in the sky. | + | * <font color="#00AA00">Click-and-drag moves the map such that the cursor remains roughly in the same place in the sky.</font> |
* <font color="#00AA00">Dragging the sky disengages tracking</font> | * <font color="#00AA00">Dragging the sky disengages tracking</font> | ||
* <font color="#00AA00">Dragging the sky to one of the poles does not cause odd behavior</font> | * <font color="#00AA00">Dragging the sky to one of the poles does not cause odd behavior</font> | ||
Line 28: | Line 28: | ||
* <font color="#00AA00">Scrolling the mouse wheel zooms in and out.</font> | * <font color="#00AA00">Scrolling the mouse wheel zooms in and out.</font> | ||
* <font color="#00AA00">Scrolling the mouse wheel while holding down Shift / Ctrl decreases the amount of zooming in / out.</font> | * <font color="#00AA00">Scrolling the mouse wheel while holding down Shift / Ctrl decreases the amount of zooming in / out.</font> | ||
− | * <font color="#00AA00">Right-click opens a context-sensitive popup menu for the object nearest the mouse cursor.</font> | + | * <font color="#00AA00">Right-click opens a context-sensitive popup menu for the object nearest the mouse cursor.</font> |
=== Keyboard commands === | === Keyboard commands === | ||
Line 34: | Line 34: | ||
* <font color="#00AA00">Arrow keys: scroll the display. Holding Shift increases the speed</font> | * <font color="#00AA00">Arrow keys: scroll the display. Holding Shift increases the speed</font> | ||
* <font color="#00AA00">[0-9] center on a major solar system body (0 is the sun, 3 is the moon; the rest are planets in order from Mercury to Pluto)</font> | * <font color="#00AA00">[0-9] center on a major solar system body (0 is the sun, 3 is the moon; the rest are planets in order from Mercury to Pluto)</font> | ||
− | * <font color="#00AA00">[<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already)</font> | + | * <font color="#00AA00">[<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already)</font> |
==== Object Actions: ==== | ==== Object Actions: ==== | ||
Line 56: | Line 56: | ||
==== Time Menu ==== | ==== Time Menu ==== | ||
− | * <font color="#CCCC00">Set time to now [Ctrl+E] </font> | + | * <font color="#CCCC00">Set time to now [Ctrl+E] </font> |
* <font color="#00AA00">Set time [Ctrl+S] </font> | * <font color="#00AA00">Set time [Ctrl+S] </font> | ||
* <font color="#00AA00">Start/Stop clock</font> | * <font color="#00AA00">Start/Stop clock</font> | ||
Line 75: | Line 75: | ||
* <font color="#00AA00">ZPressing Ctrl+- or Ctrl++ while holding down Shift / Ctrl decreases the amount of zooming in / out.</font> | * <font color="#00AA00">ZPressing Ctrl+- or Ctrl++ while holding down Shift / Ctrl decreases the amount of zooming in / out.</font> | ||
* <font color="#00AA00">Default zoom [Ctrl+Z]</font> | * <font color="#00AA00">Default zoom [Ctrl+Z]</font> | ||
− | * <font color="#00AA00">Zoom to angular size [Ctrl+Shift+Z]</font> | + | * <font color="#00AA00">Zoom to angular size [Ctrl+Shift+Z]</font> |
* <font color="#00AA00">Full-screen mode [Ctrl+Shift+F]</font> | * <font color="#00AA00">Full-screen mode [Ctrl+Shift+F]</font> | ||
* <font color="#00AA00">Horizontal/Equatorial Coordinates [Space]</font> | * <font color="#00AA00">Horizontal/Equatorial Coordinates [Space]</font> | ||
Line 85: | Line 85: | ||
===== Telescope wizard ===== | ===== Telescope wizard ===== | ||
− | * Help button displays KStars hand book. | + | * <font color="#00AA00">Help button displays KStars hand book.</font> |
− | * Next/Back buttons work. | + | * <font color="#00AA00">Next/Back buttons work.</font> |
* Listed telescopes reflect system + user added telescopes. | * Listed telescopes reflect system + user added telescopes. | ||
− | * Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates. | + | * <font color="#00AA00">Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates.</font> |
* Setting port name initiate a scan for that specific port, whereas leaving the port empty initiates a complete auto port scan. Both actions can be canceled at any time. | * Setting port name initiate a scan for that specific port, whereas leaving the port empty initiates a complete auto port scan. Both actions can be canceled at any time. | ||
* Automatic port scan. | * Automatic port scan. | ||
===== Telescope properties ===== | ===== Telescope properties ===== | ||
− | * Telescope list reflect system & user added telescope. | + | * <font color="#00AA00">Telescope list reflect system & user added telescope.</font> |
− | * Selecting a telescope update all property fields. | + | * <font color="#00AA00">Selecting a telescope update all property fields.</font> |
− | * Removing a telescope shows a confirmation box. | + | * <font color="#00AA00">Removing a telescope shows a confirmation box.</font> |
− | * Saving updated properties works. | + | * <font color="#00AA00">Saving updated properties works.</font> |
===== Device manager ===== | ===== Device manager ===== | ||
Line 107: | Line 107: | ||
==== Tools Menu (test opening tools only here) ==== | ==== Tools Menu (test opening tools only here) ==== | ||
− | * Calculator [Ctrl+C] | + | * <font color="#00AA00">Calculator [Ctrl+C]</font> |
− | * Observing List [Ctrl+L] | + | * <font color="#00AA00">Observing List [Ctrl+L]</font> |
− | * AAVSO Light Curves [Ctrl+V] | + | * <font color="#00AA00">AAVSO Light Curves [Ctrl+V]</font> |
− | * Altitude vs. Time [Ctrl+A] | + | * <font color="#00AA00">Altitude vs. Time [Ctrl+A]</font> |
− | * What's Up Tonight [Ctrl+U] | + | * <font color="#00AA00">What's Up Tonight [Ctrl+U]</font> |
* Glossary [Ctrl+K] <<disabled>> | * Glossary [Ctrl+K] <<disabled>> | ||
− | * Script Builder [Ctrl+B] | + | * <font color="#00AA00">Script Builder [Ctrl+B]</font> |
− | * Solar System [Ctrl+Y] | + | * <font color="#00AA00">Solar System [Ctrl+Y]</font> |
− | * | + | * J<font color="#00AA00">upiter's Moons [Ctrl+J]</font> |
==== Settings Menu ==== | ==== Settings Menu ==== | ||
− | * <font color="# | + | * <font color="#00AA00">Infoboxes Display toggles</font> |
− | * <font color="# | + | * <font color="#00AA00">Toolbar display toggles</font> |
− | * <font color="# | + | * <font color="#00AA00">Toolbar customization</font> |
− | * <font color="#000000">Statusbar display toggles</font> | + | * <font color="#000000">Statusbar display toggles</font> |
− | * <font color="# | + | * <font color="#00AA00">Color scheme toggles</font> |
− | * <font color="# | + | * <font color="#00AA00">Field-of-view (FOV) Symbol selector</font> |
− | * <font color="# | + | * <font color="#00AA00">FOV Editor</font> |
− | * <font color="# | + | * <font color="#00AA00">Geographic Location [Ctrl+G]</font> |
− | * <font color="# | + | * <font color="#00AA00">Configure KStars</font> |
− | * <font color="# | + | * <font color="#00AA00">Startup Wizard</font> |
==== Help Menu ==== | ==== Help Menu ==== | ||
− | * <font color="# | + | * <font color="#00AA00">KStars Handbook [F1]</font> |
− | * <font color="# | + | * <font color="#CC8800">What's this?</font> [1] |
* <font color="#000000">Report Bug</font> | * <font color="#000000">Report Bug</font> | ||
− | * <font color="# | + | * <font color="#00AA00">About KStars</font> |
− | * <font color="# | + | * <font color="#00AA00">About KDE</font> |
=== Toolbars === | === Toolbars === | ||
==== Main toolbar ==== | ==== Main toolbar ==== | ||
− | * <font color="# | + | * <font color="#00AA00">Zoom in/out</font> |
− | * <font color="# | + | * <font color="#00AA00">Find object...</font> |
− | * <font color="# | + | * <font color="#00AA00">Stop/Start clock</font> |
− | * <font color="# | + | * <font color="#00AA00">Timestep widget</font> |
==== View toolbar ==== | ==== View toolbar ==== | ||
− | * <font color="# | + | * <font color="#00AA00">Show stars</font> |
− | * <font color="# | + | * <font color="#00AA00">Show deep-sky</font> |
− | * <font color="# | + | * <font color="#00AA00">Show solar system</font> |
− | * <font color="# | + | * <font color="#00AA00">Show constellation lines</font> |
− | * <font color="# | + | * <font color="#00AA00">Show constellation names</font> |
− | * <font color="# | + | * <font color="#00AA00">Show constellation boundaries</font> |
− | * <font color="# | + | * <font color="#00AA00">Show Milky Way</font> |
− | * <font color="# | + | * <font color="#00AA00">Show coordinate grid</font> |
− | * <font color="# | + | * <font color="#00AA00">Show opaque ground</font> |
=== Centering and tracking === | === Centering and tracking === | ||
− | * <font color="# | + | * <font color="#00AA00">Center+Track on object (double-click, popup menu, click then press "C")</font> |
− | * <font color="# | + | * <font color="#00AA00">Center+Track on empty sky (double-click, popup menu)</font> |
− | * <font color="# | + | * <font color="#CC8800">If requested position moves display below horizon, confirm dialog is shown</font> |
− | * <font color="# | + | * <font color="#00AA00">If startup position is below horizon, recenter dialog is shown</font> |
* <font color="#000000">Information in "Focus" InfoBox updates correctly when recentering</font> | * <font color="#000000">Information in "Focus" InfoBox updates correctly when recentering</font> | ||
=== Info boxes === | === Info boxes === | ||
− | * <font color="# | + | * <font color="#00AA00">Displayed with semi-transparent backgound</font> |
* <font color="#000000">Highlight color on click</font> | * <font color="#000000">Highlight color on click</font> | ||
* <font color="#000000">"Shade" on double-click</font> | * <font color="#000000">"Shade" on double-click</font> | ||
− | * <font color="# | + | * <font color="#00AA00">Move on drag</font> |
* <font color="#000000">Collision avoidance works</font> | * <font color="#000000">Collision avoidance works</font> | ||
− | * <font color="# | + | * <font color="#00AA00">"Stick" to screen edges</font> |
− | * <font color="# | + | * <font color="#00AA00">Remember position and shade-state on restart</font> |
=== Color schemes === | === Color schemes === | ||
− | * Show all available schemes, incl. predefined and custom | + | * <font color="#00AA00">Show all available schemes, incl. predefined and custom</font> |
− | * All color settings change upon selecting a new scheme | + | * <font color="#00AA00">All color settings change upon selecting a new scheme</font> |
− | * Color settings persistent on reload | + | * <font color="#00AA00">Color settings persistent on reload</font> |
* Custom scheme appears in menu after creating in in the Configure dialog | * Custom scheme appears in menu after creating in in the Configure dialog | ||
* Custom scheme is removed from menu if it is removed in the Configure dialog | * Custom scheme is removed from menu if it is removed in the Configure dialog | ||
Line 187: | Line 187: | ||
* FITS image is opened and displayed properly. | * FITS image is opened and displayed properly. | ||
* Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar. | * Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar. | ||
− | * Undo/Redo work[[#Footnotes|[ | + | * Undo/Redo work[[#Footnotes|[4]]] |
* Zoom in/out, Default zoom | * Zoom in/out, Default zoom | ||
* Statistics | * Statistics | ||
* FITS header | * FITS header | ||
− | * Closing without save issues a warning dialog[[#Footnotes|[ | + | * Closing without save issues a warning dialog[[#Footnotes|[4]]] |
* Save and Save As work | * Save and Save As work | ||
Line 198: | Line 198: | ||
==== Save sky image ==== | ==== Save sky image ==== | ||
− | * Saves image to file: Doesn't seem to save GIF | + | * <font color="#CCCC00">Saves image to file: Doesn't seem to save GIF</font> [5] |
* Image matches screen display (without FOV or infobox overlays) | * Image matches screen display (without FOV or infobox overlays) | ||
Line 206: | Line 206: | ||
==== Print ==== | ==== Print ==== | ||
− | * Prints image of current skymap (without infoboxes or FOV symbols) | + | * <font color="#00AA00">Prints image of current skymap (without infoboxes or FOV symbols)</font> |
− | * Ask to reset color scheme if background is not white | + | * <font color="#00AA00">Ask to reset color scheme if background is not white</font> |
− | * Color scheme is properly reset for printing, and reverted afterward | + | * <font color="#00AA00">Color scheme is properly reset for printing, and reverted afterward</font> |
==== Set time ==== | ==== Set time ==== | ||
− | * Simulation clock is set to selected time | + | * <font color="#00AA00">Simulation clock is set to selected time</font> |
− | * Selected date displayed properly in calendar widget | + | * <font color="#00AA00">Selected date displayed properly in calendar widget</font> |
− | * It is not possible to select an invalid date | + | * <font color="#00AA00">It is not possible to select an invalid date</font>[3] |
==== Set focus manually ==== | ==== Set focus manually ==== | ||
− | * Setting RA/Dec coordinates works | + | * <font color="#00AA00">Setting RA/Dec coordinates works</font> |
− | * Setting Az/Alt coordinates works | + | * <font color="#00AA00">Setting Az/Alt coordinates works</font> |
==== Find object ==== | ==== Find object ==== | ||
− | * Filter by name works | + | * <font color="#00AA00">Filter by name works</font> |
− | * Filter by type works | + | * <font color="#00AA00">Filter by type works</font> |
− | * Highlighted object is centered in map when user hits return or presses Ok | + | * <font color="#00AA00">Highlighted object is centered in map when user hits return or presses Ok</font> |
* Dialog message when a match fails; window does not close | * Dialog message when a match fails; window does not close | ||
− | * Up/Down arrow keys navigate the list of objects | + | * <font color="#00AA00">Up/Down arrow keys navigate the list of objects</font> |
==== Zoom to angular size ==== | ==== Zoom to angular size ==== | ||
− | * Zoom is set to display the angle entered | + | *<font color="#00AA00"> Zoom is set to display the angle entered</font> |
* Min/max values make sense | * Min/max values make sense | ||
Line 239: | Line 239: | ||
==== Startup Wizard ==== | ==== Startup Wizard ==== | ||
− | * Set Geographic location works | + | * <font color="#00AA00">Set Geographic location works</font> |
* Download Extra Data works | * Download Extra Data works | ||
Line 247: | Line 247: | ||
* Selected image is shown; window is sized to fit image | * Selected image is shown; window is sized to fit image | ||
* Authorship and copyright in statusbar | * Authorship and copyright in statusbar | ||
− | * Save button works | + | * <font color="#00AA00">Save button works</font> |
=== Popup menu === | === Popup menu === | ||
Line 259: | Line 259: | ||
* Equinoxes and Solstices displayed are correct | * Equinoxes and Solstices displayed are correct | ||
* Equatorial to Galactic Coords conversion works | * Equatorial to Galactic Coords conversion works | ||
− | * Conversion from Equatorial to Horizontal coordinates is accurate[[#Footnotes|[ | + | * Conversion from Equatorial to Horizontal coordinates is accurate[[#Footnotes|[4]]] |
* Horizontal Coordinates UI | * Horizontal Coordinates UI | ||
* Ecliptic Coordinates tool UI | * Ecliptic Coordinates tool UI | ||
Line 288: | Line 288: | ||
* Almanac data are correct | * Almanac data are correct | ||
* Displays objects that are visible on the given date, from the given location | * Displays objects that are visible on the given date, from the given location | ||
− | * Changing the Date works, and updates the list of objects and almanac | + | * <font color="#00AA00">Changing the Date works, and updates the list of objects and almanac</font> |
− | * Changing the Location works, and updates the list of objects and almanac | + | * <font color="#00AA00">Changing the Location works, and updates the list of objects and almanac</font> |
− | * Selecting Evening/Morning/All Night works, and updates the list of objects | + | * <font color="#00AA00">Selecting Evening/Morning/All Night works, and updates the list of objects</font> |
* Selected object is displayed in right panel correctly | * Selected object is displayed in right panel correctly | ||
* The Rise/Set/Transit data are correct | * The Rise/Set/Transit data are correct | ||
Line 303: | Line 303: | ||
=== Details window === | === Details window === | ||
− | * Displays object information | + | * <font color="#00AA00">Displays object information</font> |
* Testing Resource links works | * Testing Resource links works | ||
* Editing Resource links works | * Editing Resource links works | ||
− | * Removing resource links works | + | * <font color="#00AA00">Removing resource links works</font> |
* Interacting with online databases works | * Interacting with online databases works | ||
==== Thumbnail Picker ==== | ==== Thumbnail Picker ==== | ||
− | * Displays list of images found via Google image search | + | * <font color="#00AA00">Displays list of images found via Google image search</font> |
− | * Selecting an image from the list displays it in the viewer | + | * <font color="#00AA00">Selecting an image from the list displays it in the viewer</font> |
* Editing the image works | * Editing the image works | ||
* Closing the window places the selected image in the Details window | * Closing the window places the selected image in the Details window | ||
Line 323: | Line 323: | ||
=== Sky Projections === | === Sky Projections === | ||
− | * Lambert Azimuthal Equal Area | + | * <font color="#00AA00">Lambert Azimuthal Equal Area</font> |
− | * Azimuthal Equidistant | + | * <font color="#00AA00">Azimuthal Equidistant</font> |
− | * Orthographic | + | * <font color="#00AA00">Orthographic</font> |
− | * Equirectangular | + | * <font color="#00AA00">Equirectangular </font> |
− | * Streographic | + | * <font color="#00AA00">Streographic</font> |
− | * Gnomonic | + | * <font color="#00AA00">Gnomonic </font> |
− | + | ||
+ | === OpenGL Support === | ||
---- | ---- | ||
Line 347: | Line 347: | ||
Add footnotes describing issues noted in the main list here. | Add footnotes describing issues noted in the main list here. | ||
− | [1]: | + | [1]: A lot of widgets have undefined what's this help. |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | [ | + | [2]: <font color="#00AA00">FIXED [897451]</font>The clock is paused if it is running, but the icon in the toolbar doesn't change state |
− | [ | + | [3]: It is possible to set type invalid date and press OK, but this will not change the time and date. |
− | [ | + | [4]: Tracking at high zoom sometimes "shakes" the display periodically. This has nothing to do with atmospheric refraction. |
− | [ | + | [5]: Saving the image works and the image can be seen, but if the image is saved in the Desktop folder it is not saved at all. |
Please test these behaviors, and indicate whether it works correctly or not. Once a behavior has been tested, attach one of the following codes to the beginning of the line to indicate its status.
If a menu action opens a window, the window's behavior is listed elsewhere. Just check to see if it opens here.
[NOTE: These features require that KStars be compiled with INDI support]
Note: changes in the modules are not reflected until the widget loses input focus. This may not be ideal, but doing immediate updates doesn't work. Consider the JD module. Let's say I want to clear the current number and enter a new one. As soon as I delete the text, it would try to process the blank line as a date. Then if I typed a "2", it would try to use that. Basically, there needs to be a way to indicate that you are done editing.
Use this section to add issues discovered while testing the program that are not listed above.
A: Will bring in Marble Widget eventually
Add footnotes describing issues noted in the main list here.
[1]: A lot of widgets have undefined what's this help.
[2]: FIXED [897451]The clock is paused if it is running, but the icon in the toolbar doesn't change state
[3]: It is possible to set type invalid date and press OK, but this will not change the time and date.
[4]: Tracking at high zoom sometimes "shakes" the display periodically. This has nothing to do with atmospheric refraction.
[5]: Saving the image works and the image can be seen, but if the image is saved in the Desktop folder it is not saved at all.