Supernovae Class Reference

Main class of the Historical Supernovae plugin. More...

#include <Supernovae.hpp>

Public Types
enum	UpdateState {   Updating, CompleteNoUpdates, CompleteUpdates, DownloadError,   OtherError }
	Used for keeping for track of the download/update status. More...

Public Slots
void	updateJSON (void)
	Download JSON from web recources described in the module section of the module.ini file and update the local JSON file. More...
void	displayMessage (const QString &message, const QString hexColor="#999999")
	Display a message. This is used for plugin-specific warnings and such. More...
void	messageTimeout (void)

Signals
void	updateStateChanged (Supernovae::UpdateState state)
void	jsonUpdateComplete (void)
	Emitted after a JSON update has run. More...

Public Member Functions
virtual void	init ()
virtual void	deinit ()
virtual void	update (double)
virtual void	draw (StelCore *core)
virtual void	drawPointer (StelCore *core, StelPainter &painter)
virtual double	getCallOrder (StelModuleActionName actionName) const
virtual QList< StelObjectP >	searchAround (const Vec3d &v, double limitFov, const StelCore *core) const
	Used to get a list of objects which are near to some position. More...
virtual StelObjectP	searchByNameI18n (const QString &nameI18n) const
	Return the matching satellite object's pointer if exists or NULL. More...
virtual StelObjectP	searchByName (const QString &name) const
	Return the matching satellite if exists or NULL. More...
virtual QStringList	listMatchingObjectsI18n (const QString &objPrefix, int maxNbItem=5, bool useStartOfWords=false) const
	Find and return the list of at most maxNbItem objects auto-completing the passed object I18n name. More...
virtual QStringList	listMatchingObjects (const QString &objPrefix, int maxNbItem=5, bool useStartOfWords=false) const
	Find and return the list of at most maxNbItem objects auto-completing the passed object English name. More...
virtual QStringList	listAllObjects (bool inEnglish) const
virtual QStringList	listAllObjectsByType (const QString &objType, bool inEnglish) const
virtual QString	getName () const
SupernovaP	getByID (const QString &id)
	get a supernova object by identifier More...
virtual bool	configureGui (bool show=true)
	Implement this to tell the main Stellarium GUI that there is a GUI element to configure this plugin. More...
void	restoreDefaults (void)
	Set up the plugin with default values. More...
void	readSettingsFromConfig (void)
	Read (or re-read) settings from the main config file. More...
void	saveSettingsToConfig (void)
	Save the settings to the main configuration file. More...
bool	getUpdatesEnabled (void)
	Get whether or not the plugin will try to update catalog data from the internet. More...
void	setUpdatesEnabled (bool b)
	Set whether or not the plugin will try to update catalog data from the internet. More...
QDateTime	getLastUpdate (void)
	Get the date and time the supernovae were updated. More...
int	getUpdateFrequencyDays (void)
	Get the update frequency in days. More...
void	setUpdateFrequencyDays (int days)
int	getSecondsToUpdate (void)
	Get the number of seconds till the next update. More...
UpdateState	getUpdateState (void)
	Get the current updateState. More...
QString	getSupernovaeList ()
	Get list of supernovae. More...
float	getLowerLimitBrightness ()
	Get lower limit of brightness for displayed supernovae. More...
int	getCountSupernovae (void)
	Get count of supernovae from catalog. More...

Detailed Description

Main class of the Historical Supernovae plugin.

Author

Alexander Wolf

Definition at line 68 of file Supernovae.hpp.

Member Enumeration Documentation

enum Supernovae::UpdateState

Used for keeping for track of the download/update status.

Enumerator
Updating	Update in progress.
CompleteNoUpdates	Update completed, there we no updates.
CompleteUpdates	Update completed, there were updates.
DownloadError	Error during download phase.
OtherError	Other error.

Definition at line 74 of file Supernovae.hpp.

Member Function Documentation

virtual bool Supernovae::configureGui ( bool  show = true )

virtual

Implement this to tell the main Stellarium GUI that there is a GUI element to configure this plugin.

void Supernovae::displayMessage ( const QString &  message, const QString  hexColor = "#999999"  )

slot

Display a message. This is used for plugin-specific warnings and such.

SupernovaP Supernovae::getByID

(

const QString &

id

)

