Manages all the rendering at the level of the observer's surroundings. More...

#include <LandscapeMgr.hpp>

Public Slots
QStringList	getAllLandscapeNames () const
	Retrieve a list of the names of all the available landscapes in the file search path sub-directories of the landscape area. More...

QStringList	getAllLandscapeIDs () const
	Retrieve a list of the identifiers of all the available landscapes in the file search path sub-directories of the landscape area. More...

QStringList	getUserLandscapeIDs () const
	Retrieve a list of the identifiers of all user-installed landscapes. More...

const QString &	getCurrentLandscapeID () const
	Get the current landscape ID. More...

bool	setCurrentLandscapeID (const QString &id)
	Change the current landscape to the landscape with the ID specified. More...

QString	getCurrentLandscapeName () const
	Get the current landscape name. More...

bool	setCurrentLandscapeName (const QString &name)
	Change the current landscape to the landscape with the name specified. More...

const QString &	getDefaultLandscapeID () const
	Get the default landscape ID. More...

bool	setDefaultLandscapeID (const QString &id)
	Change the default landscape to the landscape with the ID specified. More...

QString	getCurrentLandscapeHtmlDescription () const
	Return a pseudo HTML formated string with all informations on the current landscape. More...

QString	getDescription () const
	Return a pseudo HTML formated string with information from description or ini file. More...

bool	getFlagLandscape () const
	Get flag for displaying Landscape. More...

void	setFlagLandscape (const bool displayed)
	Set flag for displaying Landscape. More...

bool	getFlagFog () const
	Get flag for displaying Fog. More...

void	setFlagFog (const bool displayed)
	Set flag for displaying Fog. More...

bool	getFlagLandscapeSetsLocation () const
	Return the value of the flag determining if a change of landscape will update the observer location. More...

void	setFlagLandscapeSetsLocation (bool b)
	Set the value of the flag determining if a change of landscape will update the observer location. More...

bool	getFlagCardinalsPoints () const
	Get flag for displaying Cardinals Points. More...

void	setFlagCardinalsPoints (const bool displayed)
	Set flag for displaying Cardinals Points. More...

Vec3f	getColorCardinalPoints () const
	Get Cardinals Points color. More...

void	setColorCardinalPoints (const Vec3f &v)
	Set Cardinals Points color. More...

bool	getFlagAtmosphere () const
	Get flag for displaying Atmosphere. More...

void	setFlagAtmosphere (const bool displayed)
	Set flag for displaying Atmosphere. More...

float	getAtmosphereFadeDuration () const
	Get atmosphere fade duration in s. More...

void	setAtmosphereFadeDuration (float f)
	Set atmosphere fade duration in s. More...

void	setAtmosphereBortleLightPollution (int bIndex)
	Set the light pollution following the Bortle Scale. More...

int	getAtmosphereBortleLightPollution ()
	Get the light pollution following the Bortle Scale. More...

void	setZRotation (float d)
	Set the rotation of the landscape about the z-axis. More...

QString	installLandscapeFromArchive (QString pathToSourceArchive, bool display=false, bool forAllUsers=false)
	Install a landscape from a ZIP archive. More...

bool	removeLandscape (QString landscapeID)
	This function removes a landscape from the user data directory. More...

QString	loadLandscapeName (QString landscapeID)
	This function reads a landscape's name from its configuration file. More...

quint64	loadLandscapeSize (QString landscapeID)
	This function calculates and returns a landscape's disc size in bytes. More...

Signals
void	atmosphereDisplayedChanged (const bool displayed)

void	cardinalsPointsDisplayedChanged (const bool displayed)

void	fogDisplayedChanged (const bool displayed)

void	landscapeDisplayedChanged (const bool displayed)

void	landscapesChanged ()
	Emitted when a landscape has been installed or un-installed. More...

void	errorUnableToOpen (QString path)
	Emitted when installLandscapeFromArchive() can't read from, write to or create a file or a directory. More...

void	errorNotArchive ()
	Emitted when the file passed to installLandscapeFromArchive() is not a ZIP archive or does not contain a valid landscape. More...

void	errorNotUnique (QString nameOrID)
	Emitted when installLandscapeFromArchive() tries to install a landscape with the same name or identifier as an already installed one. More...

