Celestia

1

2
#************************************************************************
3
#                     Celestia Configuration File
4
#
5
# This file contains configuration data read by Celestia each time it
6
# is run. Many of the items may be changed to suit your specific needs
7
# or requirements. PLEASE make a backup copy of this file before you
8
# make any changes to it.
9
#
10
# To learn more about Celestia, visit the Celestia forums at:
11
#   https://celestiaproject.space/forum/
12
# or the Celestia web site at: https://celestiaproject.space/
13
#************************************************************************
14

15

16
Configuration
17
{
18

19
#------------------------------------------------------------------------
20
# This section contains a list of data files that Celestia uses to load
21
# information about stars, constellations and locations. DO NOT change
22
# these file names or the order in which they are listed, unless you
23
# know exactly what you are doing. Most of these files can be viewed
24
# with a plain text editor. Discussion about their content and formats
25
# can be found on the Celestia forums: https://celestiaproject.space/forum/
26

27
# If you want to load all your stars from .stc files, you can now comment
28
# out the StarDatabase entry.
29
#------------------------------------------------------------------------
30
  StarDatabase                 "data/stars.dat"
31
  StarNameDatabase             "data/starnames.dat"
32
  StarCatalogs               [ "data/revised.stc"
33
                               "data/extrasolar.stc"
34
                               "data/nearstars.stc"
35
                               "data/visualbins.stc"
36
                               "data/spectbins.stc"
37
                               "data/charm2.stc"
38
                               "data/pulsars.stc" ]
39

40
  HDCrossIndex                 "data/hdxindex.dat"
41
  SAOCrossIndex                "data/saoxindex.dat"
42

43
  SolarSystemCatalogs        [ "data/solarsys.ssc"
44
                               "data/dwarfplanets.ssc"
45
                               "data/asteroids.ssc"
46
                               "data/comets.ssc"
47
                               "data/outersys.ssc"
48
                               "data/minormoons.ssc"
49
                               "data/extrasolar.ssc"
50
                               "data/merc_locs.ssc"
51
                               "data/venus_locs.ssc"
52
                               "data/earth_locs.ssc"
53
                               "data/moon_locs.ssc"
54
                               "data/mars_locs.ssc"
55
                               "data/marsmoons_locs.ssc"
56
                               "data/jupitermoons_locs.ssc"
57
                               "data/saturnmoons_locs.ssc"
58
                               "data/uranusmoons_locs.ssc"
59
                               "data/neptunemoons_locs.ssc"
60
                               "data/dwarfplanets_locs.ssc"
61
                               "data/asteroids_locs.ssc"
62
                               "data/ring_locs.ssc"
63
                               "data/world-capitals.ssc" ]
64

65
  DeepSkyCatalogs            [ "data/galaxies.dsc"
66
                               "data/globulars.dsc"
67
                               "data/openclusters.dsc" ]
68

69
  AsterismsFile                "data/asterisms.dat"
70
  BoundariesFile               "data/boundaries.dat"
71

72

73
#------------------------------------------------------------------------
74
# Default star textures for each spectral type
75
#
76
# The default textures may be overridden in individual star definitions.
77
#------------------------------------------------------------------------
78
StarTextures
79
{
80
	# This texture will be used for any spectral type not listed
81
	# in this block.
82
	Default "astar.*"
83

84
	O "ostar.*"
85
	B "bstar.*"
86
	A "astar.*"
87
	F "fstar.*"
88
	G "gstar.*"
89
	K "kstar.*"
90
	M "mstar.*"
91

92
	# carbon stars
93
	C "mstar.*"
94
	R "mstar.*"  # former subclass of carbon star
95
	N "mstar.*"  # former subclass of carbon star
96
	S "mstar.*"  # roughly between M and C
97

98
	# Wolf-Rayet stars
99
	WC "ostar.*"
100
	WN "ostar.*"
101
	WO "ostar.*"
102

103
	# brown dwarfs
104
	L "lstar.*"
105
	T "browndwarf.*"
106
	Y "exo-class4night.*"
107

108
	# stellar remnants
109
	WD "whitedwarf.*"
110
	NeutronStar "ostar.*"
111
}
112

113

114
#------------------------------------------------------------------------
115
# User Interface files ...
116
#
117
# Despite their ".cel" file extension, these are not CEL scripts, but
118
# rather data files that populate controls such as menus and dialog
119
# boxes.
120
#
121
# FavoritesFile
122
# -------------
123
# This is where Bookmarks data are stored. The file does not exist until
124
# you save a Bookmark from within Celestia. You can view this file with
125
# a plain text editor and if you write CEL scripts, it contains some
126
# useful information.
127
#
128
# DestinationFile
129
# ---------------
130
# This is the list of Destinations used in the Tour Guide dialog box,
131
# accessed via the Navigation Menu. You can edit this file with a plain
132
# text editor to add your own destinations to the dialog box. The order
133
# in which the items are listed in the file is the order in which they
134
# will be listed in the Tour Guide dialog.
135
#
136
# Cursor
137
# ------
138
# This parameter allows you to select from three cursors, but currently
139
# only in the Windows version of Celestia ...
140
#  * White crosshair ("crosshair") --> default cursor
141
#  * Inverting crosshair ("inverting crosshair")
142
#  * Standard Windows arrow ("arrow")
143
#
144
# The inverting crosshair can be a better choice because it's more
145
# visible on bright backgrounds. However, should you decide to try this
146
# cursor, TEST IT CLOSELY. Not all graphics chipsets support an inverting
147
# cursor, which will cause Windows to fall back to software emulation.
148
# The emulated cursor interacts with OpenGL applications in unfortunate
149
# ways, forcing a lot of extra redrawing and cutting by half the frame
150
# rate on a GeForce2-equipped laptop. So, if you change this, check your
151
# FPS rates to make sure you haven't kicked Windows into software
152
# emulation mode.
153
#------------------------------------------------------------------------
154
  FavoritesFile    "favorites.cel"
155
  DestinationFile  "guide.cel"
156
  Cursor           "crosshair"
157

158

159
#------------------------------------------------------------------------
160
# Included CEL script files.
161
#
162
# The following CEL script files are included in the basic Celestia
163
# distribution. These script files may be viewed and edited with a
164
# plain text editor. They may both be modified or replaced to suit your
165
# specific needs.
166
#
167
# InitScript is the CEL script that is automatically run each time
168
# Celestia is started. The default script (start.cel) travels to Io, one
169
# of Jupiter's moons.
170
#
171
# DemoScript is the CEL script that is run when you select the "Run Demo"
172
# option in the File menu in Celestia. The default script (demo.cel)
173
# takes you on a short tour of some interesting places in our solar
174
# system.
175
#
176
# To learn more about how to use and write CEL scripts and Lua scripts
177
# in Celestia, please visit the Celestia Scripting forum at:
178
#   https://celestiaproject.space/forum/viewforum.php?f=9
179
#------------------------------------------------------------------------
180
  InitScript  "start.cel"
181
  DemoScript  "demo.cel"
182

183

184
#------------------------------------------------------------------------
185
# The 'extras' directory is located under the celestia root directory
186
# and is used for storing third-party add-ons to Celestia. To learn
187
# more about Add-Ons for Celestia, visit the Celestia Add-Ons forum at:
188
#   https://celestiaproject.space/forum/viewforum.php?f=6
189
#
190
# You may specify additional add-on directories by adding additional
191
# entries, such as the following example shows:
192
# ExtrasDirectories  [ "extras" "myextras1" "myextras2" ]
193
#
194
# To specify absolute paths on windows, you either have to use "/" or
195
# double backslashes to seperate path components. Example:
196
#   ExtrasDirectories  [ "D:/celestia-extras" ]
197
# or
198
#   ExtrasDirectories  [ "D:\\celestia-extras" ]
199
#------------------------------------------------------------------------
200
  ExtrasDirectories  [ "extras-standard" "extras" @CELCFG_EXTRAS_DIRS@]
201

202

203
#------------------------------------------------------------------------
204
# Addons in 'extras' directories can be skipped. For example, if you have
205
# an addon which provides a better version of ISS spacecraft you might
206
# want to use it instead of the default one shipped with Celestia. But if
207
# you load it you will have two spacecraft rendered in the same place. So
208
# you can either remove the default one but it will be reinstalled on
209
# Celestia upgrade or you can it to the skip list. Example:
210
#   SkipExtras "extras-standard/iss/iss.ssc"
211
# or
212
#   SkipExtras ["extras/wostars.stc" "extras-standard/iss/iss.ssc"]
213
#
214
# Please note that 1) only relative paths work, 2) directories are not
215
# accepted in the list only catalog file names.
216
#------------------------------------------------------------------------
217
#  SkipExtras [ ]
218

219
#------------------------------------------------------------------------
220
# Font definitions.
221
#
222
# The following entries define the fonts Celestia will use to display
223
# text on the display screen. To view the list of fonts available with
224
# your distribution of Celestia, look in the fonts directory located
225
# under the Celestia root directory. The default fonts are UTF-8
226
# compatible in order to display non-English characters. Font size is
227
# measured in points to ensure the same sizes on all DPI configurations.
228
#
229
# Font:      Used to display all informational text.
230
#            Default: "DejaVuSans.ttf,9"
231
#
232
# LabelFont: Used to display all label text (objects, locations, etc.).
233
#            Default "DejaVuSans.ttf,9"
234
#
235
# TitleFont: Used to display object names, messages, and script text.
236
#            Default "DejaVuSans-Bold.ttf,15"
237
#------------------------------------------------------------------------
238
  Font       "DejaVuSans.ttf,9"
239
  LabelFont  "DejaVuSans.ttf,9"
240
  TitleFont  "DejaVuSans-Bold.ttf,15"
241

242

243
#------------------------------------------------------------------------
244
# LogoTexture defines the graphic file to be displayed when Celestia is
245
# started. The default filename is "logo.png"
246
#------------------------------------------------------------------------
247
  LogoTexture  "logo.png"
248

249

250
#------------------------------------------------------------------------
251
# FaintestVisibleMagnitude defines the lowest magnitude at which a star
252
# will be displayed in Celestia. This setting may be adjusted real-time
253
# via the '[' and ']' keys in Celestia. The default value is 6.0.
254
#------------------------------------------------------------------------
255
  FaintestVisibleMagnitude 6.0
256

257

258
#------------------------------------------------------------------------
259
# RotateAcceleration defines the speed at which an object will be
260
# rotated in Celestia, when using a keypress, such as the left and right
261
# arrow keys. A higher value will rotate the object quicker, while a
262
# lower value will cause a slower rotation. The default value is 120.0.
263
#------------------------------------------------------------------------
264
  RotateAcceleration 120.0
265

266

267
#------------------------------------------------------------------------
268
# MouseRotationSensitivity defines the speed at which an object will be
269
# rotated in Celestia, when using the mouse -- press both mouse-buttons
270
# or Ctrl+LeftMouseButton, and move the mouse left or right. A higher
271
# value will rotate the object quicker, while a lower value will cause
272
# a slower rotation. A value of 0.0 (zero) will disable this particluar
273
# feature. The default value is 1.0.
274
#------------------------------------------------------------------------
275
  MouseRotationSensitivity 1.0
276

277

278
#------------------------------------------------------------------------
279
# ReverseMouseWheel performs a change of command rotates
280
# the mouse wheel on the opposite. The default value is false.
281
# RayBasedDragging enables dragging behavior that based on change of
282
# pick rays instead of screen coordinates. The default value is false.
283
# FocusZooming enables the zooming behavior where the focus location on
284
# screen is kept. The default value is false.
285
#------------------------------------------------------------------------
286
#  ReverseMouseWheel true
287
#  RayBasedDragging  true
288
#  FocusZooming      true
289

290

291
#------------------------------------------------------------------------
292
# The following parameter is used in Lua (.celx) scripting.
293
#
294
#   ScriptScreenshotDirectory defines the directory where screenshots
295
#   are to be stored. The default value is "", i.e. Celestia's
296
#   installation directory.
297
#------------------------------------------------------------------------
298
  ScriptScreenshotDirectory ""
299

300

301
#------------------------------------------------------------------------
302
# CELX-scripts can request permission to perform dangerous operations,
303
# such as reading, writing and deleting files or executing external
304
# programs. If granted, a malicious script could use this to destroy
305
# data or compromise system security.
306
# The following parameter determines what Celestia does upon such
307
# requests:
308
#  "ask": ask the user if he want's to allow access (default)
309
#  "allow": always allow such requests
310
#  "deny": always deny such requests
311
#------------------------------------------------------------------------
312
  ScriptSystemAccessPolicy "ask"
313

314

315
#------------------------------------------------------------------------
316
# The following lines are render detail settings.  Assigning higher
317
# values will produce better quality images, but may cause some older
318
# systems to run slower.
319
#
320
#   OrbitPathSamplePoints defines how many sample points to use when
321
#   rendering orbit paths. The default value is 100.
322
#
323
#   RingSystemSections defines the number of segments in which ring
324
#   systems are rendered. The default value is 100.
325
#
326
#   ShadowTextureSize defines the size* of shadow texture to be used.
327
#   The default value is 256. Maximum useful value is 2048.
328
#
329
#   EclipseTextureSize defines the size* of eclipse texture to be used.
330
#   The default value is 128. Maximum useful value is 1024.
331
#
332
#   * The ShadowTextureSize and EclipseTextureSize values should both be
333
#     powers of two (128, 256, 512, etc.). Using larger values will
334
#     reduce the jagged edges of eclipse shadows and shadows on planet
335
#     rings, but it will decrease the amount of memory available for
336
#     planet textures.
337
#------------------------------------------------------------------------
338
  OrbitPathSamplePoints  100
339
  RingSystemSections     100
340

341
  ShadowTextureSize      256
342
  EclipseTextureSize     128
343

344

345
#------------------------------------------------------------------------
346
# Orbit rendering parameters
347
#------------------------------------------------------------------------
348
# OrbitWindowEnd ->
349
# End of the orbit window relative to the current simulation time.
350
# Units are orbital periods. The default value is 0.5.
351
# The range of values 0.0 - 1.0.
352
#
353
# OrbitPeriodsShown ->
354
# Number of orbit periods shown.
355
# The default value is 1.0.
356
#
357
# LinearFadeFraction ->
358
# Fraction of the window over which the orbit fades from opaque
359
# to transparent. Fading is disabled when this value is zero.
360
# The default value is 0.0. The range of values 0.0 - 1.0.
361
#------------------------------------------------------------------------
362
  OrbitWindowEnd         0.0
363
# OrbitPeriodsShown      1.0
364
  LinearFadeFraction     0.8
365

366

367
#-----------------------------------------------------------------------
368
# Set the level of multisample antialiasing.  Not all 3D graphics
369
# hardware supports antialiasing, though most newer graphics chipsets
370
# do.  Larger values will result in smoother edges with a cost in
371
# rendering speed.  4 is a sensible setting for recent, higher-end
372
# graphics hardware; 2 is probably better mid-range graphics.  The
373
# default value is 1, which disables antialiasing.
374
# AntialiasingSamples        4
375

376

377
#------------------------------------------------------------------------
378
# The following line is commented out by default.
379
#
380
# Celestia enables and disables certain rendering features based on
381
# the set of extensions supported by the installed OpenGL driver and 3D
382
# graphics hardware.  With IgnoreGLExtensions, you may specify a list of
383
# extensions that Celestia will treat as unsupported.  This is useful
384
# primarily for the developers of Celestia.
385
#------------------------------------------------------------------------
386
# IgnoreGLExtensions [ "GL_ARB_vertex_program" ]
387

388

389
#------------------------------------------------------------------------
390
# The number of rows in the debug log (displayable onscreen by pressing
391
# the ~ (tilde). The default log size is 200.
392
#------------------------------------------------------------------------
393
# LogSize 1000
394

395
#------------------------------------------------------------------------
396
# The following define options for x264 and ffvhuff video codecs when
397
# Celestia is compiled with ffmpeg library support for video capture.
398
#------------------------------------------------------------------------
399
# X264EncoderOptions ""
400
# FFVHEncoderOptions ""
401

402
#------------------------------------------------------------------------
403
# The following define the measurement system Celestia uses to display
404
# in HUD, available options for MeasurementSystem  are `metric` and
405
# `imperial`. By default, metric measurement system is used. Available
406
# options for TemperatureScale are `kelvin`, `celsius`, and `fahrenheit`.
407
# By default kelvin is used.
408
#------------------------------------------------------------------------
409
# MeasurementSystem "imperial"
410
# TemperatureScale "celsius"
411

412
#------------------------------------------------------------------------
413
# The following options are used to configure how scenes in Celestia
414
# are projected and what distortion method is used.
415
# Available options for ProjectionMode are `perspective` (default) and
416
# `fisheye`. Available `ViewportEffect`s (distortion methods) are `none`
417
# (default), `passthrough`, and `warpmesh`.
418
# For `warpmesh` viewport effect, you need to specify a warp mesh file
419
# under the parameter name `WarpMeshFile`, The file should be placed
420
# inside the `warp` folder.
421
# File format for warp mesh: http://paulbourke.net/dataformats/meshwarp/
422
#------------------------------------------------------------------------
423
# ProjectionMode "fisheye"
424
# ViewportEffect "warpmesh"
425
# WarpMeshFile "warp.map"
426

427
#------------------------------------------------------------------------
428
# The following option provides location of NIST format leap-seconds.list
429
# file which override default leap seconds database. Debian-based systems
430
# provide it as /usr/share/zoneinfo/leap-seconds.list. For other systems it
431
# can be dounload from ftp://ftp.nist.gov/pub/time/leap-seconds.list or
432
# ftp://ftp.boulder.nist.gov/pub/time/leap-seconds.list.
433
#------------------------------------------------------------------------
434
# LeapSecondsFile "/usr/share/zoneinfo/leap-seconds.list"
435

436
#------------------------------------------------------------------------
437
# The following option provides control over layout direction of the text
438
# in Celestia. Available options are `ltr` (default) and `rtl`.
439
#------------------------------------------------------------------------
440
# LayoutDirection "rtl"
441

442
}
443