%% Part of Stellarium User Guide
%% Status:
%% 2015-12-30 taken from wiki
%% 2016-04-06 GZ reformatted a bit. 
%% 2016-08-01 AW added color boxes for visual representation of colours. 
%% 2017-12-23..26 GZ removed many \midrules, and reduced labels (where not referenced) to allow processing with tex4ht.
%% TODO: document the more obscure entries. Add links to the respective chapters.
%% TODO: remove unused entries, add new ones.  


\chapter{Configuration Files}
\label{app:ConfigFiles}

\section{Program Configuration}
\label{sec:config.ini}
First, see \ref{sec:ConfigurationFile} (The
Main Configuration File) for information about the file \file{config.ini}, including its
default installed location, and command line options that can
affect how it is processed.

%Deprecated parameters are marked by gray background. 
%Possible new parameters are marked by yellow background.
%% GZ This is no longer true. Reactivate somehow? 

The file \file{config.ini} (or a file which you can load instead with
the \command{-\/-config <file>} option) is structured into the following
parts. In addition, plugins can add a section named like the plugin
(Exception: The Text User Interface plugin's section is named \texttt{[tui]}
for historical reasons).

\subsection{\big[astro\big]}
%\label{sec:config.ini:astro}

This section includes settings for the commonly displayed objects.

\begin{longtable}{l|l|l|p{55mm}}
\toprule
\emph{ID} & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
apparent\_magnitude\_algorithm     & string & Mallama2018 & Set algorithm for computation of apparent magnitude of the planets. 
                                                   Possible values: \emph{Mallama2018}, \emph{ExpSup2013}, \emph{ExpSup1992}, \emph{AstrAlm1984}, \emph{Mueller1893} and \emph{Generic}.\\%\midrule
nebula\_magnitude\_limit           & float  & 8.5  & Value of limiting magnitude for the deep-sky objects.\\%\midrule
star\_magnitude\_limit             & float  & 6.5  & Value of limiting magnitude for the stars. Sometimes you don't want to display more stars when zooming in. \\%\midrule
planet\_magnitude\_limit           & float  & 6.5  & Value of limiting magnitude for the planets. Sometimes you don't want to display more planets when zooming in. \\%\midrule
planets\_orbits\_color\_style      & string & one\_color & Set the style of orbits color. Possible values: \emph{one\_color}, \emph{groups} and \emph{max}.\\%\midrule
flag\_nebula\_magnitude\_limit     & bool   & false & Set to \emph{true} to activate limit for showing deep-sky objects.\\%\midrule
flag\_star\_magnitude\_limit       & bool   & false & Set to \emph{true} to activate limit for showing stars\\%\midrule
flag\_planet\_magnitude\_limit     & bool   & false & Set to \emph{true} to activate limit for showing planets.\\\midrule
extinction\_mode\_below\_horizon   & string & zero & Set extinction mode for atmosphere below horizon. Possible values: \emph{zero}, \emph{mirror} and \emph{max}.\\
twilight\_altitude                 & float  & -6.0 & Solar altitude for going to previous/next twilight.\\\midrule
%
flag\_stars                        & bool   & true  & Set to \emph{false} to hide the stars on start-up\\
flag\_star\_name                   & bool   & true  & Set to \emph{false} to hide the star labels on start-up\\
flag\_star\_additional\_names      & bool   & true  & Set \emph{true} to use all available proper names for stars.\\\midrule
%
flag\_star\_designation\_usage     & bool   & false & If \emph{true}, use designations of stars on the sky (on-screen labels) instead of their common names.\\
flag\_star\_designation\_dbl       & bool   & false & If \emph{true}, and star doesn't have common name and Bayer or Flamsteed designations then use first of traditional designations of double stars to the on-screen labels.\\
flag\_star\_designation\_var       & bool   & false & If \emph{true}, and star doesn't have common name or Bayer, Flamsteed or double star designation then use designation of variable stars as the on-screen label.\\
flag\_star\_designation\_hip       & bool   & false & If \emph{true}, use HIP designations of stars for the on-screen labels if common name or traditional designations do not exist for star.\\\midrule
%
flag\_planets                      & bool   & true  & Set to \emph{false} to hide the planet labels on start-up\\%\midrule
flag\_planets\_hints               & bool   & true  & Set to \emph{false} to hide the planet hints on startup (names and circular highlights)\\%\midrule
flag\_planets\_orbits              & bool   & false & Set to \emph{true} to show the planet orbits on startup\\%\midrule
flag\_permanent\_orbits            & bool   & false & Set to \emph{true} to show the orbit of planet, when planet is out of the viewport also.\\%\midrule
flag\_planets\_pointers            & bool   & false & Set to \emph{true} to show the planet pointer markers on startup\\%\midrule
flag\_planets\_nomenclature        & bool   & false & Set to \emph{true} to show the planetary nomenclature markers and labels\\%\midrule
flag\_planets\_nomenclature\_\ldots& bool   & false & Set to \emph{true} to show only items\\
\hspace{12mm}terminator\_only       &        &       & along the terminator\\
planet\_nomenclature\_\ldots       &        &       &\\
\hspace{12mm}solar\_altitude\_min   & int    & -5    & minimum solar altitude for the terminator setting above\\
\hspace{12mm}solar\_altitude\_max   & int    & 40 & maximum solar altitude for the terminator setting above\\
flag\_hide\_local\_nomenclature    & bool   & true  & Set to \emph{true} to hide the planetary nomenclature items on the observer's celestial body\\\midrule
%
flag\_light\_travel\_time          & bool   & true  & Should be \emph{true} to improve accuracy in the movement of the planets by compensating 
                                           for the time it takes for light to travel. This has a slight impact on performance, 
                                           but is essential e.g.\ for Jupiter's moons.\\%\midrule
flag\_object\_trails               & bool   & false & Turns on and off drawing of object trails (which show the movement of the planets over time).\\%\midrule
%
flag\_nebula                       & bool   & true  & Set to \emph{false} to hide the nebulae on start-up. \\%\midrule
flag\_nebula\_name                 & bool   & false & Set to \emph{true} to show the nebula labels on start-up. \\%\midrule
flag\_nebula\_display\_no\_texture & bool   & false & Set to \emph{true} to suppress displaying of nebula textures. \\%\midrule
nebula\_texture\_decimation        & int    & 1     & Reduce nebula texture size by this factor [1\ldots8]. May help on very limited systems. \\
nebula\_hints\_amount              & float  & 3.0   & Sets the amount of hints [0\ldots10]. \\%\midrule
nebula\_labels\_amount             & float  & 3.0   & Sets the amount of labels [0\ldots10].\\%\midrule
flag\_milky\_way                   & bool   & true  & Set to \emph{false} to hide the Milky Way.\\%\midrule
milky\_way\_color                  & Color & \ccbox[box]{1.0,1.0,1.0} & Base color of the Milky Way.\\
milky\_way\_intensity              & float  & 1.0   & Sets the relative brightness with which the milky way is drawn. Typical [1\ldots3]. \\%\midrule
milky\_way\_saturation             & float  & 1.0   & Sets the color saturation with which the milky way is drawn [0\ldots1]. \\%\midrule
flag\_zodiacal\_light              & bool   & true  & Set to \emph{false} to hide the zodiacal light\\%\midrule
zodiacal\_light\_color             & Color & \ccbox[box]{1.0,0.0,1.0} & Base color of the Zodiacal Light.\\
zodiacal\_light\_intensity         & float  & 1.0   & Sets the relative brightness with which the zodiacal light is drawn. \\%\midrule
max\_mag\_nebula\_name             & float  & 8.0   & Sets the magnitude of the nebulae whose name is shown. \\%\midrule
flag\_nebula\_hints\_proportional  & bool   & false & Enables/disables proportional markers for deep-sky objects. \\%\midrule
flag\_surface\_brightness\_usage   & bool   & false & Enables/disables usage surface brightness for markers for deep-sky objects.\\\midrule
%
flag\_size\_limits\_usage          & bool   & false & Enables/disables usage angular size filter for markers for deep-sky objects.\\%\midrule
size\_limit\_min                   & int    & 1     & Minimal angular size of visible deep-sky objects in arcminutes.\\%\midrule
size\_limit\_max                   & int    & 600   & Maximum angular size of visible deep-sky objects in arcminutes.\\\midrule
%
flag\_use\_type\_filter            & bool   & false & Enables/disables usage of the type filters for deep-sky objects. \\\midrule
flag\_nutation  				   & bool   & true  & Enables/disables usage nutation.\\\midrule
flag\_topocentric\_coordinates	   & bool   & true  & Enables/disables usage topocentric coordinates.\\\midrule
shadow\_enlargement\_danjon 	   & bool   & false & Earth shadow enlargement (see \ref{sec:Eclipses:lunar}).\\\midrule
%
flag\_dso\_designation\_usage      & bool   & false & If \emph{true}, use designations of deep-sky objects on the sky instead of their common names.\\%\midrule
flag\_dso\_outlines\_usage         & bool   & false & If \emph{true}, use outlines for big deep-sky objects on the sky instead of their hints.\\%\midrule
flag\_dso\_additional\_names       & bool   & true  & Set \emph{true} to use additional names (also known as) for deep-sky objects.\\\midrule
flag\_dso\_show\_only\_named       & bool   & false & If \emph{true}, only show deep-sky objects with names, hiding those with only designations.\\\midrule
%
grs\_longitude                     & int    & 216   & Longitude (System II) of Great Red Spot on Jupiter in degrees.\\%\midrule
grs\_drift                         & float  & 15.0  & Annual drift of Great Red Spot on Jupiter in degrees.\\%\midrule
grs\_jd                            & float  & 2456901.5 & Initial JD for calculation of position of Great Red Spot on Jupiter.\\%\midrule
grs\_measurements\_url             & string &       & URL of recent measurements of GRS' position\footnote{Default value is \url{http://jupos.privat.t-online.de/rGrs.htm}}. \\\midrule
%
meteor\_zhr                        & int    & 10    & ZHR for sporadic meteors.\\\midrule
%
de430\_path                        & string &       & Path to JPL DE430 ephemerides file.\\%\midrule
flag\_use\_de430                   & bool   & false & Enables/disables usage JPL DE430 ephemerides (if available).\\%\midrule
de431\_path                        & string &       & Path to JPL DE431 ephemerides file.\\%\midrule
flag\_use\_de431                   & bool   & false & Enables/disables usage JPL DE431 ephemerides (if available).\\\midrule
%
flag\_toast\_survey                & bool   & false & Enables/disables Digitized Sky Survey in TOAST format.\\%\midrule
toast\_survey\_host                & string &       & Host of Digitized Sky Survey storage data.\\%\midrule
toast\_survey\_directory           & string & results & Directory name of Digitized Sky Survey storage data.\\%\midrule
toast\_survey\_levels              & int    & 11    & Count of levels for Digitized Sky Survey storage data.\\\bottomrule
\end{longtable}

