Stellarium is prepared to manage more than one set of nebulae (Deep-Sky Objects). More...

#include <NebulaMgr.hpp>

Public Slots
void	setCatalogFilters (int cflags)

int	getCatalogFilters () const

void	selectAllCatalogs ()
	Activate all catalogs.

void	selectStandardCatalogs ()
	Activate a useful selection of catalogs: M, NGC, IC.

void	selectNoneCatalogs ()
	Disable all catalogs.

void	loadCatalogFilters ()
	retrieve configured catalogs from config.ini.

void	storeCatalogFilters ()
	store configured catalogs into config.ini.

void	setTypeFilters (int tflags)

int	getTypeFilters () const

void	setCirclesColor (const Vec3f &c)
	Set the default color used to draw the nebula symbols (default circles, etc). More...

const Vec3f	getCirclesColor (void) const
	Get current value of the nebula circle color.

void	setRegionsColor (const Vec3f &c)
	Set the default color used to draw the region symbols (default dashed shape). More...

const Vec3f	getRegionsColor (void) const
	Get current value of the region color.

void	setGalaxyColor (const Vec3f &c)
	Set the color used to draw the galaxy symbols (ellipses). More...

const Vec3f	getGalaxyColor (void) const
	Get current value of the galaxy symbol color.

void	setActiveGalaxyColor (const Vec3f &c)
	Set the color used to draw the active galaxy symbols (ellipses). More...

const Vec3f	getActiveGalaxyColor (void) const
	Get current value of the active galaxy symbol color.

void	setInteractingGalaxyColor (const Vec3f &c)
	Set the color used to draw the interacting galaxy symbols (ellipses). More...

const Vec3f	getInteractingGalaxyColor (void) const
	Get current value of the interacting galaxy symbol color.

void	setRadioGalaxyColor (const Vec3f &c)
	Set the color used to draw the radio galaxy symbols (ellipses). More...

const Vec3f	getRadioGalaxyColor (void) const
	Get current value of the radio galaxy symbol color.

void	setQuasarColor (const Vec3f &c)
	Set the color used to draw the quasars symbols (ellipses). More...

const Vec3f	getQuasarColor (void) const
	Get current value of the quasar symbol color.

void	setNebulaColor (const Vec3f &c)
	Set the color used to draw the bright nebula symbols (emission nebula boxes, planetary nebulae circles). More...

const Vec3f	getNebulaColor (void) const
	Get current value of the nebula circle color.

void	setPlanetaryNebulaColor (const Vec3f &c)
	Set the color used to draw the planetary nebulae symbols. More...

const Vec3f	getPlanetaryNebulaColor (void) const
	Get current value of the planetary nebula circle color.

void	setReflectionNebulaColor (const Vec3f &c)
	Set the color used to draw the reflection nebulae symbols. More...

const Vec3f	getReflectionNebulaColor (void) const
	Get current value of the reflection nebula circle color.

void	setBipolarNebulaColor (const Vec3f &c)
	Set the color used to draw the bipolar nebulae symbols. More...

const Vec3f	getBipolarNebulaColor (void) const
	Get current value of the bipolar nebula circle color.

void	setEmissionNebulaColor (const Vec3f &c)
	Set the color used to draw the emission nebulae symbols. More...

const Vec3f	getEmissionNebulaColor (void) const
	Get current value of the emission nebula circle color.

void	setHydrogenRegionColor (const Vec3f &c)
	Set the color used to draw the ionized hydrogen region symbols. More...

const Vec3f	getHydrogenRegionColor (void) const
	Get current value of the hydrogen region symbol color.

void	setSupernovaRemnantColor (const Vec3f &c)
	Set the color used to draw the supernova remnant symbols. More...

const Vec3f	getSupernovaRemnantColor (void) const
	Get current value of the supernova remnant symbol color.

void	setSupernovaCandidateColor (const Vec3f &c)
	Set the color used to draw the supernova candidate symbols. More...

const Vec3f	getSupernovaCandidateColor (void) const
	Get current value of the supernova candidate symbol color.

void	setSupernovaRemnantCandidateColor (const Vec3f &c)
	Set the color used to draw the supernova remnant candidate symbols. More...

const Vec3f	getSupernovaRemnantCandidateColor (void) const
	Get current value of the supernova remnant candidate symbol color.

void	setInterstellarMatterColor (const Vec3f &c)
	Set the color used to draw the interstellar matter symbols. More...

const Vec3f	getInterstellarMatterColor (void) const
	Get current value of the interstellar matter symbol color.

void	setDarkNebulaColor (const Vec3f &c)
	Set the color used to draw the dark nebula symbols (gray boxes). More...

const Vec3f	getDarkNebulaColor (void) const
	Get current value of the dark nebula color.

void	setClusterColor (const Vec3f &c)
	Set the color used to draw the star cluster symbols (Open/Globular). More...

