SUG amendments

guide/app_config_ini.tex

@@ -583,6 +583,11 @@ \subsection{\big[landscape\big]}
 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

guide/ch_interface.tex

@@ -842,7 +842,7 @@ \subsection{The Landscape Tab}
   file. 
   \end{description}
 \item[Draw only polygon]\newFeature{0.20.2} If a polygonal horizon line has been
-  defined for the landscape, only draw this with the given thickness.
+  defined for the landscape, only draw this with the given thickness and color.
 \item[Transparency] Allow peeking below the horizon. \newFeature{23.3} Note that this may show graphical errors. 
 \end{description}
 

guide/ch_landscapes_gz.tex

@@ -216,7 +216,6 @@ \subsection{Polygonal landscape}
 polygonal_horizon_list = horizon_Geneve.txt
 polygonal_angle_rotatez = 0
 ground_color = .15,.45,.45
-horizon_line_color = .75,.45,.45
 \end{configfile}
 %
 Where:
@@ -242,9 +241,6 @@ \subsection{Polygonal landscape}
 \item[\var{ground\_color}] (optional, default=\var{0,0,0}, i.e.,
   black) Color for the area below the horizon line. Each R,G,B
   component is a float within 0..1.
-\item[\var{horizon\_line\_color}] (optional, default: invisible) used
-  to draw a polygonal horizon line. Each R,G,B component is a float
-  within 0..1.
 \item[\var{minimal\_brightness}] (optional) Some minimum brightness to
   keep landscape visible. Default=-1, i.e., use
   \var{minimal\_brightness} from the \var{[landscape]} section in the
@@ -258,6 +254,13 @@ \subsection{Polygonal landscape}
   for high mountain peaks with many negative horizon values this
   should be set to true.
 \end{description}
+No longer used:
+\begin{description}
+\item[\var{horizon\_line\_color}] (optional, default: invisible) used
+  to draw a polygonal horizon line. 
+  %Each R,G,B component is a float within 0..1. 
+  This is now\newFeature{24.4} a global setting, \var{config.ini:landscape/polygon\_color}.
+\end{description}
 
 \subsubsection{Artificial Polygonal Panoramas}
 The online service
@@ -293,8 +296,7 @@ \subsubsection{Artificial Polygonal Panoramas}
 
 A similar web service, \program{PeakFinder}\footnote{\url{https://www.peakfinder.com}}, 
 meanwhile also allows downloading the horizon polygon as installable landscape for Stellarium. 
-Unfortunately, currently (early 2024) the excellent gazetteer (peak identification) visible on the website 
-is not exported.
+A great feature of this service is the excellent gazetteer (peak identification) also visible on the website.
 
 
 \subsection{Spherical landscape}
@@ -335,7 +337,6 @@ \subsection{Spherical landscape}
 minimal_brightness = 0.0075
 polygonal_horizon_list = horizon_grossmugl.txt
 polygonal_angle_rotatez=0
-horizon_line_color =  .75,.45,.45
 minimal_altitude = -1
 \end{configfile}
 Where:
@@ -389,7 +390,6 @@ \subsection{Spherical landscape}
   rising/setting times)
 \item[\var{polygonal\_horizon\_list\_mode}] (optional) see \ref{sec:landscapes:Polygonal}
 \item[\var{polygonal\_angle\_rotatez}] (optional, default=0) see \ref{sec:landscapes:Polygonal}
-\item[\var{horizon\_line\_color}] see \ref{sec:landscapes:Polygonal}
 \item[\var{minimal\_brightness}]  see \ref{sec:landscapes:Polygonal}
 \item[\var{minimal\_altitude}] (optional, default=-2) \newFeature{0.14.0} Some sky
   elements, e.g.\ stars, are not drawn below this altitude for
@@ -592,7 +592,6 @@ \subsection{High resolution (``Old Style'')  landscape}
 \item[\var{polygonal\_horizon\_list}] (optional) see \ref{sec:landscapes:Spherical}
 \item[\var{polygonal\_horizon\_list\_mode}] (optional) see \ref{sec:landscapes:Polygonal}
 \item[\var{polygonal\_angle\_rotatez}] (optional, default=0) see \ref{sec:landscapes:Polygonal}
-\item[\var{horizon\_line\_color}] (optional) see \ref{sec:landscapes:Polygonal}
 \item[\var{minimal\_brightness}]  (optional) see \ref{sec:landscapes:Polygonal}
 \item[\var{minimal\_altitude}] (optional) see \ref{sec:landscapes:Polygonal}
 \end{description}
@@ -659,7 +658,6 @@ \subsection{Fisheye landscape}
 \item[\var{polygonal\_horizon\_list}] (optional) see \ref{sec:landscapes:Spherical}
 \item[\var{polygonal\_horizon\_list\_mode}] (optional) see \ref{sec:landscapes:Polygonal}
 \item[\var{polygonal\_angle\_rotatez}] (optional, default=0) see \ref{sec:landscapes:Polygonal}
-\item[\var{horizon\_line\_color}] (optional) see \ref{sec:landscapes:Polygonal}
 \item[\var{minimal\_brightness}] (optional)  see \ref{sec:landscapes:Polygonal}
 \item[\var{minimal\_altitude}] (optional) see \ref{sec:landscapes:Polygonal}
 \end{description}