Provide script API for Stellarium global functions. More...

#include <StelMainScriptAPI.hpp>

Public Slots
void	setJDay (double JD)
	Set the current date as Julian Day number. More...

double	getJDay () const
	Get the current date as Julian Day number. More...

void	setMJDay (double MJD)
	Set the current date as Modified Julian Day. More...

double	getMJDay () const
	Get the current date as Modified Julian Day. More...

void	setDate (const QString &dateStr, const QString &spec="utc", const bool &dateIsDT=false)
	set the date in ISO format, e.g. More...

QString	getDate (const QString &spec="utc") const
	get the simulation date and time as a string in ISO format, e.g. More...

QString	getDeltaT () const
	get the DeltaT for the simulation date and time as a string in HMS format, e.g. More...

QString	getDeltaTAlgorithm () const
	get the DeltaT equation name for the simulation date and time as a string More...

void	setDeltaTAlgorithm (QString algorithmName)
	set equation of the DeltaT for the simulation date and time More...

void	setTimeRate (double ts)
	Set time speed in JDay/sec. More...

double	getTimeRate () const
	Get simulation time rate. More...

bool	isRealTime () const
	Get the simulation time and rate state - is it "real time". More...

void	setRealTime ()
	Set the simulation time to the current system time, and the time rate to 1.

bool	isPlanetocentricCalculations () const
	Get the type of calculations in the simulation - is it "planetocentric calculations" or not. More...

void	setPlanetocentricCalculations (bool f)
	Set the flag for use planetocentric calculations.

void	selectObjectByName (const QString &name, bool pointer=false) const
	Select an object by name. More...

void	selectConstellationByName (const QString &name) const
	Select a constellation by name. More...

QVariantMap	getObjectPosition (const QString &name) const
	Fetch a map with data about an object's position, magnitude and so on. More...

QVariantMap	getObjectInfo (const QString &name) const
	Fetch a map with data about an object's position, magnitude and so on. More...

QVariantMap	getSelectedObjectInfo () const
	Fetch a map with data about the latest selected object's position, magnitude and so on. More...

void	clear (const QString &state="natural")
	Clear the display options, setting a "standard" view. More...

double	getViewAltitudeAngle () const
	Get the current viewing direction altitude angle at center of view. More...

double	getViewAzimuthAngle () const
	Get the current viewing direction azimuth angle at center of view. More...

double	getViewRaAngle () const
	Get the current viewing direction Right Ascension at center of view. More...

double	getViewDecAngle () const
	Get the current viewing direction Declination angle at center of view. More...

double	getViewRaJ2000Angle () const
	Get the current viewing direction Right Ascension in J2000 frame at center of view. More...

double	getViewDecJ2000Angle () const
	Get the current viewing direction Declination angle in J2000 frame at center of view. More...

void	moveToAltAzi (const QString &alt, const QString &azi, float duration=1.)
	move the current viewing direction to some specified altitude and azimuth. More...

void	moveToRaDec (const QString &ra, const QString &dec, float duration=1.)
	move the current viewing direction to some specified right ascension and declination. More...

void	moveToRaDecJ2000 (const QString &ra, const QString &dec, float duration=1.)
	move the current viewing direction to some specified right ascension and declination in the J2000 frame angles may be specified in a format recognised by StelUtils::getDecAngle() More...

void	moveToGalLongLat (const QString &lon, const QString &lat, float duration)
	move the current viewing direction to some specified galactic coordinates angles may be specified in a format recognised by StelUtils::getDecAngle() More...

void	setObserverLocation (double longitude, double latitude, double altitude, double duration=1., const QString &name="", const QString &planet="")
	Set the observer location. More...

void	setObserverLocation (const QString id, float duration=1.)
	Set the location by the name of the location. More...

QString	getObserverLocation () const
	Get the ID of the current observer location.

QVariantMap	getObserverLocationInfo () const
	Get the info of the current observer location. More...

void	setTimezone (QString tz)
	set timezone name. More...

QStringList	getAllTimezoneNames () const
	Return an array of all timezone names valid for setTimezone(tzName)

void	screenshot (const QString &prefix, bool invert=false, const QString &dir="", const bool overwrite=false)
	Save a screenshot. More...

void	setGuiVisible (bool b)
	Show or hide the GUI (toolbars). More...

void	setMinFps (float m)
	Set the minimum frames per second. More...

float	getMinFps () const
	Get the current minimum frames per second. More...

void	setMaxFps (float m)
	Set the maximum frames per second. More...

float	getMaxFps () const
	Get the current maximum frames per second. More...

QString	getMountMode () const
	Get the mount mode as a string. More...

void	setMountMode (const QString &mode)
	Set the mount mode. More...

bool	getNightMode () const
	Get the current status of Night Mode. More...

void	setNightMode (bool b)
	Set the status of Night Mode. More...

QString	getProjectionMode () const
	Get the current projection mode ID string. More...

void	setProjectionMode (const QString &id)
	Set the current projection mode. More...

bool	getDiskViewport () const
	Get the status of the disk viewport. More...

void	setDiskViewport (bool b)
	Set the disk viewport. More...

void	setSphericMirror (bool b)
	Set the viewport distortion effect. More...

void	setViewportOffset (const float x, const float y)
	Set viewport offset This can be used e.g. More...

void	setViewportStretch (const float stretch)
	Set a lateral width distortion. More...

QStringList	getAllSkyCultureIDs () const
	Get a list of Sky Culture IDs. More...

QString	getSkyCulture () const
	Find out the current sky culture. More...

void	setSkyCulture (const QString &id)
	Set the current sky culture. More...

QString	getSkyCultureName () const
	Find out the current sky culture and get it English name. More...

QString	getSkyCultureNameI18n () const
	Find out the current sky culture and get it localized name. More...

bool	getFlagGravityLabels () const
	Get the current status of the gravity labels option. More...

void	setFlagGravityLabels (bool b)
	Turn on/off gravity labels. More...

void	loadSkyImage (const QString &id, const QString &filename, double lon0, double lat0, double lon1, double lat1, double lon2, double lat2, double lon3, double lat3, double minRes=2.5, double maxBright=14, bool visible=true, const QString &frame="EqJ2000")
	Load an image into the sky background at the given sky coordinates and be warped with the sky. More...