\subsection{\big[astrocalc\big]}
%\label{sec:config.ini:astrocalc}

This section includes settings for the Astronomical Calculations feature.

\noindent%
\begin{longtable}{l|l|l|p{65mm}}
\toprule
\emph{ID}                   & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
flag\_ephemeris\_markers       & bool   & true  & Set to \emph{true} to show the calculated ephemeris markers for Solar system bodies.\\%\midrule
flag\_ephemeris\_line          & bool   & false & Set to \emph{true} to show the connecting line between the ephemeris markers.\\%\midrule
flag\_ephemeris\_dates         & bool   & false & Set to \emph{true} to show the dates of calculated ephemeris for Solar system bodies.\\%\midrule
flag\_ephemeris\_magnitudes    & bool   & false & Set to \emph{true} to show the magnitude of Solar system body for the calculated ephemeride.\\%\midrule
flag\_ephemeris\_horizontal    & bool   & false & Set to \emph{true} to use horizontal coordinates for ephemerides.\\%\midrule
flag\_ephemeris\_skip\_data    & bool   & false & Set to \emph{true} to skip the showing data near ephemeris markers.\\%\midrule
flag\_ephemeris\_smart\_dates  & bool   & true  & Set to \emph{true} to use smart format for dates, who showing near ephemeris markers.\\%\midrule
flag\_ephemeris\_scale\_markers  & bool   & false  & Set to \emph{true} to use small ephemeris markers, when line is enabled.\\%\midrule
ephemeris\_celestial\_body     & string & Moon  & Default celestial body for computation of ephemerides.\\%\midrule
ephemeris\_time\_step          & int    & 6     & Identificator for time step category.\\%\midrule
ephemeris\_data\_step          & int    & 0     & Value of skipping step when skipping option is enabled (label each N steps, where N is step).\\%\midrule
celestial\_magnitude\_limit    & float  & 6.0   & Value of limiting magnitude for the celestial objects in computation of their positions.\\%\midrule
celestial\_category            & int    & 200   & Identificator for default category of celestial bodies.\\%\midrule
flag\_horizontal\_coordinates  & bool   & false & Set to \emph{true} to use horizontal coordinates for compute of positions for the celestial objects.\\%\midrule
flag\_phenomena\_opposition    & bool   & false & Set to \emph{true} to compute of opposition phenomenon between the Solar system bodies.\\%\midrule
flag\_phenomena\_perihelion    & bool   & false & Set to \emph{true} to compute perihelion and aphelion for Solar system bodies (except moons).\\%\midrule
phenomena\_angular\_separation & float  & 1.0   & Allowed angular separation between celestial bodies for computation of phenomena.\\%\midrule
phenomena\_celestial\_body     & string & Venus & Default celestial body for computation of phenomena.\\%\midrule
phenomena\_celestial\_group    & int    & 0     & Identificator for group of celestial bodies for computation of phenomena.\\%\midrule
wut\_magnitude\_limit          & float  & 10.0  & Value of limiting magnitude for calculations within What's Up Tonight feature.\\%\midrule
wut\_time\_interval            & int    & 0     & Identificator for time interval within What's Up Tonight feature computations.\\%\midrule
wut\_angular\_limit\_flag      & bool   & false & Set to \emph{true} to use the angular size filter.\\%\midrule
wut\_angular\_limit\_min       & float  & 1.0   & Minimal allowed angular size, arcminutes.\\%\midrule
wut\_angular\_limit\_max       & float  & 600.0 & Maximal allowed angular size, arcminutes.\\%\midrule
wut\_altitude\_min             & float  & 0.0   & Minimal allowed altitude for compute rise and set times, degrees.\\%\midrule
graphs\_celestial\_body        & string & Moon  & Default celestial body for draw of graphs.\\%\midrule
graphs\_duration               & int    & 1     & How much years account into calculation of graphs.\\%\midrule
graphs\_first\_id              & int    & 1     & Identificator for left graph (blue line).\\%\midrule
graphs\_second\_id             & int    & 2     & Identificator for right graph (yellow line).\\\bottomrule
\end{longtable}

\subsection{\big[audio\big]}
%\label{sec:config.ini:audio}

This section includes settings for Audio features.

\noindent%
\begin{longtable}{l|l|l|p{65mm}}
\toprule
\emph{ID}         & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
enabled           & bool        & true           & Enable sound output\\\bottomrule
\end{longtable}

\subsection{\big[color\big]}
%\label{sec:config.ini:color}

This section defines the RGB colors for the various objects, lines,
grids, labels etc. Values are given in float from 0 to
1. e.g. \emph{1.0,1.0,1.0} for white, or \emph{1,0,0} for red. Leave
no whitespace between the numbers!