const Vec3f	getClusterColor (void) const
	Get current value of the star cluster symbol color.

void	setOpenClusterColor (const Vec3f &c)
	Set the color used to draw the open star cluster symbols. More...

const Vec3f	getOpenClusterColor (void) const
	Get current value of the open star cluster symbol color.

void	setGlobularClusterColor (const Vec3f &c)
	Set the color used to draw the globular star cluster symbols. More...

const Vec3f	getGlobularClusterColor (void) const
	Get current value of the globular star cluster symbol color.

void	setStellarAssociationColor (const Vec3f &c)
	Set the color used to draw the stellar associations symbols. More...

const Vec3f	getStellarAssociationColor (void) const
	Get current value of the stellar association symbol color.

void	setStarCloudColor (const Vec3f &c)
	Set the color used to draw the star clouds symbols. More...

const Vec3f	getStarCloudColor (void) const
	Get current value of the star cloud symbol color.

void	setEmissionObjectColor (const Vec3f &c)
	Set the color used to draw the emission objects symbols. More...

const Vec3f	getEmissionObjectColor (void) const
	Get current value of the emission object symbol color.

void	setBlLacObjectColor (const Vec3f &c)
	Set the color used to draw the BL Lac objects symbols. More...

const Vec3f	getBlLacObjectColor (void) const
	Get current value of the BL Lac object symbol color.

void	setBlazarColor (const Vec3f &c)
	Set the color used to draw the blazars symbols. More...

const Vec3f	getBlazarColor (void) const
	Get current value of the blazar symbol color.

void	setMolecularCloudColor (const Vec3f &c)
	Set the color used to draw the molecular clouds symbols. More...

const Vec3f	getMolecularCloudColor (void) const
	Get current value of the molecular cloud symbol color.

void	setYoungStellarObjectColor (const Vec3f &c)
	Set the color used to draw the young stellar objects symbols. More...

const Vec3f	getYoungStellarObjectColor (void) const
	Get current value of the young stellar object symbol color.

void	setPossibleQuasarColor (const Vec3f &c)
	Set the color used to draw the possible quasars symbols. More...

const Vec3f	getPossibleQuasarColor (void) const
	Get current value of the possible quasar symbol color.

void	setPossiblePlanetaryNebulaColor (const Vec3f &c)
	Set the color used to draw the possible planetary nebulae symbols. More...

const Vec3f	getPossiblePlanetaryNebulaColor (void) const
	Get current value of the possible planetary nebula symbol color.

void	setProtoplanetaryNebulaColor (const Vec3f &c)
	Set the color used to draw the protoplanetary nebulae symbols. More...

const Vec3f	getProtoplanetaryNebulaColor (void) const
	Get current value of the protoplanetary nebula symbol color.

void	setStarColor (const Vec3f &c)
	Set the color used to draw the stars symbols. More...

const Vec3f	getStarColor (void) const
	Get current value of the star symbol color.

void	setSymbioticStarColor (const Vec3f &c)
	Set the color used to draw the symbiotic stars symbols. More...

const Vec3f	getSymbioticStarColor (void) const
	Get current value of the symbiotic star symbol color.

void	setEmissionLineStarColor (const Vec3f &c)
	Set the color used to draw the emission-line stars symbols. More...

const Vec3f	getEmissionLineStarColor (void) const
	Get current value of the emission-line star symbol color.

void	setGalaxyClusterColor (const Vec3f &c)
	Set the color used to draw the cluster of galaxies symbols. More...

const Vec3f	getGalaxyClusterColor (void) const
	Get current value of the cluster of galaxies symbol color.

void	setHintsFadeDuration (float duration)
	Set how long it takes for nebula hints to fade in and out when turned on and off. More...

void	setFlagHints (bool b)
	Set flag for displaying Nebulae Hints.

bool	getFlagHints (void) const
	Get flag for displaying Nebulae Hints.

void	setHintsProportional (const bool proportional)
	Set whether hints (symbols) should be scaled according to nebula size.

bool	getHintsProportional (void) const
	Get whether hints (symbols) are scaled according to nebula size.

void	setFlagOutlines (const bool flag)
	Set flag for usage outlines for big DSO instead their hints.

bool	getFlagOutlines (void) const
	Get flag for usage outlines for big DSO instead their hints.

void	setFlagAdditionalNames (const bool flag)
	Set flag for show an additional names for DSO.

bool	getFlagAdditionalNames (void) const
	Get flag for show an additional names for DSO.

void	setDesignationUsage (const bool flag)
	Set flag for usage designations of DSO for their labels instead common names.

bool	getDesignationUsage (void) const
	Get flag for usage designations of DSO for their labels instead common names.

void	setFlagSurfaceBrightnessUsage (const bool usage)
	Set whether hints (symbols) should be visible according to surface brightness value.

