layer.h

Go to the documentation of this file.

/*
 *   libpal - Automated Placement of Labels Library
 *
 *   Copyright (C) 2008 Maxence Laurent, MIS-TIC, HEIG-VD
 *                      University of Applied Sciences, Western Switzerland
 *                      http://www.hes-so.ch
 *
 *   Contact:
 *      maxence.laurent <at> heig-vd <dot> ch
 *    or
 *      eric.taillard <at> heig-vd <dot> ch
 *
 * This file is part of libpal.
 *
 * libpal 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 3 of the License, or
 * (at your option) any later version.
 *
 * libpal 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 libpal.  If not, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef PAL_LAYER_H_
#define PAL_LAYER_H_

#include "pal.h"
#include <QMutex>
#include <QLinkedList>
#include <QHash>
#include <fstream>

class QgsLabelFeature;

namespace pal
{

  template<class DATATYPE, class ELEMTYPE, int NUMDIMS, class ELEMTYPEREAL, int TMAXNODES, int TMINNODES> class RTree;

  class FeaturePart;
  class Pal;
  class LabelInfo;

  class CORE_EXPORT Layer
  {
      friend class Pal;
      friend class FeaturePart;

      friend class Problem;

      friend class LabelPosition;

    public:
      enum LabelMode { LabelPerFeature, LabelPerFeaturePart };
      enum UpsideDownLabels
      {
        Upright, // upside-down labels (90 <= angle < 270) are shown upright
        ShowDefined, // show upside down when rotation is layer- or data-defined
        ShowAll // show upside down for all labels, including dynamic ones
      };

      virtual ~Layer();

      bool displayAll() const { return mDisplayAll; }

      int featureCount() { return mHashtable.size(); }

      QgsAbstractLabelProvider* provider() const { return mProvider; }

      QString name() const { return mName; }

      QgsPalLayerSettings::Placement arrangement() const { return mArrangement; }

      void setArrangement( QgsPalLayerSettings::Placement arrangement ) { mArrangement = arrangement; }

      LineArrangementFlags arrangementFlags() const { return mArrangementFlags; }

      void setArrangementFlags( const LineArrangementFlags& flags ) { mArrangementFlags = flags; }

      void setActive( bool active ) { mActive = active; }

      bool active() const { return mActive; }

      void setLabelLayer( bool toLabel ) { mLabelLayer = toLabel; }

      bool labelLayer() const { return mLabelLayer; }

      QgsPalLayerSettings::ObstacleType obstacleType() const { return mObstacleType; }

      void setObstacleType( QgsPalLayerSettings::ObstacleType obstacleType ) { mObstacleType = obstacleType; }

      void setPriority( double priority );

      double priority() const { return mDefaultPriority; }

      void setLabelMode( LabelMode mode ) { mMode = mode; }

      LabelMode labelMode() const { return mMode; }

      void setMergeConnectedLines( bool merge ) { mMergeLines = merge; }

      bool mergeConnectedLines() const { return mMergeLines; }

      void setUpsidedownLabels( UpsideDownLabels ud ) { mUpsidedownLabels = ud; }

      UpsideDownLabels upsidedownLabels() const { return mUpsidedownLabels; }

      void setCentroidInside( bool forceInside ) { mCentroidInside = forceInside; }

      bool centroidInside() const { return mCentroidInside; }

      void setFitInPolygonOnly( bool fitInPolygon ) { mFitInPolygon = fitInPolygon; }

      bool fitInPolygonOnly() const { return mFitInPolygon; }

      bool registerFeature( QgsLabelFeature* label );

      void joinConnectedFeatures();

      int connectedFeatureId( QgsFeatureId featureId ) const;

      void chopFeaturesAtRepeatDistance();

    protected:
      QgsAbstractLabelProvider* mProvider; // not owned
      QString mName;

      QLinkedList<FeaturePart*> mFeatureParts;

      QList<FeaturePart*> mObstacleParts;

      Pal *pal;

      double mDefaultPriority;

      QgsPalLayerSettings::ObstacleType mObstacleType;
      bool mActive;
      bool mLabelLayer;
      bool mDisplayAll;
      bool mCentroidInside;
      bool mFitInPolygon;

      QgsPalLayerSettings::Placement mArrangement;
      LineArrangementFlags mArrangementFlags;
      LabelMode mMode;
      bool mMergeLines;

      UpsideDownLabels mUpsidedownLabels;

      // indexes (spatial and id)
      RTree<FeaturePart*, double, 2, double, 8, 4> *mFeatureIndex;
      QHash< QgsFeatureId, QgsLabelFeature*> mHashtable;

      //obstacle r-tree
      RTree<FeaturePart*, double, 2, double, 8, 4> *mObstacleIndex;

      QHash< QString, QLinkedList<FeaturePart*>* > mConnectedHashtable;
      QStringList mConnectedTexts;
      QHash< QgsFeatureId, int > mConnectedFeaturesIds;

      QMutex mMutex;

      Layer( QgsAbstractLabelProvider* provider, const QString& name, QgsPalLayerSettings::Placement arrangement, double defaultPriority, bool active, bool toLabel, Pal *pal, bool displayAll = false );

      void addFeaturePart( FeaturePart* fpart, const QString &labelText = QString() );

      void addObstaclePart( FeaturePart* fpart );

  };

} // end namespace pal

#endif