File indexing completed on 2025-04-13 03:32:45

 /*
     SPDX-FileCopyrightText: 2016 Artem Fedoskin <afedoskin3@gmail.com>
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #pragma once
 
 #include "skyitem.h"
 #include "skyopacitynode.h"
 #include "deepskycomponent.h"
 #include "skynodes/trixelnode.h"
 
 class DeepSkyComponent;
 class SkyMesh;
 class StarBlockFactory;
 class MeshIterator;
 
 /**
  * @short This class represents DSOs from particular catalog. To create a node, first create a DSOTrixelNode,
  * (if a node of this trixelID is not a child of m_trixels yet), append it to m_trixels and then append
  * DeepSkyNode to DSOTrixelNode
  */
 class DSOIndexNode : public SkyOpacityNode
 {
   public:
     DSOIndexNode(DeepSkyIndex *index, LabelsItem::label_t labelType, QString colorString);
 
     /** @short hides the catalog nodes and their labels */
     virtual void hide();
 
     /** @short shows the catalog nodes and their labels */
     virtual void show();
 
     DeepSkyIndex *m_index { nullptr };
     QSGNode *m_trixels { nullptr };
     /** @short m_labelType holds label type of this catalog */
     LabelsItem::label_t m_labelType;
     /** @short schemeColor holds the color, with which nodes of this catalog should be drawn */
     QString schemeColor;
 };
 
 /**
  * @short The DSOTrixelNode class represents trixel. Symbols should be appended to m_symbols, labels to
  * m_labels and DeepSkyNodes directly to DSOTrixelNode
  */
 class DSOTrixelNode : public TrixelNode
 {
   public:
     explicit DSOTrixelNode(Trixel trixelID);
 
     virtual void deleteAllChildNodes();
 
     TrixelNode *m_labels { nullptr };
     QSGNode *m_symbols { nullptr };
 };
 
 /**
  * @class DeepSkyItem
  *
  * @short Class that handles representation of Deep Sky Objects.
  *
  * @author Artem Fedoskin
  * @version 1.0
  */
 class DeepSkyItem : public SkyItem
 {
   public:
     /**
      * @short Constructor. Instantiates DSOIndexNodes for catalogs
      * @param dsoComp pointer to DeepSkyComponent that handles data
      * @param rootNode parent RootNode that instantiated this object
      */
     DeepSkyItem(DeepSkyComponent *dsoComp, RootNode *rootNode);
 
     /** @short Call update on all DSOIndexNodes (catalogs) */
     virtual void update();
 
     /**
      * @short update all nodes needed to represent DSO in the given DSOIndexNode
      * In this function we perform some tricks to reduce memory consumption:
      * 1. Each TrixelNode has hideCount() function that returns the number of updates, during which this TrixelNode
      * was hidden. Whenever TrixelNode becomes visible this counter is set to 0 and is not being incremented.
      * 2. Based on the zoom level we calculate the limit for hideCount. If hideCount() of particular TrixelNode is
      * larger than the limit, we delete all nodes of this TrixelNode.
      * 3. If DSOTrixelNode is visible, we iterate over its DeepSkyObjects and DeepSkyNodes. If hideCount of DeepSkyNode
      * is larger than the limit we delete it. If DeepSkyObject is visible but no DeepSkyNode to represent this object
      * is created, we instantiate a new one.
      * @param node - DSOIndexNode(catalog) that should be updated
      * @param drawObject - true if objects from this catalog should be drawn, false otherwise
      * @param region - MeshIterator that should be used to iterate over visible trixels
      * @param drawImage - true if images for objects should be drawn, false otherwise
      */
     void updateDeepSkyNode(DSOIndexNode *node, bool drawObject, MeshIterator *region, bool drawImage = false);
 
   private:
     DeepSkyComponent *m_dsoComp { nullptr };
     SkyMesh *m_skyMesh { nullptr };
 
     DSOIndexNode *m_Messier { nullptr };
     DSOIndexNode *m_NGC { nullptr };
     DSOIndexNode *m_IC { nullptr };
     DSOIndexNode *m_other { nullptr };
 };