kplitem.h

/***************************************************************************
                          kplitem.h  -  description
                             -------------------
 
    This file is a part of kpl - a program for graphical presentation of
    data sets and functions.
 
    begin                : Wed Aug 25 1999
    copyright            : (C) 2024 by Werner Stille
    email                : kpl@werner-stille.de
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   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 KPLITEM_H
#define KPLITEM_H
 
#include <QBrush>
#include <QPen>
#include <QPixmap>
#include <QString>
 
class QGraphicsItem;
class QPainter;
class QPointF;
class QRectF;
class KConfigGroup;
class QUrl;
 
class Q_DECL_EXPORT KplItem
{
public:
  enum FillStyle {
    NoBrush,         
    SolidPattern,    
    HorPattern,      
    VerPattern,      
    CrossPattern,    
    BDiagPattern,    
    FDiagPattern,    
    DiagCrossPattern 
  };
  enum ItemType {
    Frame = 1,   
    Array,       
    Function,    
    ParFunction, 
    Spline,      
    Array3D,     
    Function3D,  
    Legend,      
    Text,        
    Line,        
    Arrow,       
    Arc,         
    Rectangle,   
    Ellipse,     
    Image,       
    ScaleBar     
  };
  enum PenType {
    FramePen, 
    GridPen,  
    DataPen   
  };
  enum Symbol {
    Invisible = -17, 
    FilledOctagon,   
    FilledHourglass, 
    FilledTriangle,  
    FilledSquare,    
    FilledDiamond,   
    FilledCircle,    
    Umbrella,        
    Ypsilon,         
    Plus,            
    Cross,           
    OpenOctagon,     
    OpenHourglass,   
    OpenTriangle,    
    OpenSquare,      
    OpenDiamond,     
    Dot,             
    OpenCircle,      
    SolidLine,       
    DashLine1,       
    DashLine2,       
    DotLine1,        
    DashLine3,       
    DashDotLine,     
    DashLine4,       
    DashLine5,       
    DotLine2         
  };
  KplItem(double relSize = 1);
  KplItem(const KplItem& a);
  KplItem(const KConfigGroup* plo);
  virtual ~KplItem();
  static QUrl absoluteUrl(const QString& path, const QUrl& urlPlo);
  static QBrush createBrush(unsigned color, FillStyle fillStyle = NoBrush);
  static QPen createPen(double width, unsigned color, PenType penType,
                        Symbol symbol);
  static void paintSymbol(QPainter* painter, const QRectF& rect,
                          Symbol symbol = OpenCircle);
  static QPixmap pixmap(Symbol symbol);
  static QPixmap pixmap(QPen pen, Symbol symbol = SolidLine);
  void readPlo(const KConfigGroup* plo);
  static QString path(const QUrl& urlPlo, const QUrl& url,
                      bool absolute = false);
  inline double relSize() const { return m_relSize; };
  static void resetDashOffset();
  static unsigned rgb(const QString& color);
  static unsigned rgbQt1(unsigned rgb);
  inline void setRelSize(double relSize) { m_relSize = relSize; };
  void writePlo(KConfigGroup* plo, bool visible = true) const;
 
protected:
  QPen& changePenWidth(QPen& pen, double width) const;
  QPen createPen(QGraphicsItem* item, unsigned color = 0,
                 PenType penType = DataPen, Symbol symbol = SolidLine) const;
  static double parentWidth(const QGraphicsItem* item);
  double penWidth(const QGraphicsItem* item, PenType penType = DataPen) const;
  static double penWidthFactor(PenType penType);
  static double m_dashOffset;
  double m_relSize;
};
 
#endif