Specialization of StelModule which manages a collection of StelObject. More...

#include <StelObjectModule.hpp>

Inheritance diagram for StelObjectModule:

Collaboration diagram for StelObjectModule:

Public Member Functions
virtual QList< StelObjectP >	searchAround (const Vec3d &v, double limitFov, const StelCore *core) const =0
	Search for StelObject in an area around a specifid point. More...

virtual StelObjectP	searchByNameI18n (const QString &nameI18n) const =0
	Find a StelObject by name. More...

virtual StelObjectP	searchByName (const QString &name) const =0
	Return the matching StelObject 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 passed object name. More...

virtual QStringList	listAllObjects (bool inEnglish) const =0
	List all StelObjects. More...

virtual QStringList	listAllObjectsByType (const QString &objType, bool inEnglish) const
	List all StelObjects by type. More...

virtual QString	getName () const =0

bool	matchObjectName (const QString &objName, const QString &objPrefix, bool useStartOfWords) const
	Auxiliary method of listMatchingObjects() More...

Public Member Functions inherited from StelModule
virtual void	init ()=0
	Initialize itself. More...

virtual void	deinit ()
	Called before the module will be delete, and before the openGL context is suppressed. More...

virtual void	draw (StelCore *core)
	Execute all the drawing functions for this module. More...

virtual void	update (double deltaTime)=0
	Update the module with respect to the time. 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 double	getCallOrder (StelModuleActionName actionName) const
	Return the value defining the order of call for the given action For example if stars.callOrder[ActionDraw] == 10 and constellation.callOrder[ActionDraw] == 11, the stars module will be drawn before the constellations. More...

virtual bool	configureGui (bool show=true)
	Detect or show the configuration GUI elements for the module. 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...

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

Specialization of StelModule which manages a collection of StelObject.

Instances deriving from the StelObjectModule class can be managed by the StelObjectMgr. The class defines extra abstract functions for searching and listing StelObjects.

Definition at line 36 of file StelObjectModule.hpp.

Member Function Documentation

virtual QStringList StelObjectModule::listAllObjects ( bool inEnglish ) const

pure virtual

List all StelObjects.

Parameters

inEnglish list 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

Implemented in NebulaMgr, SolarSystem, Satellites, StarMgr, ConstellationMgr, MeteorShowersMgr, Pulsars, Exoplanets, Quasars, Novae, Supernovae, TelescopeControl, MeteorShowers, and CustomObjectMgr.

virtual QStringList StelObjectModule::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 in NebulaMgr, SolarSystem, and StarMgr.

virtual QStringList StelObjectModule::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 passed object name.

Parameters

objPrefix	the first letters of the searched object
maxNbItem	the maximum number of returned object names
useStartOfWords	decide if start of word is searched
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 in NebulaMgr, Satellites, StarMgr, ConstellationMgr, MeteorShowersMgr, Pulsars, Exoplanets, Quasars, Novae, MeteorShowers, and CustomObjectMgr.

bool StelObjectModule::matchObjectName	(	const QString &	objName,
		const QString &	objPrefix,
		bool	useStartOfWords
	)		const

Auxiliary method of listMatchingObjects()

Parameters

objName	object name
objPrefix	the first letters of the searched object
useStartOfWords	decide if start of word is searched

Returns: true if it matches

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

pure virtual

Search for StelObject in an area around a specifid point.

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

v	equatorial position at epoch J2000.
limitFov	angular diameter of the searching zone in degree.
core	the core instance to use.

Returns: the list of all the displayed objects contained in the defined zone.

Implemented in SolarSystem, NebulaMgr, Satellites, StarMgr, MeteorShowersMgr, ConstellationMgr, Pulsars, Exoplanets, Quasars, Supernovae, Novae, TelescopeControl, MeteorShowers, and CustomObjectMgr.

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

pure virtual

Return the matching StelObject if exists or the empty StelObject if not found.

Parameters

name	the english object name

Implemented in SolarSystem, NebulaMgr, Satellites, StarMgr, ConstellationMgr, MeteorShowersMgr, Pulsars, Exoplanets, Quasars, Supernovae, Novae, TelescopeControl, MeteorShowers, and CustomObjectMgr.

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

pure virtual

Find a StelObject by name.

Parameters

nameI18n The translated name for the current sky locale.

Returns: The matching StelObject if exists or the empty StelObject if not found.

Implemented in SolarSystem, NebulaMgr, Satellites, StarMgr, ConstellationMgr, MeteorShowersMgr, Pulsars, Exoplanets, Quasars, Supernovae, Novae, TelescopeControl, MeteorShowers, and CustomObjectMgr.

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

/home/aw/devel/stellarium/0.15/src/core/StelObjectModule.hpp

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation