Pointer Coordinates Plug-in

Data Structures
class	PointerCoordinatesWindow
	Main window of the Pointer Coordinates plug-in. More...
class	PointerCoordinates
	Main class of the Pointer Coordinates plugin. More...

Detailed Description

The Pointer Coordinates plugin shows the coordinates of the mouse pointer.

Configuration

The plug-ins' configuration data is stored in Stellarium's main configuration file (section [PointerCoordinates]).

---

Data Structure Documentation

class PointerCoordinatesWindow

Public Slots
void	retranslate ()
Public Slots inherited from StelDialog
virtual void	retranslate ()=0
	Retranslate the content of the dialog. More...
void	setVisible (bool)
	On the first call with "true" populates the window contents.
void	close ()
	Closes the window (the window widget is not deleted, just not visible).
void	handleMovedTo (QPoint newPos)
	Adds dialog location to config.ini; should be connected in createDialogContent()
virtual void	handleDialogSizeChanged (QSizeF size)
	Stores dialog sizes into config.ini; should be connected from the proxy. More...
QString	getDialogName ()
Protected Member Functions
void	createDialogContent ()
	Initialize the dialog widgets and connect the signals/slots.

Additional Inherited Members
Signals inherited from StelDialog
void	visibleChanged (bool)
Public Member Functions inherited from StelDialog
	StelDialog (QString dialogName="Default", QObject *parent=Q_NULLPTR)
bool	visible () const
	Returns true if the dialog contents have been constructed and are currently shown.
Static Protected Member Functions inherited from StelDialog
static void	connectCheckBox (QAbstractButton *checkBox, const QString &actionName)
	Helper function to connect a checkbox to the StelAction with the specified name.
static void	connectCheckBox (QAbstractButton *checkBox, StelAction *action)
	Helper function to connect a checkbox to the given StelAction.
static void	connectIntProperty (QSpinBox *spinBox, const QString &propName)
	Helper function to connect a QSpinBox to an integer StelProperty. More...
static void	connectIntProperty (QComboBox *comboBox, const QString &propName)
	Helper function to connect a QComboBox to an integer StelProperty. More...
static void	connectIntProperty (QSlider *slider, const QString &propName, int minValue, int maxValue)
	Helper function to connect a QSlider to an double or float StelProperty. More...
static void	connectDoubleProperty (QDoubleSpinBox *spinBox, const QString &propName)
	Helper function to connect a QDoubleSpinBox to an double or float StelProperty. More...
static void	connectDoubleProperty (QSlider *slider, const QString &propName, double minValue, double maxValue)
	Helper function to connect a QSlider to an double or float StelProperty. More...
static void	connectBoolProperty (QAbstractButton *checkBox, const QString &propName)
	Helper function to connect a checkbox to a bool StelProperty. More...
Protected Attributes inherited from StelDialog
QWidget *	dialog
	The main dialog.
class CustomProxy *	proxy
QString	dialogName
	The name should be set in derived classes' constructors and can be used to store and retrieve the panel locations.
Properties inherited from StelDialog
bool	visible

class PointerCoordinates

Author

Alexander Wolf

Public Types
enum	CoordinatesPlace {   TopCenter, TopRight, RightBottomCorner, NearMouseCursor,   Custom }
	Available places of string with coordinates. More...
enum	CoordinateSystem {   RaDecJ2000, RaDec, HourAngle, Ecliptic,   EclipticJ2000, AltAzi, Galactic, Supergalactic }
	Available coordinate systems.
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...
Public Slots
void	enableCoordinates (bool b)
	Enable plugin usage.
void	setFlagEnableAtStartup (bool b)
	Enable plugin usage at startup.
void	setFontSize (int size)
	Set font size for message.
void	setFlagShowCoordinatesButton (bool b)
	Display plugin button on toolbar.
void	setFlagShowCrossedLines (bool b)
void	setCurrentCoordinatesPlace (CoordinatesPlace place)
	Set the current place of the string with coordinates.
CoordinatesPlace	getCurrentCoordinatesPlace () const
	Get the current place of the string with coordinates.
QString	getCurrentCoordinatesPlaceKey (void) const
	Get the current place of the string with coordinates.
void	setCurrentCoordinatesPlaceKey (QString key)
	Set the current place of the string with coordinates from its key.
void	setCurrentCoordinateSystem (CoordinateSystem cs)
	Set the current coordinate system.
CoordinateSystem	getCurrentCoordinateSystem () const
	Get the current coordinate system.
QString	getCurrentCoordinateSystemKey (void) const
	Get the current coordinate system key.
void	setCurrentCoordinateSystemKey (QString key)
	Set the current coordinate system from its key.
void	setCustomCoordinatesPlace (int x, int y)
void	setFlagShowConstellation (bool b)
bool	getFlagShowConstellation (void) const
Signals
void	flagCoordinatesVisibilityChanged (bool b)
Public Member Functions
virtual void	init ()
	Initialize itself. More...
virtual void	deinit ()
	Called before the module will be delete, and before the openGL context is suppressed. More...
virtual void	update (double)
	Update the module with respect to the time. More...
virtual void	draw (StelCore *core)
	Execute all the drawing functions for this module. 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)
	Detect or show the configuration GUI elements for the module. More...
void	restoreDefaultConfiguration (void)
	Set up the plugin with default values. More...
void	loadConfiguration (void)
	Read (or re-read) settings from the main config file. More...
void	saveConfiguration (void)
	Save the settings to the main configuration file.
bool	isEnabled () const
	Is plugin enabled?
int	getFontSize (void)
	Get font size for messages.
bool	getFlagEnableAtStartup (void)
bool	getFlagShowCoordinatesButton (void)
bool	getFlagShowCrossedLines (void)
QPair< int, int >	getCoordinatesPlace (QString text)
QPair< int, int >	getCustomCoordinatesPlace ()
Public Member Functions inherited from StelModule
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...
Properties
bool	enabled

Additional Inherited Members
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...

Member Enumeration Documentation

enum PointerCoordinates::CoordinatesPlace

Enumerator
TopCenter	The top center of the screen.
TopRight	In center of the top right half of the screen.
RightBottomCorner	The right bottom corner of the screen.
NearMouseCursor	Near mouse cursor.
Custom	The custom position on the screen.

Member Function Documentation

virtual bool PointerCoordinates::configureGui ( bool  show )

virtual

This is to be used with plugins to display a configuration dialog from the plugin list window.

Parameters

show	if true, make the configuration GUI visible. If false, hide the config GUI if there is one.

Returns

true if the module has a configuration GUI, else false.

Reimplemented from StelModule.

virtual void PointerCoordinates::deinit ( )

virtual

Deinitialize all openGL texture in this method.

Reimplemented from StelModule.

virtual void PointerCoordinates::draw ( StelCore *  core )

virtual

Parameters

core	the core to use for the drawing

Reimplemented from StelModule.

virtual double PointerCoordinates::getCallOrder ( StelModuleActionName  actionName ) const

virtual

Parameters

actionName

the 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 PointerCoordinates::init ( )

virtual

If the initialization takes significant time, the progress should be displayed on the loading bar.

Implements StelModule.

void PointerCoordinates::loadConfiguration

(

void

)

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

void PointerCoordinates::restoreDefaultConfiguration

(

void

)

This means clearing out the PointerCoordinates section in the main config.ini (if one already exists), and populating it with default values.

virtual void PointerCoordinates::update ( double  deltaTime )

inlinevirtual

Parameters

deltaTime

the time increment in second since last call.

Implements StelModule.