void	errorRemoveManually (QString path)
	Emitted when removeLandscape() is unable to remove all the files of a landscape. More...

Public Member Functions
virtual void	init ()
	Initialize the LandscapeManager class. More...

virtual void	draw (StelCore core, class StelRenderer renderer)
	Draw the landscape graphics, cardinal points and atmosphere. More...

virtual void	update (double deltaTime)
	Update time-dependent state. More...

virtual double	getCallOrder (StelModuleActionName actionName) const
	Get the order in which this module will draw it's objects relative to other modules. More...

float	getLuminance ()
	Return the global landscape luminance, for being used e.g for setting eye adaptation. More...

bool	loadLandscape (QMap< QString, QString > &param)
	Load a landscape based on a hash of parameters mirroring the landscape.ini file and make it the current landscape. More...

Landscape *	createFromFile (const QString &landscapeFile, const QString &landscapeId)
	Create a new landscape from the files which describe it. More...

Public Member Functions inherited from StelModule
virtual void	deinit ()
	Called before the module will be deleted, and before the renderer is destroyed. More...

virtual bool	drawPartial (StelCore core, class StelRenderer renderer)
	Iterate through the drawing sequence. More...

virtual QString	getModuleVersion () const
	Get the version of the module, default is stellarium main version. More...

virtual QString	getAuthorName () const
	Get the name of the module author. More...

virtual QString	getAuthorEmail () const
	Get the email adress of the module author. More...

virtual void	handleMouseClicks (class QMouseEvent *)
	Handle mouse clicks. More...

virtual void	handleMouseWheel (class QWheelEvent *)
	Handle mouse wheel. More...

virtual bool	handleMouseMoves (int x, int y, Qt::MouseButtons b)
	Handle mouse moves. More...

virtual void	handleKeys (class QKeyEvent *e)
	Handle key events. More...

virtual bool	configureGui (bool show=true)
	Detect or show the configuration GUI elements for the module. More...

Properties
bool	atmosphereDisplayed

bool	cardinalsPointsDisplayed

bool	fogDisplayed

bool	landscapeDisplayed

Additional Inherited Members
Public Types inherited from StelModule
enum	StelModuleSelectAction { AddToSelection, ReplaceSelection, RemoveFromSelection }
	Enum used when selecting objects to define whether to add to, replace, or remove from the existing selection list. More...

enum	StelModuleActionName { ActionDraw, ActionUpdate, ActionHandleMouseClicks, ActionHandleMouseMoves, ActionHandleKeys }
	Define the possible action for which an order is defined. More...

Detailed Description

Manages all the rendering at the level of the observer's surroundings.

This includes landscape textures, fog, atmosphere and cardinal points. I decided to put all these elements together in a single class because they are inherently linked, especially when we start moving the observer in altitude.

Definition at line 41 of file LandscapeMgr.hpp.

Member Function Documentation

Landscape* LandscapeMgr::createFromFile	(	const QString &	landscapeFile,
		const QString &	landscapeId
	)

Create a new landscape from the files which describe it.

Reads a landscape.ini file which is passed as the first parameter, determines the landscape type, and creates a new object for the landscape of the proper type. The load member is then called, passing both parameters.

Parameters

landscapeFile	This is the path to a landscape.ini file.
landscapeId	This is the landscape ID, which is also the name of the directory in which the files (textures and so on) for the landscape reside.

Returns: A pointer to the newly created landscape object.

virtual void LandscapeMgr::draw	(	StelCore *	core,
		class StelRenderer *	renderer
	)

virtual

Draw the landscape graphics, cardinal points and atmosphere.

Reimplemented from StelModule.

void LandscapeMgr::errorNotArchive ( )

signal

Emitted when the file passed to installLandscapeFromArchive() is not a ZIP archive or does not contain a valid landscape.

(A way of moving the need for translatable error messages to the GUI.)

void LandscapeMgr::errorNotUnique ( QString nameOrID )

signal

Emitted when installLandscapeFromArchive() tries to install a landscape with the same name or identifier as an already installed one.

(A way of moving the need for translatable error messages to the GUI.)

Parameters

nameOrID the name or the identifier of the landscape

void LandscapeMgr::errorRemoveManually ( QString path )

signal

Emitted when removeLandscape() is unable to remove all the files of a landscape.

(A way of moving the need for translatable error messages to the GUI.)

Parameters