bool	getFlagSurfaceBrightnessUsage (void) const
	Get whether hints (symbols) are visible according to surface brightness value.

void	setFlagSurfaceBrightnessArcsecUsage (const bool usage)
	Set flag for usage of measure unit mag/arcsec^2 to surface brightness value.

bool	getFlagSurfaceBrightnessArcsecUsage (void) const
	Get flag for usage of measure unit mag/arcsec^2 to surface brightness value.

void	setFlagSurfaceBrightnessShortNotationUsage (const bool usage)
	Set flag for usage of short notation for measure unit to surface brightness value.

bool	getFlagSurfaceBrightnessShortNotationUsage (void) const
	Get flag for usage of short notation for measure unit to surface brightness value.

void	setFlagSizeLimitsUsage (const bool usage)
	Set flag for usage of size limits.

bool	getFlagSizeLimitsUsage (void) const
	Get flag for usage of size limits.

void	setFlagShow (bool b)
	Set flag used to turn on and off Nebula rendering.

bool	getFlagShow (void) const
	Get value of flag used to turn on and off Nebula rendering.

void	setFlagUseTypeFilters (const bool b)
	Set flag used to turn on and off DSO type filtering.

bool	getFlagUseTypeFilters (void) const
	Get value of flag used to turn on and off DSO type filtering.

void	setFlagShowOnlyNamedDSO (const bool b)
	Set flag used to turn on and off Named DSO Only.

bool	getFlagShowOnlyNamedDSO (void) const
	Get value of flag used to turn on and off Named DSO Only.

void	setMinSizeLimit (double s)
	Set the limit for min. More...

double	getMinSizeLimit (void) const
	Get the limit for min. More...

void	setMaxSizeLimit (double s)
	Set the limit for max. More...

double	getMaxSizeLimit (void) const
	Get the limit for max. More...

void	setLabelsColor (const Vec3f &c)
	Set the color used to draw nebula labels. More...

const Vec3f	getLabelsColor (void) const
	Get current value of the nebula label color.

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

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

void	setHintsAmount (double f)
	Set the amount of nebulae hints. More...

double	getHintsAmount (void) const
	Get the amount of nebulae labels. More...

void	setLabelsBrightness (double b)
	Set the brightness used to paint nebulae labels. More...

double	getLabelsBrightness (void) const
	Get the brightness used to paint nebulae labels. More...

void	setHintsBrightness (double b)
	Set the brightness of nebulae hints. More...

double	getHintsBrightness (void) const
	Get the brightness of nebulae labels. More...

Signals
void	flagHintsDisplayedChanged (bool b)
	Emitted when hints are toggled.

void	flagUseTypeFiltersChanged (bool b)
	Emitted when filter types are changed.

void	catalogFiltersChanged (int flags)
	Emitted when the catalog filter is changed.

void	typeFiltersChanged (int flags)
	Emitted when the type filter is changed.

void	hintsProportionalChanged (bool b)

void	flagOutlinesDisplayedChanged (bool b)

void	flagAdditionalNamesDisplayedChanged (bool b)

void	designationUsageChanged (bool b)

void	flagShowOnlyNamedDSOChanged (bool b)

void	flagSurfaceBrightnessUsageChanged (bool b)

void	flagSurfaceBrightnessArcsecUsageChanged (bool b)

void	flagSurfaceBrightnessShortNotationUsageChanged (bool b)

void	flagSizeLimitsUsageChanged (bool b)

void	minSizeLimitChanged (double s)

void	maxSizeLimitChanged (double s)

void	labelsAmountChanged (double a)

void	hintsAmountChanged (double f)

void	labelsBrightnessChanged (double b)

void	hintsBrightnessChanged (double b)

void	labelsColorChanged (const Vec3f &color) const

void	circlesColorChanged (const Vec3f &color) const

void	regionsColorChanged (const Vec3f &color) const

void	galaxiesColorChanged (const Vec3f &color) const

void	activeGalaxiesColorChanged (const Vec3f &color) const

void	radioGalaxiesColorChanged (const Vec3f &color) const

void	interactingGalaxiesColorChanged (const Vec3f &color) const

void	quasarsColorChanged (const Vec3f &color) const

void	possibleQuasarsColorChanged (const Vec3f &color) const

void	clustersColorChanged (const Vec3f &color) const

void	openClustersColorChanged (const Vec3f &color) const

void	globularClustersColorChanged (const Vec3f &color) const

void	stellarAssociationsColorChanged (const Vec3f &color) const

void	starCloudsColorChanged (const Vec3f &color) const

void	starsColorChanged (const Vec3f &color) const

void	symbioticStarsColorChanged (const Vec3f &color) const

void	emissionLineStarsColorChanged (const Vec3f &color) const

void	nebulaeColorChanged (const Vec3f &color) const

void	planetaryNebulaeColorChanged (const Vec3f &color) const

void	darkNebulaeColorChanged (const Vec3f &color) const