void	loadSkyImage (const QString &id, const QString &filename, const QString &lon0, const QString &lat0, const QString &lon1, const QString &lat1, const QString &lon2, const QString &lat2, const QString &lon3, const QString &lat3, double minRes=2.5, double maxBright=14, bool visible=true, const QString &frame="EqJ2000")
	Convenience function which allows the user to provide longitudinal and latitudinal angles (RA/Dec or Long/Lat or Az/Alt) as strings (e.g. More...

void	loadSkyImage (const QString &id, const QString &filename, double lon, double lat, double angSize, double rotation, double minRes=2.5, double maxBright=14, bool visible=true, const QString &frame="EqJ2000")
	Convenience function which allows loading of a (square) sky image based on a central coordinate, angular size and rotation. More...

void	loadSkyImage (const QString &id, const QString &filename, const QString &lon, const QString &lat, double angSize, double rotation, double minRes=2.5, double maxBright=14, bool visible=true, const QString &frame="EqJ2000")
	Convenience function which allows loading of a (square) sky image based on a central coordinate, angular size and rotation. More...

void	loadSkyImageAltAz (const QString &id, const QString &filename, double azi0, double alt0, double azi1, double alt1, double azi2, double alt2, double azi3, double alt3, double minRes=2.5, double maxBright=14, bool visible=true)
	Load an image which will have a sky location given in alt-azimuthal coordinates. More...

void	loadSkyImageAltAz (const QString &id, const QString &filename, double alt, double azi, double angSize, double rotation, double minRes=2.5, double maxBright=14, bool visible=true)
	Convenience function which allows loading of a sky image based on a central alt-azimuthal coordinate, angular size and rotation. More...

void	removeSkyImage (const QString &id)
	Remove a SkyImage. More...

QVariantMap	getScreenXYFromAltAzi (const QString &alt, const QString &azi) const
	Get screen coordinates from some specified altitude and azimuth angles may be specified in a format recognised by StelUtils::getDecAngle() More...

void	loadSound (const QString &filename, const QString &id)
	Load a sound from a file. More...

void	playSound (const QString &id)
	Play a sound which has previously been loaded with loadSound. More...

void	pauseSound (const QString &id)
	Pause a sound which is playing. More...

void	stopSound (const QString &id)
	Stop a sound from playing. More...

void	dropSound (const QString &id)
	Drop a sound from memory. More...

qint64	getSoundPosition (const QString &id) const
	Get position in a playing sound. More...

qint64	getSoundDuration (const QString &id) const
	Get duration of a sound object (if possible). More...

void	loadVideo (const QString &filename, const QString &id, float x, float y, bool show=true, float alpha=1.0f)
	Load a video from a file. More...

void	playVideo (const QString &id, bool keepVisibleAtEnd=false)
	Play a video which has previously been loaded with loadVideo. More...

void	playVideoPopout (const QString &id, float fromX, float fromY, float atCenterX, float atCenterY, float finalSizeX, float finalSizeY, float popupDuration, bool frozenInTransition)
	Play a video which has previously been loaded with loadVideo with a complex effect. More...

void	pauseVideo (const QString &id)
	Pause a video which is playing. More...

void	stopVideo (const QString &id)
	Stop a video from playing. More...

void	dropVideo (const QString &id)
	Drop a video from memory. More...

void	seekVideo (const QString &id, qint64 ms, bool pause=false)
	Seeks a video to the requested time and either start playing or freeze there. More...

void	setVideoXY (const QString &id, float x, float y, bool relative=false)
	Sets the position of the video widget. More...

void	setVideoAlpha (const QString &id, float alpha)
	Set the alpha value of a video when visible. More...

void	resizeVideo (const QString &id, float w, float h)
	Resize the video widget to the specified width, height. More...

void	showVideo (const QString &id, bool show=true)
	Set the visibility state of a video. More...

qint64	getVideoDuration (const QString &id) const
	Get the duration of a loaded video, or -1. More...

qint64	getVideoPosition (const QString &id) const
	Get the current position of a loaded video, or -1. More...

int	getScreenWidth () const
	Get the screen width in pixels. More...

int	getScreenHeight () const
	Get the screen height (actually, height of Stellarium main view) in pixels. More...

double	getScriptRate () const
	Get the script execution rate as a multiple of normal execution speed. More...

void	setScriptRate (double r)
	Set the script execution rate as a multiple of normal execution speed. More...

void	pauseScript ()
	Pause the currently running script. More...

void	setSelectedObjectInfo (const QString &level)
	Set the amount of selected object information to display. More...

void	exit ()
	Stop the script.

void	quitStellarium ()
	Close Stellarium.

QStringList	getPropertyList () const
	Return a QStringlist of all available properties. Useful for script development...

static void	debug (const QString &s)
	print a debugging message to the console More...

void	output (const QString &s) const
	print an output message from script More...

static QString	mapToString (const QVariantMap &map)
	print contents of a QVariantMap as []-delimited list of [ "key" = ] lists. More...

void	resetOutput (void) const
	Reset (clear) output file.

void	saveOutputAs (const QString &filename)
	Save output file to new file (in same directory as output.txt). More...

QString	getAppLanguage () const
	Get the current application language. More...

void	setAppLanguage (QString langCode)
	Set the current application language. More...

QString	getSkyLanguage () const
	Get the current sky language. More...

void	setSkyLanguage (QString langCode)
	Set the current sky language. More...

void	goHome ()
	Go to defaults position and direction of view.

void	setMilkyWayVisible (bool b)
	Show or hide the Milky Way. More...

void	setMilkyWayIntensity (double i)
	Set Milky Way intensity. More...

double	getMilkyWayIntensity () const
	Get Milky Way intensity. More...

void	setZodiacalLightVisible (bool b)
	Show or hide the Zodiacal Light. More...

void	setZodiacalLightIntensity (double i)
	Set Zodiacal Light intensity. More...

double	getZodiacalLightIntensity () const
	Get Zodiacal Light intensity. More...

int	getBortleScaleIndex () const
	Returns the currently set Bortle scale index, which is used to simulate light pollution. More...

void	setBortleScaleIndex (int index)
	Changes the Bortle scale index, which is used to simulate light pollution. More...

void	setDSSMode (bool b)
	Show or hide the DSS (photorealistic sky). More...

bool	isDSSModeEnabled () const
	Get the current status of DSS mode. More...

static double	jdFromDateString (const QString &dt, const QString &spec)
	For use in setDate and waitFor For parameter descriptions see setDate(). More...

void	wait (double t) const
	Pauses the script for t seconds. More...

void	waitFor (const QString &dt, const QString &spec="utc") const
	Waits until a specified simulation date/time. More...

static QString	getEnv (const QString &var)
	Retrieve value of environment variable. More...

Signals
void	requestLoadSkyImage (const QString &id, const QString &filename, double c1, double c2, double c3, double c4, double c5, double c6, double c7, double c8, double minRes, double maxBright, bool visible, const StelCore::FrameType frameType)

void	requestLoadSkyImageAltAz (const QString &id, const QString &filename, double c1, double c2, double c3, double c4, double c5, double c6, double c7, double c8, double minRes, double maxBright, bool visible)

void	requestRemoveSkyImage (const QString &id)

void	requestLoadSound (const QString &filename, const QString &id)

void	requestPlaySound (const QString &id)

void	requestPauseSound (const QString &id)

void	requestStopSound (const QString &id)

void	requestDropSound (const QString &id)

void	requestLoadVideo (const QString &filename, const QString &id, float x, float y, bool show, float alpha)

void	requestPlayVideo (const QString &id, const bool keepVisibleAtEnd)

void	requestPlayVideoPopout (const QString &id, float fromX, float fromY, float atCenterX, float atCenterY, float finalSizeX, float finalSizeY, float popupDuration, bool frozenInTransition)

void	requestPauseVideo (const QString &id)

void	requestStopVideo (const QString &id)

void	requestDropVideo (const QString &id)

void	requestSeekVideo (const QString &id, qint64 ms, bool pause=false)

void	requestSetVideoXY (const QString &id, float x, float y, bool relative=false)

void	requestSetVideoAlpha (const QString &id, float alpha)

void	requestResizeVideo (const QString &id, float w, float h)

void	requestShowVideo (const QString &id, bool show)

void	requestSetNightMode (bool b)

void	requestSetProjectionMode (QString id)

void	requestSetSkyCulture (QString id)

void	requestSetDiskViewport (bool b)

void	requestExit ()

void	requestSetHomePosition ()

Public Member Functions
	StelMainScriptAPI (QObject *parent=Q_NULLPTR)

Properties
double	JDay

double	timeSpeed

Detailed Description

Public slots in this class may be used in Stellarium scripts, and are accessed as member function to the "core" scripting object. Module-specific functions, such as setting and clearing of display flags (e.g. LandscapeMgr::setFlagAtmosphere) can be accessed directly via the scripting object with the class name, e.g. by using the scripting command: LandscapeMgr.setFlagAtmosphere(true);

Member Function Documentation

◆ clear

void StelMainScriptAPI::clear ( const QString & state = "natural" )

slot

Preset states:

natural : azimuthal mount, atmosphere, landscape, no lines, labels or markers
starchart : equatorial mount, constellation lines, no landscape, atmosphere etc. labels & markers on.
deepspace : like starchart, but no planets, no eq.grid, no markers, no lines.
galactic : like deepspace, but in galactic coordinate system.
Parameters

state the name of a preset state.

◆ debug

static void StelMainScriptAPI::debug ( const QString & s )

staticslot

Parameters

s	the message to be displayed on the console.

◆ dropSound

void StelMainScriptAPI::dropSound ( const QString & id )

slot

You should do this before the end of your script.

Parameters

id	the identifier used when loadSound was called

◆ dropVideo

void StelMainScriptAPI::dropVideo ( const QString & id )

slot

You should do this before the end of your script.

Parameters

id	the identifier used when loadVideo() was called

◆ getAllSkyCultureIDs

QStringList StelMainScriptAPI::getAllSkyCultureIDs ( ) const

slot

Returns: a list of valid sky culture IDs

◆ getAppLanguage

QString StelMainScriptAPI::getAppLanguage ( ) const

slot

Returns: two letter language code, e.g. "en", or "de" and so on.

◆ getBortleScaleIndex

int StelMainScriptAPI::getBortleScaleIndex ( ) const

slot

Wrapper for StelSkyDrawer::getBortleScaleIndex

See also: https://en.wikipedia.org/wiki/Bortle_scale

Returns: the Bortle scale index in range [1,9]

◆ getDate

QString StelMainScriptAPI::getDate ( const QString & spec = "utc" ) const

slot

"2008-03-24T13:21:01"

Parameters

spec	if "utc", the returned string's timezone is UTC, else it is local time.

Returns: the current simulation time.

◆ getDeltaT

QString StelMainScriptAPI::getDeltaT ( ) const

slot

"0h1m68.2s"

Returns: the DeltaT for current simulation time.

◆ getDeltaTAlgorithm

QString StelMainScriptAPI::getDeltaTAlgorithm ( ) const

slot

Returns: name of the DeltaT equation

◆ getDiskViewport

bool StelMainScriptAPI::getDiskViewport ( ) const

slot

Returns: true if the disk view port is currently enabled

◆ getEnv

static QString StelMainScriptAPI::getEnv ( const QString & var )

staticslot

Parameters

name. On desktop Windows and Qt before 5.10, this call may result in data loss if the original string contains Unicode characters not representable in the ANSI encoding.

◆ getFlagGravityLabels

bool StelMainScriptAPI::getFlagGravityLabels ( ) const

slot

Returns: true if gravity labels are enabled, else false

◆ getJDay

double StelMainScriptAPI::getJDay ( ) const

slot

Returns: the Julian Day number

◆ getMaxFps

float StelMainScriptAPI::getMaxFps ( ) const

slot

Returns: The current maximum frames per second setting.

◆ getMilkyWayIntensity

double StelMainScriptAPI::getMilkyWayIntensity ( ) const

slot

Returns: value of Milky Way intensity, e.g. "1.2"

◆ getMinFps

float StelMainScriptAPI::getMinFps ( ) const

slot

Returns: The current minimum frames per second setting.

◆ getMJDay

double StelMainScriptAPI::getMJDay ( ) const

slot

Returns: the Modified Julian Day

◆ getMountMode

QString StelMainScriptAPI::getMountMode ( ) const

slot

Returns: "equatorial" or "azimuthal"

◆ getNightMode

bool StelMainScriptAPI::getNightMode ( ) const

slot

Returns: true if night mode is currently set

◆ getObjectInfo

QVariantMap StelMainScriptAPI::getObjectInfo ( const QString & name ) const

slot

Parameters

name	is the English name of the object for which data will be returned.

Returns

a map of object data. Keys:

above-horizon : true, if celestial body is above horizon
altitude : apparent altitude angle in decimal degrees
azimuth : apparent azimuth angle in decimal degrees
altitude-geometric : geometric altitude angle in decimal degrees
azimuth-geometric : geometric azimuth angle in decimal degrees
ra : right ascension angle (current date frame) in decimal degrees
dec : declination angle (current date frame) in decimal degrees
raJ2000 : right ascension angle (J2000 frame) in decimal degrees
decJ2000 : declination angle (J2000 frame) in decimal degrees
glong : galactic longitude in decimal degrees
glat : galactic latitude in decimal degrees
sglong : supergalactic longitude in decimal degrees
sglat : supergalactic latitude in decimal degrees
elong : ecliptic longitude in decimal degrees (on Earth only!)
elat : ecliptic latitude in decimal degrees (on Earth only!)
elongJ2000 : ecliptic longitude (Earth's J2000 frame) in decimal degrees
elatJ2000 : ecliptic latitude (Earth's J2000 frame) in decimal degrees
vmag : visual magnitude
vmage : visual magnitude (extincted)
size: angular size in radians
size-dd : angular size in decimal degrees
size-deg : angular size in decimal degrees (formatted string)
size-dms : angular size in DMS format
localized-name : localized name The returned map can contain other information. For example, Solar System objects add:
distance : distance to object in AU (for Solar system objects only!)
phase : phase (illuminated fraction, 0..1) of object (for Solar system objects only!)
illumination : phase of object in percent (0..100) (for Solar system objects only!)
phase-angle : phase angle of object in radians (for Solar system objects only!)
phase-angle-dms : phase angle of object in DMS (for Solar system objects only!)
phase-angle-deg : phase angle of object in decimal degrees (for Solar system objects only!)
elongation : elongation of object in radians (for Solar system objects only!)
elongation-dms : elongation of object in DMS (for Solar system objects only!)
elongation-deg : elongation of object in decimal degrees (for Solar system objects only!) Other StelObject derivates, also those defined in plugins, may add more, these fields are documented in the respective classes, or simply try what you get: You can print a complete set of entries into output with the following commands:
map=core.getSelectedObjectInfo();
core.output(core.mapToString(map));

◆ getObjectPosition

QVariantMap StelMainScriptAPI::getObjectPosition ( const QString & name ) const

slot

Parameters

name	is the English name of the object for which data will be returned.

Returns: a map of object data, exactly like getObjectInfo().

Deprecated:: Use getObjectInfo()

◆ getObserverLocationInfo

QVariantMap StelMainScriptAPI::getObserverLocationInfo ( ) const

slot

Returns

a map of object data. Keys:

altitude : altitude in meters
longitude : longitude in decimal degrees
latitude : latitude in decimal degrees
planet : name of planet
location : city and country
sidereal-year : duration of the sidereal year on the planet in Earth's days (since 0.12.0)
sidereal-day : duration of the sidereal day on the planet in Earth's hours (since 0.12.0)
solar-day : duration of the mean solar day on the planet in Earth's hours (since 0.12.0)
local-sidereal-time : local sidereal time on the planet in hours (since 0.13.3)
local-sidereal-time-hms : local sidereal time on the planet in hours in HMS format (since 0.13.3)
timezone : IANA timezone or "LMST" (Local Mean Solar Time) or "LTST" (Local True Solar Time) (since 0.18.3)
location-timezone : IANA timezone of current location (as stored in location database) (since 0.18.3)

◆ getProjectionMode

QString StelMainScriptAPI::getProjectionMode ( ) const

slot

Returns: the string which identifies the current projection mode. For a list of possibl results, see setProjectionMode();

◆ getScreenHeight

int StelMainScriptAPI::getScreenHeight ( ) const

slot

Returns: The screen height in pixels

◆ getScreenWidth

int StelMainScriptAPI::getScreenWidth ( ) const

slot

Returns: The screen width (actually, width of Stellarium main view) in pixels

◆ getScreenXYFromAltAzi

QVariantMap StelMainScriptAPI::getScreenXYFromAltAzi	(	const QString &	alt,
		const QString &	azi
	)		const

slot

Parameters

alt	the altitude angle [degrees]
azi	the azimuth angle [degrees]

Returns

a map of object data. Keys:

x : x coordinate on the screen
y : y coordinate on the screen

◆ getScriptRate

double StelMainScriptAPI::getScriptRate ( ) const

slot

Returns: the current script execution rate.

◆ getSelectedObjectInfo

QVariantMap StelMainScriptAPI::getSelectedObjectInfo ( ) const

slot

Returns: a map of object data. See description for getObjectInfo(const QString& name);

◆ getSkyCulture

QString StelMainScriptAPI::getSkyCulture ( ) const

slot

Returns: the ID of the current sky culture (i.e. the name of the directory in which the curret sky cultures files are found, e.g. "western")

◆ getSkyCultureName

QString StelMainScriptAPI::getSkyCultureName ( ) const

slot

Returns: the English name of the current sky culture

◆ getSkyCultureNameI18n

QString StelMainScriptAPI::getSkyCultureNameI18n ( ) const

slot

Returns: the translated name of the current sky culture

◆ getSkyLanguage

QString StelMainScriptAPI::getSkyLanguage ( ) const

slot

Returns: two letter language code, e.g. "en", or "de" and so on.

◆ getSoundDuration

qint64 StelMainScriptAPI::getSoundDuration ( const QString & id ) const

slot

Parameters

id	the identifier used when loadSound was called

Returns: duration[ms] if known, 0 if unknown (e.g. during load/before playing), -1 in case of error.

◆ getSoundPosition

qint64 StelMainScriptAPI::getSoundPosition ( const QString & id ) const

slot

Parameters

id	the identifier used when loadSound was called

Returns: position [ms] during play or pause, 0 when stopped, -1 in case of error.

◆ getTimeRate

double StelMainScriptAPI::getTimeRate ( ) const

slot

Returns: time speed as a multiple of real time.

◆ getVideoDuration

qint64 StelMainScriptAPI::getVideoDuration ( const QString & id ) const

slot

Parameters

id	the identifier used when loadVideo() was called

◆ getVideoPosition

qint64 StelMainScriptAPI::getVideoPosition ( const QString & id ) const

slot

Parameters

id	the identifier used when loadVideo() was called

◆ getViewAltitudeAngle

double StelMainScriptAPI::getViewAltitudeAngle ( ) const

slot

Returns: the altitude angle in decimal degrees. 0 is horizon, zenith is 180, nadir = -180.

◆ getViewAzimuthAngle

double StelMainScriptAPI::getViewAzimuthAngle ( ) const

slot

Returns: the azimuth angle in decimal degrees as a compass bearing i.e. 0 is North, 90 is East, 180 is South, 270 is West.

◆ getViewDecAngle

double StelMainScriptAPI::getViewDecAngle ( ) const

slot

Returns: the Declination angle in decimal degrees. The value returned falls in the range -180 .. 180

◆ getViewDecJ2000Angle

double StelMainScriptAPI::getViewDecJ2000Angle ( ) const

slot

Returns: the Declination angle in J2000 frame in decimal degrees.

◆ getViewRaAngle

double StelMainScriptAPI::getViewRaAngle ( ) const

slot

Returns: the Right Ascension angle in decimal degrees. The value returned falls in the range 0 .. 360

◆ getViewRaJ2000Angle

double StelMainScriptAPI::getViewRaJ2000Angle ( ) const

slot

Returns: the Right Ascension angle in J2000 frame in decimal degrees.

◆ getZodiacalLightIntensity

double StelMainScriptAPI::getZodiacalLightIntensity ( ) const

slot

Returns: value of Zodiacal Light intensity, e.g. "1.2"

◆ isDSSModeEnabled

bool StelMainScriptAPI::isDSSModeEnabled ( ) const

slot

Returns: The current status of DSS mode.

◆ isPlanetocentricCalculations

bool StelMainScriptAPI::isPlanetocentricCalculations ( ) const

slot

Returns: true if the calculations is planetocentric (geocentric on Earth), else return false

◆ isRealTime

bool StelMainScriptAPI::isRealTime ( ) const

slot

Returns: true if the time rate is normal, and the simulation time is real time, else return false

◆ jdFromDateString

static double StelMainScriptAPI::jdFromDateString	(	const QString &	dt,
		const QString &	spec
	)

staticslot

Returns: Julian day.

◆ loadSkyImage [1/4]

void StelMainScriptAPI::loadSkyImage	(	const QString &	id,
		const QString &	filename,
		double	lon0,
		double	lat0,
		double	lon1,
		double	lat1,
		double	lon2,
		double	lat2,
		double	lon3,
		double	lat3,
		double	minRes = `2.5`,
		double	maxBright = `14`,
		bool	visible = `true`,
		const QString &	frame = `"EqJ2000"`
	)

slot

The image is projected like a deep-sky object, with a notion for surface magnitude of the brightest parts. Transparent sections in the image are possibly rendered white, so make your image just RGB with black background. The black background covers the milky way, but is brightened by the Zodiacal light.

Parameters

id	a string ID to be used when referring to this image (e.g. when changing the displayed status or deleting it.
filename	the file name of the image. If a relative path is specified, "scripts/" will be prefixed before the image is searched for using StelFileMgr.
lon0	The right ascension/longitude/azimuth of the first corner of the image in degrees (bottom left)
lat0	The declination/latitude/altitude of the first corner of the image in degrees (bottom left)
lon1	The right ascension/longitude/azimuth of the second corner of the image in degrees (bottom right)
lat1	The declination/latitude/altitude of the second corner of the image in degrees (bottom right)
lon2	The right ascension/longitude/azimuth of the third corner of the image in degrees (top right)
lat2	The declination/latitude/altitude of the third corner of the image in degrees (top right)
lon3	The right ascension/longitude/azimuth of the fourth corner of the image in degrees (top left)
lat3	The declination/latitude/altitude of the fourth corner of the image in degrees (top left)
minRes	The minimum resolution setting for the image
maxBright	The maximum brightness setting for the image
visible	The initial visibility of the image
frame	one of EqJ2000\|EqDate\|EclJ2000\|EclDate\|Gal(actic)\|SuperG(alactic)\|AzAlt.

Note: since 2017-03, you can select Frame.; Images in AzAlt frame are not affected by atmosphere effects like refraction or extinction.

◆ loadSkyImage [2/4]

void StelMainScriptAPI::loadSkyImage	(	const QString &	id,
		const QString &	filename,
		const QString &	lon0,
		const QString &	lat0,
		const QString &	lon1,
		const QString &	lat1,
		const QString &	lon2,
		const QString &	lat2,
		const QString &	lon3,
		const QString &	lat3,
		double	minRes = `2.5`,
		double	maxBright = `14`,
		bool	visible = `true`,
		const QString &	frame = `"EqJ2000"`
	)

slot

"12d 14m 8s" or "5h 26m 8s" - formats accepted by StelUtils::getDecAngle()).

◆ loadSkyImage [3/4]

void StelMainScriptAPI::loadSkyImage	(	const QString &	id,
		const QString &	filename,
		double	lon,
		double	lat,
		double	angSize,
		double	rotation,
		double	minRes = `2.5`,
		double	maxBright = `14`,
		bool	visible = `true`,
		const QString &	frame = `"EqJ2000"`
	)

slot

Note that the edges will not be aligned with edges at center plus/minus size!

Parameters

id	a string ID to be used when referring to this image (e.g. when changing the displayed status or deleting it.
filename	the file name of the image. If a relative path is specified, "scripts/" will be prefixed before the image is searched for using StelFileMgr.
lon	The right ascension/longitude/azimuth of the center of the image in frame degrees
lat	The declination/latitude/altitude of the center of the image in frame degrees
angSize	The angular size of the image in arc minutes
rotation	The clockwise rotation angle of the image in degrees. Use 0 for an image with top=north. (New from 2017 – This used to be 90!)
minRes	The minimum resolution setting for the image. UNCLEAR, using 2.5 seems to work well.
maxBright	The maximum brightness setting for the image, Vmag/arcmin^2. Use this to blend the brightest possible pixels with DSO. mag 15 or brighter seems ok.
visible	The initial visibility of the image
frame	one of EqJ2000\|EqDate\|EclJ2000\|EclDate\|Gal(actic)\|SuperG(alactic)\|AzAlt.

Note: since 2017-03, you can select Frame.; Images in AzAlt frame are not affected by atmosphere effects like refraction or extinction.

◆ loadSkyImage [4/4]

void StelMainScriptAPI::loadSkyImage	(	const QString &	id,
		const QString &	filename,
		const QString &	lon,
		const QString &	lat,
		double	angSize,
		double	rotation,
		double	minRes = `2.5`,
		double	maxBright = `14`,
		bool	visible = `true`,
		const QString &	frame = `"EqJ2000"`
	)

slot

Parameters are the same as the version of this function which takes double values for the lon and lat, except here text expressions of angles may be used.

◆ loadSkyImageAltAz [1/2]

void StelMainScriptAPI::loadSkyImageAltAz	(	const QString &	id,
		const QString &	filename,
		double	azi0,
		double	alt0,
		double	azi1,
		double	alt1,
		double	azi2,
		double	alt2,
		double	azi3,
		double	alt3,
		double	minRes = `2.5`,
		double	maxBright = `14`,
		bool	visible = `true`
	)

slot

Parameters

id	a string ID to be used when referring to this image (e.g. when changing the displayed status or deleting it.
filename	the file name of the image. If a relative path is specified, "scripts/" will be prefixed before the image is searched for using StelFileMgr.
alt0	The altitude angle of the first corner of the image in degrees
azi0	The azimuth angle of the first corner of the image in degrees
alt1	The altitude angle of the second corner of the image in degrees
azi1	The azimuth angle of the second corner of the image in degrees
alt2	The altitude angle of the third corner of the image in degrees
azi2	The azimuth angle of the third corner of the image in degrees
alt3	The altitude angle of the fourth corner of the image in degrees
azi3	The azimuth angle of the fourth corner of the image in degrees
minRes	The minimum resolution setting for the image
maxBright	The maximum brightness setting for the image
visible	The initial visibility of the image

Deprecated:: since 2017-02 and no longer available since 2018-10 because of inconsistent name. Use loadSkyImage(,,,, "AzAlt") instead!

◆ loadSkyImageAltAz [2/2]

void StelMainScriptAPI::loadSkyImageAltAz	(	const QString &	id,
		const QString &	filename,
		double	alt,
		double	azi,
		double	angSize,
		double	rotation,
		double	minRes = `2.5`,
		double	maxBright = `14`,
		bool	visible = `true`
	)

slot

Parameters

id	a string ID to be used when referring to this image (e.g. when changing the displayed status or deleting it.
filename	the file name of the image. If a relative path is specified, "scripts/" will be prefixed before the image is searched for using StelFileMgr.
alt	The altitude angle of the center of the image in degrees
azi	The azimuth angle of the center of the image in degrees
angSize	The angular size of the image in arc minutes
rotation	The clockwise rotation angle of the image in degrees
minRes	The minimum resolution setting for the image
maxBright	The maximum brightness setting for the image
visible	The initial visibility of the image

Deprecated:: since 2017-03 and no longer available since 2018-10. Use loadSkyImage(,,,, "AzAlt") instead!

◆ loadSound

void StelMainScriptAPI::loadSound	(	const QString &	filename,
		const QString &	id
	)

slot

Parameters

filename	the name of the file to load.
id	the identifier which will be used to refer to the sound when calling playSound, pauseSound, stopSound and dropSound.

◆ loadVideo

void StelMainScriptAPI::loadVideo	(	const QString &	filename,
		const QString &	id,
		float	x,
		float	y,
		bool	show = `true`,
		float	alpha = `1.0f`
	)

slot

Parameters

filename	the name of the file to load, relative to the scripts directory.
id	the identifier which will be used to refer to the video when calling playVideo(), pauseVideo(), stopVideo(), dropVideo() etc.
x	the x-coordinate (pixels from left) for the video frame.
y	the y-coordinate (pixels from top) for the video frame.
show	the visibility state for the video. (Optional since V0.15) You should load a video with show=true (or leave default), to start it immediately in native size. Else set show=false, and then call resizeVideo(), playVideo() or use playVideoPopout().
alpha	the initial alpha value of the video, defaults to 1.

◆ mapToString

static QString StelMainScriptAPI::mapToString ( const QVariantMap & map )

staticslot

Parameters

map	QVariantMap e.g. from getObjectInfo() or getLocationInfo()

Note: string values are surrounded with ", simple numeric types are printed as themselves.; More complicated value types like lists are only indicated by their type name. You must extract those (and their contents) yourself.

◆ moveToAltAzi

void StelMainScriptAPI::moveToAltAzi	(	const QString &	alt,
		const QString &	azi,
		float	duration = `1.`
	)

slot

The move will run in AltAz coordinates. This will look different from moveToRaDec() when timelapse is fast. angles may be specified in a format recognised by StelUtils::getDecAngle()

Parameters

alt	the altitude angle
azi	the azimuth angle
duration	the duration of the movement in seconds

◆ moveToGalLongLat

void StelMainScriptAPI::moveToGalLongLat	(	const QString &	lon,
		const QString &	lat,
		float	duration
	)

slot

Parameters

lon	the galactic longitude
dec	the galactic latitude
duration	the duration of the movement in seconds

◆ moveToRaDec

void StelMainScriptAPI::moveToRaDec	(	const QString &	ra,
		const QString &	dec,
		float	duration = `1.`
	)

slot

The move will run in equatorial coordinates. This will look different from moveToAltAzi() when timelapse is fast. angles may be specified in a format recognised by StelUtils::getDecAngle()

Parameters

ra	the right ascension angle
dec	the declination angle
duration	the duration of the movement in seconds

◆ moveToRaDecJ2000

void StelMainScriptAPI::moveToRaDecJ2000	(	const QString &	ra,
		const QString &	dec,
		float	duration = `1.`
	)

slot

Parameters

ra	the right ascension angle
dec	the declination angle
duration	the duration of the movement in seconds

◆ output

void StelMainScriptAPI::output ( const QString & s ) const

slot

Parameters

s	the message to be displayed on the output file.

◆ pauseScript

void StelMainScriptAPI::pauseScript ( )

slot

Note that you may need to use a key sequence like 'Ctrl-D,R' or the GUI to resume script execution.

◆ pauseSound

void StelMainScriptAPI::pauseSound ( const QString & id )

slot

Subsequent playSound calls will resume playing from the position in the file when it was paused.

Parameters

id	the identifier used when loadSound was called

◆ pauseVideo

void StelMainScriptAPI::pauseVideo ( const QString & id )

slot

Subsequent playVideo() calls will resume playing from the position in the file when it was paused.

Parameters

id	the identifier used when loadVideo() was called

◆ playSound

void StelMainScriptAPI::playSound ( const QString & id )

slot

Parameters

id	the identifier used when loadSound was called

◆ playVideo

void StelMainScriptAPI::playVideo	(	const QString &	id,
		bool	keepVisibleAtEnd = `false`
	)

slot

Parameters

id	the identifier used when loadVideo was called

◆ playVideoPopout

void StelMainScriptAPI::playVideoPopout	(	const QString &	id,
		float	fromX,
		float	fromY,
		float	atCenterX,
		float	atCenterY,
		float	finalSizeX,
		float	finalSizeY,
		float	popupDuration,
		bool	frozenInTransition
	)

slot

The video appears out of fromX/fromY, grows within popupDuration to size finalSizeX/finalSizeY, and shrinks back towards fromX/fromY at the end during popdownDuration.

Parameters

id	the identifier used when loadVideo was called
fromX	X position of starting point, counted from left of window. May be absolute (if >1) or relative (0<X<1)
fromY	Y position of starting point, counted from top of window. May be absolute (if >1) or relative (0<Y<1)
atCenterX	X position of center of final video frame, counted from left of window. May be absolute (if >1) or relative (0<X<1)
atCenterY	Y position of center of final video frame, counted from top of window. May be absolute (if >1) or relative (0<Y<1)
finalSizeX	X size of final video frame. May be absolute (if >1) or relative to window size (0<X<1). If -1, scale proportional from finalSizeY.
finalSizeY	Y size of final video frame. May be absolute (if >1) or relative to window size (0<Y<1). If -1, scale proportional from finalSizeX.
popupDuration	duration of growing start transition (seconds)
frozenInTransition	true if video should be paused during growing/shrinking transition.

◆ removeSkyImage

void StelMainScriptAPI::removeSkyImage ( const QString & id )

slot

Parameters

id	the ID of the image to remove.

◆ requestLoadSkyImageAltAz

void StelMainScriptAPI::requestLoadSkyImageAltAz	(	const QString &	id,
		const QString &	filename,
		double	c1,
		double	c2,
		double	c3,
		double	c4,
		double	c5,
		double	c6,
		double	c7,
		double	c8,
		double	minRes,
		double	maxBright,
		bool	visible
	)

signal

Deprecated:: ! USE requestLoadSkyImage() with frameType=AzAlt!

◆ resizeVideo

void StelMainScriptAPI::resizeVideo	(	const QString &	id,
		float	w,
		float	h
	)

slot

Parameters

id	the identifier used when loadVideo() was called
w	the new width for the widget. (if <1, relative to main view size)
h	the new height for the widget. (if <1, relative to main view size)

◆ saveOutputAs

void StelMainScriptAPI::saveOutputAs ( const QString & filename )

slot

This is required to allow reading with other program on Windows while output.txt is still open.

◆ screenshot

void StelMainScriptAPI::screenshot	(	const QString &	prefix,
		bool	invert = `false`,
		const QString &	dir = `""`,
		const bool	overwrite = `false`
	)

slot

Parameters

prefix	the prefix for the file name to use
dir	the path of the directory to save the screenshot in. If none is specified, the default screenshot directory will be used.
invert	whether colors have to be inverted in the output image
overwrite	true to use exactly the prefix as filename (plus .png), and overwrite any existing file.

◆ seekVideo

void StelMainScriptAPI::seekVideo	(	const QString &	id,
		qint64	ms,
		bool	pause = `false`
	)

slot

Parameters

id	the identifier used when loadVideo() was called
ms	the time in milliseconds from the start of the media.
pause	true if you want to pause at the requested position, keep it false to play from here.

◆ selectConstellationByName

void StelMainScriptAPI::selectConstellationByName ( const QString & name ) const

slot

Parameters

name	the name of the constellation to select (english)

◆ selectObjectByName

void StelMainScriptAPI::selectObjectByName	(	const QString &	name,
		bool	pointer = `false`
	)		const

slot

Parameters

name	the name of the object to select (english) If the name is "", any currently selected objects will be de-selected.
pointer	whether or not to have the selection pointer enabled

◆ setAppLanguage

void StelMainScriptAPI::setAppLanguage ( QString langCode )

slot

Parameters

langCode two letter language code, e.g. "en", or "de".

◆ setBortleScaleIndex

void StelMainScriptAPI::setBortleScaleIndex ( int index )

slot

Wrapper for StelSkyDrawer::setBortleScaleIndex Valid values are in the range [1,9]

See also: https://en.wikipedia.org/wiki/Bortle_scale

Parameters

index the new Bortle scale index, must be in range [1,9]

◆ setDate

void StelMainScriptAPI::setDate	(	const QString &	dateStr,
		const QString &	spec = `"utc"`,
		const bool &	dateIsDT = `false`
	)

slot

"2008-03-24T13:21:01"

Parameters

dateStr

the date string to use. Formats:

ISO, e.g. "2008-03-24T13:21:01"
"now" (set sim time to real time)
relative, e.g. "+ 4 days", "-2 weeks". can use these units: seconds, minutes, hours, days, weeks, months, years. You may also append " sidereal" to use sidereal days and so on. You can also use "now" at the start. For example: "now + 3 hours sidereal"

Note: you must use the plural all the time, even when the number of the unit is 1. i.e. use "+ 1 days" not "+1 day".; when sidereal time is used, the length of time for each unit is dependent on the current planet. By contrast when sidereal time is not specified (i.e. solar time is used) the value is conventional - i.e. 1 day means 1 Earth Solar day.

Parameters

spec	"local" or "utc" - only has an effect when the ISO date type is used. Defaults to "utc".
enableDeltaT	is true or false - enable Delta-T correction or not. Defaults to "true".

Note: for fully compatibles behavior of this function with the version 0.11.4 or earlier, you should call core.setDeltaTAlgorithm("WithoutCorrection"); before running core.setDate(); for disabling DeltaT correction.; starting with version 0.13.2 all relative dates are set without DeltaT correction.; starting with version 0.14.0 the final optional Boolean argument has a different meaning and default!

Parameters

dateIsTT true if the given date is formulated in Dynamical Time, i.e. with DeltaT added.

◆ setDeltaTAlgorithm

void StelMainScriptAPI::setDeltaTAlgorithm ( QString algorithmName )

slot

Parameters

algorithmName is name of equation, e.g. "WithoutCorrection" or "EspenakMeeus"

Note: list of possible names of equation for DeltaT: WithoutCorrection, Schoch, Clemence, IAU, AstronomicalEphemeris, TuckermanGoldstine, MullerStephenson, Stephenson1978, SchmadelZech1979, MorrisonStephenson1982, StephensonMorrison1984, StephensonHoulden, Espenak, Borkowski, SchmadelZech1988, ChaprontTouze, StephensonMorrison1995, Stephenson1997, ChaprontMeeus, JPLHorizons, MeeusSimons, MontenbruckPfleger, ReingoldDershowitz, MorrisonStephenson2004, EspenakMeeus, Reijs, Banjevic, IslamSadiqQureshi, Henriksson2017, Custom.

◆ setDiskViewport

void StelMainScriptAPI::setDiskViewport ( bool b )

slot

Parameters

b	if true, sets the disk viewport on, else sets it off

◆ setDSSMode

void StelMainScriptAPI::setDSSMode ( bool b )

slot

Parameters

b	if true, show the DSS, if false, hide the DSS layer.

◆ setFlagGravityLabels

void StelMainScriptAPI::setFlagGravityLabels ( bool b )

slot

Parameters

b	if true, turn on gravity labels, else turn them off

◆ setGuiVisible

void StelMainScriptAPI::setGuiVisible ( bool b )

slot

Note this only applies to GUI plugins which provide the public slot "setGuiVisible(bool)".

Parameters

b	if true, show the GUI, if false, hide the GUI.

◆ setJDay

void StelMainScriptAPI::setJDay ( double JD )

slot

Parameters

JD	the Julian Day number

◆ setMaxFps

void StelMainScriptAPI::setMaxFps ( float m )

slot

Parameters

m	the new maximum fps setting.

◆ setMilkyWayIntensity

void StelMainScriptAPI::setMilkyWayIntensity ( double i )

slot

Parameters

i	value of intensity for the Milky Way

◆ setMilkyWayVisible

void StelMainScriptAPI::setMilkyWayVisible ( bool b )

slot

Parameters

b	if true, show the Milky Way, if false, hide the Milky Way.

◆ setMinFps

void StelMainScriptAPI::setMinFps ( float m )

slot

Usually this minimum will be switched to after there are no user events for some seconds to save power. However, if can be useful to set this to a high value to improve playing smoothness in scripts.

Parameters

m	the new minimum fps setting.

◆ setMJDay

void StelMainScriptAPI::setMJDay ( double MJD )

slot

Parameters

MJD	the Modified Julian Day

◆ setMountMode

void StelMainScriptAPI::setMountMode ( const QString & mode )

slot

Parameters

mode	should be "equatorial" or "azimuthal"

◆ setNightMode

void StelMainScriptAPI::setNightMode ( bool b )

slot

Parameters

b	if true, set Night Mode, else set Normal Mode

◆ setObserverLocation [1/2]

void StelMainScriptAPI::setObserverLocation	(	double	longitude,
		double	latitude,
		double	altitude,
		double	duration = `1.`,
		const QString &	name = `""`,
		const QString &	planet = `""`
	)

slot

Parameters

longitude	the longitude in degrees. E is +ve. values out of the range -180..180 mean that the longitude will not be set
latitude	the latitude in degrees. N is +ve. values out of the range -90..90 mean that the latitude will not be set
altitude	the new altitude in meters. values less than -1000 mean the altitude will not be set.
duration	the time for the transition from the old to the new location.
name	A name for the location (which will appear in the status bar.
planet	the English name of the new planet. If the planet name is not known (e.g. ""), the planet will not be set.

◆ setObserverLocation [2/2]

void StelMainScriptAPI::setObserverLocation	(	const QString	id,
		float	duration = `1.`
	)

slot

Parameters

id	the location ID as it would be found in the database of locations - do a search in the Location window to see what where is. e.g. "York, UnitedKingdom".
duration	the number of seconds to take to move location.

◆ setProjectionMode

void StelMainScriptAPI::setProjectionMode ( const QString & id )

slot

Parameters

id

the name of the projection mode to use, e.g. "ProjectionPerspective" and so on. valid values of id are:

ProjectionPerspective
ProjectionEqualArea
ProjectionStereographic
ProjectionFisheye
ProjectionHammer
ProjectionCylinder
ProjectionMercator
ProjectionOrthographic
ProjectionSinusoidal
ProjectionMiller

◆ setScriptRate

void StelMainScriptAPI::setScriptRate ( double r )

slot

Parameters

r	the multiple of the normal script execution speed, i.e. if 5 is passed the script will execute 5 times faster than it would if the script rate was 1.

◆ setSelectedObjectInfo

void StelMainScriptAPI::setSelectedObjectInfo ( const QString & level )

slot

Parameters

level can be "AllInfo", "ShortInfo", "None"

◆ setSkyCulture

void StelMainScriptAPI::setSkyCulture ( const QString & id )

slot

Parameters

id	the ID of the sky culture to set, e.g. western or inuit etc.

◆ setSkyLanguage

void StelMainScriptAPI::setSkyLanguage ( QString langCode )

slot

Parameters

langCode two letter language code, e.g. "en", or "de".

◆ setSphericMirror

void StelMainScriptAPI::setSphericMirror ( bool b )

slot

Parameters

b	if true, sets the spherical mirror distortion effect for viewport on, else sets it off

◆ setTimeRate

void StelMainScriptAPI::setTimeRate ( double ts )

slot

Parameters

ts	the new rate of passage of time as a multiple of real time. For example if ts is 1, time will pass at the normal rate. If ts == 10 then simulation time will pass at 10 times the normal rate. If ts is negative, simulation time will go backwards.

◆ setTimezone

void StelMainScriptAPI::setTimezone ( QString tz )

slot

This only changes the currently used timezone (in StelCore). Location (database) timezone will not be touched. Valid values for tz can be found from the results of getAllTimezoneNames, including: "LMST" = Local Mean Solar Time "LTST" = Local True Solar Time

◆ setVideoAlpha

void StelMainScriptAPI::setVideoAlpha	(	const QString &	id,
		float	alpha
	)

slot

Parameters

id	the identifier used when loadVideo() was called
alpha	the new alpha value to set.
alpha	does not work properly, only
alpha=0	makes it invisible.

◆ setVideoXY

void StelMainScriptAPI::setVideoXY	(	const QString &	id,
		float	x,
		float	y,
		bool	relative = `false`
	)

slot

Parameters

id	the identifier used when loadVideo() was called
x	the new x-coordinate for the video. (if <1, relative to main view size)
y	the new y-coordinate for the video. (if <1, relative to main view size)
relative	true if you want to move in relative coordinates, not set absolutely

◆ setViewportOffset

void StelMainScriptAPI::setViewportOffset	(	const float	x,
		const float	y
	)

slot

in wide cylindrical panorama screens to push the horizon down and see more of the sky.

Parameters

x	-0.5...0.5 horizontal offset. This is not available in the GUI, and it is recommended to keep it at 0.
y	-0.5...0.5 vertical offset. This is available in the GUI.

Deprecated:: Use StelMovementMgr::moveViewport instead

◆ setViewportStretch

void StelMainScriptAPI::setViewportStretch ( const float stretch )

slot

Use this e.g. in startup.ssc. Implemented for 0.15 for a setup with 5 projectors with edge blending. The 9600x1200 get squeezed somewhat which looks a bit odd. Use this stretch to compensate. Experimental! To avoid overuse, there is currently no config.ini setting available.

Note: Currently only the projected content is affected. ScreenImage, ScreenLabel is not stretched.

◆ setZodiacalLightIntensity

void StelMainScriptAPI::setZodiacalLightIntensity ( double i )

slot

Parameters

i	value of intensity for the Zodiacal Light

◆ setZodiacalLightVisible

void StelMainScriptAPI::setZodiacalLightVisible ( bool b )

slot

Parameters

b	if true, show the Zodiacal Light, if false, hide the Zodiacal Light.

◆ showVideo

void StelMainScriptAPI::showVideo	(	const QString &	id,
		bool	show = `true`
	)

slot

Parameters

id	the identifier used when loadVideo() was called
show	the new visible state of the video.

Note: You must call this if you called loadVideo() with its

Parameters

show=false,else video will be played hidden.

◆ stopSound

void StelMainScriptAPI::stopSound ( const QString & id )

slot

This resets the position in the sound to the start so that subsequent playSound calls will start from the beginning.

Parameters

id	the identifier used when loadSound was called

◆ stopVideo

void StelMainScriptAPI::stopVideo ( const QString & id )

slot

This resets the position in the video to the start so that subsequent playVideo() calls will start from the beginning.

Parameters

id	the identifier used when loadVideo() was called

◆ wait

void StelMainScriptAPI::wait ( double t ) const

slot

Parameters

t	the number of seconds to wait

◆ waitFor

void StelMainScriptAPI::waitFor	(	const QString &	dt,
		const QString &	spec = `"utc"`
	)		const

slot

This function will take into account the rate (and direction) in which simulation time is passing. e.g. if a future date is specified and the time is moving backwards, the function will return immediately. If the time rate is 0, the function will not wait. This is to prevent infinite wait time.

Parameters

dt	the date string to use, format like "2012-06-06T4:44:00" or "-1428-03-04T22:23:45"
spec	"local" or "utc"

Public Slots

Signals

Public Member Functions

Properties

Detailed Description

Member Function Documentation

◆ clear

◆ debug

◆ dropSound

◆ dropVideo

◆ getAllSkyCultureIDs

◆ getAppLanguage

◆ getBortleScaleIndex

◆ getDate

◆ getDeltaT

◆ getDeltaTAlgorithm

◆ getDiskViewport

◆ getEnv

◆ getFlagGravityLabels

◆ getJDay

◆ getMaxFps

◆ getMilkyWayIntensity

◆ getMinFps

◆ getMJDay

◆ getMountMode

◆ getNightMode

◆ getObjectInfo

◆ getObjectPosition

◆ getObserverLocationInfo

◆ getProjectionMode

◆ getScreenHeight

◆ getScreenWidth

◆ getScreenXYFromAltAzi

◆ getScriptRate

◆ getSelectedObjectInfo

◆ getSkyCulture

◆ getSkyCultureName

◆ getSkyCultureNameI18n

◆ getSkyLanguage

◆ getSoundDuration

◆ getSoundPosition

◆ getTimeRate

◆ getVideoDuration

◆ getVideoPosition

◆ getViewAltitudeAngle

◆ getViewAzimuthAngle

◆ getViewDecAngle

◆ getViewDecJ2000Angle

◆ getViewRaAngle

◆ getViewRaJ2000Angle

◆ getZodiacalLightIntensity

◆ isDSSModeEnabled

◆ isPlanetocentricCalculations

◆ isRealTime

◆ jdFromDateString

◆ loadSkyImage [1/4]

◆ loadSkyImage [2/4]

◆ loadSkyImage [3/4]

◆ loadSkyImage [4/4]

◆ loadSkyImageAltAz [1/2]

◆ loadSkyImageAltAz [2/2]

◆ loadSound

◆ loadVideo

◆ mapToString

◆ moveToAltAzi

◆ moveToGalLongLat

◆ moveToRaDec

◆ moveToRaDecJ2000

◆ output

◆ pauseScript

◆ pauseSound

◆ pauseVideo

◆ playSound

◆ playVideo

◆ playVideoPopout

◆ removeSkyImage

◆ requestLoadSkyImageAltAz

◆ resizeVideo

◆ saveOutputAs

◆ screenshot