QGIS API Documentation  2.99.0-Master (cb63e82)
qgsmaprenderercustompainterjob.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsmaprenderercustompainterjob.h
3  --------------------------------------
4  Date : December 2013
5  Copyright : (C) 2013 by Martin Dobias
6  Email : wonder dot sk at gmail dot com
7  ***************************************************************************
8  * *
9  * This program is free software; you can redistribute it and/or modify *
10  * it under the terms of the GNU General Public License as published by *
11  * the Free Software Foundation; either version 2 of the License, or *
12  * (at your option) any later version. *
13  * *
14  ***************************************************************************/
15 
16 #ifndef QGSMAPRENDERERCUSTOMPAINTERJOB_H
17 #define QGSMAPRENDERERCUSTOMPAINTERJOB_H
18 
19 #include "qgis_core.h"
20 #include "qgsmaprendererjob.h"
21 
22 #include <QEventLoop>
23 
34 {
35  Q_OBJECT
36  public:
37  QgsMapRendererCustomPainterJob( const QgsMapSettings &settings, QPainter *painter );
39 
40  virtual void start() override;
41  virtual void cancel() override;
42  virtual void cancelWithoutBlocking() override;
43  virtual void waitForFinished() override;
44  virtual bool isActive() const override;
45  virtual bool usedCachedLabels() const override;
46  virtual QgsLabelingResults *takeLabelingResults() override;
47 
49  const LayerRenderJobs &jobs() const { return mLayerJobs; }
50 
63  void waitForFinishedWithEventLoop( QEventLoop::ProcessEventsFlags flags = QEventLoop::AllEvents );
64 
74  void renderSynchronously();
75 
76  private slots:
77  void futureFinished();
78 
79  private:
80  static void staticRender( QgsMapRendererCustomPainterJob *self ); // function to be used within the thread
81 
82  // these methods are called within worker thread
83  void doRender();
84 
85  QPainter *mPainter = nullptr;
86  QFuture<void> mFuture;
87  QFutureWatcher<void> mFutureWatcher;
88  std::unique_ptr< QgsLabelingEngine > mLabelingEngineV2;
89 
90  bool mActive;
91  LayerRenderJobs mLayerJobs;
92  LabelRenderJob mLabelJob;
93  bool mRenderSynchronously;
94 
95 };
96 
97 
98 #endif // QGSMAPRENDERERCUSTOMPAINTERJOB_H
const LayerRenderJobs & jobs() const
Job implementation that renders everything sequentially using a custom painter.
Abstract base class for map rendering implementations.
The QgsMapSettings class contains configuration for rendering of the map.
virtual void waitForFinished()=0
Block until the job has finished.
virtual void start()=0
Start the rendering job and immediately return.
virtual void cancel()=0
Stop the rendering job - does not return until the job has terminated.
virtual void cancelWithoutBlocking()=0
Triggers cancelation of the rendering job without blocking.
Class that stores computed placement from labeling engine.
virtual QgsLabelingResults * takeLabelingResults()=0
Get pointer to internal labeling engine (in order to get access to the results).
virtual bool isActive() const =0
Tell whether the rendering job is currently running in background.
virtual bool usedCachedLabels() const =0
Returns true if the render job was able to use a cached labeling solution.