Store and manages the displaying of the Landscape. More...

#include <Landscape.hpp>

Data Structures
struct	LandscapeLabel

Public Types
enum	horizonListMode { invalid =-1 , azDeg_altDeg = 0 , azDeg_zdDeg = 1 , azRad_altRad = 2 , azRad_zdRad = 3 , azGrad_altGrad = 4 , azGrad_zdGrad = 5 }
	The list of azimuths (counted from True North towards East) and altitudes can come in various formats. We read the first two elements, which can be of formats: More...

Public Member Functions
	Landscape (float _radius=2.f)

virtual void	initGL ()

virtual void	load (const QSettings &landscapeIni, const QString &landscapeId)=0
	Load landscape. More...

unsigned int	getMemorySize () const
	Return approximate memory footprint in bytes (required for cache cost estimate in LandscapeMgr) The returned value is only approximate, content of QStrings and other small containers like the horizon polygon are not put in in detail. More...

virtual void	draw (StelCore *core, bool onlyPolygon)=0
	Draw the landscape. If onlyPolygon, only draw the landscape polygon, if one is defined. If no polygon is defined, the.

void	update (double deltaTime)

void	setBrightness (const double b, const double pollutionBrightness=0.0)
	Set the brightness of the landscape plus brightness of optional add-on night lightscape. More...

double	getBrightness () const
	Returns the current brightness level.

double	getLightscapeBrightness () const
	Returns the lightscape brightness.

double	getTargetLightscapeBrightness () const
	Returns the lightscape brightness modulated with the fader's target state (i.e. binary on/off)

double	getEffectiveLightscapeBrightness () const
	Gets the currently effective lightscape brightness (modulated by the fader)

void	setFlagShow (const bool b)
	Set whether landscape is displayed (does not concern fog)

bool	getFlagShow () const
	Get whether landscape is displayed (does not concern fog)

float	getEffectiveLandFadeValue () const
	Returns the currently effective land fade value.

void	setFlagShowFog (const bool b)
	Set whether fog is displayed.

bool	getFlagShowFog () const
	Get whether fog is displayed.

void	setFlagShowIllumination (const bool b)
	Set whether illumination is displayed.

bool	getFlagShowIllumination () const
	Get whether illumination is displayed.

void	setFlagShowLabels (const bool b)
	Set whether labels are displayed.

bool	getFlagShowLabels () const
	Get whether labels are displayed.

void	setLabelFontSize (const int size)
	Change font and fontsize for landscape labels.

int	getLabelFontSize ()
	Get fontsize for landscape labels.

Vec3f	getLabelColor () const
	Get color for landscape labels.

void	setLabelColor (const Vec3f &c)
	Set color for landscape labels.

QString	getName () const
	Get landscape name.

QString	getAuthorName () const
	Get landscape author name.

QString	getDescription () const
	Get landscape description.

QString	getId () const
	Get landscape id. This is the landscape directory name, used for cache handling.

const StelLocation &	getLocation () const
	Return the associated location (may be empty!)

bool	hasLocation () const
	Return if the location is valid (a valid location has a valid planetName!)

QVariant	getDefaultLightPollutionLuminance () const
	Return default light pollution luminance in cd/m², if present.

int	getDefaultFogSetting () const
	Return default fog setting (0/1) or -1 (no change)

double	getDefaultAtmosphericExtinction () const
	Return default atmosperic extinction [mag/airmass], or -1 (no change)

double	getDefaultAtmosphericTemperature () const
	Return configured atmospheric temperature [degrees Celsius], for refraction computation, or -1000 for "unknown/no change".

double	getDefaultAtmosphericPressure () const
	Return configured atmospheric pressure [mbar], for refraction computation. More...

double	getLandscapeMinimalBrightness () const
	Return minimal brightness for landscape returns -1 to signal "standard conditions" (use default value from config.ini)

void	setZRotation (float d)
	Set an additional z-axis (azimuth) rotation after landscape has been loaded. More...

bool	getIsFullyVisible () const
	Get whether the landscape is currently fully visible (i.e. opaque).

