File indexing completed on 2024-05-19 04:26:58

 /*
  *  SPDX-FileCopyrightText: 2016 Boudewijn Rempt <boud@valdyas.org>
  *
  *  SPDX-License-Identifier: LGPL-2.0-or-later
  */
 #ifndef LIBKIS_VIEW_H
 #define LIBKIS_VIEW_H
 
 #include <QObject>
 
 #include "kritalibkis_export.h"
 #include "libkis.h"
 
 class ManagedColor;
 class Resource;
 class Scratchpad;
 class Node;
 class KisView;
 
 /**
  * View represents one view on a document. A document can be
  * shown in more than one view at a time.
  */
 class KRITALIBKIS_EXPORT View : public QObject
 {
     Q_OBJECT
     Q_DISABLE_COPY(View)
 
 public:
     explicit View(KisView *view, QObject *parent = 0);
     ~View() override;
 
     bool operator==(const View &other) const;
     bool operator!=(const View &other) const;
 
 public Q_SLOTS:
 
     /**
      * @return the window this view is shown in.
      */
     Window* window() const;
 
     /**
      * @return the document this view is showing.
      */
     Document* document() const;
 
     /**
      * Reset the view to show @p document.
      */
     void setDocument(Document *document);
 
     /**
      * @return true if the current view is visible, false if not.
      */
     bool visible() const;
 
     /**
      * Make the current view visible.
      */
     void setVisible();
 
     /**
      * @return the canvas this view is showing. The canvas controls
      * things like zoom and rotation.
      */
     Canvas* canvas() const;
 
     /**
      * @brief activateResource activates the given resource.
      * @param resource: a pattern, gradient or paintop preset
      */
     void activateResource(Resource *resource);
 
 
 
     /**
      * @brief foregroundColor allows access to the currently active color.
      * This is nominally per canvas/view, but in practice per mainwindow.
      * @code
 color = Application.activeWindow().activeView().foregroundColor()
 components = color.components()
 components[0] = 1.0
 components[1] = 0.6
 components[2] = 0.7
 color.setComponents(components)
 Application.activeWindow().activeView().setForeGroundColor(color)
      * @endcode
      */
     ManagedColor *foregroundColor() const;
     void setForeGroundColor(ManagedColor *color);
 
     ManagedColor *backgroundColor() const;
     void setBackGroundColor(ManagedColor *color);
 
     Resource *currentBrushPreset() const;
     void setCurrentBrushPreset(Resource *resource);
 
     Resource *currentPattern() const;
     void setCurrentPattern(Resource *resource);
 
     Resource *currentGradient() const;
     void setCurrentGradient(Resource *resource);
 
     QString currentBlendingMode() const;
     void setCurrentBlendingMode(const QString &blendingMode);
 
     float HDRExposure() const;
     void setHDRExposure(float exposure);
 
     float HDRGamma() const;
     void setHDRGamma(float gamma);
 
     qreal paintingOpacity() const;
     void setPaintingOpacity(qreal opacity);
 
     qreal brushSize() const;
     void setBrushSize(qreal brushSize);
 
     qreal brushRotation() const;
     void setBrushRotation(qreal brushRotation);
 
     qreal paintingFlow() const;
     void setPaintingFlow(qreal flow);
 
     /**
      * @brief showFloatingMessage displays a floating message box on the top-left corner of the canvas
      * @param message: Message to be displayed inside the floating message box
      * @param icon: Icon to be displayed inside the message box next to the message string
      * @param timeout: Milliseconds until the message box disappears
      * @param priority: 0 = High, 1 = Medium, 2 = Low. Higher priority
      * messages will be displayed in place of lower priority messages
      */
     void showFloatingMessage(const QString &message, const QIcon& icon, int timeout, int priority);
 
     /**
      * @brief selectedNodes returns a list of Nodes that are selected in this view.
      *
      *
 @code
 from krita import *
 w = Krita.instance().activeWindow()
 v = w.activeView()
 selected_nodes = v.selectedNodes()
 print(selected_nodes)
 @endcode
      *
      *
      * @return a list of Node objects which may be empty.
      */
     QList<Node *> selectedNodes() const;
 
     /**
      * @brief flakeToDocumentTransform
      * The transformation of the document relative to the view without rotation and mirroring
      * @return QTransform
      */
     QTransform flakeToDocumentTransform() const;
 
     /**
      * @brief flakeToCanvasTransform
      * The transformation of the canvas relative to the view without rotation and mirroring
      * @return QTransform
      */
     QTransform flakeToCanvasTransform() const;
 
     /**
      * @brief flakeToImageTransform
      * The transformation of the image relative to the view without rotation and mirroring
      * @return QTransform
      */
     QTransform flakeToImageTransform() const;
 
 private:
 
     friend class Window;
     friend class Scratchpad;
 
 
     KisView *view();
 
     struct Private;
     Private *const d;
 
 };
 
 #endif // LIBKIS_VIEW_H