Stellarium  0.16.1
List of all members | Public Slots | Signals | Public Member Functions | Static Public Member Functions | Properties | Friends
StelApp Class Reference

Singleton main Stellarium application class. More...

#include <StelApp.hpp>

+ Inheritance diagram for StelApp:
+ Collaboration diagram for StelApp:

Public Slots

void glWindowHasBeenResized (const QRectF &rect)
 Call this when the size of the GL window has changed. More...
 
void setVisionModeNight (bool)
 Set flag for activating night vision mode. More...
 
bool getVisionModeNight () const
 Get flag for activating night vision mode. More...
 
void setFlagShowDecimalDegrees (bool b)
 Set flag for showing decimal degree in various places. More...
 
bool getFlagShowDecimalDegrees () const
 Get flag for showing decimal degree in various places. More...
 
bool getFlagSouthAzimuthUsage () const
 Set flag for using calculation of azimuth from south towards west (instead north towards east) More...
 
void setFlagSouthAzimuthUsage (bool use)
 Get flag for using calculation of azimuth from south towards west (instead north towards east) More...
 
void setFlagUseFormattingOutput (bool b)
 Set flag for using of formatting output for coordinates. More...
 
bool getFlagUseFormattingOutput () const
 Get flag for using of formatting output for coordinates. More...
 
void setFlagUseCCSDesignation (bool b)
 Set flag for using designations for celestial coordinate systems. More...
 
bool getFlagUseCCSDesignation () const
 Get flag for using designations for celestial coordinate systems. More...
 
float getFps () const
 Get the current number of frame per second. More...
 
quint32 getDefaultFBO () const
 Returns the default FBO handle, to be used when StelModule instances want to release their own FBOs. More...
 
void ensureGLContextCurrent ()
 Makes sure the correct GL context used for main drawing is made current. More...
 
static double getTotalRunTime ()
 Return the time since when stellarium is running in second. More...
 
static double getAnimationTime ()
 Return the scaled time for animated objects. More...
 
void reportFileDownloadFinished (QNetworkReply *reply)
 Report that a download occured. More...
 
void quit ()
 do some cleanup and call QCoreApplication::exit(0) More...
 

Signals

void visionNightModeChanged (bool)
 
void colorSchemeChanged (const QString &)
 
void languageChanged ()
 
void progressBarAdded (const StelProgressController *)
 Called just after a progress bar is added. More...
 
void progressBarRemoved (const StelProgressController *)
 Called just before a progress bar is removed. More...
 
void aboutToQuit ()
 Called just before we exit Qt mainloop. More...
 

Public Member Functions

 StelApp (StelMainView *parent)
 Create and initialize the main Stellarium application. More...
 
virtual ~StelApp ()
 Deinitialize and destroy the main Stellarium application. More...
 
void init (QSettings *conf)
 Initialize core and all the modules. More...
 
void deinit ()
 Deinitialize core and all the modules. More...
 
void initPlugIns ()
 Load and initialize external modules (plugins) More...
 
void initScriptMgr ()
 Registers all loaded StelModules with the ScriptMgr, and queues starting of the startup script. More...
 
StelModuleMgrgetModuleMgr ()
 Get the module manager to use for accessing any module loaded in the application. More...
 
StelLocaleMgrgetLocaleMgr ()
 Get the locale manager to use for i18n & date/time localization. More...
 
StelSkyCultureMgrgetSkyCultureMgr ()
 Get the sky cultures manager. More...
 
StelTextureMgrgetTextureManager ()
 Get the texture manager to use for loading textures. More...
 
StelLocationMgrgetLocationMgr ()
 Get the Location manager to use for managing stored locations. More...
 
StelObjectMgrgetStelObjectMgr ()
 Get the StelObject manager to use for querying from all stellarium objects. More...
 
StelSkyLayerMgrgetSkyImageMgr ()
 
StelAudioMgrgetStelAudioMgr ()
 Get the audio manager. More...
 
StelActionMgrgetStelActionManager ()
 Get the actions manager to use for managing and editing actions. More...
 
StelPropertyMgrgetStelPropertyManager ()
 Return the property manager. More...
 