double	getSinMinAltitudeLimit () const
	Get the sine of the limiting altitude (can be used to short-cut drawing below horizon, like star fields). There is no set here, value is only from landscape.ini.

void	setTransparency (const double f)

virtual float	getOpacity (Vec3d azalt) const
	Find opacity in a certain direction. More...

void	loadLabels (const QString &landscapeId)
	Load descriptive labels from optional file gazetteer.LANG.utf8.

bool	hasLandscapePolygon () const

Protected Member Functions
void	setupCurrentVAO ()

void	bindVAO ()

void	releaseVAO ()

void	loadCommon (const QSettings &landscapeIni, const QString &landscapeId)
	Load attributes common to all landscapes. More...

void	drawLabels (StelCore core, StelPainter painter)
	Draw optional labels on the landscape.

void	createPolygonalHorizon (const QString &lineFileName, const float polyAngleRotateZ=0.0f, const QString &listMode="azDeg_altDeg")
	Create a StelSphericalPolygon that describes a measured horizon line. More...

void	drawHorizonLine (StelCore *core, StelPainter &painter)

Static Protected Member Functions
static const QString	getTexturePath (const QString &basename, const QString &landscapeId)
	search for a texture in landscape directory, else global textures directory More...

Protected Attributes
std::unique_ptr< QOpenGLVertexArrayObject >	vao

std::unique_ptr< QOpenGLBuffer >	vbo

StelProjectorP	prevProjector

std::unique_ptr< QOpenGLShaderProgram >	renderProgram

double	radius

QString	name

QString	author
	Read from landscape.ini:[landscape]name.

QString	description
	Read from landscape.ini:[landscape]author.

QString	id
	Read from landscape.ini:[landscape]description.

float	minBrightness
	Set during load. Required for consistent caching.

float	landscapeBrightness
	Read from landscape.ini:[landscape]minimal_brightness. Allows minimum visibility that cannot be underpowered.

float	lightScapeBrightness
	brightness [0..1] to draw the landscape. Computed by the LandscapeMgr.

bool	validLandscape
	can be used to draw nightscape texture (e.g. city light pollution), if available. Computed by the LandscapeMgr.

LinearFader	landFader
	was a landscape loaded properly?

LinearFader	fogFader
	Used to slowly fade in/out landscape painting.

LinearFader	illumFader
	Used to slowly fade in/out fog painting.

LinearFader	labelFader
	Used to slowly fade in/out illumination painting.

unsigned int	rows
	Used to slowly fade in/out landscape feature labels.

unsigned int	cols
	horizontal rows. May be given in landscape.ini:[landscape]tesselate_rows. More indicates higher accuracy, but is slower.

float	angleRotateZ
	vertical columns. May be given in landscape.ini:[landscape]tesselate_cols. More indicates higher accuracy, but is slower.

float	angleRotateZOffset
	[radians] if pano does not have its left border in the east, rotate in azimuth. Configured in landscape.ini[landscape]angle_rotatez (or decor_angle_rotatez for old_style landscapes)

double	sinMinAltitudeLimit
	[radians] This is a rotation changeable at runtime via setZRotation (called by LandscapeMgr::setZRotation). More...

double	landscapeTransparency
	Minimal altitude of landscape cover. Can be used to construct bounding caps, so that e.g. no stars are drawn below this altitude. Default -0.035, i.e. sin(-2 degrees).

StelLocation	location

QVariant	defaultLightPollutionLuminance
	OPTIONAL. If present, can be used to set location. More...

int	defaultFogSetting

double	defaultExtinctionCoefficient
	May be given in landscape.ini:[location]display_fog: -1(no change), 0(off), 1(on). Default: -1.

double	defaultTemperature
	May be given in landscape.ini:[location]atmospheric_extinction_coefficient. Default -1 (no change).

double	defaultPressure
	[Celsius] May be given in landscape.ini:[location]atmospheric_temperature. default: -1000.0 (no change)

SphericalRegionP	horizonPolygon
	[mbar] May be given in landscape.ini:[location]atmospheric_pressure. Default -1.0 (compute from [location]/altitude), use -2 to indicate "no change".