\begin{longtable}{l|l|p{55mm}}
\toprule
\emph{ID}	                            & \emph{Default}      & \emph{Colour of the\ldots}\\
\midrule
default\_color           				& \ccbox{0.5,0.5,0.7} & default colour.\\\midrule
daylight\_text\_color            		& \ccbox{0.0,0.0,0.0} & info text at daylight. \\\midrule
info\_text\_color               		& \ccbox{1.0,1.0,1.0} & info text color when overwrite mode for text color is enabled. \\\midrule
sky\_background\_color                  & \ccbox{0.0,0.0,0.0} & sky background (non-black is useful for artists only). \\\midrule
%% Ecliptic J2000 group: red tones
ecliptical\_J2000\_color 				& \ccbox{0.4,0.1,0.1} &  ecliptical grid (J2000.0 frame). \\%\midrule
ecliptic\_J2000\_color   				& \ccbox{0.7,0.2,0.2} &  ecliptic line (J2000.0 frame). \\%\midrule
equinox\_J2000\_points\_color			& \ccbox{0.7,0.2,0.2} &  equinox points (J2000.0 frame). \\%\midrule
solstice\_J2000\_points\_color			& \ccbox{0.7,0.2,0.2} &  solstice points (J2000.0 frame). \\%\midrule
ecliptic\_J2000\_poles\_color			& \ccbox{0.7,0.2,0.2} &  ecliptic poles (J2000.0 frame). \\\midrule
%% Ecliptic of date group: orange tones
ecliptical\_color        				& \ccbox{0.6,0.3,0.1} &  ecliptical grid (of date). \\%\midrule
ecliptic\_color          				& \ccbox{0.9,0.6,0.2} &  ecliptic line (of date). \\%\midrule
equinox\_points\_color					& \ccbox{0.9,0.6,0.2} &  equinox points (of date). \\%\midrule
solstice\_points\_color					& \ccbox{0.9,0.6,0.2} &  solstice points (of date). \\%\midrule
ecliptic\_poles\_color					& \ccbox{0.9,0.6,0.2} &  ecliptic poles (of date). \\%\midrule
precession\_circles\_color 				& \ccbox{0.9,0.6,0.2} &  precession circles. \\\midrule
%% Equatorial J2000 group: blue tones (standard atlas coordinates)
equator\_J2000\_color      				& \ccbox{0.2,0.2,0.6} &  equator line (J2000.0 frame). \\%\midrule
equatorial\_J2000\_color 				& \ccbox{0.1,0.1,0.5} &  equatorial grid (J2000.0 frame). \\%\midrule
celestial\_J2000\_poles\_color			& \ccbox{0.2,0.2,0.6} &  celestial poles (J2000.0 frame). \\\midrule
%% Equatorial of date group: brighter blue
equator\_color           				& \ccbox{0.3,0.5,1.0} &  equator line (of date). \\%\midrule
equatorial\_color        				& \ccbox{0.2,0.3,0.8} &  equatorial grid (of date). \\%\midrule
celestial\_poles\_color					& \ccbox{0.3,0.5,1.0} &  celestial poles (of date). \\%\midrule
circumpolar\_circles\_color 			& \ccbox{0.3,0.5,1.0} &  circumpolar circles. \\\midrule
%% Fixed Equatorial: unspecified
fixed\_equator\_color           			& \ccbox{0.5,0.5,0.7} &  fixed equator (hour angle) line. \\%\midrule
fixed\_equatorial\_color        			& \ccbox{0.5,0.5,0.7} &  fixed equatorial grid. \\\midrule
%% Galaxy: brownish, not too strong.
galactic\_color          				& \ccbox{0.3,0.2,0.1} &  galactic grid. \\%\midrule
galactic\_equator\_color 				& \ccbox{0.5,0.3,0.1} &  galactic equator line. \\%\midrule
galactic\_poles\_color					& \ccbox{0.5,0.3,0.1} &  galactic poles. \\\midrule
%% Supergalactic group: dark grey, should be less apparent than galactic.
supergalactic\_color       				& \ccbox{0.2,0.2,0.2} &  supergalactic grid. \\%\midrule
supergalactic\_equator\_color 			& \ccbox{0.4,0.4,0.4} &  supergalactic equator line. \\%\midrule
supergalactic\_poles\_color				& \ccbox{0.4,0.4,0.4} &  supergalactic poles. \\\midrule
%% Horizon and altazimuthal grid: greenish.
azimuthal\_color         				& \ccbox{0.0,0.3,0.2} &  azimuthal grid. \\%\midrule
horizon\_color           				& \ccbox{0.2,0.6,0.2} &  horizon line. \\%\midrule
meridian\_color          				& \ccbox{0.2,0.6,0.2} &  meridian line. \\%\midrule
prime\_vertical\_color   				& \ccbox{0.2,0.5,0.2} &  prime vertical. \\%\midrule
zenith\_nadir\_color					& \ccbox{0.2,0.6,0.2} &  zenith and nadir. \\%\midrule
cardinal\_color          				& \ccbox{0.8,0.2,0.1} &  cardinal points. \\\midrule
%% A mix of equatorial (blueish) and ecliptical (reddish)...
colures\_color 			 			& \ccbox{0.5,0.0,0.5} &  colures. \\\midrule
antisolar\_point\_color 				& \ccbox{0.9,0.3,0.5} &  antisolar point. \\%\midrule
apex\_points\_color 			 		& \ccbox{0.8,0.2,0.3} &  apex points. \\%\midrule
oc\_longitude\_color	     				& \ccbox{0.6,0.2,0.4} &  opposition/conjunction longitude. \\
quadrature\_color	     				& \ccbox{0.6,0.2,0.4} &  quadrature circle. \\\midrule
%% Skycultures
const\_lines\_color                     & \ccbox{0.2,0.2,0.6} & constellation lines. \\
const\_names\_color                     & \ccbox{0.4,0.6,0.9} & constellation names. \\
const\_boundary\_color                  & \ccbox{0.8,0.3,0.3} & constellation boundaries.\\
const\_hulls\_color                     & \ccbox{0.6,0.2,0.2} & constellation areas (convex hulls).\\
asterism\_lines\_color                  & \ccbox{0.4,0.4,0.8} & asterism lines. \\
asterism\_names\_color                  & \ccbox{0.4,0.4,0.8} & asterism names. \\
rayhelper\_lines\_color                 & \ccbox{1.0,1.0,0.0} & the ray helper lines. \\
skyculture\_zodiac\_color               & \ccbox{1.0,1.0,0.0} & Zodiac band.\\
skyculture\_lunarsystem\_color          & \ccbox{0.0,1.0,0.5} & Band/boundaries of Lunar stations\,/\,mansions.\\\midrule
%% DSO
dso\_label\_color                       & \ccbox{0.2,0.6,0.7} & deep-sky objects labels. \\%\midrule
dso\_circle\_color                      & \ccbox{1.0,0.7,0.2} & deep-sky objects symbols, if not of the types below. \\%\midrule
dso\_region\_color                      & \ccbox{0.7,0.7,0.2} & regions symbols. \\%\midrule
dso\_galaxy\_color                      & \ccbox{1.0,0.2,0.2} & galaxies symbols. \\%\midrule
dso\_radio\_galaxy\_color               & \ccbox{0.3,0.3,0.3} & radio galaxies symbols. \\%\midrule
dso\_active\_galaxy\_color              & \ccbox{1.0,0.5,0.2} & active galaxies symbols. \\%\midrule
dso\_interacting\_galaxy\_color         & \ccbox{0.2,0.8,1.0} & clusters of galaxies symbols. \\%\midrule
dso\_galaxy\_cluster\_color             & \ccbox{0.2,0.5,1.0} & interacting galaxies symbols. \\%\midrule
dso\_quasar\_color                      & \ccbox{1.0,0.2,0.2} & quasars symbols. \\%\midrule
dso\_possible\_quasar\_color            & \ccbox{1.0,0.2,0.2} & possible quasars symbols. \\%\midrule
dso\_bl\_lac\_color                     & \ccbox{1.0,0.2,0.2} & BL Lac objects symbols. \\%\midrule
dso\_blazar\_color                      & \ccbox{1.0,0.2,0.2} & blazars symbols. \\%\midrule
dso\_nebula\_color                      & \ccbox{0.1,1.0,0.1} & nebulae symbols. \\%\midrule
dso\_planetary\_nebula\_color           & \ccbox{0.1,1.0,0.1} & planetary nebulae symbols. \\%\midrule
dso\_reflection\_nebula\_color          & \ccbox{0.1,1.0,0.1} & reflection nebulae symbols. \\%\midrule
dso\_bipolar\_nebula\_color             & \ccbox{0.1,1.0,0.1} & bipolar nebulae symbols. \\%\midrule
dso\_emission\_nebula\_color            & \ccbox{0.1,1.0,0.1} & emission nebulae symbols. \\%\midrule
dso\_dark\_nebula\_color                & \ccbox{0.3,0.3,0.3} & dark nebulae symbols. \\%\midrule
dso\_hydrogen\_region\_color            & \ccbox{0.1,1.0,0.1} & hydrogen regions symbols. \\%\midrule
dso\_supernova\_remnant\_color          & \ccbox{0.1,1.0,0.1} & supernovae remnants symbols. \\%\midrule
dso\_supernova\_candidate\_color        & \ccbox{0.1,1.0,0.1} & supernova candidates symbols. \\%\midrule
dso\_supernova\_remnant\_cand\_color    & \ccbox{0.1,1.0,0.1} & supernova remnant candidates symbols. \\%\midrule
dso\_interstellar\_matter\_color        & \ccbox{0.1,1.0,0.1} & interstellar matter symbols. \\%\midrule
dso\_molecular\_cloud\_color            & \ccbox{0.1,1.0,0.1} & molecular clouds symbols. \\%\midrule
dso\_possible\_planetary\_nebula\_color & \ccbox{0.1,1.0,0.1} & possible planetary nebulae symbols. \\%\midrule
dso\_protoplanetary\_nebula\_color      & \ccbox{0.1,1.0,0.1} & protoplanetary nebulae symbols. \\%\midrule
dso\_cluster\_color                     & \ccbox{1.0,1.0,0.1} & star clusters symbols. \\%\midrule
dso\_open\_cluster\_color               & \ccbox{1.0,1.0,0.1} & open star clusters symbols. \\%\midrule
dso\_globular\_cluster\_color           & \ccbox{1.0,1.0,0.1} & globular star clusters symbols. \\%\midrule
dso\_stellar\_association\_color        & \ccbox{1.0,1.0,0.1} & stellar associations symbols. \\%\midrule
dso\_star\_cloud\_color                 & \ccbox{1.0,1.0,0.1} & star clouds symbols. \\%\midrule
dso\_star\_color                        & \ccbox{1.0,0.7,0.2} & star symbols. \\%\midrule
dso\_symbiotic\_star\_color             & \ccbox{1.0,0.7,0.2} & symbiotic star symbols. \\%\midrule
dso\_emission\_star\_color              & \ccbox{1.0,0.7,0.2} & emission-line star symbols. \\%\midrule
dso\_emission\_object\_color            & \ccbox{1.0,0.7,0.2} & emission objects symbols. \\%\midrule
dso\_young\_stellar\_object\_color      & \ccbox{1.0,0.7,0.2} & young stellar objects symbols. \\\midrule
%
%star\_label\_color                      & \ccbox{0.4,0.3,0.5} & star labels. \\%\midrule
planet\_names\_color                    & \ccbox{0.5,0.5,0.7} & planet names. \\%\midrule
planet\_pointers\_color                 & \ccbox{1.0,0.3,0.3} & planet pointers. \\%\midrule
planet\_nomenclature\_color             & \ccbox{0.1,1.0,0.1} & planetary nomenclature hints and labels. \\\midrule
%
sso\_orbits\_color                      & \ccbox{0.7,0.2,0.2} & default orbits. \\%\midrule
major\_planet\_orbits\_color            & \ccbox{0.7,0.2,0.2} & major planet orbits. \\%\midrule
minor\_planet\_orbits\_color            & \ccbox{0.7,0.5,0.5} & minor planet orbits. \\%\midrule
dwarf\_planet\_orbits\_color            & \ccbox{0.7,0.5,0.5} & dwarf planet orbits. \\%\midrule
moon\_orbits\_color                     & \ccbox{0.7,0.2,0.2} & moon of planet orbits. \\%\midrule
cubewano\_orbits\_color                 & \ccbox{0.7,0.5,0.5} & cubewano orbits. \\%\midrule
plutino\_orbits\_color                  & \ccbox{0.7,0.5,0.5} & plutino orbits. \\%\midrule
sdo\_orbits\_color                      & \ccbox{0.7,0.5,0.5} & scattered disk object orbits. \\%\midrule
oco\_orbits\_color                      & \ccbox{0.7,0.5,0.5} & Oort cloud object orbits. \\%\midrule
sednoid\_orbits\_color                  & \ccbox{0.7,0.5,0.5} & Sednoid object orbits. \\%\midrule
interstellar\_orbits\_color             & \ccbox{1.0,0.6,1.0} & Interstellar object ``orbits'' (trajectories). \\%\midrule
comet\_orbits\_color                    & \ccbox{0.7,0.8,0.8} & comet orbits. \\%\midrule
mercury\_orbit\_color                   & \ccbox{0.5,0.5,0.5} & orbit of Mercury. \\%\midrule
venus\_orbit\_color                     & \ccbox{0.9,0.9,0.7} & orbit of Venus. \\%\midrule
earth\_orbit\_color                     & \ccbox{0.0,0.0,1.0} & orbit of Earth. \\%\midrule
mars\_orbit\_color                      & \ccbox{0.8,0.4,0.1} & orbit of Mars. \\%\midrule
jupiter\_orbit\_color                   & \ccbox{1.0,0.6,0.0} & orbit of Jupiter. \\%\midrule
saturn\_orbit\_color                    & \ccbox{1.0,0.8,0.0} & orbit of Saturn. \\%\midrule
uranus\_orbit\_color                    & \ccbox{0.0,0.7,1.0} & orbit of Uranus. \\%\midrule
neptune\_orbit\_color                   & \ccbox{0.0,0.3,1.0} & orbit of Neptune. \\\midrule
% other colors
object\_trails\_color                   & \ccbox{1.0,0.7,0.0} & planet trails. \\\midrule
custom\_marker\_color                   & \ccbox{0.1,1.0,0.1} & custom marker. \\\midrule
% Script colors
script\_console\_keyword\_color         & \ccbox{1.0,0.0,1.0} & syntax highlight for keywords in the script console. \\%\midrule
script\_console\_module\_color          & \ccbox{0.0,1.0,1.0} & syntax highlight for modules in the script console. \\%\midrule
script\_console\_comment\_color         & \ccbox{1.0,1.0,0.0} & syntax highlight for comments in the script console. \\%\midrule
script\_console\_function\_color        & \ccbox{0.0,1.0,0.0} & syntax highlight for functions in the script console. \\%\midrule
script\_console\_constant\_color        & \ccbox{1.0,0.5,0.5} & syntax highlight for constants in the script console. \\\midrule
% special markers colors
fov\_center\_marker\_color              & \ccbox{0.5,0.5,0.7} & FOV Center marker. \\%\midrule
fov\_circular\_marker\_color            & \ccbox{0.5,0.5,0.7} & circular marker of FOV. \\%\midrule
fov\_rectangular\_marker\_color         & \ccbox{0.5,0.5,0.7} & rectangular marker of FOV. \\%\midrule
compass\_marks\_color                   & \ccbox{0.5,0.5,0.7} & compass marks. \\
\bottomrule
\end{longtable}

\subsection{\big[custom\_selected\_info\big]}
%\label{sec:config.ini:custom_selected_info}

You can fine-tune the bits of information to display for the selected object in this section. Set the entry to \emph{true} to display it.