void	reflectionNebulaeColorChanged (const Vec3f &color) const

void	bipolarNebulaeColorChanged (const Vec3f &color) const

void	emissionNebulaeColorChanged (const Vec3f &color) const

void	possiblePlanetaryNebulaeColorChanged (const Vec3f &color) const

void	protoplanetaryNebulaeColorChanged (const Vec3f &color) const

void	hydrogenRegionsColorChanged (const Vec3f &color) const

void	interstellarMatterColorChanged (const Vec3f &color) const

void	emissionObjectsColorChanged (const Vec3f &color) const

void	molecularCloudsColorChanged (const Vec3f &color) const

void	blLacObjectsColorChanged (const Vec3f &color) const

void	blazarsColorChanged (const Vec3f &color) const

void	youngStellarObjectsColorChanged (const Vec3f &color) const

void	supernovaRemnantsColorChanged (const Vec3f &color) const

void	supernovaCandidatesColorChanged (const Vec3f &color) const

void	supernovaRemnantCandidatesColorChanged (const Vec3f &color) const

void	galaxyClustersColorChanged (const Vec3f &color) const

Public Member Functions
void	init () override
	Initialize the NebulaMgr object. More...

void	draw (StelCore *core) override
	Draws all nebula objects and the pointer.

void	update (double deltaTime) override
	Update state which is time dependent.

double	getCallOrder (StelModuleActionName actionName) const override
	Determines the order in which the various modules are drawn.

QList< StelObjectP >	searchAround (const Vec3d &v, double limitFov, const StelCore *core) const override
	Used to get a vector of objects which are near to some position. More...

StelObjectP	searchByNameI18n (const QString &nameI18n) const override
	Return the matching nebula object's pointer if exists or an "empty" StelObjectP. More...

StelObjectP	searchByName (const QString &name) const override
	Return the matching nebula if exists or Q_NULLPTR. More...

StelObjectP	searchByID (const QString &id) const override
	Return the StelObject with the given ID if exists or the empty StelObject if not found. More...

QStringList	listMatchingObjects (const QString &objPrefix, int maxNbItem=5, bool useStartOfWords=false) const override
	Find and return the list of at most maxNbItem objects auto-completing the passed object English name. More...

QStringList	listAllObjects (bool inEnglish) const override

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

QString	getName () const override
	Gets a user-displayable name of the object category.

QString	getStelObjectType () const override
	Returns the name that will be returned by StelObject::getType() for the objects this module manages.

float	computeMaxMagHint (const class StelSkyDrawer *skyDrawer) const
	Compute the maximum magntiude for which hints will be displayed.

QString	getLatestSelectedDSODesignation () const
	Get designation for latest selected DSO with priority. More...

QString	getLatestSelectedDSODesignationWIC () const
	Get designation for latest selected DSO with priority and ignorance of availability of catalogs. More...

const QVector< NebulaP > &	getAllDeepSkyObjects () const
	Get the list of all deep-sky objects.

const QList< NebulaP >	getDeepSkyObjectsByType (const QString &objType) const
	Get the list of deep-sky objects by type.

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
	StelModule ()
	Constructor. Every derived class MUST call setObjectName(className) in its constructor.

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

virtual QSettings *	getSettings ()
	Return module-specific settings. 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 address 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
bool	flagHintDisplayed

bool	flagTypeFiltersUsage

int	typeFilters

int	catalogFilters

bool	hintsProportional

bool	flagOutlinesDisplayed

bool	flagAdditionalNamesDisplayed

bool	flagSurfaceBrightnessUsage

bool	flagSurfaceBrightnessArcsecUsage

bool	flagSurfaceBrightnessShortNotationUsage

double	labelsAmount
	The amount of labels (between 0 and 10)

double	hintsAmount
	The amount of hints (between 0 and 10)

bool	flagDesignationLabels

bool	flagShowOnlyNamedDSO

bool	flagUseSizeLimits

double	minSizeLimit

double	maxSizeLimit

double	hintsBrightness
	The max brightness setting of hints (between 0 and 1)

double	labelsBrightness
	The max brightness setting of labels (between 0 and 1)

Vec3f	labelsColor

Vec3f	circlesColor

Vec3f	regionsColor

Vec3f	galaxiesColor

Vec3f	activeGalaxiesColor

Vec3f	radioGalaxiesColor

Vec3f	interactingGalaxiesColor

Vec3f	quasarsColor

Vec3f	possibleQuasarsColor

Vec3f	clustersColor

Vec3f	openClustersColor

Vec3f	globularClustersColor

Vec3f	stellarAssociationsColor

Vec3f	starCloudsColor

Vec3f	starsColor

Vec3f	symbioticStarsColor

Vec3f	emissionLineStarsColor

Vec3f	nebulaeColor

Vec3f	planetaryNebulaeColor

Vec3f	darkNebulaeColor

