Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://astro.uni-altai.ru/~aw/stellarium/api/classLandscapeMgr.html
Дата изменения: Unknown Дата индексирования: Fri Feb 28 07:27:37 2014 Кодировка: |
Stellarium 0.12.3
|
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 > ¶m) |
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... | |
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.
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.
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. |
|
virtual |
Draw the landscape graphics, cardinal points and atmosphere.
Reimplemented from StelModule.
|
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.)
|
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.)
nameOrID | the name or the identifier of the landscape |
|
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.)
path | the path to the landscape's directory |
|
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.)
path | path to the file or directory |
|
slot |
Retrieve a list of the identifiers of all the available landscapes in the file search path sub-directories of the landscape area.
|
slot |
Retrieve a list of the names of all the available landscapes in the file search path sub-directories of the landscape area.
|
slot |
Get the light pollution following the Bortle Scale.
|
slot |
Get atmosphere fade duration in s.
|
virtual |
Get the order in which this module will draw it's objects relative to other modules.
Reimplemented from StelModule.
|
slot |
Get Cardinals Points color.
|
slot |
Return a pseudo HTML formated string with all informations on the current landscape.
|
inlineslot |
Get the current landscape ID.
Definition at line 126 of file LandscapeMgr.hpp.
|
slot |
Get the current landscape name.
|
inlineslot |
Get the default landscape ID.
Definition at line 139 of file LandscapeMgr.hpp.
|
slot |
Return a pseudo HTML formated string with information from description or ini file.
|
slot |
Get flag for displaying Atmosphere.
|
slot |
Get flag for displaying Cardinals Points.
|
slot |
Get flag for displaying Fog.
|
slot |
Get flag for displaying Landscape.
|
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.
|
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 |
Initialize the LandscapeManager class.
Operations performed:
Implements StelModule.
|
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:
The landscape identifier is either:
The landscape identifier must be unique.
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!) |
|
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.
|
slot |
This function reads a landscape's name from its configuration file.
landscapeID | an installed landscape's identifier (the folder name) |
|
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.)
landscapeID | an installed landscape's identifier (the folder name) |
|
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.
landscapeID | an installed landscape's identifier (the folder name) |
|
slot |
Set the light pollution following the Bortle Scale.
|
slot |
Set atmosphere fade duration in s.
|
slot |
Set Cardinals Points color.
|
slot |
Change the current landscape to the landscape with the ID specified.
id | the ID of the new landscape |
|
slot |
Change the current landscape to the landscape with the name specified.
name | the name of the new landscape, as found in the landscape:name key of the landscape.ini file. |
|
slot |
Change the default landscape to the landscape with the ID specified.
id | the ID of the landscape to use by default |
|
slot |
Set flag for displaying Atmosphere.
|
slot |
Set flag for displaying Cardinals Points.
|
slot |
Set flag for displaying Fog.
|
slot |
Set flag for displaying Landscape.
|
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.
|
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).
d | the rotation angle in degrees as an offset from the originally loaded value. |
|
virtual |
Update time-dependent state.
Includes:
Implements StelModule.