path	the path to the landscape's directory

void LandscapeMgr::errorUnableToOpen ( QString path )

signal

Emitted when installLandscapeFromArchive() can't read from, write to or create a file or a directory.

(A way of moving the need for translatable error messages to the GUI.)

Parameters

path	path to the file or directory

QStringList LandscapeMgr::getAllLandscapeIDs ( ) const

slot

Retrieve a list of the identifiers of all the available landscapes in the file search path sub-directories of the landscape area.

Returns: the identifiers of the landscapes, which are the names of the directories containing the landscapes' files

QStringList LandscapeMgr::getAllLandscapeNames ( ) const

slot

Retrieve a list of the names of all the available landscapes in the file search path sub-directories of the landscape area.

Returns: the names of the landscapes, which are the values of the name parameter in the landscape.ini files

int LandscapeMgr::getAtmosphereBortleLightPollution ( )

slot

Get the light pollution following the Bortle Scale.

float LandscapeMgr::getAtmosphereFadeDuration ( ) const

slot

Get atmosphere fade duration in s.

virtual double LandscapeMgr::getCallOrder ( StelModuleActionName actionName ) const

virtual

Get the order in which this module will draw it's objects relative to other modules.

Reimplemented from StelModule.

Vec3f LandscapeMgr::getColorCardinalPoints ( ) const

slot

Get Cardinals Points color.

QString LandscapeMgr::getCurrentLandscapeHtmlDescription ( ) const

slot

Return a pseudo HTML formated string with all informations on the current landscape.

const QString& LandscapeMgr::getCurrentLandscapeID ( ) const

inlineslot

Get the current landscape ID.

Definition at line 126 of file LandscapeMgr.hpp.

QString LandscapeMgr::getCurrentLandscapeName ( ) const

slot

Get the current landscape name.

const QString& LandscapeMgr::getDefaultLandscapeID ( ) const

inlineslot

Get the default landscape ID.

Definition at line 139 of file LandscapeMgr.hpp.

QString LandscapeMgr::getDescription ( ) const

slot

Return a pseudo HTML formated string with information from description or ini file.

bool LandscapeMgr::getFlagAtmosphere ( ) const

slot

Get flag for displaying Atmosphere.

bool LandscapeMgr::getFlagCardinalsPoints ( ) const

slot

Get flag for displaying Cardinals Points.

bool LandscapeMgr::getFlagFog ( ) const

slot

Get flag for displaying Fog.

bool LandscapeMgr::getFlagLandscape ( ) const

slot

Get flag for displaying Landscape.

bool LandscapeMgr::getFlagLandscapeSetsLocation ( ) const

inlineslot

Return the value of the flag determining if a change of landscape will update the observer location.

Definition at line 162 of file LandscapeMgr.hpp.

float LandscapeMgr::getLuminance ( )

Return the global landscape luminance, for being used e.g for setting eye adaptation.

QStringList LandscapeMgr::getUserLandscapeIDs ( ) const

slot

Retrieve a list of the identifiers of all user-installed landscapes.

Effectively, this returns the results of getAllLandscapeIDs() without the landscapes specified in the #packagedLandscapeIDs list.

virtual void LandscapeMgr::init ( )

virtual

Initialize the LandscapeManager class.

Operations performed:

Load the default landscape as specified in the application configuration
Set up landscape-releated display flags from ini parser object

Implements StelModule.

QString LandscapeMgr::installLandscapeFromArchive	(	QString	pathToSourceArchive,
		bool	display = `false`,
		bool	forAllUsers = `false`
	)

slot

Install a landscape from a ZIP archive.

This function searches for a file named "landscape.ini" in the root directory of the archive. If it is not found there, the function searches inside the topmost sub-directories (if any), but no deeper. If a landscape configuration file is found:

if a "landscapes" directory does not exist in the user data directory, it is created;
inside it, a sub-directory is created with the landscape identifier for a name;
all files in the archive directory that contains the "landscape.ini" file are extracted to the new sub-directory of "landscapes";
all sub-directories of that archive directory will be skipped along with any other files or directories in the archive.

The landscape identifier is either:

the name of the folder in the archive that contains "landscape.ini",
or the first 65 (or less) characters of the archive name, if the "landscape.ini" file is in the nameless root directory of the archive.

The landscape identifier must be unique.