Vec3f	reflectionNebulaeColor

Vec3f	bipolarNebulaeColor

Vec3f	emissionNebulaeColor

Vec3f	possiblePlanetaryNebulaeColor

Vec3f	protoplanetaryNebulaeColor

Vec3f	hydrogenRegionsColor

Vec3f	interstellarMatterColor

Vec3f	emissionObjectsColor

Vec3f	molecularCloudsColor

Vec3f	blLacObjectsColor

Vec3f	blazarsColor

Vec3f	youngStellarObjectsColor

Vec3f	supernovaRemnantsColor

Vec3f	supernovaCandidatesColor

Vec3f	supernovaRemnantCandidatesColor

Vec3f	galaxyClustersColor

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

StelAction *	addAction (const QString &id, const QString &groupId, const QString &text, QObject *contextObject, std::function< void()> lambda, const QString &shortcut="", const QString &altShortcut="")
	convenience methods to add an action (call to Lambda functor) to the StelActionMgr object. More...

Detailed Description

Stellarium is prepared to manage more than one set of nebulae (Deep-Sky Objects).

Manage a collection of nebulae.

Currently all data are loaded from directory nebulae/default/. The actual textures are managed in a StelSphericalIndex. The file names.dat is an annotated list of object nicknames, providing names and references. Some names are a bit too fancyful for some users, so references can be excluded from loading by setting an entry in config.ini: [astro] nebula_exclude_references=default:ADI,DSC-HT;custom:foo,bar This would exclude references ADI and DSC-HT from nebulae/default/names.dat and references foo and bar from a (future) nebulae/custom/names.dat nebula set. If the value string does not contain a colon, it is assumed we mean default.

This class is used to display the M, NGC, IC, Barnard, and many other catalogs with information, and textures for some of them.

Member Function Documentation

◆ getHintsAmount

double NebulaMgr::getHintsAmount ( void ) const

slot

Get the amount of nebulae labels.

The real amount is also proportional with FOV.

Returns: the amount between 0 and 10. 0 is no hints, 10 is maximum of hints

◆ getHintsBrightness

double NebulaMgr::getHintsBrightness ( void ) const

slot

Get the brightness of nebulae labels.

Returns: the amount between 0 and 1. 0 is dark (no hints), 1 is maximum brightness of hints

◆ getLabelsAmount

double NebulaMgr::getLabelsAmount ( void ) const

slot

Get the amount of nebulae 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

◆ getLabelsBrightness

double NebulaMgr::getLabelsBrightness ( void ) const

slot

Get the brightness used to paint nebulae labels.

Returns: the amount between 0 and 1. 0 is dark (no labels), 1 is maximum brightness of labels

◆ getLatestSelectedDSODesignation()

QString NebulaMgr::getLatestSelectedDSODesignation ( ) const

Get designation for latest selected DSO with priority.

Note: using for bookmarks feature as example

Returns: a designation

◆ getLatestSelectedDSODesignationWIC()

QString NebulaMgr::getLatestSelectedDSODesignationWIC ( ) const

Get designation for latest selected DSO with priority and ignorance of availability of catalogs.

Note: using for bookmarks feature as example

Returns: a designation

◆ getMaxSizeLimit

double NebulaMgr::getMaxSizeLimit ( void ) const

slot

Get the limit for max.

angular size of displayed DSO.

Returns: the angular size between 1 and 600 arcminutes

◆ getMinSizeLimit

double NebulaMgr::getMinSizeLimit ( void ) const

slot

Get the limit for min.

angular size of displayed DSO.

Returns: the angular size between 1 and 600 arcminutes

◆ init()

void NebulaMgr::init ( )

overridevirtual

Initialize the NebulaMgr object.

Load the font into the Nebula class, which is used to draw Nebula labels.
Load the texture used to draw nebula locations into the Nebula class (for those with no individual texture).
Load the pointer texture.
Set flags values from ini parser which relate to nebula display.
call updateI18n() to translate names.

Implements StelModule.

◆ listAllObjects()

QStringList NebulaMgr::listAllObjects ( bool inEnglish ) const

overridevirtual

Note: Loading deep-sky objects with the proper names only.

Implements StelObjectModule.

◆ listAllObjectsByType()

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

overridevirtual

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.

◆ listMatchingObjects()

QStringList NebulaMgr::listMatchingObjects	(	const QString &	objPrefix,
		int	maxNbItem = `5`,
		bool	useStartOfWords = `false`
	)		const

overridevirtual

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.

◆ searchAround()

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

overridevirtual

Used to get a vector of objects which are near to some position.

Parameters

v	a vector representing the position in th sky around which to search for nebulae.
limitFov	the field of view around the position v in which to search for nebulae.
core	the StelCore to use for computations.

Returns: a list containing the nebulae located inside the limitFov circle around position v.

Reimplemented from StelObjectModule.

