16#ifndef QGSMAPRENDERERJOB_H
17#define QGSMAPRENDERERJOB_H
21#include <QFutureWatcher>
26#include <QElapsedTimer>
57 LayerRenderJob() =
default;
60 LayerRenderJob(
const LayerRenderJob & ) =
delete;
63 LayerRenderJob &operator=(
const LayerRenderJob & ) =
delete;
65 LayerRenderJob( LayerRenderJob && );
66 LayerRenderJob &operator=( LayerRenderJob && );
74 void setContext( std::unique_ptr< QgsRenderContext > context ) { mContext = std::move( context ); }
88 QImage *img =
nullptr;
106 QImage *previewRenderImage =
nullptr;
109 bool imageInitialized =
false;
116 bool previewRenderImageInitialized =
false;
118 bool imageCanBeComposed()
const;
122 QPainter::CompositionMode blendMode = QPainter::CompositionMode_SourceOver;
124 double opacity = 1.0;
130 bool renderAboveLabels =
false;
140 bool completed =
false;
143 int renderingTime = -1;
154 int estimatedRenderingTime = 0;
184 std::unique_ptr<QPainter> maskPainter;
188 std::unique_ptr<QPaintDevice> maskPaintDevice;
194 bool maskRequiresLayerRasterization =
false;
200 LayerRenderJob *firstPassJob =
nullptr;
205 std::unique_ptr<QPicture> picture;
213 QList<QPair<LayerRenderJob *, int>> maskJobs;
216 std::unique_ptr< QgsRenderContext > mContext;
232 QImage *img =
nullptr;
235 std::unique_ptr<QPicture> picture;
238 std::vector< std::unique_ptr<QPainter> > maskPainters;
250 std::vector< std::unique_ptr<QPaintDevice> > maskPaintDevices;
261 bool canUseCache =
false;
263 bool complete =
false;
265 int renderingTime = -1;
267 QList< QPointer< QgsMapLayer > > participatingLayers;
383 Error(
const QString &lid,
const QString &msg )
392 typedef QList<QgsMapRendererJob::Error>
Errors;
434 int renderingTime()
const {
return mRenderingTime; }
454 void setLayerRenderingTimeHints( const QHash< QString,
int > &hints )
SIP_SKIP;
473 static const QString LABEL_PREVIEW_CACHE_ID
SIP_SKIP;
480 static const QString ELEVATION_MAP_CACHE_PREFIX
SIP_SKIP;
534 int mRenderingTime = 0;
549 bool mRecordRenderingTime =
true;
575 std::vector< LayerRenderJob > prepareJobs( QPainter *painter,
QgsLabelingEngine *labelingEngine2,
bool deferredPainterSet = false )
SIP_SKIP;
591 std::vector< LayerRenderJob > prepareSecondPassJobs( std::vector< LayerRenderJob > &firstPassJobs, LabelRenderJob &labelJob )
SIP_SKIP;
597 void initSecondPassJobs( std::vector< LayerRenderJob > &secondPassJobs, LabelRenderJob &labelJob ) const
SIP_SKIP;
601 const std::vector< LayerRenderJob > &jobs,
602 const LabelRenderJob &labelJob,
617 static
void composeSecondPass( std::vector< LayerRenderJob > &secondPassJobs, LabelRenderJob &labelJob,
bool forceVector = false )
SIP_SKIP;
620 void logRenderingTime( const std::vector< LayerRenderJob > &jobs, const std::vector< LayerRenderJob > &secondPassJobs, const LabelRenderJob &labelJob )
SIP_SKIP;
623 void cleanupJobs( std::vector< LayerRenderJob > &jobs )
SIP_SKIP;
626 void cleanupSecondPassJobs( std::vector< LayerRenderJob > &jobs )
SIP_SKIP;
633 void cleanupLabelJob( LabelRenderJob &job )
SIP_SKIP;
662 QImage *allocateImage( QString layerId );
668 QPainter *allocateImageAndPainter( QString layerId, QImage *&image, const
QgsRenderContext *context );
675 virtual
void startPrivate() = 0;
680 typedef std::pair<std::unique_ptr<QPicture>, QPainter * > PictureAndPainter;
683 PictureAndPainter allocatePictureAndPainter( const
QgsRenderContext *context );
Stores digital elevation model in a raster image which may get updated as a part of map layer renderi...
Abstract interface for use by classes that filter the features or attributes of a layer.
Abstract base class that can be used to intercept rendered labels from a labeling / rendering job.
QgsFeedback subclass for granular reporting of labeling engine progress.
The QgsLabelingEngine class provides map labeling functionality.
Class that stores computed placement from labeling engine.
Base class for utility classes that encapsulate information necessary for rendering of map layers.
Base class for all map layer types.
This class is responsible for keeping cache of rendered images resulting from a map rendering job.
Abstract base class for map rendering implementations.
virtual void waitForFinished()=0
Block until the job has finished.
void setCache(QgsMapRendererCache *cache)
Assign a cache to be used for reading and storing rendered images of individual layers.
QHash< QgsMapLayer *, int > perLayerRenderingTime() const
Returns the render time (in ms) per layer.
virtual bool usedCachedLabels() const =0
Returns true if the render job was able to use a cached labeling solution.
void setLabelSink(QgsLabelSink *sink)
Assigns the label sink which will take over responsibility for handling labels during the rendering j...
QHash< QString, int > mLayerRenderingTimeHints
Approximate expected layer rendering time per layer, by layer ID.
std::unique_ptr< QgsRenderedItemResults > mRenderedItemResults
Errors errors() const
List of errors that happened during the rendering job - available when the rendering has been finishe...
void layerRendered(const QString &layerId)
Emitted when a layer has completed rendering.
void renderingLayersFinished()
Emitted when the layers are rendered.
QElapsedTimer mRenderingStart
void finished()
emitted when asynchronous rendering is finished (or canceled).
const QgsFeatureFilterProvider * featureFilterProvider() const
Returns the feature filter provider used by the QgsRenderContext of each LayerRenderJob.
static const QgsSettingsEntryBool * settingsLogCanvasRefreshEvent
Settings entry log canvas refresh event.
QgsMapRendererJob(const QgsMapSettings &settings)
~QgsMapRendererJob() override
void start()
Start the rendering job and immediately return.
void layerRenderingStarted(const QString &layerId)
Emitted just before rendering starts for a particular layer.
QStringList mLayersRedrawnFromCache
QStringList layersRedrawnFromCache() const
Returns a list of the layer IDs for all layers which were redrawn from cached images.
QList< QgsMapRendererJob::Error > Errors
QHash< QgsWeakMapLayerPointer, int > mPerLayerRenderingTime
Render time (in ms) per layer, by layer ID.
QgsRenderedItemResults * takeRenderedItemResults()
Takes the rendered item results from the map render job and returns them.
virtual bool isActive() const =0
Tell whether the rendering job is currently running in background.
QgsLabelingEngineFeedback * labelingEngineFeedback()
Returns the associated labeling engine feedback object.
virtual QgsLabelingResults * takeLabelingResults()=0
Gets pointer to internal labeling engine (in order to get access to the results).
virtual void cancel()=0
Stop the rendering job - does not return until the job has terminated.
static const QgsSettingsEntryString * settingsMaskBackend
Settings entry for mask painting backend engine.
virtual void cancelWithoutBlocking()=0
Triggers cancellation of the rendering job without blocking.
QgsLabelSink * labelSink() const
Returns the label sink associated to this rendering job.
bool prepareLabelCache() const
Prepares the cache for storing the result of labeling.
Intermediate base class adding functionality that allows client to query the rendered image.
QgsMapRendererQImageJob(const QgsMapSettings &settings)
virtual QImage renderedImage()=0
Gets a preview/resulting image.
The QgsMapSettings class contains configuration for rendering of the map.
This class allows the creation of mask ids based on the different label layers and to give a mask id ...
A rectangle specified with double values.
Contains information about the context of a rendering operation.
Stores collated details of rendered items during a map rendering operation.
A boolean settings entry.
QPointer< QgsMapLayer > QgsWeakMapLayerPointer
Weak pointer for QgsMapLayer.
Error(const QString &lid, const QString &msg)