• Skip to content
• Skip to link menu

KDE 3.5 API Reference

• KDE API Reference
• API Reference

• Sitemap
• Contact Us

 

kstars

ksplanetbase.h

Go to the documentation of this file.

/***************************************************************************
                          ksplanetbase.h  -  K Desktop Planetarium
                             -------------------
    begin                : Sun Jan 29 2002
    copyright            : (C) 2002 by Mark Hollomon
    email                : mhh@mindspring.com
 ***************************************************************************/

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

#ifndef KSPLANETBASE_H
#define KSPLANETBASE_H

#include <qstring.h>
#include <qptrlist.h>
#include <qimage.h>

#include <kdebug.h>

#include "skyobject.h"
#include "dms.h"

#define MAXTRAIL 400  //maximum number of points in a planet trail

class QPoint;
class KSNumbers;
class KSPopupMenu;

class EclipticPosition {
    public:
        dms longitude;
        dms latitude;
        double radius;

        EclipticPosition(dms plong = 0.0, dms plat = 0.0, double prad = 0.0) :
            longitude(plong), latitude(plat), radius(prad) {}

        EclipticPosition &operator=(EclipticPosition &r) {
            this->longitude = r.longitude;
            this->latitude = r.latitude;
            this->radius = r.radius;
            return *this;
        }
};

class KStarsData;
class KSPlanetBase : public SkyObject {
public:

    KSPlanetBase( KStarsData *kd, QString s = i18n("unnamed"), QString image_file="", double pSize=0 );

    virtual ~KSPlanetBase() {}

    const dms* ecLong( void ) const { return &ep.longitude; }

    const dms* ecLat( void ) const { return &ep.latitude; }

    void setEcLong( dms elong ) { ep.longitude = elong; }

    void setEcLong( double elong ) { ep.longitude.setD( elong ); }

    void setEcLat( dms elat ) { ep.latitude = elat; }

    void setEcLat( double elat ) { ep.latitude.setD( elat ); }
    
    const dms* helEcLong( void ) const { return &helEcPos.longitude; }

    const dms* helEcLat( void ) const { return &helEcPos.latitude; }

    void setHelEcLong( dms elong ) { helEcPos.longitude = elong; }

    void setHelEcLong( double elong ) { helEcPos.longitude.setD( elong ); }

    void setHelEcLat( dms elat ) { helEcPos.latitude = elat; }

    void setHelEcLat( double elat ) { helEcPos.latitude.setD( elat ); }

    virtual bool loadData() = 0;

    void EclipticToEquatorial( const dms *Obliquity );

    void EquatorialToEcliptic( const dms *Obliquity );

    QImage* image( void ) { return &Image; }

    QImage* image0( void ) { return &Image0; }

    double rsun( void ) const { return ep.radius; }

    void setRsun( double r ) { ep.radius = r; }

    double rearth() const { return Rearth; }

    void setRearth( double r ) { Rearth = r; }

    void setRearth( const KSPlanetBase *Earth );

    virtual void updateCoords( KSNumbers *num, bool includePlanets=true, const dms *lat=0, const dms *LST=0 );

    void findPosition( const KSNumbers *num, const dms *lat=0, const dms *LST=0, const KSPlanetBase *Earth = 0 );

        virtual double pa() const { return PositionAngle; }

        void setPA( double p ) { PositionAngle = p; }

        double angSize() const { return AngularSize; }

    void setAngularSize( double size ) { AngularSize = size; }

        double physicalSize() const { return PhysicalSize; }

    void setPhysicalSize( double size ) { PhysicalSize = size; }

    bool isMajorPlanet() const;

    bool hasTrail() const { return ( Trail.count() > 0 ); }

        QPtrList<SkyPoint>* trail() { return &Trail; }

        void addToTrail() { Trail.append( new SkyPoint( ra(), dec() ) ); }

        void clipTrail() { Trail.removeFirst(); }

        void clearTrail() { Trail.clear(); }

        void updateTrail( dms *LST, const dms *lat );

    void rotateImage( double imageAngle );

    void scaleRotateImage( int scale, double imageAngle );

    virtual void showPopupMenu( KSPopupMenu *pmenu, QPoint pos ) { pmenu->createPlanetMenu( this ); pmenu->popup( pos ); }

protected:
    virtual bool loadData(QString n) {
        kdDebug() << "didn't reimplement for " << n << endl; return false;
    }

    virtual bool findGeocentricPosition( const KSNumbers *num, const KSPlanetBase *Earth=NULL ) = 0;

    void findPA( const KSNumbers *num );

    // Geocentric ecliptic position, but distance to the Sun
    EclipticPosition ep;

    // Heliocentric ecliptic position referred to the equinox of the epoch 
    // as obtained from VSOP.
    EclipticPosition helEcPos;
    QPtrList<SkyPoint> Trail;
    double  Rearth;

private:
    void localizeCoords( const KSNumbers *num, const dms *lat, const dms *LST );

    /* Computes the visual magnitude for the major planets. 
     * @param num pointer to a ksnumbers object. Needed for the saturn rings contribution to 
     *        saturn magnitude.
     * @param Earth pointer to an Earth object. Needed to know the distance between the Earth and the
     *        Sun.
     */
    void findMagnitude(const KSNumbers *num);

    QImage Image0, Image;
    double PositionAngle, ImageAngle, AngularSize, PhysicalSize;
    KStarsData *data;
};

#endif

kstars

Skip menu "kstars"

• Main Page
• Modules
• Class Hierarchy
• Alphabetical List
• Class List
• File List
• Class Members
• Related Pages

API Reference

Skip menu "API Reference"

• keduca
• kstars

Generated for API Reference by doxygen 1.5.9
This website is maintained by Adriaan de Groot and Allen Winter.
KDE^® and the K Desktop Environment^® logo are registered trademarks of KDE e.V. | Legal