◆ searchByID()

StelObjectP NebulaMgr::searchByID ( const QString & id ) const

inlineoverridevirtual

Return the StelObject with the given ID if exists or the empty StelObject if not found.

Parameters

name	the english object name

Implements StelObjectModule.

◆ searchByName()

StelObjectP NebulaMgr::searchByName ( const QString & name ) const

overridevirtual

Return the matching nebula if exists or Q_NULLPTR.

Parameters

name	The case in-sensitive standard program name

Implements StelObjectModule.

◆ searchByNameI18n()

StelObjectP NebulaMgr::searchByNameI18n ( const QString & nameI18n ) const

overridevirtual

Return the matching nebula object's pointer if exists or an "empty" StelObjectP.

Parameters

nameI18n The case in-sensitive nebula name or NGC M catalog name : format can be M31, M 31, NGC31, NGC 31

Implements StelObjectModule.

◆ setActiveGalaxyColor

void NebulaMgr::setActiveGalaxyColor ( const Vec3f & c )

slot

Set the color used to draw the active galaxy symbols (ellipses).

Parameters

c	The color of the active galaxy symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 0.0, 0.0); NebulaMgr.setActiveGalaxyColor(c.toVec3f());

◆ setBipolarNebulaColor

void NebulaMgr::setBipolarNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the bipolar nebulae symbols.

Parameters

c	The color of the bipolar nebulae symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setBipolarNebulaColor(c.toVec3f());

◆ setBlazarColor

void NebulaMgr::setBlazarColor ( const Vec3f & c )

slot

Set the color used to draw the blazars symbols.

Parameters

c	The color of the blazars symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setBlazarColor(c.toVec3f());

◆ setBlLacObjectColor

void NebulaMgr::setBlLacObjectColor ( const Vec3f & c )

slot

Set the color used to draw the BL Lac objects symbols.

Parameters

c	The color of the BL Lac objects symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setBlLacObjectColor(c.toVec3f());

◆ setCirclesColor

void NebulaMgr::setCirclesColor ( const Vec3f & c )

slot

Set the default color used to draw the nebula symbols (default circles, etc).

Parameters

c	The color of the nebula symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.6, 0.8, 0.0); NebulaMgr.setCirclesColor(c.toVec3f());

◆ setClusterColor

void NebulaMgr::setClusterColor ( const Vec3f & c )

slot

Set the color used to draw the star cluster symbols (Open/Globular).

Parameters

c	The color of the cluster symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setClusterColor(c.toVec3f());

◆ setDarkNebulaColor

void NebulaMgr::setDarkNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the dark nebula symbols (gray boxes).

Parameters

c	The color of the dark nebula symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.2, 0.2, 0.2); NebulaMgr.setDarkNebulaColor(c.toVec3f());

◆ setEmissionLineStarColor

void NebulaMgr::setEmissionLineStarColor ( const Vec3f & c )

slot

Set the color used to draw the emission-line stars symbols.

Parameters

c	The color of the emission-line stars symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setEmissionLineStarColor(c.toVec3f());

◆ setEmissionNebulaColor

void NebulaMgr::setEmissionNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the emission nebulae symbols.

Parameters

c	The color of the emission nebulae symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setEmissionNebulaColor(c.toVec3f());

◆ setEmissionObjectColor

void NebulaMgr::setEmissionObjectColor ( const Vec3f & c )

slot

Set the color used to draw the emission objects symbols.

Parameters

c	The color of the emission objects symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 0.0, 0.0); NebulaMgr.setEmissionObjectColor(c.toVec3f());

◆ setGalaxyClusterColor

void NebulaMgr::setGalaxyClusterColor ( const Vec3f & c )

slot

Set the color used to draw the cluster of galaxies symbols.

Parameters

c	The color of the cluster of galaxies symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setGalaxyClusterColor(c.toVec3f());

◆ setGalaxyColor

void NebulaMgr::setGalaxyColor ( const Vec3f & c )

slot

Set the color used to draw the galaxy symbols (ellipses).

Parameters

c	The color of the galaxy symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 0.0, 0.0); NebulaMgr.setGalaxyColor(c.toVec3f());

◆ setGlobularClusterColor

void NebulaMgr::setGlobularClusterColor ( const Vec3f & c )

slot

Set the color used to draw the globular star cluster symbols.

Parameters

c	The color of the globular star cluster symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setGlobularClusterColor(c.toVec3f());

◆ setHintsAmount

void NebulaMgr::setHintsAmount ( double f )

slot

Set the amount of nebulae hints.

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

Parameters

f	the amount between 0 and 10. 0 is no hints, 10 is maximum of hints

◆ setHintsBrightness

void NebulaMgr::setHintsBrightness ( double b )

slot

Set the brightness of nebulae hints.

Parameters

f	the amount between 0 and 10. 0 is no hints, 10 is maximum of hints