StelVideoMgrgetStelVideoMgr ()
 Get the video manager. More...
 
StelCoregetCore ()
 Get the core of the program. More...
 
QNetworkAccessManager * getNetworkAccessManager ()
 Get the common instance of QNetworkAccessManager used in stellarium. More...
 
void updateI18n ()
 Update translations, font for GUI and sky everywhere in the program. More...
 
QSettings * getSettings ()
 Return the main configuration options. More...
 
QString getCurrentStelStyle ()
 Return the currently used style. More...
 
void update (double deltaTime)
 Update all object according to the deltaTime in seconds. More...
 
void draw ()
 Draw all registered StelModule in the order defined by the order lists. More...
 
float getDevicePixelsPerPixel () const
 Get the ratio between real device pixel and "Device Independent Pixel". More...
 
void setDevicePixelsPerPixel (float dppp)
 
float getGlobalScalingRatio () const
 Get the scaling ratio to apply on all display elements, like GUI, text etc. More...
 
void setGlobalScalingRatio (float r)
 
int getBaseFontSize () const
 Get the size of font. More...
 
void setBaseFontSize (int s)
 
StelGuiBasegetGui () const
 Get the GUI instance implementing the abstract GUI interface. More...
 
void setGui (StelGuiBase *b)
 Tell the StelApp instance which GUI is currently being used. More...
 
StelMainScriptAPIProxygetMainScriptAPIProxy ()
 Get the script API proxy (for signal handling) More...
 
StelScriptMgrgetScriptMgr ()
 Get the script manager. More...
 
StelProgressControlleraddProgressBar ()
 Add a progression indicator to the GUI (if applicable). More...
 
void removeProgressBar (StelProgressController *p)
 
void setViewportEffect (const QString &effectName)
 Define the type of viewport effect to use. More...
 
QString getViewportEffect () const
 Get the type of viewport effect currently used. More...
 
void dumpModuleActionPriorities (StelModule::StelModuleActionName actionName)
 Dump diagnostics about action call priorities. More...
 

Static Public Member Functions

static QStringList getCommandlineArguments ()
 Returns all arguments passed on the command line, together with the contents of the STEL_OPTS environment variable. More...
 
static StelAppgetInstance ()
 Get the StelApp singleton instance. More...
 
static void initStatic ()
 
static void deinitStatic ()
 

Properties

bool nightMode
 

Friends

class StelAppGraphicsWidget
 
class StelRootItem
 

Detailed Description

Singleton main Stellarium application class.

This is the central class of Stellarium. Only one singleton instance of this class is created and can be accessed from anywhere else. This class is the access point to several "Manager" class which provide application-wide services for managment of font, textures, localization, sky culture, and in theory all other services used by the other part of the program.

The StelApp class is also the one managing the StelModule in a generic manner by calling their update, drawing and other methods when needed.

Author
Fabien Chereau

Definition at line 68 of file StelApp.hpp.

Constructor & Destructor Documentation

StelApp::StelApp ( StelMainView parent)

Create and initialize the main Stellarium application.

Parameters
parentthe QObject parent The configFile will be searched for in the search path by the StelFileMgr, it is therefore possible to specify either just a file name or path within the search path, or use a full path or even a relative path to an existing file
virtual StelApp::~StelApp ( )
virtual

Deinitialize and destroy the main Stellarium application.

Member Function Documentation

void StelApp::aboutToQuit ( )
signal

Called just before we exit Qt mainloop.

StelProgressController* StelApp::addProgressBar ( )

Add a progression indicator to the GUI (if applicable).

Returns
a controller which can be used to indicate the current status. The StelApp instance remains the owner of the controller.
void StelApp::deinit ( )

Deinitialize core and all the modules.

void StelApp::draw ( )

Draw all registered StelModule in the order defined by the order lists.

void StelApp::dumpModuleActionPriorities ( StelModule::StelModuleActionName  actionName)

Dump diagnostics about action call priorities.

void StelApp::ensureGLContextCurrent ( )
slot

Makes sure the correct GL context used for main drawing is made current.

This is always the case during init() and draw() calls, but if OpenGL access is required elsewhere, this MUST be called before using any GL functions.

