SolarSystem Class Reference

This StelObjectModule derivative is used to model SolarSystem bodies. More...

#include <SolarSystem.hpp>

Public Slots
void	setFlagPlanets (bool b)
	Set flag which determines if planets are drawn or hidden. More...
bool	getFlagPlanets () const
	Get the current value of the flag which determines if planet are drawn or hidden. More...
void	setFlagTrails (bool b)
	Set flag which determines if planet trails are drawn or hidden. More...
bool	getFlagTrails () const
	Get the current value of the flag which determines if planet trails are drawn or hidden. More...
void	setFlagHints (bool b)
	Set flag which determines if planet hints are drawn or hidden along labels. More...
bool	getFlagHints () const
	Get the current value of the flag which determines if planet hints are drawn or hidden along labels. More...
void	setFlagLabels (bool b)
	Set flag which determines if planet labels are drawn or hidden. More...
bool	getFlagLabels () const
	Get the current value of the flag which determines if planet labels are drawn or hidden. More...
void	setLabelsAmount (float a)
	Set the amount of planet labels. More...
float	getLabelsAmount (void) const
	Get the amount of planet labels. More...
void	setFlagOrbits (bool b)
	Set flag which determines if planet orbits are drawn or hidden. More...
bool	getFlagOrbits () const
	Get the current value of the flag which determines if planet orbits are drawn or hidden. More...
void	setFlagLightTravelTime (bool b)
	Set flag which determines if the light travel time calculation is used or not. More...
bool	getFlagLightTravelTime (void) const
	Get the current value of the flag which determines if light travel time calculation is used or not. More...
void	setFontSize (float newFontSize)
	Set planet names font size. More...
void	setLabelsColor (const Vec3f &c)
	Set the color used to draw planet labels. More...
const Vec3f &	getLabelsColor (void) const
	Get the current color used to draw planet labels. More...
void	setOrbitsColor (const Vec3f &c)
	Set the color used to draw planet orbit lines. More...
Vec3f	getOrbitsColor (void) const
	Get the current color used to draw planet orbit lines. More...
void	setTrailsColor (const Vec3f &c)
	Set the color used to draw planet trails lines. More...
Vec3f	getTrailsColor () const
	Get the current color used to draw planet trails lines. More...
void	setFlagMoonScale (bool b)
	Set flag which determines if Earth's moon is scaled or not. More...
bool	getFlagMoonScale (void) const
	Get the current value of the flag which determines if Earth's moon is scaled or not. More...
void	setMoonScale (float f)
	Set the display scaling factor for Earth's moon. More...
float	getMoonScale (void) const
	Get the display scaling factor for Earth's oon. More...
void	updateI18n ()
	Translate names. (public so that SolarSystemEditor can call it). More...
float	getPlanetVMagnitude (QString planetName, bool withExtinction=false) const
	Get the V magnitude for Solar system bodies from scripts. More...
double	getDistanceToPlanet (QString planetName) const
	Get distance to Solar system bodies from scripts. More...
double	getElongationForPlanet (QString planetName) const
	Get elongation for Solar system bodies from scripts. More...
double	getPhaseAngleForPlanet (QString planetName) const
	Get phase angle for Solar system bodies from scripts. More...
float	getPhaseForPlanet (QString planetName) const
	Get phase for Solar system bodies from scripts. More...

Public Member Functions
virtual void	init ()
	Initialize the SolarSystem. More...
virtual void	draw (StelCore *core, class StelRenderer *renderer)
	Draw SolarSystem objects (planets). More...
virtual void	update (double deltaTime)
	Update time-varying components. More...
virtual double	getCallOrder (StelModuleActionName actionName) const
	Used to determine what order to draw the various StelModules. More...
virtual QList< StelObjectP >	searchAround (const Vec3d &v, double limitFov, const StelCore *core) const
	Search for SolarSystem objects in some area around a point. More...
virtual StelObjectP	searchByNameI18n (const QString &nameI18n) const
	Search for a SolarSystem object based on the localised name. More...
virtual StelObjectP	searchByName (const QString &name) const
	Search for a SolarSystem object based on the English name. More...
virtual QStringList	listMatchingObjectsI18n (const QString &objPrefix, int maxNbItem=5) const
	Find objects by translated name prefix. More...
virtual QStringList	listMatchingObjects (const QString &objPrefix, int maxNbItem=5) const
	Find objects by translated name prefix. More...
virtual QStringList	listAllObjects (bool inEnglish) const
virtual QString	getName () const
PlanetP	searchByEnglishName (QString planetEnglishName) const
	Get a pointer to a Planet object. More...
PlanetP	getSun () const
	Get the Planet object pointer for the Sun. More...
PlanetP	getEarth () const
	Get the Planet object pointer for the Earth. More...
PlanetP	getMoon () const
	Get the Planet object pointer for Earth's moon. More...
bool	nearLunarEclipse ()
	Determine if a lunar eclipse is close at hand? More...
QStringList	getAllPlanetEnglishNames () const
	Get the list of all the planet english names. More...
