Stores the star catalogue data. More...

#include <StarMgr.hpp>

Inheritance diagram for StarMgr:

Collaboration diagram for StarMgr:

Public Slots
void	setLabelColor (const Vec3f &c)
	Set the color used to label bright stars. More...

Vec3f	getLabelColor (void) const
	Get the current color used to label bright stars. More...

void	setFlagStars (bool b)
	Set display flag for Stars. More...

bool	getFlagStars (void) const
	Get display flag for Stars. More...

void	setFlagLabels (bool b)
	Set display flag for Star names (labels). More...

bool	getFlagLabels (void) const
	Get display flag for Star names (labels). More...

void	setLabelsAmount (double a)
	Set the amount of star labels. More...

double	getLabelsAmount (void) const
	Get the amount of star labels. More...

void	setFontSize (float newFontSize)
	Define font size to use for star names display. More...

static void	setFlagSciNames (bool f)
	Show scientific or catalog names on stars without common names. More...

static bool	getFlagSciNames (void)

Signals
void	starLabelsDisplayedChanged (const bool displayed)

void	starsDisplayedChanged (const bool displayed)

void	labelsAmountChanged (float a)

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

virtual void	draw (StelCore *core)
	Draw the stars and the star selection indicator if necessary. More...

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

virtual double	getCallOrder (StelModuleActionName actionName) const
	Used to determine the order in which the various StelModules are drawn. More...

virtual QList< StelObjectP >	searchAround (const Vec3d &v, double limitFov, const StelCore *core) const
	Return a list containing the stars located inside the limFov circle around position v. More...

virtual StelObjectP	searchByNameI18n (const QString &nameI18n) const
	Return the matching Stars object's pointer if exists or NULL. More...

virtual StelObjectP	searchByName (const QString &name) const
	Return the matching star if exists or NULL. More...