Vec3f	horizonPolygonLineColor
	Optional element describing the horizon line. More...

QList< LandscapeLabel >	landscapeLabels
	for all horizon types, the horizonPolygon line, if specified, will be drawn in this color More...

int	fontSize

Vec3f	labelColor
	Used for landscape labels (optionally indicating landscape features)

unsigned int	memorySize
	Color for the landscape labels. More...

bool	multisamplingEnabled_

bool	initialized = false

Detailed Description

Store and manages the displaying of the Landscape.

Don't use this class directly, use the LandscapeMgr. A landscape's most important element is a photo panorama, or at least a polygon that describes the true horizon visible from your observing location. Optional components include:

A fog texture that is displayed with the Fog [F] command (displayed only if atmosphere is on!).
A location. It is possible to auto-move to the location when loading.
Atmospheric conditions: temperature/pressure/extinction coefficients. These influence refraction and extinction.
Light pollution information (Bortle index)
A night texture that gets blended over the dimmed daylight panorama. (All landscapes except Polygonal.)
A polygonal horizon line (required for PolygonalLandscape). If present, defines a measured horizon line, which can be plotted or queried for rise/set predictions.
You can set a minimum brightness level to prevent too dark landscape. There is a global activation setting (config.ini[landscape]flag_minimal_brightness), a global value (config.ini[landscape]minimal_brightness), and, if config.ini[landscape]flag_landscape_sets_minimal_brightness=true, optional individual values given in landscape.ini[landscape]minimal_brightness are used.

We discern:

Parameters

LandscapeId	The directory name of the landscape.
name	The landscape name as specified in the LandscapeIni (may contain spaces, translatable, UTF8, ...)

Data Structure Documentation

◆ Landscape::LandscapeLabel

struct Landscape::LandscapeLabel

Data Fields
Vec3d	featurePoint
Vec3d	labelPoint
QString	name

Member Enumeration Documentation

◆ horizonListMode

enum Landscape::horizonListMode

The list of azimuths (counted from True North towards East) and altitudes can come in various formats. We read the first two elements, which can be of formats:

Enumerator
azDeg_zdDeg	azimuth[degrees] altitude[degrees]
azRad_altRad	azimuth[degrees] zenithDistance[degrees]
azRad_zdRad	azimuth[radians] altitude[radians]
azGrad_altGrad	azimuth[radians] zenithDistance[radians]
azGrad_zdGrad	azimuth[new_degrees] altitude[new_degrees] (may be found on theodolites)

Member Function Documentation

◆ createPolygonalHorizon()

void Landscape::createPolygonalHorizon	(	const QString &	lineFileName,
		const float	polyAngleRotateZ = `0.0f`,
		const QString &	listMode = `"azDeg_altDeg"`
	)

protected

Create a StelSphericalPolygon that describes a measured horizon line.

If present, this can be used to draw a horizon line or simplify the functionality to discern if an object is below the horizon.

Parameters

lineFileName	A text file with lines that are either empty or comment lines starting with # or azimuth altitude [degrees]
polyAngleRotateZ	possibility to set some final calibration offset like meridian convergence correction.
listMode	keys which indicate angular units for the angles

◆ getDefaultAtmosphericPressure()

double Landscape::getDefaultAtmosphericPressure ( ) const

inline

Return configured atmospheric pressure [mbar], for refraction computation.

returns -1 to signal "standard conditions" [compute from altitude], or -2 for "unknown/invalid/no change"

◆ getMemorySize()

unsigned int Landscape::getMemorySize ( ) const

inline

Return approximate memory footprint in bytes (required for cache cost estimate in LandscapeMgr) The returned value is only approximate, content of QStrings and other small containers like the horizon polygon are not put in in detail.

However, texture image sizes must be computed and added in subclasses. The value returned is a sum of RAM and texture memory requirements.

◆ getOpacity()

virtual float Landscape::getOpacity ( Vec3d azalt ) const

inlinevirtual

Find opacity in a certain direction.