\begin{longtable}{l|l|l}\toprule
\emph{ID} & \emph{Type} & \emph{Description}\\\midrule
flag\_show\_name              & bool & common name for object.\\
flag\_show\_catalognumber     & bool & catalog designations for objects.\\
flag\_show\_type              & bool & type of object.\\
flag\_show\_magnitude         & bool & magnitude for object.\\
flag\_show\_absolutemagnitude & bool & absolute magnitude for objects.\\
flag\_show\_radecj2000        & bool & equatorial coordinates (J2000.0 frame) of object.\\
flag\_show\_radecofdate       & bool & equatorial coordinates (of date) of object.\\
flag\_show\_hourangle         & bool & hour angle for object.\\
flag\_show\_altaz             & bool & horizontal coordinates for objects.\\
flag\_show\_eclcoordj2000     & bool & ecliptic coordinates (J2000.0 frame) of object.\\
flag\_show\_eclcoordofdate    & bool & ecliptic coordinates (of date) of object.\\
flag\_show\_galcoord          & bool & galactic coordinates (System~II) of object.\\
flag\_show\_supergalcoord     & bool & supergalactic coordinates of object.\\
flag\_show\_othercoord        & bool & other coordinates of object (from plugins).\\
flag\_show\_constellation     & bool & show 3-letter IAU\index{IAU} constellation label.\\
flag\_show\_sidereal\_time    & bool & sidereal time.\\
flag\_show\_elongation        & bool & elongation from the Sun for solar system objects.\\
flag\_show\_distance          & bool & distance to object.\\
flag\_show\_velocity          & bool & velocity of object.\\
flag\_show\_propermotion      & bool & proper motion of object.\\
flag\_show\_size              & bool & size of object.\\
flag\_show\_rts\_time         & bool & rise, transit and set times.\\
flag\_show\_solar\_lunar      & bool & horizontal coordinates for Sun and Moon.\\
flag\_show\_extra             & bool & extra info for object.\\\bottomrule
\end{longtable}

\subsection{\big[custom\_time\_correction\big]}
%\label{sec:config.ini:custom_time_correction}

Stellarium allows experiments with $\Delta T$. See \ref{sec:Concepts:DeltaT} for details.

\noindent%
\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID}    & \emph{Type} & \emph{Description}\\\midrule
coefficients & [float,float,float] & Coefficients $a, b, c$ for custom equation of $\Delta T$\\%\midrule
ndot & float & n-dot value for custom equation of $\Delta T$\\%\midrule
year & int   & Year for custom equation of $\Delta T$\\\bottomrule
\end{tabularx}

\subsection{\big[devel\big]}
%\label{sec:config.ini:devel}

This section is for developers only. 
%% TODO: Still it has to be documented!

\noindent%
\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID}              & \emph{Type} & \emph{Description}\\\midrule
check\_loading\_constellation\_data & bool & Set to \emph{true} to check loading constellation data.
                                      This option is needed to debug new sky cultures. Default value: \emph{false}.\\
convert\_locations\_list     & bool & Set to \emph{true} to convert file \file{base\_locations.txt} 
                                      into file \file{base\_locations.bin}\footnote{To get the standard 
                                        packed \file{base\_locations.bin.gz} file please run the command
                                        \verb|gzip -nc base_locations.bin > base_locations.bin.gz|.}. 
                                      Default value: \emph{false}.\\
convert\_dso\_catalog        & bool & Set to \emph{true} to convert file \file{catalog.txt} 
                                      into file \file{catalog.dat}. Default value: \emph{false}.\\%\midrule
convert\_dso\_decimal\_coord & bool & Set to \emph{true} to use decimal values for coordinates 
                                      in source catalog. Default value: \emph{true}.\\\midrule
markers\_to\_logfile         & bool & Write marker coordinates to logfile. Useful when developing dark constellations. See p.~\pageref{SC:constellations:dark:markers}\\\bottomrule
\end{tabularx}

\subsection{\big[dso\_catalog\_filters\big]}
%\label{sec:config.ini:dso_catalog_filters}
In this section you can fine-tune which of the deep-sky catalogs should be selected on startup.

\begin{longtable}{l|l|l|p{90mm}}\toprule
\emph{ID} & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
flag\_show\_ngc   & bool & true  & New General Catalogue (NGC). \\%\midrule
flag\_show\_ic    & bool & true  & Index Catalogue (IC). \\%\midrule
flag\_show\_m     & bool & true  & Messier Catalog (M). \\%\midrule
flag\_show\_c     & bool & false & Caldwell Catalogue (C). \\%\midrule
flag\_show\_b     & bool & false & Barnard Catalogue (B). \\%\midrule
flag\_show\_sh2   & bool & false & Sharpless Catalogue (SH2). \\%\midrule
flag\_show\_vdb   & bool & false & Van den Bergh Catalogue of reflection nebulae (vdB). \\%\midrule
flag\_show\_rcw   & bool & false & The RCW catalogue of H$\alpha$-emission regions in the southern Milky Way (RCW). \\%\midrule
flag\_show\_lbn   & bool & false & Lynds' Catalogue of Bright Nebulae (LBN). \\%\midrule
flag\_show\_ldn   & bool & false & Lynds' Catalogue of Dark Nebulae (LDN). \\%\midrule
flag\_show\_cr    & bool & false & Collinder Catalogue (Cr or Collinder). \\%\midrule
flag\_show\_mel   & bool & false & Melotte Catalogue of Deep Sky Objects (Mel or Melotte).  \\%\midrule
flag\_show\_pgc   & bool & false & HYPERLEDA. I. Catalog of galaxies (PGC). \\%\midrule
flag\_show\_ced   & bool & false & Cederblad Catalog of bright diffuse Galactic nebulae (Ced). \\%\midrule
flag\_show\_ugc   & bool & false & The Uppsala General Catalogue of Galaxies (UGC). \\%\midrule
flag\_show\_arp   & bool & false & Atlas of Peculiar Galaxies (Arp). \\%\midrule
flag\_show\_vv    & bool & false & The Catalogue of Interacting Galaxies (VV). \\%\midrule
flag\_show\_pk    & bool & false & The Catalogue of Galactic Planetary Nebulae (PK). \\%\midrule
flag\_show\_png   & bool & false & The Strasbourg-ESO Catalogue of Galactic Planetary Nebulae (PN G). \\%\midrule
flag\_show\_snrg  & bool & false & A catalogue of Galactic supernova remnants (SNR G). \\%\midrule
flag\_show\_aco   & bool & false & A Catalog of Rich Clusters of Galaxies (Abell or ACO). \\%\midrule
flag\_show\_hcg   & bool & false & A Hickson Compact Group (HCG). \\%\midrule
flag\_show\_eso   & bool & false & ESO/Uppsala Survey of the ESO(B) Atlas (ESO). \\%\midrule
flag\_show\_vdbh  & bool & false & Catalogue of southern stars embedded in nebulosity (vdBH). \\%\midrule
flag\_show\_dwb   & bool & false & Catalogue and distances of optically visible H II regions (DWB). \\%\midrule
flag\_show\_tr    & bool & false & Trumpler Catalogue (Tr or Trumpler). \\%\midrule
flag\_show\_st    & bool & false & Stock Catalogue (St or Stock). \\%\midrule
flag\_show\_ru    & bool & false & Ruprecht Catalogue (Ru or Ruprecht). \\%\midrule
flag\_show\_vdbha & bool & false & van den Bergh-Hagen Catalogue (vdB-Ha). \\%\midrule
flag\_show\_other & bool & true & All objects without identifiers. \\\bottomrule
\end{longtable}

\subsection{\big[dso\_type\_filters\big]}
%\label{sec:config.ini:dso_type_filters}
In this section you can fine-tune which types of the deep-sky objects should be selected on startup.

\noindent%
\begin{tabularx}{\textwidth}{l|l|l|X}\toprule
\emph{ID} & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
flag\_show\_galaxies              & bool & true & display galaxies.\\%\midrule
flag\_show\_active\_galaxies      & bool & true & display active galaxies. \\%\midrule
flag\_show\_interacting\_galaxies & bool & true & display interacting galaxies.  \\%\midrule
flag\_show\_open\_clusters        & bool & true & display open star clusters.  \\%\midrule
flag\_show\_globular\_clusters    & bool & true & display globular star clusters.  \\%\midrule
flag\_show\_bright\_nebulae       & bool & true & display bright nebulae.  \\%\midrule
flag\_show\_dark\_nebulae         & bool & true & display dark nebulae.  \\%\midrule
flag\_show\_planetary\_nebulae    & bool & true & display planetary nebulae.  \\%\midrule
flag\_show\_hydrogen\_regions     & bool & true & display hydrogen regions. \\%\midrule
flag\_show\_supernova\_remnants   & bool & true & display supernovae remnants. \\%\midrule
flag\_show\_galaxy\_clusters      & bool & true & display clusters of galaxies. \\%\midrule
flag\_show\_other                 & bool & true & display other deep-sky objects.  \\\bottomrule
\end{tabularx}

\subsection{\big[fov\big]}
In this section you can fine-tune 10 predefined values of field of view in degrees (all FOV may be set through keyboard hotkeys, see section~\ref{sec:tour:moving}).

\noindent%
\begin{tabularx}{\textwidth}{l|l|l|X}\toprule
\emph{ID} & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
quick\_fov\_1 & float & 180  & predefined value for FOV \emph{1}.\\
quick\_fov\_2 & float & 90   & predefined value for FOV \emph{2}.\\
quick\_fov\_3 & float & 60   & predefined value for FOV \emph{3}.\\
quick\_fov\_4 & float & 45   & predefined value for FOV \emph{4}.\\
quick\_fov\_5 & float & 20   & predefined value for FOV \emph{5}.\\
quick\_fov\_6 & float & 10   & predefined value for FOV \emph{6}.\\
quick\_fov\_7 & float & 5    & predefined value for FOV \emph{7}.\\
quick\_fov\_8 & float & 2    & predefined value for FOV \emph{8}.\\
quick\_fov\_9 & float & 1    & predefined value for FOV \emph{9}.\\
quick\_fov\_0 & float & 0.5  & predefined value for FOV \emph{0}.\\\bottomrule
\end{tabularx}


\subsection{\big[gui\big]}
%\label{sec:config.ini:gui}

This section includes settings for the graphical user interface. See sections \ref{sec:gui:configuration:extras}--\ref{sec:gui:configuration:tools} for most of these keys.

\begin{longtable}{p{50mm}|l|l|p{55mm}}
\toprule
\emph{ID} & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
flag\_show\_gui                 & bool   & true & If \emph{true}, display GUI.\\\midrule
screen\_font\_size & int  & 13 & Sets the font size for screen texts. Typical value: \emph{13..15}\\%\midrule
gui\_font\_size  & int    & 13 & Sets the dialog font size. Typical value: \emph{10..20}\\%\midrule
base\_font\_name & string & Verdana     & Selects the name \\
                 &        & (Windows)            & for base font\\
                 &        & DejaVu Sans & \\
                 &        & (others)            & \\%\midrule
%safe\_font\_name               & string &      & Selects the name for safe font, e.g. \emph{Verdana}\\\midrule
base\_font\_file                & string &      & Selects the name for font file, e.g. \emph{DejaVuSans.ttf}\\
flag\_font\_selection           & bool  & false & Show GUI elements for font selection.\\\midrule
immediate\_save\_details        & bool  & false & Set to \emph{true} to store some detail settings in the configuration dialog immediately, 
                                                  instead of having to press ``Save settings'' explicitly.\\\midrule
