Stellarium 0.11.2
Home · All Namespaces · All Classes · Functions · Coding Style · Scripting · Plugins · File Structure
Classes | Public Slots | Public Member Functions
StelSkyLayerMgr Class Reference

Manage the sky background images, including DSS and deep sky objects images. More...

#include <StelSkyLayerMgr.hpp>

List of all members.

Classes

class  SkyLayerElem
 Store the informations needed for a graphical element layer.

Public Slots

void setFlagShow (bool b)
bool getFlagShow () const
bool loadSkyImage (const QString &id, const QString &filename, double ra0, double dec0, double ra1, double dec1, double ra2, double dec2, double ra3, double dec3, double minRes, double maxBright, bool visible)
void showLayer (const QString &id, bool b)
bool getShowLayer (const QString &id) const
QString insertSkyImage (const QString &uri, const QString &keyHint=QString(), bool show=true)
void removeSkyLayer (const QString &key)
QStringList getAllKeys () const

Public Member Functions

virtual void init ()
virtual void draw (StelCore *core)
virtual void update (double)
virtual double getCallOrder (StelModuleActionName actionName) const
QString insertSkyLayer (StelSkyLayerP l, const QString &keyHint=QString(), bool show=true)
void removeSkyLayer (StelSkyLayerP l)
QMap< QString, StelSkyLayerPgetAllSkyLayers () const
StelSkyLayerP getSkyLayer (const QString &key) const

Detailed Description

Manage the sky background images, including DSS and deep sky objects images.


Member Function Documentation

bool StelSkyLayerMgr::getShowLayer ( const QString &  id) const [slot]

Get the current shown status of a specified image.

Parameters:
idthe ID of the image whose status is desired.
Returns:
the current shown status of the specified image:
  • true means the specified image is currently shown.
  • false means the specified image is currently not shown.
QString StelSkyLayerMgr::insertSkyImage ( const QString &  uri,
const QString &  keyHint = QString(),
bool  show = true 
) [slot]

Add a new SkyImage from its URI (URL or local file name).

The image is owned by the manager and will be destroyed at the end of the program or when removeSkyImage is called with the same URI

Parameters:
urithe local file or the URL where the JSON image description is located.
keyHinta hint on which key to use for later referencing the image.
showdefined whether the image should be shown by default.
Returns:
the reference key to use when accessing this image later on.
QString StelSkyLayerMgr::insertSkyLayer ( StelSkyLayerP  l,
const QString &  keyHint = QString(),
bool  show = true 
)

Add a new layer.

Parameters:
lthe layer to insert.
keyHinta hint on which key to use for later referencing the image.
showdefined whether the layer should be shown by default
Returns:
the reference key to use when accessing this layer later on.
bool StelSkyLayerMgr::loadSkyImage ( const QString &  id,
const QString &  filename,
double  ra0,
double  dec0,
double  ra1,
double  dec1,
double  ra2,
double  dec2,
double  ra3,
double  dec3,
double  minRes,
double  maxBright,
bool  visible 
) [slot]

Load an image from a file.

This should not be called directly from scripts because it is not thread safe. Instead use the simiarly named function in the core scripting object.

Parameters:
ida string identifier for the image
filenamethe name of the image file to load. Will be searched for using StelFileMgr, so partial names are fine.
ra0right ascention of corner 0 in degrees
dec0declenation of corner 0 in degrees
ra1right ascention of corner 1 in degrees
dec1declenation of corner 1 in degrees
ra2right ascention of corner 2 in degrees
dec2declenation of corner 2 in degrees
ra3right ascention of corner 3 in degrees
dec3declenation of corner 3 in degrees
minResthe minimum resolution setting for the image
maxBrightthe maximum brightness setting for the image
visibleinitial visibility setting
void StelSkyLayerMgr::removeSkyLayer ( const QString &  key) [slot]

Remove a sky layer from the list.

Note: this is not thread safe, and so should not be used directly from scripts - use the similarly named function in the core scripting API object to delete SkyLayers.

Parameters:
keythe reference key (id) generated by insertSkyImage.
void StelSkyLayerMgr::showLayer ( const QString &  id,
bool  b 
) [slot]

Decide to show or not to show a layer by it's ID.

Parameters:
idthe id of the layer whose status is to be changed.
bthe new shown value:
  • true means the specified image will be shown.
  • false means the specified image will not be shown.