StelMainScriptAPI.hpp

/*
 * Stellarium
 * Copyright (C) 2009 Matthew Gates
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA  02110-1335, USA.
 */

#ifndef _STELMAINSCRIPTAPI_HPP_
#define _STELMAINSCRIPTAPI_HPP_

#include <QObject>
#include <QVariant>
#include <QStringList>

class QScriptEngine;

class StelMainScriptAPI : public QObject
{
    Q_OBJECT
    Q_PROPERTY(double JDay READ getJDay WRITE setJDay)
    Q_PROPERTY(double timeSpeed READ getTimeRate WRITE setTimeRate)

public:
    StelMainScriptAPI(QObject *parent = 0);
    ~StelMainScriptAPI();

// These functions will be available in scripts
public slots:
    void setJDay(double JD);
    double getJDay() const;

    void setMJDay(double MJD);
    double getMJDay() const;

    void setDate(const QString& dt, const QString& spec="utc", const bool& enableDeltaT=true);

    QString getDate(const QString& spec="utc");

    QString getDeltaT() const;

    QString getDeltaTAlgorithm() const;

    void setDeltaTAlgorithm(QString algorithmName);

    void setTimeRate(double ts);
    double getTimeRate() const;

    bool isRealTime();

    void setRealTime();

    void selectObjectByName(const QString& name, bool pointer=false);

    QVariantMap getObjectPosition(const QString& name);

    QVariantMap getObjectInfo(const QString& name);

    QVariantMap getSelectedObjectInfo();

    void clear(const QString& state="natural");

    double getViewAltitudeAngle();

    double getViewAzimuthAngle();

    double getViewRaAngle();

    double getViewDecAngle();

    double getViewRaJ2000Angle();

    double getViewDecJ2000Angle();

    void moveToAltAzi(const QString& alt, const QString& azi, float duration=1.);

    void moveToRaDec(const QString& ra, const QString& dec, float duration=1.);

    void moveToRaDecJ2000(const QString& ra, const QString& dec, float duration=1.);

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

    void setObserverLocation(const QString id, float duration=1.);

    QString getObserverLocation();

    QVariantMap getObserverLocationInfo();

    void screenshot(const QString& prefix, bool invert=false, const QString& dir="");

    void setGuiVisible(bool b);

    void setMinFps(float m);

    float getMinFps();

    void setMaxFps(float m);

    float getMaxFps();

    QString getMountMode();

    void setMountMode(const QString& mode);

    bool getNightMode();

    void setNightMode(bool b);

    QString getProjectionMode();

    void setProjectionMode(const QString& id);

    bool getDiskViewport();

    void setDiskViewport(bool b);

    void setSphericMirror(bool b);

    QStringList getAllSkyCultureIDs();

    QString getSkyCulture();

    void setSkyCulture(const QString& id);

    QString getSkyCultureName();

    QString getSkyCultureNameI18n();

    bool getFlagGravityLabels();

    void setFlagGravityLabels(bool b);

    void loadSkyImage(const QString& id, const QString& filename,
                      double ra0, double dec0,
                      double ra1, double dec1,
                      double ra2, double dec2,
                      double ra3, double dec3,
                      double minRes=2.5, double maxBright=14, bool visible=true);


    void loadSkyImage(const QString& id, const QString& filename,
                      const QString& ra0, const QString& dec0,
                      const QString& ra1, const QString& dec1,
                      const QString& ra2, const QString& dec2,
                      const QString& ra3, const QString& dec3,
                      double minRes=2.5, double maxBright=14, bool visible=true);

    void loadSkyImage(const QString& id, const QString& filename,
                      double ra, double dec, double angSize, double rotation,
                      double minRes=2.5, double maxBright=14, bool visible=true);

    void loadSkyImage(const QString& id, const QString& filename,
                      const QString& ra, const QString& dec, double angSize, double rotation,
                      double minRes=2.5, double maxBright=14, bool visible=true);

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

    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);

    void removeSkyImage(const QString& id);

    void loadSound(const QString& filename, const QString& id);

    void playSound(const QString& id);

    void pauseSound(const QString& id);

    void stopSound(const QString& id);

    void dropSound(const QString& id);

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

    void playVideo(const QString& id);

    void pauseVideo(const QString& id);

    void stopVideo(const QString& id);

    void dropVideo(const QString& id);

        void seekVideo(const QString& id, qint64 ms);                                   

        void setVideoXY(const QString& id, float x, float y);                           

        void setVideoAlpha(const QString& id, float alpha);                             

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

        void showVideo(const QString& id, bool show);

    int getScreenWidth();
    int getScreenHeight();

    double getScriptRate();
    void setScriptRate(double r);

    void pauseScript();

    void setSelectedObjectInfo(const QString& level);

    void exit();

    void quitStellarium();

    void debug(const QString& s);

    void output(const QString& s);

    QString getAppLanguage();

    void setAppLanguage(QString langCode);

    QString getSkyLanguage();

    void setSkyLanguage(QString langCode);

    void goHome();

    void setMilkyWayVisible(bool b);

    void setMilkyWayIntensity(double i);

    double getMilkyWayIntensity();

    void setZodiacalLightVisible(bool b);

    void setZodiacalLightIntensity(double i);

    double getZodiacalLightIntensity();

    double jdFromDateString(const QString& dt, const QString& spec);

    // Methods wait() and waitFor() was added for documentation.
    // Details: https://bugs.launchpad.net/stellarium/+bug/1402200

    void wait(double t) { Q_UNUSED(t) }

    void waitFor(const QString& dt, const QString& spec="utc") { Q_UNUSED(dt); Q_UNUSED(spec) }

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);
    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);
    void requestPauseVideo(const QString& id);
    void requestStopVideo(const QString& id);
    void requestDropVideo(const QString& id);
    void requestSeekVideo(const QString& id, qint64 ms);
    void requestSetVideoXY(const QString& id, float x, float y);
    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();
};

#endif // _STELMAINSCRIPTAPI_HPP_