%% TODO: Is this required? timeout=0 also keeps cursor visible.
flag\_mouse\_cursor\_timeout    & bool  & true  & Set to \emph{false} if you want to have cursor visible at all times.\\%\midrule
mouse\_cursor\_timeout          & float & 10    & Set to \emph{0} if you want to keep the mouse cursor visible at all times. 
                                                  non-0 values mean the cursor will be hidden after that many seconds of inactivity\\\midrule
%
flag\_show\_boundaries\_button         & bool  & false & Show a button to toggle constellation boundaries\\
flag\_show\_asterism\_lines\_button    & bool  & false & Show a button to toggle asterism lines\\
flag\_show\_asterism\_labels\_button   & bool  & false & Show a button to toggle asterism labels\\
flag\_show\_ecliptic\_grid\_button     & bool  & false & Show a button to toggle ecliptic grid\\
flag\_show\_icrs\_grid\_button         & bool  & false & Show a button to toggle ICRS (equatorial J2000.0) grid\\
flag\_show\_galactic\_grid\_button     & bool  & false & Show a button to toggle galactic grid\\
flag\_show\_goto\_selected\_button     & bool  & true  & Show a button to center to selected object\\
flag\_show\_nightmode\_button          & bool  & true  & Show a button to toggle night mode\\
flag\_show\_nebulae\_ \mbox{background\_button} & bool & false & Show a button to toggle images for deep-sky objects\\%\midrule
flag\_show\_flip\_buttons              & bool  & false & Show the image flipping buttons in the main toolbar \\%\midrule
flag\_show\_dss\_button                & bool  & false & Show a button to toggle Digitized Sky Survey (DSS)\\%\midrule
flag\_show\_hips\_button               & bool  & false & Show a button to toggle HiPS survey display\\%\midrule
flag\_show\_bookmark\_button           & bool  & false & Show a button to show and edit bookmarks\\
flag\_show\_fullscreen\_button         & bool  & true  & Show a button to toggle fullscreen view\\
flag\_show\_quit\_button               & bool  & true  & Show a button to quit via button press\\
flag\_show\_cardinal\_button           & bool  & true  & Show a button to toggle cardinals via button press\\
flag\_show\_compass\_button            & bool  & false & Show a button to toggle compass marks via button press\\
flag\_show\_buttons\_background        & bool  & true  & If \emph{true}, use background under buttons on bottom bar.\\\midrule
flag\_overwrite\_info\_color           & bool  & false & Set \emph{true} to use one color for test in info panel for all objects.\\
flag\_info\_shadow                     & bool  & false & Set \emph{true} to apply a slight shadow behind the infotext for increased readability.\\
pixmaps\_brightness                    & float & 1.0   & Brighten the gray of GUI buttons. Usable: [1\ldots1.8]\\\midrule
%
selected\_object\_info            & string & all  & Values: \emph{default}, \emph{all}, \emph{short}, \emph{none}, 
                                                    and \emph{custom} (see~\ref{sec:gui:configuration:info}).\\\midrule
custom\_marker\_size             & float   & 5.0 & Size of custom marker.\\%\midrule
custom\_marker\_radius\_limit    & int   & 15 & Limit the click radius for mouse cursor position in any direction for removing of closest custom marker.\\\midrule
%% NO LONGER HERE!
%day\_key\_mode                  & string & Specifies the amount of time which is added and subtracted when the 
%                                                    {[} {]} - and = keys are pressed - calendar days, or sidereal days. 
%                                                    This option only makes sense for Digitalis planetariums. %% WHY?
%                                                    Values: \emph{calendar} or \emph{sidereal}\\\midrule
auto\_hide\_horizontal\_toolbar & bool   & true  & Set to \emph{true} if you want auto hide the horizontal toolbar.\\%\midrule
auto\_hide\_vertical\_toolbar   & bool   & true  & Set to \emph{true} if you want auto hide the vertical toolbar.\\%\midrule
flag\_use\_window\_transparency & bool   & false & If \emph{false}, show menu bars opaque\\%\midrule
flag\_show\_datetime            & bool   & true  & display date and time in the bottom bar\\%\midrule
flag\_time\_jd                  & bool   & false & use JD format for time in the bottom bar\\%\midrule
flag\_show\_tz                  & bool   & false & show time zone info in the bottom bar\\%\midrule
flag\_show\_location            & bool   & true  & display location in the bottom bar\\%\midrule
flag\_show\_fps                 & bool   & true  & show at how many frames per second Stellarium is rendering\\%\midrule
flag\_show\_fov                 & bool   & true  & show how many degrees your vertical field of view is\\%\midrule
flag\_fov\_dms                  & bool   & false & use DMS format for FOV in the bottom bar\\\midrule
%
flag\_show\_decimal\_degrees    & bool   & false & If \emph{true}, use decimal degrees for coordinates\\\midrule
flag\_use\_azimuth\_from\_south & bool   & false & If \emph{true}, calculate azimuth from south towards west 
                                                   (as in some astronomical literature)\\
flag\_use\_negative\_hour\_angles & bool & false & If \emph{true}, use hour angles -12h\ldots12h\\ 
flag\_use\_polar\_distance      & bool   & false & Use distance from North Celestial Pole, not declination from equator \\\midrule
flag\_surface\_brightness\_arcsec  & bool  & false & Toggle usage the measure unit $^{mag}/_\square{'}$ ($^{mag}/arcmin^2$) or 
                                                     $^{mag}/_\square{''}$ ($^{mag}/arcsec^2$) for the surface brightness of deep-sky objects.\\%\midrule
flag\_surface\_brightness\_short  & bool   & false & Toggle usage the short notation for the surface brightness of deep-sky objects.\\\midrule
flag\_enable\_kinetic\_scrolling & bool  & true  & If \emph{true}, use kinetic scrolling in the GUI\footnote{%
                                                   Scroll by dragging in the window directly, not a slider handle. Scrolling stops after a short time.}.\\\midrule
pointer\_animation\_speed 		& float  & 1.0 	 & Animation speed of pointers.\\\midrule
%
gpsd\_hostname                  & string & localhost & hostname of server running \program{gpsd} (non-Windows only)\\%\midrule
gpsd\_port                      & int    & 2947   & port number of \program{gpsd} (non-Windows only)\\%\midrule
gps\_interface                  & string &  COM3  & Port number of serial/USB GPS device. (May look like \texttt{ttyUSB0} on Linux,
                                                    if you really don't run \program{gpsd}.)\\%\midrule
gps\_baudrate                   & int    &  4800  & baudrate of serial/USB GPS device (for direct serial connection only)\\\bottomrule
\end{longtable}

\subsection{\big[init\_location\big]}
%\label{sec:config.ini:init_location}

\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID} & \emph{Type} & \emph{Description}\\\midrule
landscape\_name   & string & Sets the landscape you see. Built-in options are \emph{garching, geneva, grossmugl, guereins, 
                             hurricane, jupiter, mars, moon, neptune, ocean, saturn, trees, uranus, zero}.\\%\midrule
location          & string & Name of location on which to start stellarium.\\%\midrule
last\_location    & string & Coordinates of last used location in stellarium.\\\bottomrule
\end{tabularx}

\subsection{\big[landscape\big]}
%% Totally crazy, one label, and tex limits are exceeded for tex4ht. 
\ifhtlatex
\else
\label{sec:configini:landscape}
\fi

\begin{longtable}{l|l|p{68mm}}\toprule
\emph{ID}                            & \emph{Type} & \emph{Description}\\\midrule
atmosphere\_fade\_duration                 & float & Sets the time (seconds) it takes for the atmosphere to fade when de-selected\\%\midrule
flag\_landscape                            & bool  & Set \emph{false} if you don't want to see the landscape at start-up\\%\midrule
flag\_fog                                  & bool  & Set \emph{false} if you don't want to see fog on start-up\\%\midrule
flag\_atmosphere                           & bool  & Set \emph{false} if you don't want to see atmosphere on start-up\\%\midrule
flag\_landscape\_sets\_location            & bool  & Set \emph{true} if you want Stellarium to modify the observer location 
                                                     when a new landscape is selected (changes planet and longitude/latitude/altitude 
                                                     if location data is available in the landscape.ini file)\\%\midrule
minimal\_brightness                        & float & Set minimal brightness for landscapes. [0\ldots1] Typical value: \emph{0.01}\\%\midrule
atmosphereybin		                   & int   & Atmosphere tessellation coefficient for Y axis. Default=44.\\%\midrule
flag\_minimal\_brightness                  & bool  & Set \emph{true} to use minimal brightness for landscape.\\%\midrule
flag\_landscape\_sets\_minimal\_brightness & bool  & Set \emph{true} to use value for minimal brightness for landscape from landscape settings.\\%\midrule
flag\_enable\_illumination\_layer          & bool  & Set \emph{true} to use illumination layer for landscape.\\%\midrule
flag\_enable\_labels                       & bool  & Set \emph{true} to use landscape labels from gazetteer layer.\\%\midrule
label\_font\_size                          & int   & Font size for landscape labels. \\
label\_color                               & \ccbox{0.0,1.0,0.0} & Color for the labels \\
label\_angle                               & int   & Angle to display landscape labels $[0\ldots90]$. \\ 
polyline\_thickness                        & int   & Thickness to draw polygon line, if one is defined $[0\ldots5]$\\
polyline\_color                            & \ccbox{1.0,0.0,0.0} & Color for the polygon line, if one is defined \\
flag\_transparency                         & bool  & Set \emph{true} to show landscape semitransparent.\\
transparency                               & float & Use this transparency for landscapes. [0\ldots1] Typical value: \emph{0.5}\\
atmospheric\_extinction\_coefficient       & float & Set atmospheric extinction coefficient $k$ [mag/airmass]\\%\midrule
temperature\_C                             & float & Set atmospheric temperature [Celsius]\\%\midrule
pressure\_mbar                             & float & Set atmospheric pressure [mbar]\\%\midrule
cache\_size\_mb                            & int   & Set the cache size for landscapes [megabytes]. Default: 100\\\bottomrule
\end{longtable}

\subsection{\big[localization\big]}
%\label{sec:config.ini:localization}

\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID}         & \emph{Type} & \emph{Description}\\\midrule
sky\_culture          & string & Sets the sky culture to use. E.g. \emph{western, polynesian, egyptian, chinese, 
                                 lakota, navajo, inuit, korean, norse, tupi, maori, aztec, sami}.\\%\midrule
sky\_locale           & string & Sets language used for names of objects in the sky (e.g. planets). 
                                 The value is a short locale code, e.g. \emph{en, de, en\_GB}\\%\midrule
app\_locale           & string & Sets language used for Stellarium's user interface. 
                                  The value is a short locale code, e.g. \emph{en, de, en\_GB}.\\%\midrule
time\_zone            & string & Sets the time zone. Valid values: \emph{system\_default}, 
                                 or some region/location combination, e.g. \emph{Pacific/Marquesas}\\%\midrule