static double StelApp::getAnimationTime ( )
staticslot

Return the scaled time for animated objects.

int StelApp::getBaseFontSize ( ) const
inline

Get the size of font.

Definition at line 182 of file StelApp.hpp.

static QStringList StelApp::getCommandlineArguments ( )
static

Returns all arguments passed on the command line, together with the contents of the STEL_OPTS environment variable.

You can use the CLIProcessor class to help parse it.

Returns
the arguments passed to Stellarium on the command line concatenated with the STEL_OPTS environment variable
StelCore* StelApp::getCore ( )
inline

Get the core of the program.

It is the one which provide the projection, navigation and tone converter.

Returns
the StelCore instance of the program

Definition at line 148 of file StelApp.hpp.

QString StelApp::getCurrentStelStyle ( )
inline

Return the currently used style.

Definition at line 160 of file StelApp.hpp.

quint32 StelApp::getDefaultFBO ( ) const
inlineslot

Returns the default FBO handle, to be used when StelModule instances want to release their own FBOs.

Note that this is usually not the same as QOpenGLContext::defaultFramebufferObject(), so use this call instead of the Qt version! Valid through a StelModule::draw() call, do not use elsewhere.

Definition at line 255 of file StelApp.hpp.

float StelApp::getDevicePixelsPerPixel ( ) const
inline

Get the ratio between real device pixel and "Device Independent Pixel".

Usually this value is 1, but for a mac with retina screen this will be value 2.

Definition at line 172 of file StelApp.hpp.

bool StelApp::getFlagShowDecimalDegrees ( ) const
inlineslot

Get flag for showing decimal degree in various places.

Definition at line 230 of file StelApp.hpp.

bool StelApp::getFlagSouthAzimuthUsage ( ) const
inlineslot

Set flag for using calculation of azimuth from south towards west (instead north towards east)

Definition at line 233 of file StelApp.hpp.

bool StelApp::getFlagUseCCSDesignation ( ) const
inlineslot

Get flag for using designations for celestial coordinate systems.

Definition at line 245 of file StelApp.hpp.

bool StelApp::getFlagUseFormattingOutput ( ) const
inlineslot

Get flag for using of formatting output for coordinates.

Definition at line 240 of file StelApp.hpp.

float StelApp::getFps ( ) const
inlineslot

Get the current number of frame per second.

Returns
the FPS averaged on the last second

Definition at line 249 of file StelApp.hpp.

float StelApp::getGlobalScalingRatio ( ) const
inline

Get the scaling ratio to apply on all display elements, like GUI, text etc.

When this ratio is 1, all pixel sizes used in Stellarium will look OK on a regular computer screen with 96 pixel per inch (reference for tuning sizes).

Definition at line 178 of file StelApp.hpp.

StelGuiBase* StelApp::getGui ( ) const
inline

Get the GUI instance implementing the abstract GUI interface.

Definition at line 186 of file StelApp.hpp.

static StelApp& StelApp::getInstance ( )
inlinestatic

Get the StelApp singleton instance.

Returns
the StelApp singleton instance

Definition at line 105 of file StelApp.hpp.

StelLocaleMgr& StelApp::getLocaleMgr ( )
inline

Get the locale manager to use for i18n & date/time localization.

Returns
the font manager to use for loading fonts.

Definition at line 113 of file StelApp.hpp.

StelLocationMgr& StelApp::getLocationMgr ( )
inline

Get the Location manager to use for managing stored locations.

Returns
the Location manager to use for managing stored locations

Definition at line 125 of file StelApp.hpp.

StelMainScriptAPIProxy* StelApp::getMainScriptAPIProxy ( )
inline

Get the script API proxy (for signal handling)

Definition at line 193 of file StelApp.hpp.

StelModuleMgr& StelApp::getModuleMgr ( )
inline

Get the module manager to use for accessing any module loaded in the application.

Returns
the module manager.

Definition at line 109 of file StelApp.hpp.

QNetworkAccessManager* StelApp::getNetworkAccessManager ( )
inline

Get the common instance of QNetworkAccessManager used in stellarium.

