Stellarium  0.17.0
Public Slots | Signals | Public Member Functions | Properties
AsterismMgr Class Reference

Display and manage the asterisms. More...

#include <AsterismMgr.hpp>

Public Slots

void setLinesColor (const Vec3f &color)
 Define line color. More...
 
Vec3f getLinesColor () const
 Get line color.
 
void setFlagLines (const bool displayed)
 Set whether asterism lines will be displayed.
 
bool getFlagLines (void) const
 Get whether asterism lines are displayed.
 
void setRayHelpersColor (const Vec3f &color)
 Define ray helper color. More...
 
Vec3f getRayHelpersColor () const
 Get ray helper color.
 
void setFlagRayHelpers (const bool displayed)
 Set whether ray helpers will be displayed.
 
bool getFlagRayHelpers (void) const
 Get whether ray helpers are displayed.
 
void setLabelsColor (const Vec3f &color)
 Set label color for names. More...
 
Vec3f getLabelsColor () const
 Get label color for names.
 
void setFlagLabels (const bool displayed)
 Set whether asterism names will be displayed.
 
bool getFlagLabels (void) const
 Set whether asterism names are displayed.
 
void setFontSize (const float newFontSize)
 Set the font size used for asterism names display.
 
float getFontSize () const
 Get the font size used for asterism names display.
 
void setAsterismLineThickness (const int thickness)
 Set the thickness of lines of the asterisms. More...
 
int getAsterismLineThickness () const
 Get the thickness of lines of the asterisms.
 
void setRayHelperThickness (const int thickness)
 Set the thickness of ray helpers of the asterisms. More...
 
int getRayHelperThickness () const
 Get the thickness of ray helper of the asterisms.
 

Signals

void fontSizeChanged (const float newSize) const
 
void linesColorChanged (const Vec3f &color) const
 
void linesDisplayedChanged (const bool displayed) const
 
void namesColorChanged (const Vec3f &color) const
 
void namesDisplayedChanged (const bool displayed) const
 
void asterismLineThicknessChanged (int thickness) const
 
void rayHelpersColorChanged (const Vec3f &color) const
 
void rayHelpersDisplayedChanged (const bool displayed) const
 
void rayHelperThicknessChanged (int thickness) const
 

Public Member Functions

 AsterismMgr (StarMgr *stars)
 Constructor.
 
virtual ~AsterismMgr ()
 Destructor.
 
virtual void init ()
 Initialize the AsterismMgr. More...
 
virtual void draw (StelCore *core)
 Draw constellation lines, art, names and boundaries.
 
virtual void update (double deltaTime)
 Updates time-varying state for each Constellation.
 
virtual double getCallOrder (StelModuleActionName actionName) const
 Return the value defining the order of call for the given action. More...
 
virtual QList< StelObjectPsearchAround (const Vec3d &v, double limitFov, const StelCore *core) const
 Search for StelObject in an area around a specifid point. More...
 
virtual StelObjectP searchByNameI18n (const QString &nameI18n) const
 Return the matching asterism object's pointer if exists or Q_NULLPTR. More...
 
virtual StelObjectP searchByName (const QString &name) const
 Return the matching asterism if exists or Q_NULLPTR. More...
 
virtual StelObjectP searchByID (const QString &id) const
 Return the StelObject with the given ID if exists or the empty StelObject if not found. 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 name. More...
 
virtual QStringList listAllObjects (bool inEnglish) const
 List all StelObjects. More...
 
virtual QString getName () const
 Gets a user-displayable name of the object category.
 
virtual QString getStelObjectType () const
 Returns the name that will be returned by StelObject::getType() for the objects this module manages.
 
- Public Member Functions inherited from StelObjectModule
virtual QStringList listAllObjectsByType (const QString &objType, bool inEnglish) const
 List all StelObjects by type. More...
 
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.
 
virtual QString getAuthorName () const
 Get the name of the module author.
 
virtual QString getAuthorEmail () const
 Get the email adress of the module author.
 
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...
 

Properties

float fontSize
 
Vec3f linesColor
 
Vec3f rayHelpersColor
 
Vec3f namesColor
 

loadNames():

Load asterism line shapes from data files.

Parameters
fileNameThe name of the asterism data file
Note
The abbreviation used in
Parameters
filenameis required for cross-identifying translatable names in
bool linesDisplayed
 
bool rayHelpersDisplayed
 
bool namesDisplayed
 
int asterismLineThickness
 
int rayHelperThickness
 

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 StelActionaddAction (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 StelActionaddAction (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

It can display asterisms lines and names. It also supports several different sky cultures.

Member Function Documentation

virtual double AsterismMgr::getCallOrder ( StelModuleActionName  actionName) const
virtual
Parameters
actionNamethe name of the action for which we want the call order
Returns
the value defining the order. The closer to 0 the earlier the module's action will be called

Reimplemented from StelModule.

virtual void AsterismMgr::init ( )
virtual

Reads from the asterism parser object and updates the loading bar as constellation objects are loaded for the required sky culture.

Implements StelModule.

virtual QStringList AsterismMgr::listAllObjects ( bool  inEnglish) const
virtual
Parameters
inEnglishlist names in English (true) or translated (false)
Returns
a list of matching object name by order of relevance, or an empty list if nothing matches

Implements StelObjectModule.

virtual QStringList AsterismMgr::listMatchingObjects ( const QString &  objPrefix,
int  maxNbItem = 5,
bool  useStartOfWords = false,
bool  inEnglish = false 
) const
virtual
Parameters
objPrefixthe case insensitive first letters of the searched object
maxNbItemthe maximum number of returned object names
useStartOfWordsthe autofill mode for returned objects names
Returns
a vector of matching object name by order of relevance, or an empty vector if nothing matches

Reimplemented from StelObjectModule.

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

The function searches in a disk of diameter limitFov centered on v. Only visible objects (i.e curretly displayed on screen) should be returned.

Parameters
vequatorial position at epoch J2000.
limitFovangular diameter of the searching zone in degree.
corethe core instance to use.
Returns
the list of all the displayed objects contained in the defined zone.

Implements StelObjectModule.

virtual StelObjectP AsterismMgr::searchByID ( const QString &  id) const
virtual
Parameters
namethe english object name

Implements StelObjectModule.

virtual StelObjectP AsterismMgr::searchByName ( const QString &  name) const
virtual
Parameters
nameThe case in-sensitive standard program name (three letter abbreviation)

Implements StelObjectModule.

virtual StelObjectP AsterismMgr::searchByNameI18n ( const QString &  nameI18n) const
virtual
Parameters
nameI18nThe case in-sensistive asterism name

Implements StelObjectModule.

void AsterismMgr::setAsterismLineThickness ( const int  thickness)
slot
Parameters
thicknessof line in pixels
void AsterismMgr::setLabelsColor ( const Vec3f color)
slot
Parameters
colorThe color of labels
// example of usage in scripts
void AsterismMgr::setLinesColor ( const Vec3f color)
slot
Parameters
colorThe color of lines
// example of usage in scripts
void AsterismMgr::setRayHelpersColor ( const Vec3f color)
slot
Parameters
colorThe color of ray helpers
// example of usage in scripts
void AsterismMgr::setRayHelperThickness ( const int  thickness)
slot
Parameters
thicknessof ray helper in pixels