Parameters

pathToSourceArchive	path to the source archive file.
display	If true, the landscape will be set to be the current landscape after installation.
forAllUsers	If true, this function will try to install the landscape in a way that meakes it is available to all users of this computer. May require running Stellarium as an administrator (root) on some Windows or *nix systems. (NOT IMPLEMENTED!)

Returns: the installed landscape's identifier, or an empty string on failure.

void LandscapeMgr::landscapesChanged ( )

signal

Emitted when a landscape has been installed or un-installed.

For example, it is used to update the list of landscapes in the Sky and viewing options window (the ViewDialog class)

bool LandscapeMgr::loadLandscape ( QMap< QString, QString > & param )

Load a landscape based on a hash of parameters mirroring the landscape.ini file and make it the current landscape.

QString LandscapeMgr::loadLandscapeName ( QString landscapeID )

slot

This function reads a landscape's name from its configuration file.

Parameters

landscapeID an installed landscape's identifier (the folder name)

Returns: an empty string if there is no such landscape or some other error occurs

quint64 LandscapeMgr::loadLandscapeSize ( QString landscapeID )

slot

This function calculates and returns a landscape's disc size in bytes.

It adds up the sizes of all files in the landscape's folder. It assumes that there are no sub-directories. (There shouldn't be any anyway.)

Parameters

landscapeID an installed landscape's identifier (the folder name)

bool LandscapeMgr::removeLandscape ( QString landscapeID )

slot

This function removes a landscape from the user data directory.

It tries to recursively delete all files in the landscape directory and then remove it from the list of available landscapes. If the function encounters any file that can't be deleted it aborts the operation (previously deleted files are not restored). Landscapes that were packaged with Stellarium can't be removed, thanks to the #packagedLandscapeIDs list.

Parameters

landscapeID an installed landscape's identifier (the folder name)

void LandscapeMgr::setAtmosphereBortleLightPollution ( int bIndex )

slot

Set the light pollution following the Bortle Scale.

void LandscapeMgr::setAtmosphereFadeDuration ( float f )

slot

Set atmosphere fade duration in s.

void LandscapeMgr::setColorCardinalPoints ( const Vec3f & v )

slot

Set Cardinals Points color.

bool LandscapeMgr::setCurrentLandscapeID ( const QString & id )

slot

Change the current landscape to the landscape with the ID specified.

Parameters

id	the ID of the new landscape

Returns: false if the new landscape could not be set (e.g. no landscape of that ID was found).

bool LandscapeMgr::setCurrentLandscapeName ( const QString & name )

slot

Change the current landscape to the landscape with the name specified.

Parameters

name	the name of the new landscape, as found in the landscape:name key of the landscape.ini file.

bool LandscapeMgr::setDefaultLandscapeID ( const QString & id )

slot

Change the default landscape to the landscape with the ID specified.

Parameters

id	the ID of the landscape to use by default

Returns: false if the new landscape could not be set (e.g. no landscape of that ID was found). True on success.

void LandscapeMgr::setFlagAtmosphere ( const bool displayed )

slot

Set flag for displaying Atmosphere.

void LandscapeMgr::setFlagCardinalsPoints ( const bool displayed )

slot

Set flag for displaying Cardinals Points.

void LandscapeMgr::setFlagFog ( const bool displayed )

slot

Set flag for displaying Fog.

void LandscapeMgr::setFlagLandscape ( const bool displayed )

slot

Set flag for displaying Landscape.

void LandscapeMgr::setFlagLandscapeSetsLocation ( bool b )

inlineslot

Set the value of the flag determining if a change of landscape will update the observer location.

Definition at line 164 of file LandscapeMgr.hpp.

void LandscapeMgr::setZRotation ( float d )

slot

Set the rotation of the landscape about the z-axis.

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).

Parameters

d	the rotation angle in degrees as an offset from the originally loaded value.

virtual void LandscapeMgr::update ( double deltaTime )

virtual

Update time-dependent state.

Includes:

Landscape, atmosphere and cardinal point on/off fading.
Atmophere colour calulation based on location, position of sun and moon.
updates adaptation lumenescence lased on visible bright objects.

Implements StelModule.

The documentation for this class was generated from the following file:

core/modules/LandscapeMgr.hpp

Public Slots

Signals

Public Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Function Documentation