File indexing completed on 2024-12-01 09:39:16

0001 /*
0002     SPDX-FileCopyrightText: 2002 Jason Harris <kstars@30doradus.org>
0003 
0004     SPDX-License-Identifier: GPL-2.0-or-later
0005 */
0006 
0007 #pragma once
0008 
0009 #include "ui_details_data.h"
0010 #include "ui_details_data_comet.h"
0011 #include "ui_details_database.h"
0012 #include "ui_details_links.h"
0013 #include "ui_details_log.h"
0014 #include "ui_details_position.h"
0015 
0016 #include "skyobjectuserdata.h"
0017 #include <kpagedialog.h>
0018 
0019 #include <QPalette>
0020 #include <QString>
0021 
0022 #include <memory>
0023 
0024 class QListWidgetItem;
0025 class QPixmap;
0026 
0027 class DataCometWidget;
0028 class DataWidget;
0029 class GeoLocation;
0030 class KStars;
0031 class KStarsDateTime;
0032 class SkyObject;
0033 
0034 class PositionWidget;
0035 class LinksWidget;
0036 class DatabaseWidget;
0037 class LogWidget;
0038 
0039 struct ADVTreeData
0040 {
0041     QString Name;
0042     QString Link;
0043     int Type;
0044 };
0045 
0046 /**
0047   * @class DetailDialog
0048   * DetailDialog is a window showing detailed information for a selected object.
0049     * The window is split into four Tabs: General, Links, Advanced and Log.
0050     * The General Tab displays some type-specific data about the object, as well as its
0051     * present coordinates and Rise/Set/Transit times for the current date.  The Type-specific
0052     * data are:
0053     * @li Stars: common name, genetive name, Spectral type, magnitude, distance
0054     * @li Solar System: name, object type (planet/comet/asteroid), Distance, magnitude (TBD),
0055     * angular size (TBD)
0056     * @li Deep Sky: Common name, other names, object type, magnitude, angular size
0057     *
0058     * The Links Tab allows the user to manage the list of Image and Information links
0059     * listed in the object's popup menu.  The Advanced Tab allows the user to query
0060     * a number of professional-grade online astronomical databases for data on the object.
0061     * The Log tab allows the user to attach their own text notes about the object.
0062     *
0063     * The General Tab includes a clickable image of the object.  Clicking the image opens
0064     * a Thumbnail picker tool, which downloads a list of mages of the object from the
0065     * network, which the user may select as the new image for this objects Details window.
0066     *
0067     * @author Jason Harris, Jasem Mutlaq
0068     * @version 1.0
0069     */
0070 class DetailDialog : public KPageDialog
0071 {
0072     Q_OBJECT
0073   public:
0074     /** Constructor */
0075     DetailDialog(SkyObject *o, const KStarsDateTime &ut, GeoLocation *geo, QWidget *parent = nullptr);
0076 
0077     /** Destructor */
0078     ~DetailDialog() override = default;
0079 
0080     /** @return pointer to the QPixmap of the object's thumbnail image */
0081     inline QPixmap *thumbnail() { return Thumbnail.get(); }
0082 
0083   public slots:
0084     /** @short Slot to add this object to the observing list. */
0085     void addToObservingList();
0086 
0087     /** @short Slot to center this object in the display. */
0088     void centerMap();
0089 
0090     /** @short Slot to center this object in the telescope. */
0091     void centerTelescope();
0092 
0093     //TODO: showThumbnail() is only called in the ctor; make it private and not a slot.
0094     /** @short Slot to display the thumbnail image for the object */
0095     void showThumbnail();
0096 
0097     /**
0098      * @short Slot to update thumbnail image for the object, using the Thumbnail
0099      * Picker tool.
0100      * @sa ThumbnailPicker
0101      */
0102     void updateThumbnail();
0103 
0104     /** @short Slot for viewing the selected image or info URL in the web browser. */
0105     void viewLink();
0106 
0107     /**
0108      * Popup menu function: Add a custom Image or Information URL.
0109      * Opens the AddLinkDialog window.
0110      */
0111     void addLink();
0112 
0113     /**
0114      * @short Set the currently-selected URL resource.
0115      *
0116      * This function is needed because there are two QListWidgets,
0117      * each with its own selection.  We need to know which the user selected most recently.
0118      */
0119     void setCurrentLink(QListWidgetItem *it);
0120 
0121     /**
0122      * @short Rebuild the Image and Info URL lists for this object.
0123      * @note used when an item is added to either list.
0124      */
0125     void updateLists();
0126 
0127     /**
0128      * @short Open a dialog to edit a URL in either the Images or Info lists,
0129      * and update the user's *url.dat file.
0130      */
0131     void editLinkDialog();
0132 
0133     /**
0134      * @short remove a URL entry from either the Images or Info lists, and
0135      * update the user's *url.dat file.
0136      */
0137     void removeLinkDialog();
0138 
0139     /**
0140      * Open the web browser to the selected online astronomy database,
0141      * with a query to the object of this Detail Dialog.
0142      */
0143     void viewADVData();
0144 
0145     /** Save the User's text in the Log Tab to the userlog.dat file. */
0146     void saveLogData();
0147 
0148     /** Update View/Edit/Remove buttons */
0149     void updateButtons();
0150 
0151   private:
0152     /** Build the General Data Tab for the current object. */
0153     void createGeneralTab();
0154 
0155     /** Build the Position Tab for the current object. */
0156     void createPositionTab(const KStarsDateTime &ut, GeoLocation *geo);
0157 
0158     /**
0159      * Build the Links Tab, populating the image and info lists with the
0160      * known URLs for the current Object.
0161      */
0162     void createLinksTab();
0163 
0164     /** Build the Advanced Tab */
0165     void createAdvancedTab();
0166 
0167     /** Build the Log Tab */
0168     void createLogTab();
0169 
0170     /** Populate the TreeView of known astronomical databases in the Advanced Tab */
0171     void populateADVTree();
0172 
0173     /**
0174      * Data for the Advanced Tab TreeView is stored in the file advinterface.dat.
0175      * This function parses advinterface.dat.
0176      */
0177     QString parseADVData(const QString &link);
0178 
0179     /**
0180      * Update the local info_url and image_url files
0181      * @param type The URL type. 0 for Info Links, 1 for Images.
0182      * @param search_line The line to be search for in the local URL files
0183      * @param replace_line The replacement line once search_line is found.
0184      * @note If replace_line is empty, the function will remove search_line from the file
0185      */
0186     void updateLocalDatabase(int type, const QString &search_line, const QString &replace_line = QString());
0187 
0188     SkyObject *selectedObject { nullptr };
0189     QPalette titlePalette;
0190     QListWidgetItem *m_CurrentLink { nullptr };
0191     std::unique_ptr<QPixmap> Thumbnail;
0192     DataWidget *Data { nullptr };
0193     DataCometWidget *DataComet { nullptr };
0194     PositionWidget *Pos { nullptr };
0195     LinksWidget *Links { nullptr };
0196     DatabaseWidget *Adv { nullptr };
0197     LogWidget *Log { nullptr };
0198     const SkyObjectUserdata::Data &m_user_data;
0199 };
0200 
0201 class DataWidget : public QFrame, public Ui::DetailsData
0202 {
0203   Q_OBJECT
0204 
0205   public:
0206     explicit DataWidget(QWidget *parent = nullptr);
0207 };
0208 
0209 class DataCometWidget : public QFrame, public Ui::DetailsDataComet
0210 {
0211   Q_OBJECT
0212 
0213   public:
0214     explicit DataCometWidget(QWidget *parent = nullptr);
0215 };
0216 
0217 class PositionWidget : public QFrame, public Ui::DetailsPosition
0218 {
0219   Q_OBJECT
0220 
0221   public:
0222     explicit PositionWidget(QWidget *parent = nullptr);
0223 };
0224 
0225 class LinksWidget : public QFrame, public Ui::DetailsLinks
0226 {
0227   Q_OBJECT
0228 
0229   public:
0230     explicit LinksWidget(QWidget *parent = nullptr);
0231 };
0232 
0233 class DatabaseWidget : public QFrame, public Ui::DetailsDatabase
0234 {
0235   Q_OBJECT
0236 
0237   public:
0238     explicit DatabaseWidget(QWidget *parent = nullptr);
0239 };
0240 
0241 class LogWidget : public QFrame, public Ui::DetailsLog
0242 {
0243   Q_OBJECT
0244 
0245   public:
0246     explicit LogWidget(QWidget *parent = nullptr);
0247 };