flag\_dst             & bool   & Set \emph{true} to apply daylight saving time as required by time zone.\\
time\_display\_format & string & time display format: can be \emph{system\_default}, \emph{24h} or \emph{12h}.\\%\midrule
date\_display\_format & string & date display format: can be \emph{system\_default}, \emph{mmddyyyy}, \emph{ddmmyyyy}, \emph{yyyymmdd} (ISO8601), \emph{wwmmddyyyy}, \emph{wwddmmyyyy}, \emph{wwyyyymmdd}.\\\bottomrule
\end{tabularx}

\subsection{\big[main\big]}
%\label{sec:config.ini:main}

\begin{longtable}{l|l|p{77mm}}\toprule
\emph{ID}                 & \emph{Type} & \emph{Description}\\\midrule
invert\_screenshots\_colors & bool   & If \emph{true}, Stellarium will save the screenshots with inverted colors.\\%\midrule
screenshot\_dir             & string & Path for saving screenshots\\%\midrule
screenshot\_format          & string & File format. One of \texttt{png|jpg|jpeg|tif|tiff| webp|pbm|pgm|ppm|xbm|xpm|ico}\\
screenshot\_custom\_size    & bool   & \emph{true} if you want to specify particular dimensions next:\\
screenshot\_custom\_width   & int    & custom width of screenshots. Max.\ available size is hardware dependent!\\
screenshot\_custom\_height  & int    & custom height of screenshots. Max.\ available size is hardware dependent!\\
screenshot\_dpi             & int    & DPI setting for screenshots. \\\midrule
observinglists\_dir         & string & Default path for saving and loading observing lists. Defaults to the user's home dir.\\
version                     & string & Version of Stellarium. This parameter may be used to detect necessary changes in config.ini file, do not edit.\\%\midrule
use\_separate\_output\_file & bool   & Set to \emph{true} if you want to create a new file for script output for each start of Stellarium\\%\midrule
restore\_defaults           & bool   & If \emph{true}, Stellarium will restore default settings at startup. 
                                       This is equivalent to calling Stellarium with the \command{--restore-defaults} option.\\%\midrule
ignore\_opengl\_warning     & bool   & Set to \emph{true} if you don't want to see OpenGL warnings for each start of Stellarium.\\%\midrule
check\_requirements         & bool   & Set to \emph{false} if you want to disable and permanently ignore checking hardware requirements at startup. 
                                       Expect problems if hardware is below requirements!\\
geoip\_api\_url             & string & URL for JSON interface of GeoIP service.\\
\bottomrule
\end{longtable}

\subsection{\big[navigation\big]}
%\label{sec:config.ini:navigation}

This section controls much of the look\&feel of Stellarium. Be careful if you change something here.

%% TODO: improve description of the various zoom settings.

\begin{longtable}{l|l|p{77mm}}\toprule
\emph{ID}              & \emph{Type} & \emph{Description}\\\midrule
preset\_sky\_time               & float  & Preset sky time used by the dome version. Unit is Julian Day. Typical value: \emph{2451514.250011573}\\%\midrule
startup\_time\_mode             & string & Set the start-up time mode, can be \emph{actual} (start with current real world time), 
                                           or \emph{Preset} (start at time defined by preset\_sky\_time)\\%\midrule
flag\_enable\_zoom\_keys        & bool   & Set to \emph{false} if you want to disable the zoom\\%\midrule
flag\_manual\_zoom              & bool   & Set to \emph{false} for normal zoom behaviour as described in this guide. 
                                           When set to \emph{true}, the auto zoom feature only moves in a small amount and must be pressed many times\\%\midrule
flag\_enable\_move\_keys        & bool   & Set to \emph{false} if you want to disable the arrow keys\\%\midrule
flag\_enable\_mouse\_navigation & bool   & Set to \emph{false} if you want to disable the mouse pan (drag).\\%\midrule
flag\_enable\_mouse\_zooming & bool   & Set to \emph{false} if you want to disable the mouse zooming (mousewheel).\\%\midrule
init\_fov                       & float  & Initial field of view, in degrees. Typical value: ''60''.\\%\midrule
min\_fov                        & float  & Minimal field of view, in degrees. Typical value: ''0.001389'' (5").\\%\midrule
max\_fov                        & float  & Maximal field of view, in degrees. Typical value: ''360.0''.\\%\midrule
init\_view\_pos                 & floats & Initial viewing direction. This is a vector with x,y,z-coordinates. x being N-S (S +ve), 
                                           y being E-W (E +ve), z being up-down (up +ve). Thus to look South at the horizon use \emph{1,0,0}. 
                                           To look Northwest and up at $45\degree$, use \emph{-1,-1,1} and so on.\\%\midrule
auto\_move\_duration            & float  & Duration (seconds) for the program to move to point at an object when the space bar is pressed. 
                                           Typical value: \emph{1.4}\\%\midrule
return\_home\_duration          & float  & Duration (seconds) of movement of returning to a home location (for a demo). Default value: \emph{0.}\\%\midrule
return\_fov\_duration           & float  & Duration (seconds) of zooming to an initial field of view value (for a demo). Default value: \emph{1.}\\%\midrule
mouse\_zoom                     & float  & Sets the mouse zoom amount (mouse-wheel)\\%\midrule
move\_speed                     & float  & Sets the speed of movement\\%\midrule
zoom\_speed                     & float  & Sets the zoom speed\\%\midrule
viewing\_mode                   & string & If set to \emph{horizon}, the viewing mode simulate an alt/azi mount, 
                                           if set to \emph{equator}, the viewing mode simulates an equatorial mount\\%\midrule
auto\_zoom\_out\_resets\_direction & bool & Set to \emph{true} if you want to auto-zoom restoring direction.\\%\midrule
time\_correction\_algorithm     & string & Algorithm of DeltaT correction.\\\bottomrule %% TODO: list values! And write ref. chapter!
\end{longtable}

\subsection{\big[plugins\_load\_at\_startup\big]}
%\label{sec:config.ini:plugins_load_at_startup}

This section lists which plugins are loaded at startup (those with
\emph{true} values). Each plugin can add another section into this
file with its own content, which is described in the respective plugin
documentation, see \ref{ch:Plugins}. You activate loading of plugins
in the \key{F2} settings dialog, tab ``Plugins''. After selection of
which plugins to load, you must restart Stellarium.

\begin{longtable}{l|l|p{80mm}}
\toprule
\emph{ID} & \emph{Type} & \emph{Description}\\\midrule
AngleMeasure          & bool & \ref{sec:plugins:AngleMeasure} Angle Measure plugin\\
ArchaeoLines          & bool & \ref{sec:plugin:ArchaeoLines} ArchaeoLines plugin\\
Calendars             & bool & \ref{sec:plugin:Calendars} Calendars plugin\\
EquationOfTime        & bool & \ref{sec:plugins:EquationOfTime} Equation of Time plugin\\
Exoplanets            & bool & \ref{sec:plugins:Exoplanets} Exoplanets plugin \\
MeteorShowers         & bool & \ref{sec:plugins:MeteorShowers} Meteor Showers plugin \\
NebulaTextures        & bool & \ref{sec:plugins:NebulaTextures} Nebula Textures plugin \\
Novae                 & bool & \ref{sec:plugins:BrightNovae} Bright Novae plugin \\
Observability         & bool & \ref{sec:plugins:Observability} Observability Analysis\\
Oculars               & bool & \ref{sec:plugins:Oculars} Oculars plugin \\
Pulsars               & bool & \ref{sec:plugins:Pulsars} Pulsars plugin \\
Quasars               & bool & \ref{sec:plugins:Quasars} Quasars plugin \\
RemoteControl         & bool & \ref{sec:plugin:RemoteControl} Remote Control plugin \\
RemoteSync            & bool & \ref{sec:plugin:RemoteSync} Remote Sync plugin \\
Satellites            & bool & \ref{sec:plugins:Satellites} Satellites plugin \\
Scenery3d             & bool & \ref{ch:scenery3d} Scenery 3D plugin \\
SolarSystemEditor     & bool & \ref{sec:plugins:SolarSystemEditor} Solar System Editor plugin\\
Supernovae            & bool & \ref{sec:plugins:HistoricalSupernovae} Historical Supernovae plugin \\
TelescopeControl      & bool & \ref{sec:plugins:TelescopeControl} Telescope Control plugin \\
TextUserInterface     & bool & \ref{sec:plugins:TextUserInterface} Text User Interface plugin \\\bottomrule
\end{longtable}

\subsection{\big[projection\big]}
%\label{sec:config.ini:projection}

This section contains the projection of your choice and several
advanced settings important if you run Stellarium on a single screen,
multi-projection, dome projection, or other setups.

\begin{longtable}{l|l|p{80mm}}\toprule
\emph{ID} & \emph{Type} & \emph{Description}\\\midrule
type                       & string & Sets projection mode. Values: \emph{ProjectionPerspective,
                                      ProjectionEqualArea, ProjectionStereographic, ProjectionFisheye,
                                      ProjectionHammer, ProjectionCylinder, ProjectionCylinderFill, ProjectionMercator,
                                      ProjectionOrthographic, ProjectionMiller}, or \emph{ProjectionSinusoidal}.\\%\midrule
flip\_horz                   & bool & \\%\midrule
flip\_vert                   & bool & \\%\midrule
viewport                   & string & How the view-port looks. Values: \emph{none} (regular rectangular screen), 
                                      \emph{disk} (circular screen, useful for planetarium setup).\\%\midrule
viewportMask               & string & How the view-port looks. Values: \emph{none}.\\%\midrule %% TODO: DESCRIBE HOW TO USE!
viewport\_fov\_diameter     & float & \\%\midrule
viewport\_x                 & float & Usually 0. \\%\midrule
viewport\_y                 & float & Usually 0. \\%\midrule
viewport\_width             & float & \\%\midrule
viewport\_height            & float & \\%\midrule
viewport\_center\_x         & float & Usually half of viewport\_width. \\%\midrule
viewport\_center\_y         & float & Usually half of viewport\_height. \\%\midrule
viewport\_center\_offset\_x & float & [-0.5\ldots+0.5] Usually 0. \\%\midrule
viewport\_center\_offset\_y & float & [-0.5\ldots+0.5] Use negative values to move the horizon lower. \\
\bottomrule
\end{longtable}

\subsection{\big[proxy\big]}
%\label{sec:config.ini:proxy}
This section has setting for connection to network through proxy server (proxy will be using when host of proxy is filled).

\noindent%
\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID}  & \emph{Type} & \emph{Description}\\\midrule
host\_name & string & Name of host for proxy. E.g. \emph{proxy.org}\\%\midrule
type	   & string & Type of proxy. E.g. \emph{socks}\\%\midrule
port       & int    & Port of proxy. E.g. \emph{8080}\\%\midrule
user       & string & Username for proxy. E.g. \emph{michael\_knight}\\%\midrule
password   & string & Password for proxy. E.g. \emph{xxxxx}\\\bottomrule
\end{tabularx}