get a supernova object by identifier

int Supernovae::getCountSupernovae ( void  )

inline

Get count of supernovae from catalog.

Definition at line 173 of file Supernovae.hpp.

QDateTime Supernovae::getLastUpdate ( void  )

inline

Get the date and time the supernovae were updated.

Definition at line 154 of file Supernovae.hpp.

float Supernovae::getLowerLimitBrightness

(

)

Get lower limit of brightness for displayed supernovae.

int Supernovae::getSecondsToUpdate

(

void

)

Get the number of seconds till the next update.

QString Supernovae::getSupernovaeList

(

)

Get list of supernovae.

int Supernovae::getUpdateFrequencyDays ( void  )

inline

Get the update frequency in days.

Definition at line 157 of file Supernovae.hpp.

bool Supernovae::getUpdatesEnabled ( void  )

inline

Get whether or not the plugin will try to update catalog data from the internet.

Returns

true if updates are set to be done, false otherwise

Definition at line 148 of file Supernovae.hpp.

UpdateState Supernovae::getUpdateState ( void  )

inline

Get the current updateState.

Definition at line 164 of file Supernovae.hpp.

void Supernovae::jsonUpdateComplete ( void  )

signal

Emitted after a JSON update has run.

virtual QStringList Supernovae::listMatchingObjects ( const QString &  objPrefix, int  maxNbItem = 5, bool  useStartOfWords = false  ) const

virtual

Find and return the list of at most maxNbItem objects auto-completing the passed object English name.

Parameters

objPrefix	the case insensitive first letters of the searched object
maxNbItem	the maximum number of returned object names
useStartOfWords	the autofill mode for returned objects names

Returns

a list of matching object name by order of relevance, or an empty list if nothing match

Implements StelObjectModule.

virtual QStringList Supernovae::listMatchingObjectsI18n ( const QString &  objPrefix, int  maxNbItem = 5, bool  useStartOfWords = false  ) const

virtual

Find and return the list of at most maxNbItem objects auto-completing the passed object I18n name.

Parameters

objPrefix	the case insensitive first letters of the searched object
maxNbItem	the maximum number of returned object names
useStartOfWords	the autofill mode for returned objects names

Returns

a list of matching object name by order of relevance, or an empty list if nothing match

Implements StelObjectModule.

void Supernovae::readSettingsFromConfig

(

void

)

Read (or re-read) settings from the main config file.

This will be called from init and also when restoring defaults (i.e. from the configuration dialog / restore defaults button).

void Supernovae::restoreDefaults

(

void

)

Set up the plugin with default values.

This means clearing out the Pulsars section in the main config.ini (if one already exists), and populating it with default values. It also creates the default supernovae.json file from the resource embedded in the plugin lib/dll file.

void Supernovae::saveSettingsToConfig

(

void

)

Save the settings to the main configuration file.

virtual QList<StelObjectP> Supernovae::searchAround ( const Vec3d &  v, double  limitFov, const StelCore *  core  ) const

virtual

Used to get a list of objects which are near to some position.

Parameters

v	a vector representing the position in th sky around which to search for nebulae.
limitFov	the field of view around the position v in which to search for satellites.
core	the StelCore to use for computations.

Returns

an list containing the satellites located inside the limitFov circle around position v.

Implements StelObjectModule.

virtual StelObjectP Supernovae::searchByName ( const QString &  name ) const

virtual

Return the matching satellite if exists or NULL.

Parameters

name	The case in-sensistive standard program name

Implements StelObjectModule.

virtual StelObjectP Supernovae::searchByNameI18n ( const QString &  nameI18n ) const

virtual

Return the matching satellite object's pointer if exists or NULL.

Parameters

nameI18n

The case in-sensistive satellite name

Implements StelObjectModule.

void Supernovae::setUpdatesEnabled ( bool  b )

inline

Set whether or not the plugin will try to update catalog data from the internet.

Parameters

b	if true, updates will be enabled, else they will be disabled

Definition at line 151 of file Supernovae.hpp.

void Supernovae::updateJSON ( void  )

slot

Download JSON from web recources described in the module section of the module.ini file and update the local JSON file.

void Supernovae::updateStateChanged ( Supernovae::UpdateState  state )

signal

Parameters

state

the new update state.

---

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

• Supernovae.hpp