(New in V0.13 series) can be used to find sunrise or visibility questions on the real-world landscape horizon. Default implementation indicates the horizon equals math horizon.

Reimplemented in LandscapeSpherical, LandscapeFisheye, LandscapePolygonal, and LandscapeOldStyle.

◆ getTexturePath()

static const QString Landscape::getTexturePath	(	const QString &	basename,
		const QString &	landscapeId
	)

staticprotected

search for a texture in landscape directory, else global textures directory

Parameters

basename	The name of a texture file, e.g. "fog.png"
landscapeId	The landscape ID (directory name) to which the texture belongs

Note: returns an empty string if file not found.

◆ load()

virtual void Landscape::load	(	const QSettings &	landscapeIni,
		const QString &	landscapeId
	)

pure virtual

Load landscape.

Parameters

landscapeIni	A reference to an existing QSettings object which describes the landscape
landscapeId	The name of the directory for the landscape files (e.g. "ocean")

Implemented in LandscapeSpherical, LandscapeFisheye, LandscapePolygonal, and LandscapeOldStyle.

◆ loadCommon()

void Landscape::loadCommon	(	const QSettings &	landscapeIni,
		const QString &	landscapeId
	)

protected

Load attributes common to all landscapes.

Parameters

landscapeIni	A reference to an existing QSettings object which describes the landscape
landscapeId	The name of the directory for the landscape files (e.g. "ocean")

◆ setBrightness()

void Landscape::setBrightness	(	const double	b,
		const double	pollutionBrightness = `0.0`
	)

inline

Set the brightness of the landscape plus brightness of optional add-on night lightscape.

This is called in each draw().

◆ setZRotation()

void Landscape::setZRotation ( float d )

inline

Set an additional z-axis (azimuth) rotation after landscape has been loaded.

This is intended for special uses such as when the landscape consists of a vehicle which might change orientation over time (e.g. a ship). It is called e.g. by the LandscapeMgr. Contrary to that, the purpose of the azimuth rotation (landscape/[decor_]angle_rotatez) in landscape.ini is to orient the pano.

Parameters

d	the rotation angle in degrees.

Field Documentation

◆ defaultLightPollutionLuminance

QVariant Landscape::defaultLightPollutionLuminance

protected

OPTIONAL. If present, can be used to set location.

May be given in landscape.ini:light_pollution_luminance in cd/m². Default: no change. Another way (deprecated) is to use landscape.ini:[location]light_pollution to set Bortle scale index. Default: -1 (no change).

◆ horizonPolygonLineColor

Vec3f Landscape::horizonPolygonLineColor

protected

Optional element describing the horizon line.

Data shall be read from the file given as landscape.ini[landscape]polygonal_horizon_list For LandscapePolygonal, this is the only horizon data item.

◆ landscapeLabels

QList<LandscapeLabel> Landscape::landscapeLabels

protected

for all horizon types, the horizonPolygon line, if specified, will be drawn in this color

specified in landscape.ini[landscape]horizon_line_color. Negative red (default) indicated "don't draw".

◆ memorySize

unsigned int Landscape::memorySize

protected

Color for the landscape labels.

holds an approximate value of memory consumption (for cache cost estimate)

◆ sinMinAltitudeLimit

double Landscape::sinMinAltitudeLimit

protected

[radians] This is a rotation changeable at runtime via setZRotation (called by LandscapeMgr::setZRotation).

Not in landscape.ini: Used in special cases where the horizon may rotate, e.g. on a ship.

Data Structures

Public Types

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Data Structure Documentation

◆ Landscape::LandscapeLabel

Member Enumeration Documentation

◆ horizonListMode

Member Function Documentation

◆ createPolygonalHorizon()

◆ getDefaultAtmosphericPressure()

◆ getMemorySize()

◆ getOpacity()

◆ getTexturePath()

◆ load()

◆ loadCommon()

◆ setBrightness()

◆ setZRotation()

Field Documentation

◆ defaultLightPollutionLuminance

◆ horizonPolygonLineColor

◆ landscapeLabels

◆ memorySize

◆ sinMinAltitudeLimit