\subsection{\big[scripts\big]}
%\label{sec:config.ini:scripts}

\begin{tabularx}{\textwidth}{l|l|l|X}\toprule
\emph{ID}                  & \emph{Type} & \emph{Default} & \emph{Description}\\\midrule
startup\_script                            & string & startup.ssc & name of script executed on program start\\
flag\_allow\_screenshots\_dir              & bool   & false       & Allow scripts to set a target directory.\\
flag\_allow\_write\_absolute\_path         & bool   & false       & set true to let scripts store output files to absolute pathnames.
                                                                    This may pose a security risk if you run scripts from other authors
                                                                    without checking what they are doing.\\\bottomrule 
\end{tabularx}

\subsection{\big[search\big]}
%\label{sec:config.ini:search}

\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID} & \emph{Type} & \emph{Description}\\\midrule
flag\_search\_online & bool   & If \emph{true}, Stellarium will be use SIMBAD for search.\\%\midrule
simbad\_server\_url  & string & URL for SIMBAD mirror\\%\midrule
flag\_start\_words   & bool   & If \emph{false}, Stellarium will be search phrase only from start of words\\%\midrule
coordinate\_system   & string & Specifies the coordinate system. 
                                \emph{Possible values:} equatorialJ2000, equatorial, horizontal, galactic. \emph{Default value:} equatorialJ2000.\\
\bottomrule
\end{tabularx}

\subsection{\big[spheric\_mirror\big]}
%\label{sec:config.ini:spheric_mirror}

Stellarium can be used in planetarium domes. You can use a projector with a hemispheric mirror with geometric properties given in this section. 
Note: These functions are only rarely used or tested, some may not work as expected.
%% TODO: Make sure we can remove this note! Maybe add a chapter in the ``Advanced setup'' part?
 
\begin{longtable}{l|l|l|p{68mm}}\toprule
\emph{ID} & \emph{Type} & \emph{Default}&\emph{Description}\\\midrule
flip\_horz             & bool  &true & Flip the projection horizontally\\%\midrule
flip\_vert             & bool  &false& Flip the projection vertically\\%\midrule
projector\_alpha       & float &0& This parameter controls the properties of the spheric mirror projection mode.\\%\midrule
projector\_gamma       & float && This parameter controls the properties of the spheric mirror projection mode.\\%\midrule
projector\_delta       & float &-1e100& This parameter controls the properties of the spheric mirror projection mode.\\%\midrule
projector\_phi         & float &0& This parameter controls the properties of the spheric mirror projection mode.\\%\midrule
projector\_position\_x & float &0& \\%\midrule
projector\_position\_y & float &1& \\%\midrule
projector\_position\_z & float &-0.2& \\%\midrule
mirror\_position\_x    & float &0& \\%\midrule
mirror\_position\_y    & float &2& \\%\midrule
mirror\_position\_z    & float &0& \\%\midrule
image\_distance\_div\_height&float&-1e100\\%\midrule
mirror\_radius         & float &0.25& \\%\midrule
dome\_radius           & float &2.5& \\%\midrule
custom\_distortion\_file& string& \\%\midrule
texture\_triangle\_base\_length&float& \\%\midrule
zenith\_y              & float &0.125& deprecated\\%\midrule
scaling\_factor        & float &0.8  & deprecated \\%\midrule
%% GZ I found some very strange names in StelViewportEffect.cpp
distorter\_max\_fov    & float & 175.0&Set the maximum field of view for the spheric mirror distorter in degrees. Typical value: \emph{180}\\%\midrule
%% TODO: MAKE SURE THIS IS STILL USED?
%flag\_use\_ext\_framebuffer\_object & bool & Some video hardware incorrectly claims to support some GL extension, GL\_FRAMEBUFFER\_EXTEXT. If, when using the spheric mirror distorter the
%frame rate drops to a very low value (e.g. 0.1 FPS), set this parameter to \emph{false} to tell Stellarium to ignore the claim of the video driver that it can use this extension\\\midrule
viewportCenterWidth    & float && projected image width, pixels\\%\midrule %% TODO Value has buggy name. Test functionality/Discuss!
viewportCenterHeight   & float && projected image height, pixels\\%\midrule %% TODO Value has buggy name. Test functionality/Discuss!
viewportCenterX        & float && projected image center X, pixels\\%\midrule
viewportCenterY        & float && projected image center Y, pixels\\
\bottomrule 
\end{longtable}

\subsection{\big[stars\big]}
%\label{sec:config.ini:stars}

This section controls how stars are rendered.
%% TODO: Explain what we mean with "magnitude conversion routine"!

\noindent%
\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID}                & \emph{Type} & \emph{Description}\\\midrule
relative\_scale          & float       & relative size of bright and faint stars. Higher values mean that bright stars 
                                         are comparatively larger when rendered. Typical value: \emph{1.0}\\%\midrule
absolute\_scale          & float       & Changes how large stars are rendered. larger value lead to larger depiction. Typical value: \emph{1.0}\\%\midrule
star\_twinkle\_amount    & float       & amount of twinkling. Typical value: \emph{0.3}\\%\midrule
flag\_star\_twinkle      & bool        & \emph{true} to allow twinkling (but only when atmosphere is active!).\\%\midrule
flag\_forced\_twinkle    & bool        & \emph{true} to allow twinkling stars even without atmosphere. This is obvious nonsense and contrary to nature, but some users seem to like it.\\%\midrule
flag\_star\_halo         & bool        & \emph{false} to not draw a halo around the brightest stars. This looks poor, but some users seem to prefer it.\\%\midrule
mag\_converter\_max\_fov & float       & maximum field of view for which the magnitude conversion routine is used. Typical value: \emph{90.0}.\\%\midrule
mag\_converter\_min\_fov & float       & minimum field of view for which the magnitude conversion routine is used. Typical value: \emph{0.001}.\\%\midrule
labels\_amount           & float       & amount of labels. Typical value: \emph{3.0}\\%\midrule
init\_bortle\_scale      & int         & initial value of light pollution on the Bortle scale. Typical value: \emph{3}.\\\bottomrule
\end{tabularx}

\subsection{\big[tui\big]}
%\label{sec:config.ini:tui}

The built-in text user interface (TUI) plugin (see chapter~\ref{sec:plugins:TextUserInterface}) is most useful for planetariums. You can even configure a system shutdown command. 
For historical reasons, the section is not called \texttt{[TextUserInterface]} but simply \texttt{[tui]}.
%% TODO: Move to TUI plugin chapter?

\noindent%
\begin{tabularx}{\textwidth}{l|l|l|X}\toprule
\emph{ID} & \emph{Type} &\emph{Default}& \emph{Description}\\\midrule
%flag\_enable\_tui\_menu & bool & Enables or disables the TUI menu\\\midrule
tui\_font\_size                   &float    & 15       & Font size for TUI.\\%\midrule
tui\_font\_color                  &floatRGB &0.3,1,0.3 & Font color for TUI.\\%\midrule
flag\_show\_gravity\_ui           & bool    & false    & Set to \emph{true} to enable gravity mode for UI (for dome projection)\\%\midrule
flag\_show\_tui\_datetime         & bool    & false    & Set to \emph{true} if you want to see a date and time label suited for dome projections\\%\midrule
flag\_show\_tui\_short\_obj\_info & bool    & false    & Set to \emph{true} if you want to see object info suited for dome projections\\%\midrule
% TODO: DESCRIBE!
tui\_admin\_shutdown\_command       & string  && e.g.\ for Linux: \command{shutdown --poweroff +2} \\\bottomrule
\end{tabularx}

\subsection{\big[video\big]}
\label{sec:config.ini:video}