Definition at line 151 of file StelApp.hpp.

StelScriptMgr& StelApp::getScriptMgr ( )
inline

Get the script manager.

Definition at line 195 of file StelApp.hpp.

QSettings* StelApp::getSettings ( )
inline

Return the main configuration options.

Definition at line 157 of file StelApp.hpp.

StelSkyCultureMgr& StelApp::getSkyCultureMgr ( )
inline

Get the sky cultures manager.

Returns
the sky cultures manager

Definition at line 117 of file StelApp.hpp.

StelActionMgr* StelApp::getStelActionManager ( )
inline

Get the actions manager to use for managing and editing actions.

Definition at line 137 of file StelApp.hpp.

StelAudioMgr* StelApp::getStelAudioMgr ( )
inline

Get the audio manager.

Definition at line 134 of file StelApp.hpp.

StelObjectMgr& StelApp::getStelObjectMgr ( )
inline

Get the StelObject manager to use for querying from all stellarium objects.

Returns
the StelObject manager to use for querying from all stellarium objects .

Definition at line 129 of file StelApp.hpp.

StelPropertyMgr* StelApp::getStelPropertyManager ( )
inline

Return the property manager.

Definition at line 140 of file StelApp.hpp.

StelVideoMgr* StelApp::getStelVideoMgr ( )
inline

Get the video manager.

Definition at line 143 of file StelApp.hpp.

StelTextureMgr& StelApp::getTextureManager ( )
inline

Get the texture manager to use for loading textures.

Returns
the texture manager to use for loading textures.

Definition at line 121 of file StelApp.hpp.

static double StelApp::getTotalRunTime ( )
staticslot

Return the time since when stellarium is running in second.

QString StelApp::getViewportEffect ( ) const

Get the type of viewport effect currently used.

bool StelApp::getVisionModeNight ( ) const
inlineslot

Get flag for activating night vision mode.

Definition at line 225 of file StelApp.hpp.

void StelApp::glWindowHasBeenResized ( const QRectF &  rect)
slot

Call this when the size of the GL window has changed.

void StelApp::init ( QSettings *  conf)

Initialize core and all the modules.

void StelApp::initPlugIns ( )

Load and initialize external modules (plugins)

void StelApp::initScriptMgr ( )

Registers all loaded StelModules with the ScriptMgr, and queues starting of the startup script.

void StelApp::progressBarAdded ( const StelProgressController )
signal

Called just after a progress bar is added.

void StelApp::progressBarRemoved ( const StelProgressController )
signal

Called just before a progress bar is removed.

void StelApp::quit ( )
slot

do some cleanup and call QCoreApplication::exit(0)

void StelApp::reportFileDownloadFinished ( QNetworkReply *  reply)
slot

Report that a download occured.

This is used for statistics purposes. Connect this slot to QNetworkAccessManager::finished() slot to obtain statistics at the end of the program.

void StelApp::setFlagShowDecimalDegrees ( bool  b)
slot

Set flag for showing decimal degree in various places.

void StelApp::setFlagSouthAzimuthUsage ( bool  use)
inlineslot

Get flag for using calculation of azimuth from south towards west (instead north towards east)

Definition at line 235 of file StelApp.hpp.

void StelApp::setFlagUseCCSDesignation ( bool  b)
slot

Set flag for using designations for celestial coordinate systems.

void StelApp::setFlagUseFormattingOutput ( bool  b)
slot

Set flag for using of formatting output for coordinates.

void StelApp::setGui ( StelGuiBase b)
inline

Tell the StelApp instance which GUI is currently being used.

The caller is responsible for destroying the GUI.

Definition at line 189 of file StelApp.hpp.

void StelApp::setViewportEffect ( const QString &  effectName)

Define the type of viewport effect to use.

Parameters
effectNamemust be one of 'none', 'framebufferOnly', 'sphericMirrorDistorter'
void StelApp::setVisionModeNight ( bool  )
slot

Set flag for activating night vision mode.

void StelApp::update ( double  deltaTime)

Update all object according to the deltaTime in seconds.

void StelApp::updateI18n ( )

Update translations, font for GUI and sky everywhere in the program.


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