OpenGL

开发平台：
Visual C++

index.docbook：源码内容
							<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY celestia "Celestia">
  <!ENTITY kappname "&celestia;">
  <!ENTITY ver "1.3.1">
  <!ENTITY package "kde-module">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY hiresolution "<keycombo action='simul'>&Shift;<keycap>R</keycap></keycombo>">
  <!ENTITY loresolution "<keycap>R</keycap>">
  <!ENTITY atmospheres "<keycombo action='simul'>&Ctrl; <keycap>A</keycap></keycombo>">
  <!ENTITY celestialgrid "<keycap>;</keycap>">
  <!ENTITY clouds "<keycap>I</keycap>">
  <!ENTITY comettails "<keycombo action='simul'>&Ctrl; <keycap>T</keycap></keycombo>">
  <!ENTITY constellations "<keycap>/</keycap>">
  <!ENTITY constellationboundaries "<keycombo action='simul'>&Ctrl; <keycap>B</keycap></keycombo>">
  <!ENTITY eclipseshadows "<keycombo action='simul'>&Ctrl; <keycap>E</keycap></keycombo>">
  <!ENTITY galaxies "<keycap>U</keycap>">
  <!ENTITY nightsidelights "<keycombo action='simul'>&Ctrl; <keycap>L</keycap></keycombo>">
  <!ENTITY orbits "<keycap>O</keycap>">
  <!ENTITY starsaspoints "<keycombo action='simul'>&Ctrl; <keycap>S</keycap></keycombo>">
  <!ENTITY verbose "<keycap>V</keycap>">
  <!ENTITY dec_fov "<keycap>.</keycap>">
  <!ENTITY inc_fov "<keycap>,</keycap>">
  <!ENTITY dec_ambientlight "<keycap>{</keycap>">
  <!ENTITY inc_ambientlight "<keycap>}</keycap>">
  <!ENTITY dec_magnitude "<keycap>[</keycap>">
  <!ENTITY inc_magnitude "<keycap>]</keycap>">
  <!ENTITY automag "<keycombo action='simul'>&Ctrl; <keycap>Y</keycap></keycombo>">
  <!ENTITY antialias "<keycombo action='simul'>&Ctrl; <keycap>X</keycap></keycombo>">
  <!ENTITY pixelshading "<keycombo action='simul'>&Ctrl; <keycap>P</keycap></keycombo>">
  <!ENTITY renderpath "<keycombo action='simul'>&Ctrl; <keycap>V</keycap></keycombo>">
  <!ENTITY fullscreen "<keycombo action='simul'>&Alt; <keycap>Enter</keycap></keycombo>">
  <!ENTITY wireframe "<keycombo action='simul'>&Ctrl; <keycap>W</keycap></keycombo>">
  <!ENTITY goto "<keycap>G</keycap>">
  <!ENTITY follow "<keycap>F</keycap>">
  <!ENTITY center "<keycap>C</keycap>">
  <!ENTITY center_co "<keycombo action='simul'>&Shift; <keycap>C</keycap></keycombo>">
  <!ENTITY esc "<keycap>Esc</keycap>">
  <!ENTITY advance "<keycap>Home</keycap>">
  <!ENTITY back "<keycap>End</keycap>">
  <!ENTITY lock "<keycap>:</keycap>">
  <!ENTITY home "<keycap>H</keycap>">
  <!ENTITY cancel "<keycap>Backspace</keycap>">
  <!ENTITY enter "<keycap>Enter</keycap>">
  <!ENTITY sync "<keycap>Y</keycap>">
  <!ENTITY track "<keycap>T</keycap>">
  <!ENTITY chase "<keycap>&quot;</keycap>">
  <!ENTITY lookback "<keycap>*</keycap>">
  <!ENTITY mark "<keycombo action='simul'>&Ctrl; <keycap>K</keycap></keycombo>">
  <!ENTITY accelerate "<keycap>A</keycap>">
  <!ENTITY decelerate "<keycap>Z</keycap>">
  <!ENTITY reverse "<keycap>Q</keycap>">
  <!ENTITY stop "<keycap>S</keycap>">
  <!ENTITY align "<keycap>X</keycap>">
  <!ENTITY F1 "<keycap>F1</keycap>">
  <!ENTITY F2 "<keycap>F2</keycap>">
  <!ENTITY F3 "<keycap>F3</keycap>">
  <!ENTITY F4 "<keycap>F4</keycap>">
  <!ENTITY F5 "<keycap>F5</keycap>">
  <!ENTITY F6 "<keycap>F6</keycap>">
  <!ENTITY F7 "<keycap>F7</keycap>">
  <!ENTITY F8 "<keycap>F8</keycap>">
  <!ENTITY F9 "<keycap>F9</keycap>">
  <!ENTITY F10 "<keycap>F10</keycap>">
  <!ENTITY F11 "<keycap>F11</keycap>">
  <!ENTITY F12 "<keycap>F12</keycap>">
  <!ENTITY pause "<keycap>Spacebar</keycap>">
  <!ENTITY time_faster "<keycap>L</keycap>">
  <!ENTITY time_slower "<keycap>K</keycap>">
  <!ENTITY time_reverse "<keycap>J</keycap>">
  <!ENTITY time_1 "<keycap></keycap>">
  <!ENTITY time_now "<keycap>!</keycap>">
  <!ENTITY lighttraveldelay "<keycap>?</keycap>">
  <!ENTITY adjlighttraveldelay "<keycap>-</keycap>">
  <!ENTITY copy_url_win "<keycombo action='simul'>&Ctrl; <keycap>Ins</keycap></keycombo>">
  <!ENTITY copy_url_lin "<keycombo action='simul'>&Ctrl; <keycap>C</keycap></keycombo>">
  <!ENTITY paste "<keycombo action='simul'>&Ctrl; <keycap>V</keycap></keycombo>">
  <!ENTITY splitV "<keycombo action='simul'>&Ctrl; <keycap>R</keycap></keycombo>">
  <!ENTITY splitH "<keycombo action='simul'>&Ctrl; <keycap>U</keycap></keycombo>">
  <!ENTITY cycleviews "<keycap>Tab</keycap>">
  <!ENTITY deleteview "<keycap>Del</keycap>">
  <!ENTITY singleview "<keycombo action='simul'>&Ctrl; <keycap>D</keycap></keycombo>">
  <!ENTITY planetlabels "<keycap>P</keycap>">
  <!ENTITY moonlabels "<keycap>M</keycap>">
  <!ENTITY galaxylabels "<keycap>E</keycap>">
  <!ENTITY starlabels "<keycap>B</keycap>">
  <!ENTITY asteroidlabels "<keycap>W</keycap>">
  <!ENTITY cometlabels "<keycombo action='simul'>&Shift; <keycap>W</keycap></keycombo>">
  <!ENTITY spacecraftlabels "<keycap>N</keycap>">
  <!ENTITY constellationlabels "<keycap>=</keycap>">
  <!ENTITY locationlabels "<keycap>&amp;</keycap>">
  <!ENTITY demo "<keycap>D</keycap>">
  <!ENTITY fps "<keycap>`</keycap>">
  <!ENTITY winfullscreen "<keycombo action='simul'>&Alt; &Enter;</keycombo>">
  <!ENTITY kdefullscreen "<keycombo action='simul'>&Ctrl; <keycap>F</keycap></keycombo>">
  <!ENTITY fps "<keycap>`</keycap>">
  <!ENTITY markers "<keycombo action='simul'>&Ctrl; <keycap>K</keycap></keycombo>">
  <!ENTITY setmark "<keycombo action='simul'>&Ctrl; <keycap>P</keycap></keycombo>">
  <!ENTITY limit_of_knowledge "<keycap>+</keycap>">
  <!ENTITY goto_surface_win "<keycombo action='simul'>&Ctrl; <keycap>G</keycap></keycombo>">
  <!ENTITY goto_surface_lin "<keycombo action='simul'>&Alt; <keycap>S</keycap></keycombo>">
  <!ENTITY capture_image_win "<keycap>F10</keycap>">
  <!ENTITY capture_image_lin "<keycombo action='simul'>&Ctrl; <keycap>G</keycap></keycombo>">
]>
<book lang="&language;">
<bookinfo>
<title>The &celestia; Handbook</title>
<authorgroup>
<author>
<firstname>Frank</firstname>
<surname>Gregorio</surname>
<affiliation><jobtitle>Documentation writter</jobtitle>
</affiliation>
</author>
<othercredit role="developer">
<firstname>Chris</firstname>
<surname>Laurel</surname>
<affiliation><address><email>claurel@shatters.net</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>
<othercredit role="developer">
<firstname>Clint</firstname>
<surname>Weisbrod</surname>
<affiliation><address><email>cweisbrod@adelphia.net</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>
<othercredit role="developer">
<firstname>Fridger</firstname>
<surname>Schrempp</surname>
<affiliation><address><email>t00fri@mail.desy.de</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>
<othercredit role="developer">
<firstname>Bob</firstname>
<surname>Ippolito</surname>
<affiliation><address><email>bob@redivi.com</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>
<othercredit role="developer">
<firstname>Christophe</firstname>
<surname>Teyssier</surname>
<affiliation><address><email>chris@teyssier.org</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<copyright>
<year>2000</year> <year>2004</year>
<holder>Chris Laurel</holder>
</copyright>
<legalnotice>&FDLNotice;
</legalnotice>
<date>2003-03-20</date>
<releaseinfo>&ver;</releaseinfo>
<abstract><para>
&celestia; is a free real-time space simulation that lets you experience
our universe in three dimensions. Unlike most planetarium software,
&celestia; does not confine you to the surface of the Earth. You can travel
throughout the solar system, to any of over 100,000 stars, or even beyond
the galaxy. All travel in &celestia; is seamless; the exponential zoom
feature lets you explore space across a huge range of scales, from galaxy
clusters down to spacecraft only a few meters across. A 'point-and-goto'
interface makes it simple to navigate through the universe to the object
you want to visit. Many add-ons and vastly improved textures of high
resolution are available for &celestia;.
</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Celestia</keyword>
<keyword>Astronomy</keyword>
<keyword>OpenGL</keyword>
<keyword>Simulation</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Introduction</title>
<para>
Many of us have looked up at the stars on a dark night and wondered what it would be like to launch ourselves into space and soar among the stars.  What do the astronauts of the space shuttle really see when they look down upon our beautiful Earth turning slowly below?  What wonders might we encounter if we could really visit Saturn and journey right through its rings?  What might they actually look like up close?  If you have ever wondered about these things and would like to find out the answers, we of the &celestia; community are happy to introduce you to &celestia;!
</para>
<para>
&celestia; is a free real-time space simulation that lets you visually experience our universe in three dimensions.  &celestia; was the initial inspiration and creation of Mr. Chris Laurel, a Seattle, WA computer programmer who in 2001, decided to write a free software program to be made available to everyone on the internet that would place you in control of a virtual reality world of the solar system.  His vision and dedication gave birth to a program that is unlike any other planetarium program in existence.  &celestia; doesn't confine you to the surface of the Earth as many other programs do.  Instead, Chris created a capability to travel throughout the solar system and anywhere else in space, at any speed and in any direction you choose.  If you wish, you can fly via your own <quote>hyperdrive</quote> spacecraft to visit stars circling the center of the Milky Way beyond the confines of our Sun.  You can even travel completely out of the Milky Way galaxy and view it from far space.
</para>
<para>
When &celestia; version 1.0 first appeared available for download on the Internet, space enthusiasts all over the world discovered and quickly realized the potential of this beautiful program.  Within a year, many talented people worldwide joined Chris in a collaborative volunteer effort to make &celestia; into not only a good graphical space simulation program but into a great one, capable of producing a virtual world of space rivaling the visual quality seen only in Hollywood films.
</para>
<para>
They have succeeded.  As of this writing, over 1000 members of the public are part of the &celestia; forum community.  Over 2 million people have downloaded the program for use at home or school.  The list grows daily and includes talented graphic artists, computer programmers, astronomers, astrophysicists, animators, engineers, teachers, students, professionals from scores of occupations and ordinary citizens in over 22 countries around the world.  We invite you to join the &celestia; <ulink url="http://www.shatters.net/forum/profile.php?mode=register">forum</ulink>.
</para>
<para>
&celestia; is available free of charge for Windows, Linux, and Mac OS X from <ulink url="http://www.shatters.net/celestia/download.html">http://www.shatters.net/celestia/download.html</ulink>.  Hopefully, you've already downloaded &celestia; and are really to install it and experience the beauty of space.  Here is just a taste of what you will be able to encounter:
</para>
<itemizedlist>
<listitem><para>Hover over each of the nine planets in our solar system as they rotate slowly below you.  See clouds actually drift by (where applicable).  Look carefully and you may be able to see mountains, canyons and craters on the planet surfaces with shadows being cast by them as the Sun sets low on the horizon.
</para></listitem>
<listitem><para>Take a spin down to the Earth's surface at a lazy speed or at thousands of miles/km per hour in your own spacecraft.  Skim over the oceans of Earth as you actually fly below the clouds.  See the sky turn a pale blue and eventually, transform into the crimson color of a Sunset.  Soar back into space in time to see the lights come on in the cities of Earth and glow an eerie white as the dark side of Earth turns below you.
</para></listitem>
<listitem><para>Position yourself above the giant gas world of Jupiter and watch as its large moons drift across the face of the planet, casting eclipse shadows on its banded clouds and Great Red Spot.
</para></listitem>
<listitem><para>Hover far beyond Saturn, speed up time and count its many moons revolving around its magnificent ringed body like pearls swirling on an invisible necklace.
</para></listitem>
<listitem><para>Journey to the frozen wasteland of Pluto and its moon Charon and imagine their icy coldness as the Sun's faint light casts pale shadows across their cratered ice surfaces.
</para></listitem>
<listitem><para>Take up station behind the comet Halley, set Celestia's clock back in time and follow this famous comet on a trip into the inner solar system, sailing past Earth with its gaseous blue tail streaming out behind it.
</para></listitem>
<listitem><para>Set your spacecraft speed and journey from the Earth's surface up to the International Space Station or the Hubble Space Telescope.  Test your skill rendezvousing with them as they orbit Earth every 90 minutes.
</para></listitem>
<listitem><para>Fly out to the very edges of our solar system, locate and follow behind Voyager 1 and 2 as they speed farther and farther away from their creators back on Earth, headed on a one way journey through the blackness of frigid space toward distant stars that will take them millions of years to reach.
</para></listitem>
<listitem><para>Set your ship at faster-than-light speed and sail to Rigel Kentaurus A and B, located 4.5 light years from Earth.  See if you can find their tiny red dwarf companion Proxima Centauri, the closest star to our own Sun, or choose to observe rotating Sunspots on any of a whopping 2,000,000 other stars drawn by your computer in the Celestia universe (to see all of those stars, a separate add-on is required).
</para></listitem>
<listitem><para>Download some of the many stunning add-ons available for Celestia and your experience becomes filled with even more wonders.  Visit the Discovery, a spaceship from the film "2001, a Space Odyssey", dark, abandoned and adrift somewhere in Jupiter space with the HAL computer inside.
</para></listitem>
<listitem><para>Journey to the edges of a massive rotating Black Hole as it spins near its stellar companion.
</para></listitem>
<listitem><para>Track the spacecraft Cassini as it approaches a precise rendezvous with Saturn in 2004.
</para></listitem>
<listitem><para>Journey to Earth?s future and be witness to the end of our planet as a swollen Red Giant sun consumes it.
</para></listitem>
<listitem><para>Witness a pulsar imbedded deep in the Crab Nebula spinning rapidly as it sends its twin beacons of light through the nebula gas.
</para></listitem>
<listitem><para>Travel back in time to witness a re-creation of what the Earth looked like billions of years ago.  Be there as Orpheus, a planet the size of Mars crashes into it, creating our Moon and sending it into an orbit within a few thousand miles of Earth.
</para></listitem>
<listitem><para>Travel forward to the year 2900 CE to observe giant mirrors melt the Martian polar ice caps and help to terraform the planet into a verdant world of water, plants and cities of the future.
</para></listitem>
<listitem><para>Drop "up" to the massive rotating Space Station V from the film, "2001 a Space Odyssey" in the year 2400 CE and see if you can land your "Celestia 1" spaceship in its cavernous landing bay.
</para></listitem>
<listitem><para>Instantly change the appearance and detail of planets and moons using the Alternative Textures command.
</para></listitem>
<listitem><para>Are you a Star Wars fan?  The &celestia; community has made available for download an entire Star Wars solar system.  Orbit the planet Tatooine and you will be amazed at the realism of its arid deserts.  Fly via hyperjump over the ice world, Hoth or to the green world of Endor but be careful for tractor beams.  Somewhere in that solar system will be the giant imperial Deathstar, glinting as the light from the system?s yellow Sun actually reflects off its evil metallic skin as imperial tie fighters keep guard.
</para></listitem>
<listitem><para>Approach an entire fleet of Borg Cubes as you command the USS Enterprise E from the StarTrek series.
</para></listitem>
</itemizedlist>
<para>
These are just a few of &celestia;'s features.  Each week, new features are being added by &celestia;'s programmers and other talented contributors.  It is a program undergoing a rapid evolution in computer graphics.  Add-on features, for example, will include entirely new solar systems with dozens of planets and moons drawn in vivid detail, gaseous nebula clouds, new galaxies, stars, globular clusters and spacecraft both real and imaginary.  Periodically as new features are added, this User's Guide will also be revised.  If this list above excites you, let's get started on our journey into the heart of &celestia;.
</para>
</chapter>
<chapter id="solar_system_tutorial">
<title>Solar System Tutorial</title>
<para>
&celestia; is a stunning program to observe and explore the solar system.  To help you discover some of its beauty and secrets, &celestia; has a short journey already laid out for you.  To see it, launch the program as described below, pull down the <guimenu>Help</guimenu> Menu and select <guimenuitem>Run Demo</guimenuitem>.  &celestia; developers have also created a score of detailed Celestia Educational Activities to take Celestia users on a virtual tour of the universe.  Look for them on the Celestia website.
</para>
</chapter>
<chapter id="what_is_available">
<title>What is Available</title>
<para>
&celestia; is a computer program written in the computer language C++.  The code is Open Source, and may be examined and freely modified by anyone under the terms of the GNU Public License.  For experienced programmers who have an interest in improving the program, you can find the Celestia source code at <ulink url="http://www.SourceForge.net">http://www.SourceForge.net</ulink>
</para><para>
In addition to the actual program, &celestia; includes many other add-on files (graphics and data) that the program can use.  If you choose to download the entire library of over 250 &celestia; add-on files designed to date by its many contributors, they can take up over 3 GB (gigabytes) of disc space.  For many people with limited computer memory and/or internet download speed, that is very large.  To offer &celestia; in a reasonable fashion, therefore, the basic program is provided for download with a comprehensive but limited set of files, sufficient to experience its capabilities without overtaxing your computer.  "Links" (web addresses) to guide you to the additional add-on files available are listed on the web within the User?s forum and &celestia; website.  To fully experience what &celestia; has to offer, we urge you to seek out and download some of these other add-on files.  Unfortunately, the add-ons are spread out across over 50 websites.  Eventually, we will have a central repository for most of them, but that is still in the works.  If you would like to get started, however, you can visit these links:
</para>
<itemizedlist>
<listitem><para><ulink url="http://shatters.net/forum/index.php">Celestia add-on page</ulink></para></listitem>
<listitem><para><ulink url="http://mikecelestia.bravehost.com/downloadlist.htm">Mike's add-on list</ulink></para></listitem>
<listitem><para><ulink url="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/celestia/celestia/textures/">Celestia basic textures</ulink></para></listitem>
<listitem><para><ulink url="http://ennui.shatters.net/celestia/files/?M=D">Celestia files</ulink></para></listitem>
<listitem><para><ulink url="http://www.celestialvisions.net/">Celestial Visions</ulink></para></listitem>
<listitem><para><ulink url="http://homepage.eircom.net/~jackcelestia/">Jack's spacecraft add-ons</ulink></para></listitem>
<listitem><para><ulink url="http://www.lns.cornell.edu/~seb/celestia/index.html">Selden's Resources</ulink></para></listitem>
<listitem><para><ulink url="http://www.shatters.net/~t00fri/texfoundry.php4">Texture Foundry</ulink></para></listitem>
<listitem><para><ulink url="http://www.shatters.net/~praesepe/files/">Praesepe's Files</ulink></para></listitem>
<listitem><para><ulink url="http://www.bt.homepage.btinternet.co.uk/Celestia.htm">BT's Celestia add-ons</ulink></para></listitem>
<listitem><para><ulink url="">Don's Celestia Hub</ulink></para></listitem>
<listitem><para><ulink url="http://exp.arc.nasa.gov/downloads/celestia/extras/">NASA Learning Technologies &celestia; distribution</ulink></para></listitem>
<listitem><para><ulink url="http://63.224.48.65/~impulse/Hub/Celestia_Hub.html">Frank's Add-ons</ulink></para></listitem>
<listitem><para><ulink url="http://www.fsgregs.org/celestia/">Jim's Celestia page</ulink></para></listitem>
<listitem><para><ulink url="http://68.43.175.239/JohnsCelestiaPage/modules/mydownloads/">John's Celestia page</ulink></para></listitem>
</itemizedlist>
<note><para>Please note that the above links may be temporary.  Websites come and go based on member's arrangements with hosting servers.  However, the above sites will get you started.  If I left out someone's add-on website, please forgive me.  Remember that there are over 50 such sites scattered throughout the forum.  To see links to more of them, visit and browse <ulink url="http://shatters.net/forum/index.php">the forum</ulink>.</para></note>
<para>
The &celestia; package for computers running <trademark class="registered">Microsoft Windows</trademark> 95, 98, ME, 2000, XP, or NT 4.0 is offered as a fully "executable" program.  It will install itself into your computer.  The current Windows version is 11 megabytes in size and is called &celestia;-win32-1.3.1.exe.  It is available for download at <ulink url="http://www.shatters.net/celestia/download.html">http://www.shatters.net/celestia/download.html</ulink>.  If you have a computer that is less than 3 years old, this is the only file you will need to get started.  If you have an older computer, or one with a graphics card with less than 16 megabytes (MB) of memory (see below), the &celestia; package with low-resolution textures is only 4.5 MB in size and may run better on your system.  You can find it at the same website above.  Please note that you do not need both of them.  See hardware comments in the next section below for more detail.
</para><para>
&celestia; is also available to Apple Macintosh users running MacOS X (&celestia; version 1.2.5).  The comments mentioned above for Windows also apply to the Apple version of &celestia;.
</para><para>
&celestia; is available for Linux in three different versions.  All of them are available in a single tarred, gzipped source archive at <ulink url="http://www.shatters.net/celestia/download.html">http://www.shatters.net/celestia/download.html</ulink>.  Which version you choose to install depends upon which desktop environment you have installed.  The most polished version of &celestia; for Linux requires KDE3 (&celestia; is not compatible with earlier versions of KDE.)  If you do have KDE3, it's highly recommended that you choose the KDE version of &celestia;, as it's under the most active development.  &celestia; can also be compiled to use Gnome/Gtk, although Gnome interface is not up to par with KDE and Windows UI.  It's still possible to build &celestia; even if you don't have either KDE3 or Gnome.  The third version of &celestia; is the GLUT version.  GLUT is a cross platform framework for OpenGL applications that should be installed on nearly every Linux computer with OpenGL.  However, it provides only a bare minimum of GUI features; if you use the GLUT version of &celestia;, you will be missing the helpful menus and dialog boxes of the other versions.
</para>
<important>
<title>Required Libraries</title>
<para>
All versions of &celestia; for Linux require that you have OpenGL installed.  More and more distributions are shipping with OpenGL, so if you've recently installed or re-installed Linux, there's a good chance that you already have a working OpenGL configuration.  In order to build &celestia;, you need to have the OpenGL developers packages installed.  They should be available on your distribution CD or ftp site if they're not already installed.  After you've successfully built &celestia;, you will want to be able to run it with hardware 3D acceleration.  For this, you'll need a Linux OpenGL driver from your graphics chipset maker.  If it's not already installed, you'll have to download it from the chipset maker's web site.  NVIDIA and ATI are the two largest graphics hardware makers, and both offer Linux drivers in the drivers section of their web sites.  &celestia; requires the image format libraries libjpeg and libpng; both should be present on all up to date Linux installations.  In order to build the Gnome/Gtk version of &celestia;, the gtkglarea library is necessary.  It is available at <ulink url="http://www.student.oulu.fi/~jlof/gtkglarea/">http://www.student.oulu.fi/~jlof/gtkglarea/</ulink> if not already installed on your computer.
</para>
</important>
</chapter>
<chapter id="hardware_requirements">
<title>Hardware Requirements</title>
<para>
&celestia; is a sophisticated program that not only positions and graphically depicts the complete solar system in 3D; it also plots and tracks a sky full of hundreds of thousands of stars in real time.  This takes computer power and computer memory.  &celestia; also has available scores of add-on files.  Some of them are large graphics files that require lots of RAM memory.  Thus, identifying what level of computer performance you need to enjoy the program depends upon what level of detail you wish to achieve.
</para><para>
In general, to run the basic &celestia; solar system program, your computer should have a CPU (processor) that has a speed of at least 300 million cycles per second (300 MHz).  Typically, computers bought new within the last 2 -3 years have adequate CPU speeds.  If your computer is more than 3 years old or is a Pentium II or equivalent with a processor speed slower than 300 MHz, &celestia; may run slowly and you will be disappointed.
</para><para>
The basic &celestia; program also requires a minimum of 128 megabytes of RAM memory.  The graphics files that &celestia; use are large, and if your computer does not have at least 128 megabytes of RAM, &celestia; may run very slowly, not run at all or may lock up.  In addition, if you wish to explore &celestia;'s maximum capabilities, you will need 256 megabytes of RAM memory, with 512 megabytes of RAM recommended.
</para><para>
Although it's not absolutely required, the program will be vastly more enjoyable if you also have a 3D video graphics accelerator in your computer.  This is hardware circuitry that draws complex graphic images on your video display monitor.  &celestia; should run with any 3D accelerator card with at least 8 megabytes of memory.  However, a 16 megabyte or 32 megabyte card is preferred if you intend to use &celestia;'s most detailed graphic files.  If you have such a card, &celestia; will run smoothly and its graphics will be complete, crisp and sharp.  If is runs too slowly, is blurry, locks up, or objects appear to be moving with jerky motions, you may need to locate a faster computer or one with more memory or graphics capability.
</para>
<important>
<para>&celestia; uses the OpenGL API to render 3D graphics.  In order to get the most from Celestia, you should have a modern OpenGL graphics card with the latest drivers from the manufacturer.  If you have problems running &celestia;, verify that your graphics card is capable enough to run &celestia;, and that the drivers are up to date.  If in doubt about the OpenGL driver, download and install a new one.  It will be available free from your card maker's web site.  Having a new driver is the best thing you can do to ensure that &celestia; runs properly.
</para>
<para>
While a graphic video card might use Open GL processing, &celestia; does not run well on all such ca
rd brands or models.  Version 1.3.0 incorporates major improvements to render &celestia; more compatible with as many brands of cards as possible, but several graphic cards handle images in a manner that &celestia; may not control properly.  To date, &celestia;'s features work best on the video chipsets manufactured by NVIDIA, Inc.  Those video cards sell under the model names "Riva", "GeForce" and "Quadro".  If an NVIDIA Open GL card is not present in your computer, &celestia; can still offer you a beautiful solar system experience, but some of its advanced features may not function.  These include shadows on mountains and craters (bump mapping), sunlight reflections off water (specular highlights), shadows of moon eclipses, and atmospheric haze.
</para><para>
As development of &celestia; continues, better support for graphics hardware will continue to be introduced; if not all the features of your graphics card are supported yet, be patient.  Better yet, join the &celestia; development team and help improve the program.
</para></important>
</chapter>
<chapter id="installation_uninstallation">
<title>Installation and Uninstallation</title>
<para>
If you have a video card incorporating a graphics accelerator with at least 32 MB of memory, install the full &celestia; installation (i.e. - celestia-win32-1.3.1.exe).  If your computer is an older model, does not have a graphics accelerator or does not support Open GL processing, obtain the &celestia; package with low-resolution textures and install that.  The views you see in &celestia; will be simpler and less detailed, but this version of the program and its files require less RAM and it may run more smoothly.  Also, see the &celestia; website for additional <ulink url="http://www.shatters.net/celestia/faq.html">answers to troubleshooting questions</ulink>.  Alternatively, the main &celestia; package includes some low-resolution image files.  While running &celestia;, you can actually switch from one resolution of graphics to another by tapping the &hiresolution; key on the keyboard (for large resolution), or the &loresolution; key (to change to low resolution images).  This alone may speed up your program.  Note, however, that not every image in &celestia; is represented by both a high and low-resolution image.  If you tap the &loresolution; key and nothing happens, it just means there is no smaller resolution image of that moon or asteroid or spacecraft to use.
</para>
<sect1 id="win">
<title>Windows Operating System (95, 98, ME, 2000, NT, XP)</title>
<para>
Once you have obtained and downloaded the executable file, simply click twice (double-click) rapidly on its name with your left mouse button.  The file will begin running and will install &celestia;.  In general, just click <guibutton>Next</guibutton> whenever it asks a question.  &celestia; has its preferred choices and unless you have reasons for altering them, we suggest you follow them.
</para>
</sect1>
<sect1 id="mac">
<title>Macintosh OS Operating Systems</title>
<para>
To install the Macintosh version, click on it and follow the on-screen menu instructions.
</para>
</sect1>
<sect1 id="linux">
<title>Linux Operating Systems</title>
<para>
RPMS packages are provided for the SuSE and Mandrake distribution. You can get them from the SourceForge <ulink url="http://sourceforge.net/project/showfiles.php?group_id=21302">project page</ulink>.
</para>
<para>
If you run SuSE or Mandrake the prefered way to install &celestia; is to get the <filename>celestia-kde</filename>, <filename>celestia-kde-texture</filename> and <filename>celestia-kde-handbook</filename> packages for your distribution and to install them by running as root in the directory where the files have been downloaded:</para>
<para><userinput><command>rpm</command> <option>-Uvh</option> <filename>celestia-kde*</filename></userinput>
</para>
<para>
Alternatively, or if you don't run one of the supported distribution, you can compile &celestia; yourself.
Unpack it and its libraries with gzip and tar via the command:</para>
<para><userinput><command>gzip</command> <option>-dc</option> <filename>celestia-1.3.1.tar.gz</filename> <command>| tar</command> <option>xvf</option></userinput></para>
<para>
Then change directory (<command>cd</command>) into the newly created directory and configure Celestia.  Run <command>configure</command> with the appropriate command line for the version that you want to compile:</para>
<variablelist>
<varlistentry>
<term>KDE</term>
<listitem><para><userinput><command>./configure</command> <option>-with-kde</option></userinput></para></listitem>
</varlistentry>
<varlistentry>
<term>Gnome/Gtk</term>
<listitem><para><userinput><command>./configure</command> <option>-with-gtk</option></userinput></para></listitem>
</varlistentry>
<varlistentry>
<term>GLUT</term>
<listitem><para><userinput><command>./configure</command></userinput></para></listitem>
</varlistentry>
</variablelist>
<note><para>To enable the CELX script language (new in 1.3.1), add <option>--with-lua</option> to the <command>configure</command> command. You need to have <ulink url="http://www.lua.org/">Lua 5</ulink> installed. Lua 5 packages are available for Mandrake in the "contrib" directory on Mandrake mirrors.</para></note>
<para>
<command>configure</command> may complain if you are missing a required component, or if you have an out of date version of a required component.  Check the error output from configure to determine what's missing, install the necessary items, and then try rerunning <command>configure</command>.  If neither the KDE or Gnome versions of &celestia; will build, try falling back to the GLUT version.  There are many options for configure; you can view them all-together with a brief explanation for each-by running <userinput><command>./configure</command> <option>-help</option></userinput>.
</para>
<para>After running configure, compile and install &celestia;:</para>
<para><userinput><command>make</command></userinput></para>
<para><userinput><command>make</command> <option>-install</option></userinput></para>
<note><para><command>make</command> <option>-install</option> will need to be run as root unless you've overridden the default install directory by invoking <command>configure</command> with the <option>-prefix</option> option.
</para></note>
<para>
Hopefully, compilation of &celestia; will go smoothly.  If it doesn't, it's most likely because some required package is missing.  A relatively common problem is that the OpenGL developer package necessary for building OpenGL applications has not been installed.  If the compiler complains that gl.h or glu.h is not found, it's a symptom of a missing or improperly installed OpenGL developer package.  Once make completes without errors, you're ready to run &celestia; from either your desktop of choice or the command line.
</para>
</sect1>
<sect1 id="uninstall">
<title>Uninstall</title>
<para>
To uninstall &celestia; in Windows, click the <guibutton>Start</guibutton> button at the bottom left of your screen, select <guisubmenu>Settings</guisubmenu>, then select <guimenuitem>Control Panel</guimenuitem>, then select Add/Remove Programs.  Locate &celestia; in the pull-down list and click the button that says, "Add/Remove". </para>
<para> For Apple and UNIX owners, follow your system's standard uninstall procedure.
</para>
</sect1>
</chapter>
<chapter id="general_operation">
<title>General Operation and Keyboard commands</title>
<note><para>In the sections that follow, images and screenshots from the program will be displayed.  Many of these images use higher-resolution graphic add-ons that are not part of the default download program, but which are available from the &celestia; forum and other websites.  As a result, if your version of &celestia; does not precisely match the enclosed screenshots, don't be alarmed.</para></note>
<para>
To launch &celestia;, double-click on its icon either on your desktop or in the Programs menu that appears when you click your Start button.  The program will load and will open far out in space hovering above Io, one of Jupiter's most fascinating moons.  Mighty Jupiter will be visible somewhere behind Io.  The beauty of &celestia; is its accuracy.  The image in front of you is exactly what you would see if you were really positioned in space at that very spot right now.  In other words, Io, Jupiter, and all of the planets and stars and spacecraft visible on your computer screen really are located in space where &celestia; has put them.</para>
<para>The Opening Screen:</para>
<screenshot>
<screeninfo>Earth</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig1.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Earth</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-08-30T16:07:23.18386?x=0HIjR+0qNFbMDA&amp;y=x8yXF3Dy&amp;z=oTFzSBjgc0YG&amp;ow=0.554402&amp;ox=-0.000000&amp;oy=0.832249&amp;oz=-0.000000&amp;select=Sol:Earth&amp;fov=31.999998&amp;ts=1.000000&amp;ltd=0&amp;rf=40855&amp;lm=1862270976">Earth</ulink></para></caption>
</mediaobject>
</screenshot>
<para>Earth turns on its axis constantly and is always changing position.  Thus, the screenshot above may or may not be the same scene you see when you open &celestia;.  However, it will be similar</para>
<itemizedlist>
<listitem><para>In the top left corner will be some information about your target (Io).  The Distance will be the distance in kilometers (km) from you to the surface of the moon.  Io's Radius in km will also be listed.</para></listitem>
<listitem><para>In the lower left corner will be Speed through space relative to the Sun.  At the moment, your ship is not moving so your speed is zero.  Later, we will begin to fly on our own and your speed will be listed here.</para></listitem>
<listitem><para>In the top right corner will be the current time and date.  In Astronomy, times are given in Universal Time (commonly referred to as Greenwich Mean Time), and this is what &celestia; uses by default.  If you find it more convenient, you can access the Time menu to make &celestia; use your local time zone instead.  The date is listed in the format (year/month/day).  Note that time will be in 24-hour format.  Thus, 1:00 PM will be 13:00:00 hours.  &celestia; can also speed up or slow down time or travel forward or backward in time with the touch of a button.  Now, you are experiencing the program in "Real Time".</para></listitem>
<listitem><para>In the lower right of the screen will be a message telling you that you are "Following" Earth.  Wherever it goes, you go.  Thus, although Earth is actually moving rapidly through space, you are moving with it.</para></listitem>
<listitem><para>Under that will be your <quote>Field of View</quote> or <quote>FOV</quote>. This is the amount of sky your view takes in.  &celestia; starts you out with an FOV that it calculates, based upon your screen size, resolution and monitor settings.  It ranges from 15掳 to 45掳, which means your monitor is displaying about 15掳 - 45掳 of the sky (most people have a total visual field of 120掳).  However, you can change the FOV easily by holding down the &Shift; key on the keyboard, <mousebutton>left</mousebutton>-clicking your mouse button and dragging the mouse forward or backward.  Try it.  As the FOV gets smaller, the scene enlarges.  It is similar to a telescope magnification.  You can also press the &dec_fov; key or the &inc_fov; keys to change field of view from the keyboard.  Enlarging the FOV allows you to magnify objects in the distance, while still keeping the planet in the foreground.  In general, an FOV of about 32掳 presents a sky view that draws objects at about the size you see them in space.  If you wish to return to the default FOV that your program opened with and you have a mouse wheel, click/push the <mousebutton>wheel</mousebutton> button.  Please note that if you change your screen window size by dragging its borders, &celestia; may assign and change the FOV, based on the new screen size.</para></listitem>
<listitem><para>
You can also instruct &celestia; to launch the program with a particular starting FOV, rather than sizing it based on your screen settings.  To do so, locate the file named <filename>start.cel</filename>, which is in the &celestia; main Directory folder.  <mousebutton>right</mousebutton>-click on it and choose the option that says, <guimenuitem>open with</guimenuitem>.  A list of programs on your computer will appear.  Locate a text editing program such as MS WordPad or Notepad and click <guibutton>OK</guibutton>.  The <filename>start.cel</filename> file will open and you鈥檒l see a set of single line commands (in English).  Locate the line that says,
<programlisting>
# set { name "FOV" value ____ }
</programlisting>
Remove the # symbol and in the space, type whatever FOV value you wish.  For example:
<programlisting>
set { name "FOV" value 32.0 }
</programlisting>
produces a 32掳 field of view that is about what your eyes would see without a telescope if looking at the Moon or a particular spot in space.
Save the file, close it and launch &celestia;.  The program will now always start with an FOV of 32掳.
</para>
</listitem>
</itemizedlist>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>The FOV here is 45掳.  Notice size of the moon behind Earth.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig2.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>The FOV here is 45掳.  Notice size of the moon behind Earth.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-03-22T18:59:45.88?x=OD6Jd5I3xO6tDA&amp;y=TuD9jqpi/f///////////w&amp;z=hVjrjdVgKXc&amp;ow=-0.363648&amp;ox=0.079560&amp;oy=0.927376&amp;oz=0.037466&amp;select=Sol:Earth&amp;fov=45.000004&amp;ts=1.000000&amp;rf=57239&amp;lm=0">The FOV here is 45掳.  Notice size of the moon behind Earth.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>The FOV here is 12掳.  Earth and moon are now enlarged.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig3.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>The FOV here is 12掳.  Earth and moon are now enlarged.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-03-22T19:01:27.24?x=4P8Iu2jRse6tDA&amp;y=rV64OPKX/////////////w&amp;z=FdjZPUzzKHc&amp;ow=-0.255431&amp;ox=0.084504&amp;oy=0.962843&amp;oz=0.023405&amp;select=Sol:Earth&amp;fov=12.053194&amp;ts=1.000000&amp;rf=57239&amp;lm=0">The FOV here is 12掳.  Earth and moon are now enlarged.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</chapter>
<chapter id="set_program_options">
<title>Set Program Options</title>
<para>When you use &celestia; for the first time, you will need to choose some options that will tell the program how you want things done. &celestia; will remember these settings once you initially establish them.  However, during your subsequent use of &celestia;, you may have need to change or reset these options.</para>
<para><guimenuitem>Display Mode</guimenuitem>: To open the <guimenu>Render</guimenu> menu, <mousebutton>left</mousebutton>-click on the word <guimenu>Render</guimenu> at the top of the &celestia; view screen and choose <guimenuitem>Select Display Mode</guimenuitem> or <guimenuitem>Toggle Full Screen</guimenuitem>.  These are instructions to &celestia; to change the resolution of the view screen.  Choose the <guimenuitem>Select Display Mode</guimenuitem> menu first to choose the size of the viewscreen you prefer.</para>
<para><guimenuitem>Windowed Mode</guimenuitem> is the default choice and sets your screen to the same resolution size your display monitor is set to display.  For example, most desktop computers display a default screen resolution of 800 x 600 pixels, while laptops are typically set to 1024 x 768 pixels in either 16 or 32-bit color.  To find out what your computer display is set at, <mousebutton>right</mousebutton>-click on your desktop, choose <guimenuitem>properties</guimenuitem> and <guimenuitem>settings</guimenuitem>, and read the resolution setting.</para>
<para>When running &celestia; in Windowed Mode, your screen gives you visible screen borders, sliders and toolbars.  You can resize the screen by dragging its corners, minimize the screen, switch between programs, etc.  If instead you select a different screen resolution from the <guimenuitem>Display Mode</guimenuitem> pulldown menu, &celestia; will immediately switch to Full Screen Mode, and draw the screen in that pixel size, filling up the entire screen.  All of the toolbars, sliders and side borders will disappear.</para>
<para>High-end computers and those with up-to-date video cards can take advantage of tighter packed pixel sizes and more detailed appearance, and many users prefer to view &celestia; in Full Screen Mode at smaller pixel sizes.  The screen is uncluttered and your view really looks like the window in a spacecraft.  However, there are disadvantages to Full Screen Mode.  First, in order to access the toolbars, you must point your mouse toward the top of the screen and wait for the menu/toolbar to be drawn.  With some video cards, the entire screen will go black for a moment as the toolbars are being drawn.  Secondly, some screen modes are simply not designed for certain monitors.  For example, if you set your resolution at 1280x720 on a regular CRT monitor, the screen will look warped and the planets will be ellipses, not spheres.
</para>
<caution><para>Also, be advised that the ability of &celestia; to redraw complex scenes in different screen sizes varies from system to system.  Some users have reported lockups and program crashes when using Full Screen Mode at certain display sizes.  We recommend you experiment with your own system and choose the resolution that works best for you.  &winfullscreen; (Windows) or &kdefullscreen; (KDE) is a useful keyboard shortcut that toggles between Windowed Mode and Full screen.</para></caution>
<para><guimenuitem>View Options</guimenuitem> is the 3rd option in the <guimenu>Render</guimenu> menu.  Left-click this option to open the View Options dialog box.  A list of choices will appear.  Deciding which ones you want is a personal and a practical choice.  If your computer is a newer model, then we recommend the options listed in the image to the right of this paragraph, and described in detail below.  If your computer is slower or older and &celestia; appears to be running slowly, deselect some of these options, as suggested in the following discussion:</para>
<sect1 id="opt_atmosphere">
<title>Atmospheres (&atmospheres;)</title>
<para>
&celestia; will draw colored atmospheres above all planets and moons that have them.  You will be able to see them from space and even fly through them.  As you do, the sky will lighten.  Atmospheres will even dim and turn color as you view them near the terminator (near the dark side).</para>
<para><emphasis>Highly Recommended</emphasis> - but does require computer resources.  Try turning it off if &celestia; is running too slowly on your system.</para>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Earth with Atmospheres selected.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig4.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Earth with Atmospheres selected.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-03-24T14:39:30.34?x=vr3XsfrEz/GtDA&amp;y=tgu0u7PuJg&amp;z=dengFcStz/Y&amp;ow=-0.798872&amp;ox=-0.219731&amp;oy=-0.380711&amp;oz=-0.410586&amp;select=Sol:Earth&amp;fov=20.349142&amp;ts=1.000000&amp;rf=57239&amp;lm=0">Earth with Atmospheres selected.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene without Atmospheres selected.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig5.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Same scene without Atmospheres selected.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-03-24T14:39:47.87?x=vr3rayPuz/GtDA&amp;y=NWaz3r3uJg&amp;z=dUGgtlNN0/Y&amp;ow=-0.798872&amp;ox=-0.219731&amp;oy=-0.380711&amp;oz=-0.410586&amp;select=Sol:Earth&amp;fov=20.349142&amp;ts=1.000000&amp;rf=56983&amp;lm=0">Same scene without Atmospheres selected.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_celestial_grid">
<title>Celestial Grid (&celestialgrid;)</title>
<para>&celestia; places an equatorial coordinate grid on the screen showing you the celestial position and direction in space.  The grid follows the standard convention of Right Ascension and Declination used in Astronomy.</para>
<para><emphasis>Recommended</emphasis> - when needed to locate a direction in space.  For example, you can turn the grid on temporarily to identify direction of an object in &celestia; then go to a real telescope and swing to that approximate coordinate.  You can also use the Celestial Grid to help you decide where to place a fictional add-on (see Part 2 of the User's Manual) or to locate an object whose RA and DEC you know from another source.</para>
<screenshot>
<screeninfo>Sky with &celestia;l Grid Enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig6.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Sky with &celestia;l Grid Enabled.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-03-24T14:40:38.16?x=wzJJcvet1/GtDA&amp;y=mFWLdBuqMg&amp;z=cXerPTw57PY&amp;ow=-0.414948&amp;ox=-0.532151&amp;oy=-0.593261&amp;oz=-0.438948&amp;select=Sol&amp;fov=45.000004&amp;ts=1.000000&amp;rf=57047&amp;lm=0">Sky with &celestia;l Grid Enabled.</ulink></para></caption>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="opt_clouds">
<title>Clouds (&clouds;)</title>
<para>Some of the planets in our solar system and many fictional planets that &celestia; users create in other solar systems have clouds drifting across their surfaces.  &celestia; has the ability to both place clouds above the surface and put them in motion.</para>
<para><emphasis>Highly Recommended</emphasis> - but does require computer resources.  Try turning off if &celestia; is running too slowly or if you just want clear skies.</para>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Earth with moving clouds selected.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig7.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Earth with moving clouds selected.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-03-24T14:41:28.15?x=1Ct3g+sEIPKtDA&amp;y=GJV89/a89////////////w&amp;z=QbP79kGgovY&amp;ow=0.612877&amp;ox=0.057523&amp;oy=-0.780640&amp;oz=0.108050&amp;select=Sol:Earth&amp;fov=45.000004&amp;ts=1.000000&amp;rf=57239&amp;lm=0">Earth with moving clouds selected.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene without clouds selected.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig8.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Same scene without clouds selected.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2003-03-24T14:41:49.22?x=1Ct+4WU2IPKtDA&amp;y=PW8EJQO99////////////w&amp;z=QUtZbbH6pvY&amp;ow=0.612877&amp;ox=0.057523&amp;oy=-0.780640&amp;oz=0.108050&amp;select=Sol:Earth&amp;fov=45.000004&amp;ts=1.000000&amp;rf=57223&amp;lm=0">Same scene without clouds selected.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_comet_tails">
<title>Comet Tails (&comettails;)</title>
<para>&celestia; will accurately place a gaseous comet tail behind all comets, properly oriented to always point away from the Sun.  To see those tails, you have to be close enough to the comet.</para>
<para><emphasis>Highly Recommended</emphasis> - but requires computer resources.  Try turning off if &celestia; is running too slowly.
</para>
<screenshot>
<screeninfo>Venus and comet Ikaya-Zhang in Feb, 2002.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig9.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Venus and comet Ikaya-Zhang in Feb, 2002.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Venus/2002-02-12T09:44:37.36?x=GOVM1fji8HLIDA&amp;y=BDqKmqLy71L//////////w&amp;z=Zbojlky5uPID&amp;ow=0.871985&amp;ox=0.128293&amp;oy=-0.105704&amp;oz=-0.460446&amp;select=Sol:Ikeya-Zhang&amp;fov=11.675808&amp;ts=1.000000&amp;rf=57223&amp;lm=0">Venus and comet Ikaya-Zhang in Feb, 2002.</ulink></para></caption>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="opt_constellations">
<title>Constellations (&constellations;)</title>
<para>&celestia; will display both constellation shapes and their official "borders" for each of the 88 constellations in the sky.  In the second Options row, you can also turn on constellation labels.  These 3 options are useful whenever you have an interest in locating a particular constellation in &celestia;.</para>
<para><emphasis>Recommended</emphasis> - only when desired.  Does not use much computer resource.</para>
<screenshot>
<screeninfo>Constellations with borders and labels enabled.  As viewed from Earth, the Sun is "in" Capricorn.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig10.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Constellations with borders and labels enabled.  As viewed from Earth, the Sun is "in" Capricorn.</phrase>
</textobject>
<caption><para><ulink url="cel://PhaseLock/Sol:Earth/Sol/2003-01-28T21:43:22.11?x=Vm0ZM6hDJ/qzDA&amp;y=TSNET44/wv///////////w&amp;z=pcrvTh/EE9Lz/////////w&amp;ow=-0.260077&amp;ox=-0.143412&amp;oy=-0.945635&amp;oz=0.132543&amp;select=Sol&amp;fov=34.907467&amp;ts=1.000000&amp;rf=65439&amp;lm=8">Constellations with borders and labels enabled.  As viewed from Earth, the Sun is "in" Capricorn.</ulink></para></caption>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="opt_eclipse_shadows">
<title>Eclipse Shadows (&eclipseshadows;)</title>
<para>&celestia; can compute the actual position of the shadows a moon will cast on a planet below as the moon passes in front of the Sun (a solar eclipse).  Turning this feature on will cause shadows to be drawn on all planets whenever an eclipse occurs.  It is an elegant feature, particularly when observing moon shadows drifting across the giant gas worlds of Jupiter and Saturn.</para>
<para><emphasis>Highly Recommended</emphasis> - but does require significant computer resources.  Note:  On some older video cards, eclipse shadows may lock up the program.</para>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Io eclipsing Jupiter, an example of Eclipse Shadows.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig11.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Io eclipsing Jupiter, an example of Eclipse Shadows.</phrase>
</textobject>
<caption><para><ulink url="cel://PhaseLock/Sol:Jupiter:Io//2003-01-30T08:22:03.99?x=2HPYJQ8gkqeEDA&amp;y=nObZfKeMKQUB&amp;z=ZdL5mSrk6njC/////////w&amp;ow=0.948617&amp;ox=-0.019555&amp;oy=-0.314877&amp;oz=-0.024411&amp;select=Sol:Jupiter:Io&amp;fov=19.402893&amp;ts=10.000000&amp;rf=57239&amp;lm=0">Io eclipsing Jupiter, an example of Eclipse Shadows.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>A total solar eclipse over Africa, as seen from space.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig12.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>A total solar eclipse over Africa, as seen from space.</phrase>
</textobject>
<caption><para><ulink url="cel://PhaseLock/Sol:Earth//2006-03-29T10:00:10.14?x=CJhT/kKTMRGuDA&amp;y=Trq1EVGVMg&amp;z=92vpvZKWWFQC&amp;ow=0.633311&amp;ox=0.076168&amp;oy=-0.767258&amp;oz=-0.066564&amp;select=Sol:Earth&amp;fov=19.402893&amp;ts=1.000000&amp;rf=57239&amp;lm=0">A total solar eclipse over Africa, as seen from space.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_galaxies">
<title>Galaxies (&galaxies;)</title>
<para>&celestia; comes with a galaxy data file that tells the program the position of numerous galaxies in the night sky and what type they are.  When this option is selected, &celestia; will create a small, dim sketch of each galaxy and position it in the proper place in space.  It will also draw the huge band of starry haze we know as the Milky Way.  Selecting the option, therefore, will improve your &celestia; experience and you will be able to see dim galaxies in the distance.  You can even travel to them in your spaceship.  However, the galaxy sketches are simple and appear as dim "blobs".  Later versions of &celestia; will improve on the graphics of galaxies.</para>
<para><emphasis>Recommended</emphasis> - but does require computer resources.  Try turning off if &celestia; is running too slowly.
</para>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Neptune and Milky Way with Galaxies enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig13.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Neptune and Milky Way with Galaxies enabled.</phrase>
</textobject>
<caption><para><ulink url="cel://PhaseLock/Sol:Neptune//2006-03-29T10:01:33.81?x=2Gskq/E6DO4bDg&amp;y=ir4/pNxkBYn+/////////w&amp;z=VXCvtfOiV8ZAAQ&amp;ow=0.017244&amp;ox=-0.142499&amp;oy=-0.989644&amp;oz=-0.000777&amp;select=Sol:Neptune&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57239&amp;lm=0">Neptune and Milky Way with Galaxies enabled.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene without Galaxies enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig14.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Same scene without Galaxies enabled.</phrase>
</textobject>
<caption><para><ulink url="cel://PhaseLock/Sol:Neptune//2006-03-29T10:01:48.90?x=cLQ0q1GcDO4bDg&amp;y=6jGoRGVgBYn+/////////w&amp;z=VcNKIyo3V8ZAAQ&amp;ow=0.017244&amp;ox=-0.142499&amp;oy=-0.989644&amp;oz=-0.000777&amp;select=Sol:Neptune&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57235&amp;lm=0">Same scene without Galaxies enabled.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_night_side_lights">
<title>Night Side Lights (&nightsidelights;)</title>
<para>&celestia; has the ability to light up the night sky.  From space, the thousands of cities across our continents are ablaze with light so bright that they can be seen vividly from hundreds of km up.  Turning on this option commands &celestia; to add those lights to the nighttime vista you see from space above Earth. Night textures are also used in some add-ons to show fictional cities or volcanic lava flows at night.</para>
<para><emphasis>Highly Recommended</emphasis> - but does require computer resources.  Note:  On older video cards, night-side lights may slow down the program.  Try turning off if &celestia; is running too slowly.</para>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Earth, Sun and terminator with night-lights enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig15.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Earth, Sun and terminator with night-lights enabled.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2006-03-29T04:38:33.20?x=2E27BL0aqA2uDA&amp;y=M4QqEncs3////////////w&amp;z=g6SKdIqs2kQC&amp;ow=0.633149&amp;ox=0.213732&amp;oy=0.692488&amp;oz=-0.271848&amp;select=Sol:Earth&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57239&amp;lm=0">Earth, Sun and terminator with night-lights enabled.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene without night-lights enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig16.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Same scene without night-lights enabled.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2006-03-29T04:38:51.19?x=2E1CQPuTqA2uDA&amp;y=a2vZXHEs3////////////w&amp;z=g6RQFYpc3kQC&amp;ow=0.633149&amp;ox=0.213732&amp;oy=0.692488&amp;oz=-0.271848&amp;select=Sol:Earth&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57111&amp;lm=0">Same scene without night-lights enabled.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_orbits">
<title>Orbits (&orbits;)</title>
<para>&celestia; will draw the actual path of a planetary orbit through the solar system.  The Option also draws orbits of all moons, comets, asteroids and spacecraft that you choose.  Each orbit type is drawn in a different color, with the active orbits in red.  For example, if you are centered on Venus and have ?planet? orbits selected, Venus?s orbit will be highlighted in red.  All other planet orbits will be highlighted in blue. Orbits are excellent for seeing the celestial mechanics of the solar system.  Turn them on, zoom out from the Sun and view the orbits from above.  Speed up time (see later discussion) and you will see the alignment of planets speeding around the Sun, or view the orbits of satellites as they circle around a planet. The Orbit/Label section of the <guimenu>View Options</guimenu> Menu allows you to turn specific orbit types on or off with a check mark in the box.</para>
<para><emphasis>Recommended</emphasis> - when desired.  Does not use much computer resources.</para>
<screenshot>
<screeninfo>Solar System with orbits enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig17.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Solar System with orbits enabled.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol/2006-03-29T04:39:48.33?x=AAAgHOqyiGVUCQ&amp;y=CkzQLZRSPWnc&amp;z=VcpQPfVHxHG59////////w&amp;ow=0.219300&amp;ox=-0.005459&amp;oy=0.973495&amp;oz=0.064688&amp;select=Sol&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57271&amp;lm=0">Solar System with orbits enabled.</ulink> The inclined orbit is that of Pluto, a large Kuiper Belt Object that may have swung into its current orbit through a past collision with another object.</para></caption>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="opt_planets">
<title>Planets</title>
<para>Normally selected.  <emphasis>Highly Recommended.</emphasis></para>
</sect1>
<sect1 id="opt_ring_shadows">
<title>Ring Shadows</title>
<para>&celestia; can compute and draw the actual position of the shadows a planet's ring will cast on a planet below and conversely, the shadow a planet will cast on its rings.</para>
<para><emphasis>Highly Recommended</emphasis> - but does require significant computer resources.</para>
<note><para>On some older video cards, ring shadows have also been known to slow down the program dramatically or lock it up entirely.</para></note>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Ring Shadows enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig18.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Ring Shadows enabled.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Saturn/2006-03-29T04:40:33.59?x=gJW90XX90hlhDA&amp;y=CpSPoBqCgcYB&amp;z=JXaSk5dugImR/////////w&amp;ow=-0.647476&amp;ox=-0.274139&amp;oy=0.707176&amp;oz=-0.074328&amp;select=Sol:Saturn&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57239&amp;lm=0">Ring Shadows enabled.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene without night-lights enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig19.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Ring Shadows disabled.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Saturn/2006-03-29T04:40:49.83?x=gJUtN50Z0hlhDA&amp;y=CnRQz0uOgcYB&amp;z=JXaSIiIigYmR/////////w&amp;ow=-0.647476&amp;ox=-0.274139&amp;oy=0.707176&amp;oz=-0.074328&amp;select=Sol:Saturn&amp;fov=20.674709&amp;ts=1.000000&amp;rf=53143&amp;lm=0">Ring Shadows disabled.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_stars_as_point">
<title>Stars As Discs or Points (&starsaspoints;)</title>
<para>&celestia; can display stars either as points, scaled discs or fuzzy points.  Which looks better is a matter of personal taste and the resolution of your monitor.  In general, a scaled disc forms a prominent circular disc that varies in both diameter and brightness based upon the actual size, magnitude and distance of the star from you.  For example, a bright Red Giant star nearer Earth will be a larger reddish disc in the sky with this option enabled, while a smaller main sequence yellow star will appear smaller and dimmer in size.  Scaled discs are not designed to mimic the true visual appearance of the sky.  Instead, they enable you to locate stars by type and magnitude.  Fuzzy points take a similar approach but draw a smaller, more realistic ?point? that varies in size and brightness.  When your monitor screen resolution is above 800x600 or higher, fuzzy points make a clearer distinction between brightnesses of a star and can produce a realistic sky view.  The 3rd option, stars displayed as Points, tend to be of similar brightness but look better at 800 x 600 and lower resolutions.  Selecting Points may also make &celestia; run faster, but this is only noticeable if you adjust the visibility limit of how many stars are drawn.  The slider in the Filter Stars section at the bottom of the <guimenuitem>View Options</guimenuitem> menu is set to one million light years so that all stars are visible, but you can lower it so that you are looking at only close stars to our own.</para>
<para>You can cycle between the three star styles with &starsaspoints; or you can set the style by using the <guisubmenu>Star Style</guisubmenu> sub-menu on the <guimenu>Render</guimenu> Menu.</para>
<informaltable pgwide="1">
<tgroup cols="3">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Voyager 1 against stars - windows mode - Stars as Points enabled.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig20.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Voyager 1 against stars - windows mode - Stars as Points enabled.</phrase>
</textobject>
<caption><para>Voyager 1 against stars - windows mode - Stars as Points enabled.</para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Stars as Points off - at resolution of 800x600 (windows mode).</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig21.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Stars as Points off - at resolution of 800x600 (windows mode).</phrase>
</textobject>
<caption><para>Stars as Points off - at resolution of 800x600 (windows mode).</para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene as figure 21 but at a higher screen resolution of 1280x720.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig22.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Same scene as figure 21 but at a higher screen resolution of 1280x720.</phrase>
</textobject>
<caption><para>Same scene as figure 21 but at a higher screen resolution of 1280x720.</para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_markers">
<title>Markers (&markers;)</title>
<para>When enabled by pressing the &markers; keys, &celestia; will draw a small square box around any object you select and mark.  To mark an object, simply select it with a single or double click of the <mousebutton>left</mousebutton> mouse button so that its name appears in the upper left corner.  Then, <mousebutton>right</mousebutton>-click on it and choose <guimenuitem>Mark</guimenuitem>.  You can also press &setmark; from the keyboard to mark an object.  You can mark as many objects as you like.  Objects not currently selected will have a green mark.  Currently selected objects will have a red mark.  To unmark an object, <mousebutton>right</mousebutton>-click on it and choose <guimenuitem>Unmark</guimenuitem>, or press &setmark; again.  To turn off all Marks, press &markers; again.  Marks are very useful for tracking an object in space that you've lost sight of, or for highlighting objects so that you can find them easily again.  For example, you can mark the Voyager 2 spacecraft and no matter where you travel in space, you can always see it by scrolling across the sky to locate its mark.</para>
<note><para>All Marks are erased and reset to zero when the program closes.</para></note>
<screenshot>
<screeninfo>The Sun and inner planets marked.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig221.jpg" />
</imageobject>
<textobject>
<phrase>The Sun and inner planets marked.</phrase>
</textobject>
<caption><para>The Sun and inner planets marked.</para></caption>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="opt_labels">
<title>Labels</title>
<para>The next Option in the <guimenu>View Options</guimenu> menu provides you the ability to turn on or off various labels for planets, major stars, moons, etc., and to select which orbit paths you want Celestia  to draw.  Turn them on or off as you desire by checking the boxes.  They do not use much computer power.
</para>
<variablelist>
<varlistentry><term>&constellationlabels;</term><listitem><para>Toggle constellation labels</para></listitem></varlistentry>
<varlistentry><term>&starlabels;</term><listitem><para>Toggle key star labels</para></listitem></varlistentry>
<varlistentry><term>&galaxylabels;</term><listitem><para>Toggle galaxy labels</para></listitem></varlistentry>
<varlistentry><term>&moonlabels;</term><listitem><para>Toggle moon labels</para></listitem></varlistentry>
<varlistentry><term>&asteroidlabels;</term><listitem><para>Toggle asteroid labels</para></listitem></varlistentry>
<varlistentry><term>&spacecraftlabels;</term><listitem><para>Toggle spacecraft labels</para></listitem></varlistentry>
<varlistentry><term>&planetlabels;</term><listitem><para>Toggle planet labels</para></listitem></varlistentry>
<varlistentry><term>&locationlabels;</term><listitem><para>Toggle location labels</para></listitem></varlistentry>
</variablelist>
</sect1>
<sect1 id="opt_information_text">
<title>Information Text (&verbose;)</title>
<para>This box allows you to choose how much data you want displayed when you select an object.  Pressing the &verbose; key also toggles the information display on or off through two levels of detail.  If you see no text at all on the screen, press &verbose; to turn it on.</para>
</sect1>
<sect1 id="opt_filter_stars">
<title>Filter Stars</title>
<para>This slider determines how many stars &celestia; will draw at one time.  It regulates star number by how far away a star is from your viewpoint.  By default, it is set at 1,000,000 light years.  Since the diameter of our galaxy (the Milky Way) is about 100,000 LY across, &celestia; will draw all stars in its data base at this slider setting.  However, you can lower the slider and command &celestia; to draw only closer stars.</para>
<para>For example, if you set the slider to 100, the program will only draw stars that are within 100 light years of Earth.  Since this requires far less computing power than the highest slider value, this may be useful if the program is running slowly for you.  Lowering the slider will speed things up.  Also, you may have a scientific need to only see the closest stars to your viewpoint.</para>
</sect1>
<sect1 id="opt_locations">
<title>Locations (&locationlabels;)</title>
<para><guimenuitem>Locations</guimenuitem> under the <guimenu>Render</guimenu> menu  is a new menu feature to &celestia; 1.3.1   The program will mark and label any city, mountain, sea, valley, crater, landing site or other feature you desire on a planet or moon, and display its name above its latitude and longitudinal position.  To enable this feature, press the &locationlabels; key.  To toggle the list of features on or off, use the menu checkboxes in the <guimenu>Render</guimenu> sub-menu.  A fast growing list of features is available at <ulink url="http://www.shatters.net/~claurel/celestia/files/locations/">http://www.shatters.net/~claurel/celestia/files/locations/</ulink> and the &celestia; <ulink url="http://www.shatters.net/forum/">forum</ulink>.</para>
<para>The forum will also explain how to make your own list of locations.  To use a Locations list, locate and download a list file from the web and place it in your <filename>Extras</filename> folder in the main &celestia; folder in/on your computer.  It will then display when the Locations option is enabled.  When observing a planet or moon from far away, only the largest or most important locations are shown.  As you approach it, more labels will appear.  To change the distance at which particular labels first appear, move the slider in the <guilabel>Minimum Labeled Feature Size</guilabel> panel in the <guisubmenu>Locations</guisubmenu> sub-menu.</para>
<para>Locations may be selected by entering their names (see :  Selecting Objects by Enter/Name/Enter Method section below).  Generally, you must enter the name of the planet or moon where the location is found, as well as the location itself.  For example, to locate and go to Cairo, press the &Enter; key and a sub-screen will appear in &celestia; with a place to type an entry.  Type 'Earth/Cairo' (or 'Sol/Earth/Cairo' if you're outside the Solar System.), then press &Enter; again and you will go to a position located directly above Cairo.</para>
</sect1>
<sect1 id="opt_stars_visible">
<title>Stars Visible (&dec_magnitude;, &inc_magnitude;)</title>
<para>On the <guimenu>Render</guimenu> menu, select <guimenuitem>More or Fewer stars visible</guimenuitem>, or toggle with the keyboard shortcuts.  This tells &celestia; how many stars to draw in the sky at one time.  It controls star numbers by Apparent Magnitude (visible brightness).</para>
<para>You can choose to display only bright stars.  On the surface of Earth, our view generally includes stars of an apparent magnitude of +6.5 or less (the lower the number, the brighter the star).  Setting this option to Magnitude 6.5 - 7.5 results is a realistic sky as seen from Earth on a clear night, with only about 3,000 stars visible.</para>
<para>However, if you were living on a space station far above earth's atmosphere, you might see stars up to a magnitude of 9.0 with the naked eye.  Because there are more stars in the sky, many &celestia; users prefer higher star settings of 8.0 to 10.0.  The keyboard shortcuts are very useful here.</para>
<para>Experiment by using the keyboard key &dec_magnitude; to decrease limiting magnitude (fewer stars visible), and &inc_magnitude; to increase limiting magnitude. </para>
</sect1>
<sect1 id="opt_automag">
<title>Automag (&automag;)</title>
<para>The default download of &celestia; actually contains about 100,000 stars up to magnitude 15.0 visible from the vicinity of Earth.  A setting of 11.0 or more simulates the view you would see through a telescope.  However, millions of stars have been cataloged by Astronomers and if you wish, you can download a star database from the &celestia; website that contains over 2,100,000 stars.  If this file is loaded, and you select the maximum magnitude limit of 15.0, the sky will be ablaze with stars.</para>
<note><para>This level of star display will dramatically slow down even fast computers.</para></note>
<para>The choice is yours.  Fortunately, &celestia; helps you to set realistic star magnitudes with a feature known as AutoMag.  To enable AutoMag, press the &automag; keys.  To disable it, press them again.  When Automag is enabled, &celestia; will turn on or turn off stars to maintain a reasonable visual range whenever you change your field of view (FOV).  It will also restrict the view to a range of 6.0 - 12.0.  A screen display will advise you of your changes.
</para>
</sect1>
<sect1 id="opt_ambient_light">
<title>Ambient Light (&dec_ambientlight;, &inc_ambientlight;)</title>
<para>On the <guimenu>Render</guimenu> menu, select <guimenuitem>Ambient Light</guimenuitem>. Since space is a near vacuum, there is very little light scattered and shadows are completely black.  You can set the ambient light level to <guilabel>none</guilabel> to simulate this and get the most realistic views of space. However, there are times when a bit of extra light is useful or aesthetically pleasing.  </para>
<para>For example, go to the dark side of any planet and adjust ambient light from <guilabel>None</guilabel> to <guilabel>Low</guilabel>, then to <guilabel>Medium</guilabel>.  You'll discover that portions of a planet?s dark side become visible with some light scattering.</para>
<para>Having a bit of extra light is also good for seeing spacecraft.  When they're on a planet's dark side, they almost disappear in the shadows.  Low or medium light allows you to track them better.  Use &dec_ambientlight; to decrease ambient light and &inc_ambientlight; to increase it through several step levels.
</para>
<note><para>Remember that no light scattering (<guilabel>None</guilabel>) is the accurate view when in space.
</para></note>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Pluto and its moon Charon with Ambient Light set to None.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig23.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Pluto and its moon Charon with Ambient Light set to None.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Pluto/2006-03-29T04:42:34.18?x=gqIGr1vv4t2QDA&amp;y=aAp+YR6GBptA&amp;z=omslMym0YF3lAQ&amp;ow=0.609327&amp;ox=0.299510&amp;oy=0.684028&amp;oz=0.266685&amp;select=Sol:Pluto&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57239&amp;lm=0">Pluto and its moon Charon with Ambient Light set to None.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene with Ambient Light set to Medium.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig24.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Same scene with Ambient Light set to Medium.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Pluto/2006-03-29T04:43:12.52?x=gqKy2xVm5N2QDA&amp;y=aApudZYkBptA&amp;z=omuVl3saYV3lAQ&amp;ow=0.609327&amp;ox=0.299510&amp;oy=0.684028&amp;oz=0.266685&amp;select=Sol:Pluto&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57239&amp;lm=0">Same scene with Ambient Light set to Medium.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="opt_antialiasing">
<title>Antialiasing (&antialias;)</title>
<para>On the <guimenu>Render</guimenu> menu, select <guimenuitem>Antialiasing</guimenuitem>.  These are instructions to &celestia; to use certain graphical processing and smoothing techniques when it draws lines on the viewscreen.</para>
<para>In general, Antialiasing evens out the lines used to draw sharp edges of spacecraft, orbit paths and constellation figures.</para>
<para><emphasis>Highly Recommended</emphasis> - but does require computer resources.  Try turning off if &celestia; is running too slowly.</para>
<note><para>Antialiasing may not be available if you do not have a higher quality graphics video card on your computer.</para></note>
</sect1>
<sect1 id="opt_render_path">
<title>Render Path (&renderpath;)</title>
<para>Not in the Render menu but controlled via keyboard, Vertex Shading is a computer graphics drawing technique that draws (renders) graphical shades (haze, shadows, specular reflections off of water or ice, etc.) on &celestia; objects.</para>
<para>To see such shading, your must have a graphics accelerator card that renders shading via a process known as Open GL.  However, as mentioned earlier, not all graphics cards can handle vertex shading properly.</para>
<para>&celestia; now handles Vertex Shading automatically.  With higher end cards, &celestia; gives you five choices for Vertex Shading.  They are:</para>
<simplelist>
<member>Basic</member>
<member>Multitexture</member>
<member>NvCombiner</member>
<member>DOT3 ARBVP</member>
<member>NvCombiner NvVP</member>
<member>NvCombiner ARBVP</member>
<member>ARBFP ARBVP</member>
<member>NV30</member>
</simplelist>
<para>The number of these available render paths you can cycle through with &renderpath; depends on the graphics card and driver version you have.  By default, &celestia; detects the type of graphics card you have and starts up your program with the highest quality rendering possible.</para>
<para>If you have an Nvidia Open GL Graphics card, all five choices will be offered.  Using the &renderpath; keyboard shortcut, select the last choice (Open GL/Nvidia Combiners); observe Earth and then cycle through the other choices.  You will see surface shadows and a haze appear or disappear on Earth.</para>
<para>If you have another brand of graphic accelerator card, cycle through whatever choices &celestia; presents to you.  If you have no graphics card at all (i.e. - your computer has a minimal built-in graphics processor), the Basic or Multitexture settings are your only choices.
</para>
<informaltable pgwide="1">
<tgroup cols="2">
<tbody>
<row>
<entry>
<screenshot>
<screeninfo>Open GL/Nvidia Combiners render path selected.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig27.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Open GL/Nvidia Combiners render path selected.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2006-03-29T04:46:45.03?x=aA0yR2AW5A6uDA&amp;y=JBwWY99k5////////////w&amp;z=fTQlxr4wI0UC&amp;ow=0.356125&amp;ox=-0.047490&amp;oy=-0.915858&amp;oz=0.179234&amp;select=Sol:Earth&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57235&amp;lm=0">Open GL/Nvidia Combiners render path selected.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry><entry>
<screenshot>
<screeninfo>Same scene with Basic render path only.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="fig28.jpg" format="PNG" />
</imageobject>
<textobject>
<phrase>Same scene with Basic render path only.</phrase>
</textobject>
<caption><para><ulink url="cel://Follow/Sol:Earth/2006-03-29T04:47:04.95?x=aI3/iKuc5A6uDA&amp;y=DY6fEdlk5////////////w&amp;z=fXQFa4pFJ0UC&amp;ow=0.356125&amp;ox=-0.047490&amp;oy=-0.915858&amp;oz=0.179234&amp;select=Sol:Earth&amp;fov=20.674709&amp;ts=1.000000&amp;rf=57235&amp;lm=0">Same scene with Basic render path only.</ulink></para></caption>
</mediaobject>
</screenshot>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<note><para>Keyboard shortcuts for turning on and off (toggling) the above options exist and are summarized in a later section below.  You can press these keys instead of pulling down the <guimenu>Render</guimenu>, <guimenuitem>View Options</guimenuitem> menu.
</para></note>
</sect1>
</chapter>
<chapter id="alternate_textures">
<title>Alternate Textures and Surfaces</title>
<para>&celestia; comes with a moderate collection of textures (graphical files) that the program uses to draw the surfaces of planets, moons, asteroids, spacecraft, etc.  &celestia; takes great care to try to include textures that are true and complete or partial photographs of the planet or moon.  In that way, the program's images are impressively accurate.</para>
<para>However, add-ons developed by forum members and others are available for download from various websites in the &celestia; community that define Alternate Surface maps for some space objects.</para>
<para>For example, you can command &celestia; to load an image of the Earth as it may have looked 4 billion years ago, soon after it formed.  Its surface will be covered with craters and lava flows.  Another Alternate Surface available for Earth is this latitude and longitude grid, that overlays a map of the equator, prime meridian, Tropics of Cancer and Capricorn, etc. onto a modern image of the planet.</para>
<para>Alternate surfaces are often used for global maps of temperature, elevation or other data.  Only one Alternate surface is displayed at a time.  To choose an Alternate Surface, <mousebutton>right</mousebutton>-click on the object.  If an Alternate Surface is available (has been installed in your program files) it will appear in the menu that is displayed.  Simply click on its name and &celestia; will load and draw the Alternative texture.  To return to the original "normal" texture, <mousebutton>right</mousebutton>-click on the object again, choose <guisubmenu>Alternate Surfaces</guisubmenu> and select the <guimenuitem>Normal</guimenuitem> texture.</para>
<note><para>There are times when you might wish to have two alternate textures displayed at the same time, representing different bodies.  For example, you might have an image of the Primitive Earth and the Primitive Moon in your texture files and want &celestia; to draw both of them together.  To do this, you must locate those files in your &celestia; texture folder and name both of those files with the same name.
</para><para>For example, if you name the Primitive Earth texture "Primitive", and the primitive Moon texture "Primitive" and place them in two different folders, both will be drawn.  The step by step procedure for doing this is a bit too complex to cover here in depth.  A posting on the &celestia; forum will help you accomplish this, if you so desire.</para></note>
<sect1 id="limit_of_knowledge">
<title>Limit of Knowledge Textures (&limit_of_knowledge;)</title>
<para>
The surfaces of some of the bodies in our solar system have only been mapped incompletely.  By default, &celestia; uses surface maps that have the unknown regions filled in with plausible surface features, typically cloned from some part of the body that has been imaged.  But &celestia; also includes a set of maps called 'limit of knowledge textures' (LOK) that depict the unknown areas as blank, clearly showing where our spacecraft have and have not aimed their cameras.  The &limit_of_knowledge; key toggles between the default 'interpretive' maps and the limit of knowledge textures.  You can also load them with a <mousebutton>right</mousebutton>-click and selection of <guimenuitem>Limit of Knowledge</guimenuitem> from the context menu.
</para>
</sect1>
</chapter>
<chapter id="movement">
<title>Movement</title>
<para>General movement in &celestia; is one of the highlights of this program.  It is easy.  Movement keys are very important for enjoying &celestia;.  For example, if you wish to go into an orbit hovering above a planet, drop down to the surface or fly around in your spaceship, you will need to change direction, orientation and distance in space frequently.  There are 15 keyboard or mouse general movement commands.  Let's return to our opening scene of the moon Io (select Io from the Solar system Browser and Goto).</para>
<orderedlist>
<listitem><para><mousebutton>Right</mousebutton>-click on the scene in front of you and while holding down the <mousebutton>right</mousebutton> mouse button, move your mouse (<mousebutton>Right</mousebutton>-dragging).  Io will rotate left, right, up or down.  You can view it from any perspective you wish.</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click your mouse and while holding the button down, drag the mouse.  The whole scene will shift as a whole.</para></listitem>
<listitem><para>Tap the <keycap>Down Arrow</keycap> on the keypad or <keycap>2</keycap> on numeric keypad.  Your view of Io will pitch upward.  Make sure you press the key labeled <keycap>Num Lock</keycap> at the top of the numeric keypad.  If so, there should be a little light lit up above the numbers on your keyboard.</para></listitem>
<listitem><para>Tap the <keycap>Up Arrow</keycap> on the keypad or <keycap>8</keycap> on numeric keypad.  Your view of Io will pitch downward.</para></listitem>
<listitem><para>Tap the <keycap>Left Arrow</keycap> on the keypad or <keycap>7</keycap> on numeric keypad.  Your view will rotate (roll) counter-clockwise</para></listitem>
<listitem><para>Tap the <keycap>Right Arrow</keycap> on the keypad or <keycap>9</keycap> on numeric keypad.  Your view will (roll) clockwise.</para></listitem>
<listitem><para>Tap the <keycap>4</keycap> key on the numeric keypad of the keyboard (the one on the right side).  The view will move (yaw) to the left</para></listitem>
<listitem><para>Tap the <keycap>6</keycap> key on the numeric keypad.  The sky will move (yaw) to the right as a whole.</para></listitem>
<listitem><para>Tap the <keycap>5</keycap> key on the numeric keypad to instantly stop all pitch, roll and yaw movement.</para></listitem>
<listitem><para>Hold down the &Shift; key and press one of the <keycap>Arrow</keycap> keys (e.g.  <keycombo action="simul">&Shift; <keycap>Right Arrow</keycap></keycombo>).  You will ?orbit? around the object in view, either left/right, or up/down.  This is convenient to see all of an object quickly.</para></listitem>
<listitem><para><keycombo action="simul"><mousebutton>Right-click</mousebutton> <mousebutton>Left-click</mousebutton><keycap>Drag</keycap></keycombo> your position will advance toward or recede away from the object.</para></listitem>
<listitem><para><keycombo action="simul">&Ctrl; <mousebutton>left</mousebutton> <keycap>Drag</keycap></keycombo> - same as #&nbsp;10 above</para></listitem>
<listitem><para><mousebutton>Roll Center Mouse Wheel</mousebutton> (if you have one) forward or backward - same as #&nbsp;10 above.</para></listitem>
<listitem><para>Press the <keycap>End</keycap> key on the keyboard.  This is the same as #&nbsp;10 but using the keyboard only.  Your position above Io will rapidly recede away.  Hold down the key and you can move light years away if you wish.</para></listitem>
<listitem><para>Press the <keycap>Home</keycap> key on the keyboard.  Your position above Io will rapidly advance toward the moon.</para>
</listitem>
<listitem><para>Press the &lookback; on the keyboard.  This is a Lookback command.  It will reverse your view so that instead of looking forward, you will look behind you (a rearview window).  It is very useful when flying from one planet to another.  You can see forward and then examine your journey from the rear view, watching the planet or moon recede from you.</para>
</listitem>
</orderedlist>
<note><para>The speed with which the view turns when you press the above keys is initially set at a particular value (120) in one of the files that &celestia; uses to operate.  That file is called <filename>celestia.cfg</filename>, and can be found in the main (root) directory of the &celestia; folder.  If you find that your view is turning too fast or too slowly for your taste when you press a movement key, that document can be opened by you and the Rotate Acceleration (turning speed) of the above keys can be lowered or increased.</para><para>To do so, double-click on the file.  If a menu comes up asking you which program you wish to use to open the document, choose "WordPad" (for Windows systems) or the proper plain text editor for MAC and Linux systems.  When open, locate the line "RotateAcceleration 120" and change the number either higher (to turn even faster) or lower (to turn more slowly).</para><para>For example, RotateAcceleration 30 will result in your view turning much more slowly when you hit a movement key.  Some users prefer this, particularly if they use the &celestia; spaceship.  Do not change any other values in this document, or &celestia; may not operate properly.  After changing, save the change by clicking the <guimenu>File</guimenu> and <guimenuitem>Save</guimenuitem> menu choices, and close the document.</para></note>
<note><para>The above five keys resemble a "zoom" ability.  However, they don't magnify an image; they just reposition you toward or away from it.  Because this feature operates exponentially, you can adjust the distance much more finely when your viewpoint is close to the object of interest.  Exponential control also makes it possible to move smoothly and rapidly from a distance of one meter to one million light years away from a &celestia; object without sacrificing precision at small distances, or experiencing long time delays traveling long distances.</para></note>
<para>Joystick control: You can also control your movement via a joystick (Windows only).  The commands for joystick control of &celestia;  are listed in the back of this document, in the Keyboard and Mouse Command Summary.
</para>
</chapter>
<chapter id="selecting_objects">
<title>Selecting Objects</title>
<para>In &celestia;, you will usually have some object selected.  If so, the program will list its name in the upper left-hand corner.  Currently, it is Io, but it could also be a star, planet, moon, asteroid, comet, spacecraft, or galaxy.  The simplest way to select an object is to point at it with your mouse and <mousebutton>left-click</mousebutton> on it. Try clicking on a star to select it. The information about Io is replaced with details about the star. Note that you have not actually gone there or changed anything yet. You've simply told &celestia; that you have selected a new object. (If you see no text on the screen, type the &verbose; key on the keyboard.)</para>
<para>To go to the star you just selected, you have four main ways to make the journey:</para>
<orderedlist>
<listitem><para>If you <mousebutton>right-click</mousebutton> on the star, and select <guimenuitem>Goto</guimenuitem>, &celestia; will take you at hyper-light speed directly to that star and position you in space at a convenient distance.</para></listitem>
<listitem><para>Alternately, you can press the letter &goto; on the keyboard.  That is the shortcut command for <quote>Goto</quote>.</para></listitem>
<listitem><para>You can select the star and fly to it in your spaceship.  It takes longer but sometimes the journey is half the fun of getting there.  How to operate your spaceship is explained later below.</para></listitem>
<listitem><para>You can also select an object using keyboard commands, then use the advance <keycap>Home</keycap> key, or recede <keycap>End</keycap> key to get there.  To do so, simply point at a star or planet, <mousebutton>left</mousebutton>-click on it with the mouse so that it is selected and tap both the &center; and the &follow; keys on the keyboard.  The &center; key tells &celestia; to center a selected object in the middle of your viewscreen.  Double-clicking quickly on an object will also center it.  The &follow; key tells &celestia; to follow the selected object, keeping it the same distance from you even though it is moving through space.  Let鈥檚 try it!</para>
<para>Point at a star, <mousebutton>left</mousebutton>-click on it to select it, and tap the &center; key.  It will swing and become centered.  Then press the &follow; key.  The words "Follow ___(star鈥檚 name)____" will appear in the lower right of the screen.  Now that you are following that object, go to it by holding down the advance <keycap>Home</keycap> key.  When you get there, back away from the object using the recede <keycap>End</keycap> key.</para></listitem>
</orderedlist>
<para>If you are following an object, pressing &goto_surface_win; (Windows) &goto_surface_lin; (KDE) will take you directly to the surface, looking at the horizon.  Although it will work for all space objects, it?s designed for planetary bodies, moons, etc.</para>
<para>To return to our solar system from anywhere in the universe (a very useful thing), press the &home; key on the keyboard.  That will select "Sol" (the Sun).  Tap the &goto; key and you will be whisked back to our Sun.</para>
<note><para>You will use these two keystrokes constantly as you explore the &celestia; universe and wish to return home.</para></note>
<para>To cancel a current selection, hit the &cancel; key on the keyboard.  To unselect everything and release your hold on your current object, press the &esc; key in the upper left of your keyboard.  You will now be adrift in space.  You can still turn and point at anything you want, but pressing the &goto; <quote>Goto</quote> key will have no effect.</para>
<para>There is another way to select objects and is one you will use often.  To demonstrate it, click <ulink url="cel://Follow/Sol:Jupiter/2003-03-24T15:44:34.12792?x=wB/kGm0QohCADA&amp;y=4JGCGET9GCQB&amp;z=1Uv4TdC76qfG/////////w&amp;ow=0.930881&amp;ox=0.020821&amp;oy=-0.360821&amp;oz=0.053249&amp;select=Sol:Jupiter&amp;fov=45.000004&amp;ts=1.000000&amp;ltd=0&amp;rf=57239&amp;lm=0">here</ulink>.  You will be taken to a position above the planet, Jupiter.  <mousebutton>Right</mousebutton>-click on Jupiter to bring up a menu of options.  One of them is <guisubmenu>Satellites</guisubmenu>.  Choose it and a list of Jupiter's moons will appear.  <mousebutton>Left</mousebutton>-click on any one of them and press the &goto; key to travel to it.  You can use the right-click feature when the object you visit orbits the Sun or planet directly.  If there is no <guisubmenu>Satellites</guisubmenu> option in the menu that appears with a <mousebutton>right</mousebutton>-click, that means the planet or moon has nothing else orbiting it.</para>
<note><para>All of these keyboard shortcut strokes are summarized in a later section.
</para></note>
<sect1 id="select_keystroke">
<title>Select Objects by Keystroke</title>
<para>There is yet another way to select planets.  The nine (9) planets in our solar system have been given numbers from 1 for Mercury to 9 for Pluto.  To go to one of them, you can simply press the number at the top of the keyboard (not on the numeric keypad to the left) and hit the &goto; key.  For example, pressing <keycap>3</keycap> and &goto; will take you to the 3rd planet, Earth.  If you are in another (fictional) solar system, number keys will also work.  To select and go to  the Sun, press &home;, then &goto;.  This will always take you back to Sol, no matter where you are in the universe.</para>
</sect1>
<sect1 id="select_enter_name_enter">
<title>Enter/Name/Enter Method</title>
<para>You can also select an object or a Location via a convenient keyboard command.  Hit the &Enter; key and the "Target Name" window will appear at the bottom of the screen. Type the name of some object you wish to visit, such as a planet or moon or star or spacecraft, or location.  As you begin to type, &celestia; will present you with a list of objects that begin with the letters you are typing.</para>
<para>For example, if you type the letter <command>M</command>, &celestia; will display a list of up to 12 objects in its data base that begin with an "M", such as Mars, the Moon, Mir, Mercury, etc.</para>
<note><para>The program has room to display only 12 objects.  &celestia;, therefore, starts with all objects closest to you and displays the first 12 it finds in its database.  As you type the 2nd letter in your object's name, the list will now display only those objects that contain both letters.  For example, typing <command>Ma</command> will reduce the list to only Mars, and perhaps another object you may have as an add-on (e.g. the "Magellan" spacecraft).</para></note>
<para>You can complete typing the name, or you can simply press the &Tab; key to cycle the cursor from word to word in the list.  When you reach the word you desire, just press the &Enter; key again and &celestia; will complete the spelling for you (auto-complete) and select the object.  Now to go there, all you have to do is press the &goto; key or use the <keycap>Home</keycap> key.</para>
<para>Try it.  Press the &Enter; key and type a single letter. A list of objects will appear.  Type a 2nd letter.  The list will shorten.  Use the tab key, cycle through the remaining objects to any one you wish and press &Enter; again.  You will have selected that object.  Once selected, you can use all the object commands such as Center, Follow, Lock, Track, Goto, etc.</para>
<para>if you are seeking a named Location on a planet or moon, you must enter the name of the planet or moon where the location is found, as well as the location itself.  For example, instead of typing simply <command>Cairo</command>, you must enter <command>Earth/Cairo</command> (or <command>Sol/Earth/Cairo</command> if you're outside the Solar System.)  The slash mark / is needed.</para>
<para>One problem that you may encounter is what to call an object.  You can use common names or Bayer and Flamsteed designations and HD or HIP catalog numbers when entering stars and space objects in all of the Navigation and Enter menus. &celestia; stores star data taken from the HD catalog but if a star isn't in the HD catalog, the HIPPARCOS data set number is used (the prefix is "HIP").  Both the 1st name or number and 2nd name of the object/star can be spelled out or abbreviated (3 letters), with a space between them.  Examples:</para>
<informalexample>
<itemizedlist>
<listitem><para>Upsilon And</para></listitem>
<listitem><para>Ups Andromedae</para></listitem>
<listitem><para>Ups And</para></listitem>
<listitem><para>51 Peg</para></listitem>
<listitem><para>51 Pegasi</para></listitem>
<listitem><para>HD 173739</para></listitem>
<listitem><para>HIP 5643</para></listitem>
</itemizedlist>
</informalexample>
<para>Planets, moons, asteroids and artificial satellites may be named by their common name (e.g. Mir or Jupiter or Io), or they can also be specified using &celestia;'s "path" syntax.  Type the name of the star, followed by a forward slash, then the planet name/, then the moon or satellite name, etc.  For example:</para>
<informalexample>
<itemizedlist>
<listitem><para>51 Peg/b</para></listitem>
<listitem><para>Sol/Earth</para></listitem>
<listitem><para>Sol/Earth/Moon/Apollo11</para></listitem>
<listitem><para>Sol/Earth/ISS</para></listitem>
<listitem><para>Sol/Jupiter/Europa</para></listitem>
</itemizedlist>
</informalexample>
</sect1>
</chapter>
<chapter id="navigaton_menu">
<title>Navigation Menu</title>
<para>&celestia; has a complete menu dedicated to space navigation that you can use often.  Some of the choices are single commands (e.g. - Select Sol).  Others open dialog boxes that give you some choices to make, or ask for some input.  Specifically:</para>
<sect1 id="select_sol">
<title>Select Sol (&home;)</title>
<para>The <guimenu>Navigation</guimenu> <guimenuitem>Select Sol</guimenuitem> menu item directs &celestia; to "select" our Sun (called by its Latin name, Sol).  You can select and locate it in space from anywhere, even from far outside of our solar system.  It is very useful to do when you are far from home and simply want to return to our solar system.  The keyboard shortcut for selecting Sol is &home;.</para>
<note><para>Please note that all you have done at this point is select the Sun.  You have not gone there or even centered it in your viewscreen.  To do that, you must enter a 2nd command, as described later below.
</para>
</note>
</sect1>
<sect1 id="select_tour_guide">
<title>Tour Guide</title>
<para>The tour guide is a list of a few of the more interesting objects you can visit in &celestia; Select the <guimenuitem>Tour guide</guimenuitem> option in the <guimenu>Navigation</guimenu> menu to bring up the guide window, choose a destination from the list, click the <guibutton>Goto</guibutton> button, and you're off.  We urge you to visit some of these stops on the tour.</para>
<note><para>The Tour Guide is not available on the KDE version yet.</para></note>
</sect1>
<sect1 id="select_object">
<title>Select Object</title>
<para>The <guimenu>Navigation</guimenu> <guimenuitem>Select Object</guimenuitem> option opens a dialog box that enables you to type the name of an object you wish to visit and then go there.  Select this option from the menu and in the space provided, type <command>Moon</command> and click <guibutton>OK</guibutton>.  Now, hit the &goto; key and you will zoom to an orbit above our Moon.</para>
<para>Try another space object.</para>
<note><para>This option does not work for Locations</para></note>
</sect1>
<sect1 id="select_goto_object">
<title>Goto Object</title>
<para>Choosing this option from the <guimenu>Navigation</guimenu> menu opens the "Go to Object" dialog box.  There are two uses for this dialog box.  First, it can be used to find your exact position in relationship to objects you may already have selected.</para>
<para>For example, if an object (such as the planet Venus) is already selected when you choose this option, the information fields you see in the Dialog box will contain your current position in relationship to Venus.</para>
<para>This will include the object's name, and your Latitude, Longitude and Distance above its surface.  This is very useful when you are positioned above something and you want to know exactly where that spot is.  If no object is selected, the fields will be blank.</para>
<para>You can instead, change the values and go somewhere else.  For example, type <command>Mars</command>, enter 30 for the latitude, 5 for the longitude and 5000 (km) for distance.  Click <guibutton>GoTo</guibutton>.  You will be taken to a position 5,000 km above the surface of Mars, at 30掳N latitude and 5掳E Longitude.  You will automatically be placed in "Sync orbit" around the object, meaning that as it turns, you will turn with it so you are always above the spot you desire.  This is an excellent way to position yourself for eclipse events or above craters, etc.</para>
<note><para>When you arrive, you may be on the dark side of a planet.  In that case, you may have to reset the clock to a time when daylight is shining on your position (see later discussion), or you can move your position to a different longitude.</para></note>
<note><para>Longitudes are + values for positions East of (0掳E) and negative (-) for longitudes West of (0掳E).  For example, longitude -40 would be 40掳W.  "Distance" is distance to the surface of the object.</para></note>
</sect1>
<sect1 id="select_center">
<title>Center Selection (&center;, &center_co;)</title>
<para>This command will direct &celestia; to reposition any object that you have previously selected in the center of your viewscreen.  It is used frequently in &celestia;.  For example, if you select a star anywhere in the sky by <mousebutton>left</mousebutton>-clicking on it, you can center it by simply choosing this menu command, or pressing the &center; key on the keyboard.  Double-clicking on the object will also center it in your viewscreen.
</para>
<para>If you were orbiting a planet or star when you selected and chose to center a new object, you might or might not lose sight of your original object as the viewscreen moved to center the new object.  To compensate for that possibility, new in &celestia; 1.3.1 is the &center_co; key combination.  Pressing both of them together causes the viewscreen to swing to center the new object you selected, without losing sight of the original.</para>
<para>To test this out, click <ulink url="cel://Follow/Sol:Earth:Moon/2003-09-30T23:41:26.03219?x=cyncz7Cem1rNDA&amp;y=/1fu8ra8pf///////////w&amp;z=955BvvBfYQP+/////////w&amp;ow=0.998542&amp;ox=-0.014644&amp;oy=-0.047090&amp;oz=-0.021936&amp;select=Sol:Earth&amp;fov=30.671297&amp;ts=0.000000&amp;ltd=0&amp;rf=57239&amp;lm=0">here</ulink>.  You will be taken to a position behind the Moon, with the Earth off to the right.  Earth has been pre-selected, but is not yet centered.  To do so, press the &center; key.  The view will swing to the right and the Moon will almost move off screen to the left.  Return to your starting view by clicking the above link again, but this time, press the &center_co; keys together.  Earth will again center, but the Moon will still be fully visible.  Your view will take up position at a new position behind the Moon.  This new feature is obviously useful if you do not want to lose sight of the original object as you sight and center on a new one.</para>
</sect1>
<sect1 id="select_goto_selection">
<title>Goto Selection (&goto;)</title>
<para>Previously mentioned, this command will direct &celestia; to go directly to your selection, and position you a pre-calculated distance above it.  You can use it with any of the Selection options mentioned here or in the following paragraphs.  For example, if you select an object with a left mouse click, choosing this command from the <guimenu>Navigation</guimenu> menu, or pressing the &goto; key as a shortcut, will send you directly to the object you selected at high speed.  If you choose it again or press the &goto; key again, you will move closer to the object.
</para>
</sect1>
<sect1 id="select_follow_object">
<title>Follow Object (&follow;)</title>
<para>This menu and keyboard command will direct &celestia; to lock onto the object selected and follow it.  As it moves through space on its orbit, you will move also.  The object can turn below you on its axis (if it is rotating) so the longitude will change constantly, but you will stay the same distance and latitude above it.  It is routinely used when you wish to take a position in space above a planet, a moon or a spacecraft and is highly recommended.  The keyboard shortcut for "Follow" is &follow; and will be used very frequently.</para>
</sect1>
<sect1 id="select_sync_orbit">
<title>Sync Orbit (&sync;)</title>
<para>This feature lets you hover directly over the same position in space above any object selected.  For example, if you are above Earth with Africa below you, selecting Sync Orbit will tell &celestia; to keep you positioned above Africa all the time.  As the Earth turns below, so will you.  Many of our satellites (navigation, weather, spy, GPS, TV and radio) are in synchronous orbit around Earth.  The keyboard shortcut for Sync Orbit is &sync;.</para>
</sect1>
<sect1 id="select_track_selection">
<title>Track Selection (&track;)</title>
<para>This command tells &celestia; to track a selected object, keeping it centered in view.  To be useful, the selected object should first be released from other effects, then reacquired and tracked.  For example, if you are currently centered on Earth, first release your hold on it (unselect it) with the &esc; key.  Then <mousebutton>left-click</mousebutton> on it to re-select it and choose the Track Selection command.  Earth will begin to recede from you at the speed it actually travels in space (about 47,100 mph, or 78,500 km/hr), but your view will swing to track it.  To see that happen, speed up time. A particular challenge is to try chasing one of our interplanetary spacecraft using the Track Selection Command.  The keyboard shortcut for Track Selection is &track;.</para>
</sect1>
<sect1 id="select_chase_selection">
<title>Chase Selection (&chase;)</title>
<para>Although not in the pull-down <guimenu>Navigation</guimenu> Menu, this command is available by pressing the quotation &chase; key on the keyboard.  It instructs &celestia; to chase a selected object in space.  It is similar to the <guimenuitem>Follow</guimenuitem> command but locks you above the object at the same position.  Try comparing the two commands.</para>
<para>When interacting with an object, you can choose any one of the Follow, Center, SyncOrbit, Track, Chase and Lock commands at any time.  Only the most recent of these will be used.  If you type the &esc; key, the current object will be completely released from all commands.</para>
</sect1>
<sect1 id="select_lock">
<title>Lock Selection (&lock;)</title>
<para>Not available in the <guimenu>Navigation</guimenu> menu but available through a keystroke &lock;, the Lock command is used in conjunction with other commands to bind two separate celestial objects together in space.  For example, click <ulink url="cel://Follow/Sol:Jupiter/2003-03-29T03:33:40.60228?x=AALP4Oxs859/DA&amp;y=PgJEvG9pWCYB&amp;z=1Zpx9+4y6wHH/////////w&amp;ow=0.788435&amp;ox=-0.038558&amp;oy=0.613126&amp;oz=0.030982&amp;select=Sol:Jupiter&amp;fov=45.000004&amp;ts=1.000000&amp;ltd=0&amp;rf=57239&amp;lm=0">here</ulink> to select Jupiter and follow it.  You will be positioned above Jupiter with its moon Io prominently in front of you.  Notice that Io is slowly moving in its orbit around Jupiter.  Now, <mousebutton>left</mousebutton>-click once on Io to select it, and press the &lock; key.  The display in the lower right corner will now say, "Lock Jupiter 鈥

						