virtual QStringList	listMatchingObjects (const QString &objPrefix, int maxNbItem=5, bool useStartOfWords=false, bool inEnglish=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
	List all StelObjects by type. More...

virtual QString	getName () const

StelObjectP	searchHP (int hip) const
	Search by Hipparcos catalogue number. More...

QVariantList	getCatalogsDescription () const

bool	checkAndLoadCatalog (const QVariantMap &m)
	Try to load the given catalog, even if it is marched as unchecked. More...

const QList< StelObjectP > &	getHipparcosStars () const
	Get the list of all Hipparcos stars. More...

Public Member Functions inherited from StelObjectModule
bool	matchObjectName (const QString &objName, const QString &objPrefix, bool useStartOfWords) const
	Auxiliary method of listMatchingObjects() More...

Public Member Functions inherited from StelModule
virtual void	deinit ()
	Called before the module will be delete, and before the openGL context is suppressed. 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	handlePinch (qreal scale, bool started)
	Handle pinch gesture events. More...

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

Static Public Member Functions
static QString	getCommonName (int hip)
	Get the (translated) common name for a star with a specified Hipparcos catalogue number. More...

static QString	getSciName (int hip)
	Get the (translated) scientific name for a star with a specified Hipparcos catalogue number. More...

static QString	getSciAdditionalName (int hip)
	Get the (translated) additional scientific name for a star with a specified Hipparcos catalogue number. More...

static QString	getGcvsName (int hip)
	Get the (translated) scientific name for a variable star with a specified Hipparcos catalogue number. More...

static QString	getWdsName (int hip)
	Get the (translated) scientific name for a double star with a specified Hipparcos catalogue number. More...

static QString	getCommonEnglishName (int hip)
	Get the (English) common name for a star with a specified Hipparcos catalogue number. More...

static QString	getAdditionalNames (int hip)
	Get the (translated) additional names for a star with a specified Hipparcos catalogue number. More...

static QString	getAdditionalEnglishNames (int hip)
	Get the English additional names for a star with a specified Hipparcos catalogue number. More...

static QString	getCrossIdentificationDesignations (int hip)
	Get the cross-identification designations for a star with a specified Hipparcos catalogue number. More...

static QString	getGcvsVariabilityType (int hip)
	Get the type of variability for a variable star with a specified Hipparcos catalogue number. More...

static float	getGcvsMaxMagnitude (int hip)
	Get the magnitude at maximum brightness for a variable star with a specified Hipparcos catalogue number. More...

static int	getGcvsMagnitudeFlag (int hip)
	Get the magnitude flag code for a variable star with a specified Hipparcos catalogue number. More...

static float	getGcvsMinMagnitude (int hip, bool firstMinimumFlag=true)
	Get the minimum magnitude or amplitude for a variable star with a specified Hipparcos catalogue number. More...

static QString	getGcvsPhotometricSystem (int hip)
	Get the photometric system for a variable star with a specified Hipparcos catalogue number. More...

static double	getGcvsEpoch (int hip)
	Get Epoch for maximum light for a variable star with a specified Hipparcos catalogue number. More...

static double	getGcvsPeriod (int hip)
	Get the period for a variable star with a specified Hipparcos catalogue number. More...

static int	getGcvsMM (int hip)
	Get the rising time or duration of eclipse for a variable star with a specified Hipparcos catalogue number. More...

static int	getWdsLastObservation (int hip)
	Get year of last satisfactory observation of double star with a Hipparcos catalogue number. More...

static int	getWdsLastPositionAngle (int hip)
	Get position angle at date of last satisfactory observation of double star with a Hipparcos catalogue number. More...

static float	getWdsLastSeparation (int hip)
	Get separation angle at date of last satisfactory observation of double star with a Hipparcos catalogue number. More...

static QString	convertToSpectralType (int index)

static QString	convertToComponentIds (int index)

Properties
bool	flagStarsDisplayed

bool	flagLabelsDisplayed

double	labelsAmount

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

Protected Member Functions inherited from StelModule
class StelAction *	addAction (const QString &id, const QString &groupId, const QString &text, QObject target, const char slot, const QString &shortcut="", const QString &altShortcut="")
	convenience methods to add an action (call to slot) to the StelActionMgr object. More...

class StelAction *	addAction (const QString &id, const QString &groupId, const QString &text, const char *slot, const QString &shortcut="", const QString &altShortcut="")
	convenience methods to add an action (call to own slot) to the StelActionMgr object. More...

Detailed Description

Stores the star catalogue data.

Used to render the stars themselves, as well as determine the color table and render the labels of those stars with names for a given SkyCulture.

The celestial sphere is split into zones, which correspond to the triangular faces of a geodesic sphere. The number of zones (faces) depends on the level of sub-division of this sphere. The lowest level, 0, is an icosahedron (20 faces), subsequent levels, L, of sub-division give the number of zones, n as:

n=20 x 4^L

Stellarium uses levels 0 to 7 in the existing star catalogues. Star Data Records contain the position of a star as an offset from the central position of the zone in which that star is located, thus it is necessary to determine the vector from the observer to the centre of a zone, and add the star's offsets to find the absolute position of the star on the celestial sphere.

This position for a star is expressed as a 3-dimensional vector which points from the observer (at the centre of the geodesic sphere) to the position of the star as observed on the celestial sphere.

Definition at line 88 of file StarMgr.hpp.

Member Function Documentation

bool StarMgr::checkAndLoadCatalog ( const QVariantMap & m )

Try to load the given catalog, even if it is marched as unchecked.

Mark it as checked if checksum is correct.

Returns: false in case of failure.

virtual void StarMgr::draw ( StelCore * core )

virtual

Draw the stars and the star selection indicator if necessary.

Reimplemented from StelModule.

static QString StarMgr::getAdditionalEnglishNames ( int hip )

static

Get the English additional names for a star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: additional names of star

static QString StarMgr::getAdditionalNames ( int hip )

static

Get the (translated) additional names for a star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: translated additional names of star

virtual double StarMgr::getCallOrder ( StelModuleActionName actionName ) const

virtual

Used to determine the order in which the various StelModules are drawn.

Reimplemented from StelModule.

static QString StarMgr::getCommonEnglishName ( int hip )

static

Get the (English) common name for a star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: common name of star (from skyculture file star_names.fab)

static QString StarMgr::getCommonName ( int hip )

static

Get the (translated) common name for a star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: translated common name of star

static QString StarMgr::getCrossIdentificationDesignations ( int hip )

static

Get the cross-identification designations for a star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: cross-identification data

bool StarMgr::getFlagLabels ( void ) const

inlineslot

Get display flag for Star names (labels).

Definition at line 175 of file StarMgr.hpp.

bool StarMgr::getFlagStars ( void ) const

inlineslot

Get display flag for Stars.

Definition at line 170 of file StarMgr.hpp.

static double StarMgr::getGcvsEpoch ( int hip )

static

Get Epoch for maximum light for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: Epoch for maximum light for a variable star

static int StarMgr::getGcvsMagnitudeFlag ( int hip )

static

Get the magnitude flag code for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: the magnitude flag code for a variable star

static float StarMgr::getGcvsMaxMagnitude ( int hip )

static

Get the magnitude at maximum brightness for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: the magnitude at maximum brightness for a variable star

static float StarMgr::getGcvsMinMagnitude	(	int	hip,
		bool	firstMinimumFlag = `true`
	)

static

Get the minimum magnitude or amplitude for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star
firstMinimumFlag

Returns: the minimum magnitude or amplitude for a variable star

static int StarMgr::getGcvsMM ( int hip )

static

Get the rising time or duration of eclipse for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: the rising time or duration of eclipse for variable star

static QString StarMgr::getGcvsName ( int hip )

static

Get the (translated) scientific name for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: translated scientific name of variable star

static double StarMgr::getGcvsPeriod ( int hip )

static

Get the period for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: the period of variable star

static QString StarMgr::getGcvsPhotometricSystem ( int hip )

static

Get the photometric system for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: the photometric system for a variable star

static QString StarMgr::getGcvsVariabilityType ( int hip )

static

Get the type of variability for a variable star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: type of variability

const QList<StelObjectP>& StarMgr::getHipparcosStars ( ) const

inline

Get the list of all Hipparcos stars.

Definition at line 333 of file StarMgr.hpp.

Vec3f StarMgr::getLabelColor ( void ) const

inlineslot

Get the current color used to label bright stars.

Definition at line 165 of file StarMgr.hpp.

double StarMgr::getLabelsAmount ( void ) const

inlineslot

Get the amount of star 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 183 of file StarMgr.hpp.

static QString StarMgr::getSciAdditionalName ( int hip )

static

Get the (translated) additional scientific name for a star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: translated additional scientific name of star

static QString StarMgr::getSciName ( int hip )

static

Get the (translated) scientific name for a star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: translated scientific name of star

static int StarMgr::getWdsLastObservation ( int hip )

static

Get year of last satisfactory observation of double star with a Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: year of last satisfactory observation

static int StarMgr::getWdsLastPositionAngle ( int hip )

static

Get position angle at date of last satisfactory observation of double star with a Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: position angle in degrees

static float StarMgr::getWdsLastSeparation ( int hip )

static

Get separation angle at date of last satisfactory observation of double star with a Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: separation in arcseconds

static QString StarMgr::getWdsName ( int hip )

static

Get the (translated) scientific name for a double star with a specified Hipparcos catalogue number.

Parameters

hip	The Hipparcos number of star

Returns: translated scientific name of double star

virtual void StarMgr::init ( )

virtual

Initialize the StarMgr.

Loads the star catalogue data into memory
Sets up the star color table
Loads the star texture
Loads the star font (for labels on named stars)
Loads the texture of the sar selection indicator
Lets various display flags from the ini parser object

Implements StelModule.

virtual QStringList StarMgr::listAllObjects ( bool inEnglish ) const

virtual

Note: Loading stars with the common names only.

Implements StelObjectModule.

virtual QStringList StarMgr::listAllObjectsByType	(	const QString &	objType,
		bool	inEnglish
	)		const

virtual

List all StelObjects by type.

Parameters

objType	object type
inEnglish	list translated names (false) or in English (true)

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

Reimplemented from StelObjectModule.

virtual QStringList StarMgr::listMatchingObjects	(	const QString &	objPrefix,
		int	maxNbItem = `5`,
		bool	useStartOfWords = `false`,
		bool	inEnglish = `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

Reimplemented from StelObjectModule.

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

virtual

Return a list containing the stars located inside the limFov circle around position v.

Implements StelObjectModule.

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

virtual

Return the matching star if exists or NULL.

Parameters

name	The case in-sensistive standard program planet name

Implements StelObjectModule.

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

virtual

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

Parameters

nameI18n The case in-sensistive star common name or HP catalog name (format can be HP1234 or HP 1234 or HIP 1234) or sci name

Implements StelObjectModule.

StelObjectP StarMgr::searchHP ( int hip ) const

Search by Hipparcos catalogue number.

Parameters

hip	the Hipparcos catalogue number of the star which is required.

Returns: the requested StelObjectP or an empty objecy if the requested one was not found.

void StarMgr::setFlagLabels ( bool b )

inlineslot

Set display flag for Star names (labels).

Definition at line 173 of file StarMgr.hpp.

static void StarMgr::setFlagSciNames ( bool f )

inlinestaticslot

Show scientific or catalog names on stars without common names.

Definition at line 189 of file StarMgr.hpp.

void StarMgr::setFlagStars ( bool b )

inlineslot

Set display flag for Stars.

Definition at line 168 of file StarMgr.hpp.

void StarMgr::setFontSize ( float newFontSize )

slot

Define font size to use for star names display.

void StarMgr::setLabelColor ( const Vec3f & c )

inlineslot

Set the color used to label bright stars.

Parameters

c	The color of the bright stars labels // example of usage in scripts StarMgr.setLabelColor(Vec3f(1.0,0.0,0.0));

Definition at line 163 of file StarMgr.hpp.

void StarMgr::setLabelsAmount ( double a )

inlineslot

Set the amount of star labels.

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

Parameters

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

Definition at line 180 of file StarMgr.hpp.

virtual void StarMgr::update ( double deltaTime )

inlinevirtual

Update any time-dependent features.

Includes fading in and out stars and labels when they are turned on and off.

Implements StelModule.

Definition at line 124 of file StarMgr.hpp.

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

/home/aw/devel/stellarium/0.15/src/core/modules/StarMgr.hpp

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Function Documentation