◆ setHintsFadeDuration

void NebulaMgr::setHintsFadeDuration ( float duration )

inlineslot

Set how long it takes for nebula hints to fade in and out when turned on and off.

Parameters

duration given in seconds

◆ setHydrogenRegionColor

void NebulaMgr::setHydrogenRegionColor ( const Vec3f & c )

slot

Set the color used to draw the ionized hydrogen region symbols.

Parameters

c	The color of the ionized hydrogen region symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setHydrogenRegionColor(c.toVec3f());

◆ setInteractingGalaxyColor

void NebulaMgr::setInteractingGalaxyColor ( const Vec3f & c )

slot

Set the color used to draw the interacting galaxy symbols (ellipses).

Parameters

c	The color of the interacting galaxy symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 0.0, 0.0); NebulaMgr.setInteractingGalaxyColor(c.toVec3f());

◆ setInterstellarMatterColor

void NebulaMgr::setInterstellarMatterColor ( const Vec3f & c )

slot

Set the color used to draw the interstellar matter symbols.

Parameters

c	The color of the interstellar matter symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setInterstellarMatterColor(c.toVec3f());

◆ setLabelsAmount

void NebulaMgr::setLabelsAmount ( double a )

slot

Set the amount of nebulae labels.

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

Parameters

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

◆ setLabelsBrightness

void NebulaMgr::setLabelsBrightness ( double b )

slot

Set the brightness used to paint nebulae labels.

Parameters

a	the amount between 0 and 1. 0 is black, 1 is maximum brightness

◆ setLabelsColor

void NebulaMgr::setLabelsColor ( const Vec3f & c )

slot

Set the color used to draw nebula labels.

Parameters

c	The color of the nebula labels // example of usage in scripts NebulaMgr.setLabelsColor(Vec3f(1.0,0.0,0.0));

◆ setMaxSizeLimit

void NebulaMgr::setMaxSizeLimit ( double s )

slot

Set the limit for max.

angular size of displayed DSO.

Parameters

s	the angular size between 1 and 600 arcminutes

◆ setMinSizeLimit

void NebulaMgr::setMinSizeLimit ( double s )

slot

Set the limit for min.

angular size of displayed DSO.

Parameters

s	the angular size between 1 and 600 arcminutes

◆ setMolecularCloudColor

void NebulaMgr::setMolecularCloudColor ( const Vec3f & c )

slot

Set the color used to draw the molecular clouds symbols.

Parameters

c	The color of the molecular clouds symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setMolecularCloudColor(c.toVec3f());

◆ setNebulaColor

void NebulaMgr::setNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the bright nebula symbols (emission nebula boxes, planetary nebulae circles).

Parameters

c	The color of the nebula symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setNebulaColor(c.toVec3f());

◆ setOpenClusterColor

void NebulaMgr::setOpenClusterColor ( const Vec3f & c )

slot

Set the color used to draw the open star cluster symbols.

Parameters

c	The color of the open star cluster symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setOpenClusterColor(c.toVec3f());

◆ setPlanetaryNebulaColor

void NebulaMgr::setPlanetaryNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the planetary nebulae symbols.

Parameters

c	The color of the planetary nebulae symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setPlanetaryNebulaColor(c.toVec3f());

◆ setPossiblePlanetaryNebulaColor

void NebulaMgr::setPossiblePlanetaryNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the possible planetary nebulae symbols.

Parameters

c	The color of the possible planetary nebulae symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setPossiblePlanetaryNebulaColor(c.toVec3f());

◆ setPossibleQuasarColor

void NebulaMgr::setPossibleQuasarColor ( const Vec3f & c )

slot

Set the color used to draw the possible quasars symbols.

Parameters

c	The color of the possible quasars symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setPossibleQuasarColor(c.toVec3f());

◆ setProtoplanetaryNebulaColor

void NebulaMgr::setProtoplanetaryNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the protoplanetary nebulae symbols.

Parameters

c	The color of the protoplanetary nebulae symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setProtoplanetaryNebulaColor(c.toVec3f());

◆ setQuasarColor

void NebulaMgr::setQuasarColor ( const Vec3f & c )

slot

Set the color used to draw the quasars symbols (ellipses).

Parameters

c	The color of the quasars symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 0.0, 0.0); NebulaMgr.setQuasarColor(c.toVec3f());

◆ setRadioGalaxyColor

void NebulaMgr::setRadioGalaxyColor ( const Vec3f & c )

slot

Set the color used to draw the radio galaxy symbols (ellipses).

Parameters

c	The color of the radio galaxy symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 0.0, 0.0); NebulaMgr.setRadioGalaxyColor(c.toVec3f());

◆ setReflectionNebulaColor

void NebulaMgr::setReflectionNebulaColor ( const Vec3f & c )

slot

Set the color used to draw the reflection nebulae symbols.

