File indexing completed on 2024-04-21 14:46:49

 /*
     SPDX-FileCopyrightText: 2012 Samikshan Bairagya <samikshan@gmail.com>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #pragma once
 
 #include <QString>
 #include <QWidget>
 
 #include <memory>
 
 class QNetworkAccessManager;
 class QQmlContext;
 class QQuickItem;
 class QQuickView;
 
 class ModelManager;
 class ObsConditions;
 class SkyObject;
 class SkyObjItem;
 
 /**
  * @class WIView
  * @brief Manages the QML user interface for What's Interesting. WIView is used to display the
  * QML UI using a QQuickView. It acts on all signals emitted by the UI and manages the data
  * sent to the UI for display.
  *
  * @author Samikshan Bairagya
  */
 class WIView : public QWidget
 {
     Q_OBJECT
   public:
     /**
      * @brief Constructor - Store QML components as QObject pointers.
      * Connect signals from various QML components into public slots.
      * Displays the user interface for What's Interesting
      */
     explicit WIView(QWidget *parent = nullptr);
 
     virtual ~WIView() override = default;
 
     /** Load details-view for selected sky-object */
     void loadDetailsView(SkyObjItem *soitem, int index);
 
     /** Updates sky-object list models */
     void updateModel(ObsConditions& obs);
 
     inline QQuickView *getWIBaseView() const { return m_BaseView; }
 
   public slots:
 
     /**
      * @brief public slot - Act upon signal emitted when category of sky-object is selected
      * from category selection view of the QML UI.
      * @param model Category selected
      */
     void onCategorySelected(QString model);
 
     /**
      * @brief public slot - Act upon signal emitted when an item is selected from list of sky-objects.
      * Display details-view for the skyobject selected.
      * @param index       Index of item in the list of skyobjects.
      */
     void onSoListItemClicked(int index);
 
     /** public slot - Show details-view for next sky-object from list of current sky-objects's category. */
     void onNextObjClicked();
 
     /**
      * @brief public slot - Show details-view for previous sky-object from list of current sky-objects's
      * category.
      */
     void onPrevObjClicked();
 
     /** public slot - Slew map to current sky-object in the details view. */
     void onCenterButtonClicked();
 
     /** public slot - Slew map to current sky-object in the details view. */
     void onSlewTelescopeButtonClicked();
 
     /** public slot - Open Details Dialog to show more details for current sky-object. */
     void onDetailsButtonClicked();
 
     /** public slot - Open WI settings dialog. */
     void onSettingsIconClicked();
 
     void onInspectIconClicked(bool checked) { inspectOnClick = checked; }
 
     /** public slot - Reload list of visible sky-objects. */
     void onReloadIconClicked();
 
     void onVisibleIconClicked(bool checked);
 
     void onFavoriteIconClicked(bool checked);
 
     void onUpdateIconClicked();
 
     void updateWikipediaDescription(SkyObjItem *soitem);
     void loadObjectDescription(SkyObjItem *soitem);
     void tryToUpdateWikipediaInfo(SkyObjItem *soitem, QString name);
     void loadObjectInfoBox(SkyObjItem *soitem);
     void saveImageURL(SkyObjItem *soitem, QString imageURL);
     void saveInfoURL(SkyObjItem *soitem, QString infoURL);
     void saveObjectInfoBoxText(SkyObjItem *soitem, QString type, QString infoText);
     void downloadWikipediaImage(SkyObjItem *soitem, QString imageURL);
     void inspectSkyObject(const QString& name);
     void inspectSkyObjectOnClick(SkyObject *obj);
     void inspectSkyObject(SkyObject *obj);
     bool inspectOnClickIsActive() { return inspectOnClick; }
     void updateObservingConditions();
     void tryToUpdateWikipediaInfoInModel(bool onlyMissing);
     void refreshListView();
     void updateProgress(double value);
     void setProgressBarVisible(bool visible);
     void setNightVisionOn(bool on);
 
   private:
     QString getWikipediaName(SkyObjItem *soitem);
 
     QQuickItem *m_BaseObj { nullptr };
     QQuickItem *m_ViewsRowObj { nullptr };
     QQuickItem *m_CategoryTitle { nullptr };
     QQuickItem *m_SoListObj { nullptr };
     QQuickItem *m_DetailsViewObj { nullptr };
     QQuickItem *m_ProgressBar { nullptr };
     QQuickItem *m_loadingMessage { nullptr };
     QQuickItem *m_NextObj { nullptr };
     QQuickItem *m_PrevObj { nullptr };
     QQuickItem *m_CenterButtonObj { nullptr };
     QQuickItem *m_SlewTelescopeButtonObj { nullptr };
     QQuickItem *m_DetailsButtonObj { nullptr };
     QQuickItem *inspectIconObj { nullptr };
     QQuickItem *visibleIconObj { nullptr };
     QQuickItem *favoriteIconObj { nullptr };
     QQmlContext *m_Ctxt { nullptr };
     QObject *infoBoxText { nullptr };
     QObject *descTextObj { nullptr };
     QObject *nightVision { nullptr };
     QObject *autoTrackCheckbox { nullptr };
     QObject *autoCenterCheckbox { nullptr };
 
     QQuickView *m_BaseView { nullptr };
     ObsConditions *m_Obs { nullptr };
     std::unique_ptr<ModelManager> m_ModManager;
     /// Current sky object item.
     SkyObjItem *m_CurSoItem { nullptr };
     /// Created sky object item on-demand
     std::unique_ptr<SkyObjItem> trackedItem;
     /// Index of current sky-object item in Details view.
     int m_CurIndex { 0 };
     /// Currently selected category from WI QML view
     QString m_CurrentObjectListName;
     std::unique_ptr<QNetworkAccessManager> manager;
     bool inspectOnClick { false };
 };