\begin{longtable}{l|l|p{80mm}}\toprule
\emph{ID}  & \emph{Type} & \emph{Description}\\\midrule
fullscreen       & bool   & If \emph{true}, Stellarium will start up in full-screen mode, else windowed mode\\%\midrule
screen\_w        & int    & Display width when in windowed mode. Value in pixels, e.g. \emph{1024}\\%\midrule
screen\_h        & int    & Display height when in windowed mode. Value in pixels, e.g. \emph{768}\\%\midrule
screen\_x        & int    & Horizontal position of the top-left corner in windowed mode. Value in pixels, e.g. \emph{0}\\%\midrule
screen\_y        & int    & Vertical   position of the top-left corner in windowed mode. Value in pixels, e.g. \emph{0}\\%\midrule
viewport\_effect & string & This is used when the spheric mirror display mode is activated. Values include \emph{none} and \emph{sphericMirrorDistorter}.\\%\midrule
minimum\_fps     & int    & Sets the minimum number of frames per second to display at (hardware performance permitting)\\%\midrule
maximum\_fps     & int    & Sets the maximum number of frames per second to display at. This is useful to reduce power consumption in laptops.\\%\midrule
min\_time\_bewteen\_frames & int & Sets the minimum time (in milliseconds) between the end of rendering and the start of the next frame. Only takes effect on Macs. Used to work around \url{https://github.com/Stellarium/stellarium/issues/2778}.\\
multisampling    & int    & Sets the number of samples to use for multisampling antialiasing. \emph{0} disables antialiasing, \emph{1} is no-op (single sample per pixel), 
                            higher values increase smoothness and degrade performance. Too high a value may result in excessive blurriness of the GUI. A good starting value to try is \emph{4}.\\
planet\_shadows\_supersampling & bool & Improves quality of shadows on the Moon by evaluating the color for each multisampling sample, rather than once per pixel. 
                                        Level of improvement (and performance cost) depends on \emph{multisampling} setting. Default is \emph{false}, i.e. disabled.\\
anisotropic\_filtering         & int  & Improves quality of rendering of inclined textured surfaces like e.g. planetary surface near the limb. 
                                        Modern (and even quite old, like from 2010) GPUs can handle high anisotropy with no noticeable performance drop, so it should be fine to set this value as high as 16. 
										If this setting value is higher than the GPU is capable of, the maximum value supported is used. The default is 16. To disable anisotropic filtering, set this value to 0.\\
\bottomrule
\end{longtable}

\subsection{\big[viewing\big]}
%\label{sec:config.ini:viewing}

This section defines which objects, labels, lines, grids etc.\ you
want to see on startup. Set those to \emph{true}. Most items can be
toggled with hotkeys or switched in the GUI. Entries ending with
\texttt{\_line} or \texttt{\ldots\_lines} usually also have entries
\texttt{\ldots\_parts} and \texttt{\ldots\_labels} which govern
partitions and labels, respectively.

\begin{longtable}{l|l|p{77mm}}
\toprule
\emph{ID} & \emph{Type} & \emph{Description}\\\midrule
flag\_asterism\_drawing         & bool  & Display asterism line drawing\\%\midrule
flag\_asterism\_name            & bool  & Display asterism names\\%\midrule
flag\_rayhelper\_drawing        & bool  & Display the ray helper line drawing\\%\midrule
flag\_constellation\_drawing    & bool  & Display constellation line drawing\\%\midrule
flag\_constellation\_name       & bool  & Display constellation names\\%\midrule
flag\_constellation\_art        & bool  & Display constellation art\\%\midrule
flag\_constellation\_boundaries & bool  & Display constellation boundaries \\%\midrule
flag\_constellation\_isolate\_selected  & bool & If \emph{true}, constellation lines, boundaries and art will be limited to the constellation of the selected star, 
                                                 if that star is ``on'' one of the constellation lines, adding more constellations as you click more \\%\midrule
flag\_constellation\_pick     & bool & If flag\_constellation\_isolate\_selected is also true, 
                                       set to \emph{true} if you only want to see the line drawing, 
									   art and name of the currently selected constellation\\\midrule
%
flag\_isolated\_trails        & bool & Set to \emph{true} if you only want to see the trail line drawn for the selected planet (asteroid, comet, moon)\\%\midrule
number\_isolated\_trails      & int  & Number of isolated trails for latest selected Solar system bodies [1..5].\\%\midrule
max\_trail\_points            & int  & Limit maximum length of trails. Trails are drawn for 1 year or this number of computing steps.
                                       Default 5000, reduce if drawing trails slows down the program too much.\\
flag\_planets\_orbits\_only   & bool & Set to \emph{true} if you want to suppress orbits of minor bodies and moons.\\
flag\_isolated\_orbits        & bool & Set to \emph{true} if you want to see orbits only for selected planet.\\
flag\_orbits\_with\_moons     & bool & Set to \emph{true} if you want to see also orbits of the selected planet.\\\midrule
line\_thickness               & int  & Set the line thickness for grids and lines. Typical value: \emph{1}\\%\midrule
part\_thickness               & int  & Set the line thickness for line partitions. Typical value: \emph{1}\\\midrule
flag\_azimutal\_grid          & bool & Display azimuthal grid \\%\midrule
flag\_equatorial\_grid        & bool & Display equatorial grid (of date) \\%\midrule
flag\_equatorial\_J2000\_grid & bool & Display equatorial grid (J2000) \\%\midrule
flag\_ecliptic\_grid          & bool & Display ecliptic grid (of date) \\%\midrule
flag\_ecliptic\_J2000\_grid   & bool & Display ecliptic grid (J2000) \\%\midrule
flag\_galactic\_grid          & bool & Display galactic grid (System~II)\\%\midrule
flag\_galactic\_equator\_line & bool & Display galactic equator line \\%\midrule
flag\_supergalactic\_grid          & bool & Display supergalactic grid\\%\midrule
flag\_supergalactic\_equator\_line & bool & Display supergalactic equator line \\%\midrule
flag\_equator\_line           & bool & Display celestial equator line (of date) \\%\midrule
flag\_fixed\_equatorial\_grid & bool & Display fixed equatorial (hour angle) grid \\%\midrule
flag\_fixed\_equator\_line    & bool & Display fixed equator (hour angle) line\\%\midrule
flag\_equator\_J2000\_line    & bool & Display celestial equator line (J2000) \\%\midrule
flag\_ecliptic\_line          & bool & Display ecliptic line (of date) \\%\midrule
flag\_ecliptic\_J2000\_line   & bool & Display ecliptic line (J2000) \\%\midrule
flag\_longitude\_line         & bool & Display opposition/conjunction circle \\%\midrule
flag\_quadrature\_line        & bool & Display quadrature circle \\%\midrule
flag\_meridian\_line          & bool & Display meridian line \\%\midrule
flag\_prime\_vertical\_line   & bool & Display Prime Vertical line (East-Zenith-West) \\%\midrule
flag\_colure\_lines           & bool & Display colure lines (Celestial Pole-\Aries/\Cancer/\Libra/\Capricorn) \\\midrule
flag\_cardinal\_points        & bool & Display cardinal points\\
flag\_ordinal\_points         & bool & Display intercardinal (or ordinal) points\\
flag\_16wcr\_points           & bool & Display secondary intercardinal points\\%\midrule
flag\_32wcr\_points           & bool & Display tertiary intercardinal points\\%\midrule
cardinal\_font\_size          & int  & Font size for cardinal points. Typical value: \emph{24}\\%\midrule
ordinal\_font\_size           & int  & Font size for intercardinal (or ordinal) points. Typical value: \emph{18}\\%\midrule
16wcr\_font\_size             & int  & Font size for secondary intercardinal points. Typical value: \emph{16}\\\midrule
% TODO: This should go into the projection group:
flag\_gravity\_labels         & bool  & Set to \emph{true} if you want labels to undergo gravity (top side of text points toward zenith). Useful with dome projection.\\
\midrule
flag\_moon\_scaled            & bool  & Keep it \emph{false} if you want to see the real moon size \\%\midrule
moon\_scale                   & float & Sets the moon scale factor, sometimes useful to correlate to our perception of the moon's size. Typical value: \emph{4}\\
flag\_planets\_scaled         & bool  & Keep it \emph{false} if you want to see the real planet size \\%\midrule
planets\_scale                & float & Sets the planet scale factor, sometimes useful to show planets symbolically. Typical value: \emph{150}\\
flag\_sun\_scaled             & bool  & Keep it \emph{false} if you want to see the real sun size \\%\midrule
sun\_scale                    & float & Sets the sun scale factor, sometimes useful to correlate to our perception of the sun's size. Typical value: \emph{4}\\
flag\_minorbodies\_scaled     & bool  & Set to \emph{true} if you want to see minor bodies enlarged \\
minorbodies\_scale            & float & Set scale factor for minor bodies, to see them in unnatural detail. Typical value: \emph{10}\\
\midrule
flag\_draw\_moon\_halo           & bool  & Display halo around the Moon\\
flag\_draw\_sun\_halo            & bool  & Display Sun's glare\\
flag\_draw\_sun\_corona          & bool  & Display Sun's corona when atmosphere is disabled\\
\midrule
flag\_fov\_center\_marker        & bool  & Set to \emph{true} to enable drawing a field of view center marker \\
flag\_fov\_circular\_marker      & bool  & Set to \emph{true} to enable drawing a circular FOV marker \\
size\_fov\_circular\_marker      & float & size of the circular FOV marker, degrees \\
flag\_fov\_rectangular\_marker   & bool  & Set to \emph{true} to enable drawing a rectangular FOV marker \\
width\_fov\_rectangular\_marker  & float & width of the rectangular FOV marker, degrees \\
height\_fov\_rectangular\_marker & float & height of the rectangular FOV marker, degrees \\
rot\_fov\_rectangular\_marker    & float & rotation angle of the rectangular FOV marker, degrees \\
flag\_compass\_marks             & bool  & Set to \emph{true} to enable drawing compass marks \\
\midrule
constellation\_art\_intensity      & float & brightness [0\ldots1] of the constellation art images. Typical value: \emph{0.5}\\%\midrule
constellation\_art\_fade\_duration & float & time the constellation art takes to fade in or out, in seconds. Typical value: \emph{1.5}\\%\midrule
constellation\_font\_size          & int   & font size for constellation labels\\%\midrule
constellation\_line\_thickness     & int   & thickness of constellation lines [1\ldots5]. Typical value: \emph{1}\\%\midrule
asterism\_font\_size               & int   & font size for asterism labels\\%\midrule
asterism\_line\_thickness          & int   & thickness of the asterism lines [1\ldots5]. Typical value: \emph{1}\\%\midrule
rayhelper\_line\_thickness         & int   & thickness of the ray helper lines [1\ldots5]. Typical value: \emph{1}\\\midrule
flag\_night                        & bool  & Enable night mode (red-only mode) on startup\\\midrule
light\_pollution\_luminance        & float & Sets the level of the light pollution simulation\\\midrule %% TODO: WHAT IS THIS?
use\_luminance\_adaptation         & bool  & Enable dynamic eye adaptation\\\midrule %% TODO: DESCRIBE!
sky\_brightness\_label\_threshold  & float & Sky brightness [$cd/m^2$] to show infotext in black \\\midrule  %% 
flag\_landscape\_autoselection     & bool  & load fitting landscape after changing planet (use \emph{zero} landscape when no fitting found).\\
flag\_environment\_auto\_enable    & bool  & Enable/disable atmosphere, fog and cardinals for observer location when switching planet.\\
flag\_show\_selection\_marker      & bool  & Enable/disable visibility of pointers for selected objects.\\
\bottomrule
\end{longtable}



\subsection{\big[DialogPositions\big]}
%\label{sec:config.ini:DialogPositions}

By default, GUI panels appear centered in the screen. You can move them to your favorite location, 
and on next start they will appear on that location instead.
The entries in this section define the upper left pixel coordinate where panels are stored.

Examples:

\noindent%
\begin{tabularx}{\textwidth}{l|l|l|X}
\toprule
\emph{ID}     & \emph{Type} & \emph{Example}&\emph{Description}     \\\midrule
Help          & int,int     &  58,39        & Position of Help panel\\%\midrule
DateTime      & int,int     &  1338,944     & Position of time panel\\\bottomrule
\end{tabularx}

%\newpage

\subsection{\big[DialogSizes\big]}
%\label{sec:config.ini:DialogSizes}

\newFeature{0.15.1}
GUI panels can be resized by dragging on their lower corners or borders.  
Enlarged sizes are stored here, and on next start they will appear in this size.
The entries in this section define the size.

Examples:

\noindent%
\begin{tabularx}{\textwidth}{l|l|l|X}
\toprule
\emph{ID}     & \emph{Type} & \emph{Example}&\emph{Description}      \\\midrule
Help          & int,int     &  895,497      & Size of Help panel     \\%\midrule
AstroCalc     & int,int     &  913,493      & Size of AstroCalc panel\\\bottomrule
\end{tabularx}


\subsection{\big[hips\big]}
\label{sec:config.ini:hips}

This section defines the source list of the HiPS surveys, as well as other
HiPS related options.
\newFeature{0.18.0}

\noindent%
\begin{tabularx}{\textwidth}{l|l|X}\toprule
\emph{ID}     & \emph{Type} & \emph{Description}\\\midrule
show          & bool        & show HiPS at startup? \\
sources/size  & int         & Number of HiPS survey sources\\%\midrule
sources/$n$/url & string      & uri of the $n$th source hipslist file ($n \in [1 \ldots \mathtt{sources/size}]$)\\
visible/url   & bool        & HiPS configured to be displayed. (Stores current setting on program exit)\\\bottomrule
\end{tabularx}


%%% Local Variables: 
%%% mode: latex
%%% TeX-PDF-mode: t
%%% TeX-master: "guide"
%%% End: 

