forked from CelestiaProject/Celestia
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
309 lines (237 loc) · 11.4 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
***************************************************************************
* Celestia *
* *
* A real-time space simulation that lets you experience our universe in *
* three dimensions. *
* *
* Copyright (c) 2001-2021, Celestia Development Team *
* *
*-------------------------------------------------------------------------*
* Celestia web site: https://celestia.space/ *
* *
* Celestia documentation: *
* https://celestia.space/guides.html *
* Celestia WikiBook: https://en.wikibooks.org/wiki/Celestia *
* *
* Celestia forums: https://celestia.space/forum/ *
* *
***************************************************************************
CONTENTS
--------
License
Getting Started
Mouse, Keyboard & Joystick Controls
Star & Solar System Browser
Selecting Objects by Name
Known Issues
User Modifiable Elements
Celestia Resources
Building From Sources
Contributions
Acknowledgements
LICENSE
-------
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details, which you should have received along with this program (filename:
COPYING). If not, request a copy from:
Free Software Foundation, Inc.
59 Temple Place - Suite 330
Boston, MA 02111-1307
USA
GETTING STARTED
---------------
Celestia will start up in a window, and if everything is working correctly,
you'll see Earth in front of a field of stars. Displayed on-screen, is some
information about your target (Earth), your speed, and the current time
(Universal Time, so it'll probably be a few hours off from your computer's
clock).
Right drag the mouse to orbit Earth and you might see the Moon and some
familiar constellations. Left dragging the mouse changes your orientation
also, but the camera rotates about its center instead of rotating around
Earth. Rolling the mouse wheel will change your distance to Earth--you can
move light years away, then roll the wheel in the opposite direction to get
back to your starting location. If your mouse lacks a wheel, you can use the
Home and End keys instead.
When running Celestia, you will usually have some object selected. Currently,
it's Earth, but it could also be a star, moon, spacecraft, galaxy, or some
other object. The simplest way to select an object is to click on it. Try
clicking on a star to select it. The information about Earth is replaced with
some details about the star. Press G (or use the Navigation menu), and you'll
zoom through space toward the selected star. If you press G again, you'll
approach the star even closer.
Press H to select our Sun, and then G to go back to our Sun. Right click on
the sun to bring up a menu of planets and other objects in the solar system.
After selecting a planet from the menu, hit G again to travel toward it. Once
there, hold down the right mouse button and drag to orbit the planet.
The Tour Guide is a list of some of the more interesting objects you can visit
in Celestia. Select the Tour Guide option in the Navigation menu to display
the Tour Guide window. Choose a destination from the list, click the Goto
button, and you're off.
That covers the very basics. For a more in-depth look at Celestia and the
controls available to you, download the "Celestia User's Guide" (written by
Frank Gregorio), available in several languages, from:
https://celestia.space/guides.html
This web page also includes links to the Celestia README file translated into
Japanese.
MOUSE, KEYBOARD & JOYSTICK CONTROLS
-----------------------------------
See the included file: controls.txt OR use the Help menu to display the Controls
list.
STAR & SOLAR SYSTEM BROWSER
-------------------------------------------
The Navigation menu contains 'Solar System Browser' and 'Star Browser'
options.
STAR BROWSER
By default, the Star Browser window displays a table of the 100 nearest stars,
along with their Distance, Apparent and Absolute Magnitude, and Type. Clicking
on the column headers will sort the stars. The table is not continuously
updated, so if you travel to another star, you should press the Refresh button
to update the table for your current position. The radio buttons beneath the
table let you switch between viewing a list of Nearest, Brightest, or 'With
planets' stars. As with the solar system browser, clicking on any star name
in the table will select it. Use this feature along with the Center and Go
To buttons to tour the stars visible from any night sky in the galaxy.
SOLAR SYSTEM BROWSER
The Solar System Browser displays a window with a tree view of all the objects
in the nearest solar system (if there is one within a light year of your current
position.) Clicking on the name of any object in the window will select it.
You can then use the Center or Go To buttons to display that object in the main
Celestia window.
SELECTING OBJECTS BY NAME
-------------------------
Celestia provides several ways to select an object by name...
1. Choose 'Select Object' from the Navigation menu, type in the object
name, and click OK.
2. Press Enter, type in the entire object name, and press Enter again.
3. Press Enter, type in the first few characters of the object name,
press the Tab key to move through the displayed listing until the
object is highlighted, then press Enter again.
You can use common names, Bayer designations or catalog numbers for stars.
Celestia currently supports the HIP, HD and SAO catalogs. Catalog numbers must
be entered with a space between the prefix and the catalog number.
KNOWN ISSUES
------------
For up-to-the-minute answers to some common problems encountered when running
Celestia, please view either the FAQ in the Help menu or take a look at the
"Celestia User's FAQ" located on the Celestia User's Forum:
https://celestia.space/forum/
USER MODIFIABLE ELEMENTS
------------------------
You can modify how Celestia starts up each time you run it, by defining your
own start-up settings. Simply open the file "start.cel" in a plain text
editor and follow the in-file instructions. Also, view the celestia.cfg file
in a plain text editor to see additional settings.
Celestia allows you to easily add real, hypothetical, or fictional objects
by creating new catalog files. It is *not* recommended that you alter the
built-in data files; nearly all desired modifications and additions can be
made by placing new catalog files in Celestia's extras folders. There are three
types of catalog files:
- ssc (solar system catalog: planets, moons, spacecraft, etc.)
- stc (star catalog)
- dsc (deep sky catalog: galaxies, star clusters, and nebulae)
All three types of catalog file are text files that can be updated with your
favorite text editing program.
CELESTIA RESOURCES
------------------
Celestia Web Site:
https://celestia.space/
Celestia User Forums:
https://celestia.space/forum/
Selden's List of Resources for Celestia:
https://www.classe.cornell.edu/~seb/celestia/
Celestia Wikibook:
https://en.wikibooks.org/wiki/Celestia
Celestial Matters Website and Forums:
http://www.celestialmatters.org/
http://forum.celestialmatters.org/
Celestia Motherlode:
http://www.celestiamotherlode.net/
Celestia Source Repository:
https://github.com/CelestiaProject/Celestia
Celestia Bug Tracking:
https://github.com/CelestiaProject/Celestia/issues
Celestia Feature Requests:
https://github.com/CelestiaProject/Celestia/issues
Celestia Discord Server:
https://discordapp.com/invite/WEWDcJh
Celestia Subreddit:
https://www.reddit.com/r/Celestiasoftware/
Celestia Archive Repository:
https://github.com/Anthony-B-Russo10/Celestia-Archive
BUILDING FROM SOURCES
---------------------
See file INSTALL for building instructions.
CONTRIBUTIONS
-------------
Authors
-------
Chris Laurel <[email protected]>
Clint Weisbrod <[email protected]>
Fridger Schrempp <[email protected]>
Bob Ippolito <[email protected]>
Christophe Teyssier <[email protected]>
Hank Ramsey <[email protected]>
Grant Hutchison <[email protected]>
Pat Suwalski <[email protected]>
Toti
Da Woon Jung <[email protected]>
Vincent Giangiulio <[email protected]>
Andrew Tribick
Hleb Valoshka
Li Linfeng
Contributors
------------
Deon Ramsey ........... Original GTK1 interface
Christopher Andre ..... Eclipse Finder
Colin Walters ......... Endianness fixes
Peter Chapman ......... Orbit path rendering changes
James Holmes ..........
Harald Schmidt ........ Lua scripting enhancements, bug fixes
Nils Larsson .......... Qt enhancements
Documentation
-------------
Frank Gregorio ........ Celestia User's Guide
Hitoshi Suzuki ........ Japanese README translation
Christophe Teyssier ... DocBook and HTML conversion of User's Guide
Diego Rodriguez ....... Acrobat conversion of User's Guide
Don Goyette ........... CEL Scripting Guide
Harald Schmidt ........ Celx/Lua Scripting Guide
Content
-------
Please see the README file in the CelestiaContent repository.
Libraries
---------
# This software is based in part on the work of the Independent JPEG Group.
# Some versions of Celestia may use the SPICE system for spacecraft and
planetary information, developed by Caltech/JPL under contract to NASA.
# Many cylindrical projections of photographs were performed by Fridger
Schrempp with Matthew Arcus 'mmps' software,
http://www.users.globalnet.co.uk/~arcus/mmps/
# The lower resolution textures were all converted from their higher resolution
versions using Gimp.
# The star database (stars.dat) was derived from the ESA's HIPPARCOS data set.
# Constellation boundaries are drawn from Davenhall & Leggett's "Catalogue of
Constellation Boundary Data":
http://cdsweb.u-strasbg.fr/viz-bin/ftp-index?/ftp/cats/VI/49
Other work
----------
# Selden Ball deserves a special mention for suffering more prerelease versions
finding more bugs, and giving more feedback than anyone else.
# Christophe Campos aka ElChristou created the splash screen for Celestia.
# The MacOS X icon was designed by Chris Alford: http://www.chrisalford.com/
# The txf font format used by Celestia was devised by Mark Kilgard.
ACKNOWLEDGEMENTS
----------------
A very big thank you for creating Celestia goes to Chris Laurel who started this
program in the year 2001.
https://celestia.space/
Special thanks go to all Celestia users who submit bug reports, suggestions, and
fixes. Celestia wouldn't be the program it is today, without their help.
The Celestia Development Team