summaryrefslogtreecommitdiffstats
path: root/doc/kstars/solarsys.docbook
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce599e4f9f94b4eb00c1b5edb85bce5431ab3df2 (patch)
treed3bb9f5d25a2dc09ca81adecf39621d871534297 /doc/kstars/solarsys.docbook
downloadtdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.tar.gz
tdeedu-ce599e4f9f94b4eb00c1b5edb85bce5431ab3df2.zip
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
Diffstat (limited to 'doc/kstars/solarsys.docbook')
-rw-r--r--doc/kstars/solarsys.docbook53
1 files changed, 53 insertions, 0 deletions
diff --git a/doc/kstars/solarsys.docbook b/doc/kstars/solarsys.docbook
new file mode 100644
index 00000000..b3a5a07b
--- /dev/null
+++ b/doc/kstars/solarsys.docbook
@@ -0,0 +1,53 @@
+<sect1 id="tool-solarsys">
+<title>Solar System Viewer</title>
+<indexterm><primary>Tools</primary>
+<secondary>Solar System Viewer</secondary>
+</indexterm>
+
+<screenshot>
+<screeninfo>
+The Solar System Viewer
+</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="solarsystem.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Solar System Viewer</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+
+<para>
+This tool displays a model of our solar system as seen from
+above. The Sun is drawn as a yellow dot in the center of the
+plot, and the orbits of the planets are drawn as ellipses with
+the correct shapes and orientations. The current position
+of each planet along its orbit is drawn as a colored dot, along
+with a name label. The display can be zoomed in and out with
+the <keycap>+</keycap> and <keycap>-</keycap> keys, and the
+display can be recentered with the arrow keys, or by
+double-clicking anywhere in the window with the mouse. You can
+also center on a planet with the <keycap>0&ndash;9</keycap> keys
+(<keycap>0</keycap> is the Sun; <keycap>9</keycap> is Pluto).
+If you center on a planet, it will be tracked as time passes in
+the tool.
+</para>
+<para>
+The Solar System Viewer has its own clock, independent of the
+clock in the main &kstars; window. There is a timestep control
+widget here, similar to the one in the main window's toolbar.
+However, this control defaults to a timestep of 1 day (so that
+the motions of the planets can be seen), and it starts out with
+the clock paused when the tool is opened.
+</para>
+<note>
+<para>
+The current model used for Pluto's orbit is only good for dates
+within about 100 years of the present date. If you let the Solar
+System clock advance beyond this range, you will see Pluto behave
+very strangely! We are aware of this issue, and will try to
+improve Pluto's orbit model soon.
+</para>
+</note>
+</sect1>