Parameters

c	The color of the reflection nebulae symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setReflectionNebulaColor(c.toVec3f());

◆ setRegionsColor

void NebulaMgr::setRegionsColor ( const Vec3f & c )

slot

Set the default color used to draw the region symbols (default dashed shape).

Parameters

c	The color of the region symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.6, 0.8, 0.0); NebulaMgr.setRegionsColor(c.toVec3f());

◆ setStarCloudColor

void NebulaMgr::setStarCloudColor ( const Vec3f & c )

slot

Set the color used to draw the star clouds symbols.

Parameters

c	The color of the star clouds symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setStarCloudColor(c.toVec3f());

◆ setStarColor

void NebulaMgr::setStarColor ( const Vec3f & c )

slot

Set the color used to draw the stars symbols.

Parameters

c	The color of the stars symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setStarColor(c.toVec3f());

◆ setStellarAssociationColor

void NebulaMgr::setStellarAssociationColor ( const Vec3f & c )

slot

Set the color used to draw the stellar associations symbols.

Parameters

c	The color of the stellar associations symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setStellarAssociationColor(c.toVec3f());

◆ setSupernovaCandidateColor

void NebulaMgr::setSupernovaCandidateColor ( const Vec3f & c )

slot

Set the color used to draw the supernova candidate symbols.

Parameters

c	The color of the supernova candidate symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setSupernovaCandidateColor(c.toVec3f());

◆ setSupernovaRemnantCandidateColor

void NebulaMgr::setSupernovaRemnantCandidateColor ( const Vec3f & c )

slot

Set the color used to draw the supernova remnant candidate symbols.

Parameters

c	The color of the supernova remnant candidate symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setSupernovaRemnantCandidateColor(c.toVec3f());

◆ setSupernovaRemnantColor

void NebulaMgr::setSupernovaRemnantColor ( const Vec3f & c )

slot

Set the color used to draw the supernova remnant symbols.

Parameters

c	The color of the supernova remnant symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(0.0, 1.0, 0.0); NebulaMgr.setSupernovaRemnantColor(c.toVec3f());

◆ setSymbioticStarColor

void NebulaMgr::setSymbioticStarColor ( const Vec3f & c )

slot

Set the color used to draw the symbiotic stars symbols.

Parameters

c	The color of the symbiotic stars symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setSymbioticStarColor(c.toVec3f());

◆ setYoungStellarObjectColor

void NebulaMgr::setYoungStellarObjectColor ( const Vec3f & c )

slot

Set the color used to draw the young stellar objects symbols.

Parameters

c	The color of the young stellar objects symbols // example of usage in scripts (Qt6-based Stellarium) var c = new Color(1.0, 1.0, 0.0); NebulaMgr.setYoungStellarObjectColor(c.toVec3f());

Public Slots

Signals

Public Member Functions

Properties

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ getHintsAmount

◆ getHintsBrightness

◆ getLabelsAmount

◆ getLabelsBrightness

◆ getLatestSelectedDSODesignation()

◆ getLatestSelectedDSODesignationWIC()

◆ getMaxSizeLimit

◆ getMinSizeLimit

◆ init()

◆ listAllObjects()

◆ listAllObjectsByType()

◆ listMatchingObjects()

◆ searchAround()

◆ searchByID()

◆ searchByName()

◆ searchByNameI18n()

◆ setActiveGalaxyColor

◆ setBipolarNebulaColor

◆ setBlazarColor

◆ setBlLacObjectColor

◆ setCirclesColor

◆ setClusterColor

◆ setDarkNebulaColor

◆ setEmissionLineStarColor

◆ setEmissionNebulaColor

◆ setEmissionObjectColor

◆ setGalaxyClusterColor

◆ setGalaxyColor

◆ setGlobularClusterColor

◆ setHintsAmount

◆ setHintsBrightness

◆ setHintsFadeDuration

◆ setHydrogenRegionColor

◆ setInteractingGalaxyColor

◆ setInterstellarMatterColor

◆ setLabelsAmount

◆ setLabelsBrightness

◆ setLabelsColor

◆ setMaxSizeLimit

◆ setMinSizeLimit

◆ setMolecularCloudColor

◆ setNebulaColor

◆ setOpenClusterColor

◆ setPlanetaryNebulaColor

◆ setPossiblePlanetaryNebulaColor

◆ setPossibleQuasarColor

◆ setProtoplanetaryNebulaColor

◆ setQuasarColor

◆ setRadioGalaxyColor

◆ setReflectionNebulaColor

◆ setRegionsColor

◆ setStarCloudColor

◆ setStarColor

◆ setStellarAssociationColor

◆ setSupernovaCandidateColor

◆ setSupernovaRemnantCandidateColor

◆ setSupernovaRemnantColor

◆ setSymbioticStarColor

◆ setYoungStellarObjectColor