QStringList	getAllPlanetLocalizedNames () const
	Get the list of all the planet localized names. More...
void	reloadPlanets ()
	Reload the planets. More...
double	getEclipseFactor (const StelCore *core) const
	Determines relative amount of sun visible from the observer's position. More...
QString	getPlanetHashString ()
	Get a hash of locale and ssystem.ini names for use with the TUI. More...
void	computePositions (double date, const Vec3d &observerPos=Vec3d(0.))
	Compute the position and transform matrix for every element of the solar system. More...
const QList< PlanetP > &	getAllPlanets () const
	Get the list of all the bodies of the solar system. More...

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

This StelObjectModule derivative is used to model SolarSystem bodies.

This includes the Major Planets, Minor Planets and Comets.

Definition at line 44 of file SolarSystem.hpp.

Member Function Documentation

void SolarSystem::computePositions	(	double	date,
		const Vec3d &	observerPos = Vec3d(0.)
	)

Compute the position and transform matrix for every element of the solar system.

Parameters

observerPos	Position of the observer in heliocentric ecliptic frame (Required for light travel time computation).
date	the date in JDay

Deprecated:

??? In the "deprecated" section, but used in SolarSystem::init()

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

virtual

Draw SolarSystem objects (planets).

Parameters

core	The StelCore object.
renderer	Renderer to use for drawing.

Returns

The maximum squared distance in pixels that any SolarSystem object has travelled since the last update.

Reimplemented from StelModule.

QStringList SolarSystem::getAllPlanetEnglishNames

(

)

const

Get the list of all the planet english names.

QStringList SolarSystem::getAllPlanetLocalizedNames

(

)

const

Get the list of all the planet localized names.

const QList<PlanetP>& SolarSystem::getAllPlanets ( ) const

inline

Get the list of all the bodies of the solar system.

Deprecated:

Used in LandscapeMgr::update(), but commented out.

Definition at line 263 of file SolarSystem.hpp.

virtual double SolarSystem::getCallOrder ( StelModuleActionName  actionName ) const

virtual

Used to determine what order to draw the various StelModules.

Reimplemented from StelModule.

double SolarSystem::getDistanceToPlanet ( QString  planetName ) const

slot

Get distance to Solar system bodies from scripts.

Parameters

planetName

the case in-sensistive English planet name.

Returns

a distance (in AU)

PlanetP SolarSystem::getEarth ( ) const

inline

Get the Planet object pointer for the Earth.

Definition at line 226 of file SolarSystem.hpp.

double SolarSystem::getEclipseFactor

(

const StelCore *

core

)

const

Determines relative amount of sun visible from the observer's position.

double SolarSystem::getElongationForPlanet ( QString  planetName ) const

slot

Get elongation for Solar system bodies from scripts.

Parameters

planetName

the case in-sensistive English planet name.

Returns

a elongation (in radians)

bool SolarSystem::getFlagHints ( ) const

slot

Get the current value of the flag which determines if planet hints are drawn or hidden along labels.

bool SolarSystem::getFlagLabels ( ) const

slot

Get the current value of the flag which determines if planet labels are drawn or hidden.

bool SolarSystem::getFlagLightTravelTime ( void  ) const

inlineslot

Get the current value of the flag which determines if light travel time calculation is used or not.

Definition at line 155 of file SolarSystem.hpp.

bool SolarSystem::getFlagMoonScale ( void  ) const

inlineslot

Get the current value of the flag which determines if Earth's moon is scaled or not.

Definition at line 178 of file SolarSystem.hpp.

bool SolarSystem::getFlagOrbits ( void  ) const

inlineslot

Get the current value of the flag which determines if planet orbits are drawn or hidden.

Definition at line 149 of file SolarSystem.hpp.

bool SolarSystem::getFlagPlanets ( ) const

slot

Get the current value of the flag which determines if planet are drawn or hidden.

bool SolarSystem::getFlagTrails ( ) const

slot

Get the current value of the flag which determines if planet trails are drawn or hidden.

float SolarSystem::getLabelsAmount ( void  ) const

inlineslot

Get the amount of planet labels.

The real amount is also proportional with FOV.

Returns

the amount between 0 and 10. 0 is no labels, 10 is maximum of labels

Definition at line 144 of file SolarSystem.hpp.

const Vec3f& SolarSystem::getLabelsColor ( void  ) const

slot

Get the current color used to draw planet labels.

PlanetP SolarSystem::getMoon ( ) const

inline

Get the Planet object pointer for Earth's moon.

Definition at line 229 of file SolarSystem.hpp.

float SolarSystem::getMoonScale ( void  ) const

inlineslot

Get the display scaling factor for Earth's oon.

Definition at line 183 of file SolarSystem.hpp.

Vec3f SolarSystem::getOrbitsColor ( void  ) const

slot

Get the current color used to draw planet orbit lines.

double SolarSystem::getPhaseAngleForPlanet ( QString  planetName ) const

slot

Get phase angle for Solar system bodies from scripts.

Parameters

planetName

the case in-sensistive English planet name.

Returns

a phase angle (in radians)

float SolarSystem::getPhaseForPlanet ( QString  planetName ) const

slot

Get phase for Solar system bodies from scripts.

Parameters

planetName

the case in-sensistive English planet name.

Returns

a phase

QString SolarSystem::getPlanetHashString

(

)

Get a hash of locale and ssystem.ini names for use with the TUI.

Returns

A newline delimited hash of localized:standard planet names. Planet translated name is PARENT : NAME

Deprecated:

???

float SolarSystem::getPlanetVMagnitude ( QString  planetName, bool  withExtinction = false  ) const

slot

Get the V magnitude for Solar system bodies from scripts.

Parameters

planetName	the case in-sensistive English planet name.
withExtinction	the flag for use extinction effect for magnitudes (default not use)

Returns

a magnitude

PlanetP SolarSystem::getSun ( ) const

inline

Get the Planet object pointer for the Sun.

Definition at line 223 of file SolarSystem.hpp.

Vec3f SolarSystem::getTrailsColor ( ) const

inlineslot

Get the current color used to draw planet trails lines.

Definition at line 173 of file SolarSystem.hpp.

virtual void SolarSystem::init ( )

virtual

Initialize the SolarSystem.

Includes:

• loading planetary body orbital and model data from data/ssystem.ini
• perform initial planet position calculation
• set display options from application settings

Implements StelModule.

virtual QStringList SolarSystem::listMatchingObjects ( const QString &  objPrefix, int  maxNbItem = 5  ) const

virtual

Find objects by translated name prefix.

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.

Returns

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

Implements StelObjectModule.

virtual QStringList SolarSystem::listMatchingObjectsI18n ( const QString &  objPrefix, int  maxNbItem = 5  ) const

virtual

Find objects by translated name prefix.

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.

Returns

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

Implements StelObjectModule.

bool SolarSystem::nearLunarEclipse

(

)

Determine if a lunar eclipse is close at hand?

void SolarSystem::reloadPlanets

(

)

Reload the planets.

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

virtual

Search for SolarSystem objects in some area around a point.

Parameters

v	A vector representing a point in the sky.
limitFov	The radius of the circle around the point v which defines the size of the area to search.
core	the core object

Returns

A STL vector of StelObjectP (pointers) containing all SolarSystem objects found in the specified area. This vector is not sorted by distance from v.

Implements StelObjectModule.

PlanetP SolarSystem::searchByEnglishName

(

QString

planetEnglishName

)

const

Get a pointer to a Planet object.

Parameters

planetEnglishName

the English name of the desired planet.

Returns

The matching planet pointer if exists or NULL.

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

virtual

Search for a SolarSystem object based on the English name.

Parameters

name	the case in-sensistive English planet name.

Returns

a StelObjectP for the object if found, else NULL.

Implements StelObjectModule.

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

virtual

Search for a SolarSystem object based on the localised name.

Parameters

nameI18n

the case in-sensistive translated planet name.

Returns

a StelObjectP for the object if found, else NULL.

Implements StelObjectModule.

void SolarSystem::setFlagHints ( bool  b )

slot

Set flag which determines if planet hints are drawn or hidden along labels.

void SolarSystem::setFlagLabels ( bool  b )

slot

Set flag which determines if planet labels are drawn or hidden.

void SolarSystem::setFlagLightTravelTime ( bool  b )

slot

Set flag which determines if the light travel time calculation is used or not.

void SolarSystem::setFlagMoonScale ( bool  b )

slot

Set flag which determines if Earth's moon is scaled or not.

void SolarSystem::setFlagOrbits ( bool  b )

slot

Set flag which determines if planet orbits are drawn or hidden.

void SolarSystem::setFlagPlanets ( bool  b )

slot

Set flag which determines if planets are drawn or hidden.

void SolarSystem::setFlagTrails ( bool  b )

slot

Set flag which determines if planet trails are drawn or hidden.

void SolarSystem::setFontSize ( float  newFontSize )

slot

Set planet names font size.

void SolarSystem::setLabelsAmount ( float  a )

inlineslot

Set the amount of planet labels.

The real amount is also proportional with FOV. The limit is set in function of the planets magnitude

Parameters

a	the amount between 0 and 10. 0 is no labels, 10 is maximum of labels

Definition at line 141 of file SolarSystem.hpp.

void SolarSystem::setLabelsColor ( const Vec3f &  c )

slot

Set the color used to draw planet labels.

void SolarSystem::setMoonScale ( float  f )

slot

Set the display scaling factor for Earth's moon.

void SolarSystem::setOrbitsColor ( const Vec3f &  c )

slot

Set the color used to draw planet orbit lines.

void SolarSystem::setTrailsColor ( const Vec3f &  c )

inlineslot

Set the color used to draw planet trails lines.

Definition at line 171 of file SolarSystem.hpp.

virtual void SolarSystem::update ( double  deltaTime )

virtual

Update time-varying components.

This includes planet motion trails.

Implements StelModule.

void SolarSystem::updateI18n ( )

slot

Translate names. (public so that SolarSystemEditor can call it).

---

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

• core/modules/SolarSystem.hpp