mirror of
https://github.com/qgis/QGIS.git
synced 2025-03-04 00:30:59 -05:00
0a0c33dcf2
The geometry cache was only used for few geometry editing operations anyway. In earlier versions of QGIS the geometry cache was also used by old snapping classes which have been replaced by QgsPointLocator that also keeps a spatial index of geometries and it is not rebuilt on every re-render. Reasons for removal: - geometry cache was repopulated on every redraw of layers in editing mode, slowing down rendering - data structure for the cache was a simple map with features accessed by their ID (no spatial index) - the cache was only getting refreshed for the current view of the main map canvas (not a generic cache) - not used for snapping anymore where caching was important to avoid roundtrips to data provider
107 lines
3.1 KiB
Plaintext
107 lines
3.1 KiB
Plaintext
class QgsMapRendererJob : QObject
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsmaprendererjob.h>
|
|
%End
|
|
|
|
public:
|
|
|
|
QgsMapRendererJob( const QgsMapSettings &settings );
|
|
|
|
virtual ~QgsMapRendererJob();
|
|
|
|
//! Start the rendering job and immediately return.
|
|
//! Does nothing if the rendering is already in progress.
|
|
virtual void start() = 0;
|
|
|
|
//! Stop the rendering job - does not return until the job has terminated.
|
|
//! Does nothing if the rendering is not active.
|
|
virtual void cancel() = 0;
|
|
|
|
virtual void cancelWithoutBlocking() = 0;
|
|
|
|
//! Block until the job has finished.
|
|
virtual void waitForFinished() = 0;
|
|
|
|
//! Tell whether the rendering job is currently running in background.
|
|
virtual bool isActive() const = 0;
|
|
|
|
virtual bool usedCachedLabels() const = 0;
|
|
|
|
//! Get pointer to internal labeling engine (in order to get access to the results)
|
|
virtual QgsLabelingResults *takeLabelingResults() = 0 /Transfer/;
|
|
|
|
//! @note Added in QGIS 3.0
|
|
//! Set the feature filter provider used by the QgsRenderContext of
|
|
//! each LayerRenderJob.
|
|
//! Ownership is not transferred and the provider must not be deleted
|
|
//! before the render job.
|
|
void setFeatureFilterProvider( const QgsFeatureFilterProvider *f );
|
|
|
|
//! @note Added in QGIS 3.0
|
|
//! Returns the feature filter provider used by the QgsRenderContext of
|
|
//! each LayerRenderJob.
|
|
const QgsFeatureFilterProvider *featureFilterProvider() const;
|
|
|
|
struct Error
|
|
{
|
|
Error( const QString &lid, const QString &msg );
|
|
|
|
QString layerID;
|
|
QString message;
|
|
};
|
|
|
|
typedef QList<QgsMapRendererJob::Error> Errors;
|
|
|
|
//! List of errors that happened during the rendering job - available when the rendering has been finished
|
|
Errors errors() const;
|
|
|
|
|
|
//! Assign a cache to be used for reading and storing rendered images of individual layers.
|
|
//! Does not take ownership of the object.
|
|
void setCache( QgsMapRendererCache *cache );
|
|
|
|
//! Find out how long it took to finish the job (in milliseconds)
|
|
int renderingTime() const;
|
|
|
|
/**
|
|
* Return map settings with which this job was started.
|
|
* @return A QgsMapSettings instance with render settings
|
|
* @note added in 2.8
|
|
*/
|
|
const QgsMapSettings &mapSettings() const;
|
|
|
|
signals:
|
|
/**
|
|
* Emitted when the layers are rendered.
|
|
* Rendering labels is not yet done. If the fully rendered layer including labels is required use
|
|
* finished() instead.
|
|
*
|
|
* @note Added in QGIS 3.0
|
|
*/
|
|
void renderingLayersFinished();
|
|
|
|
//! emitted when asynchronous rendering is finished (or canceled).
|
|
void finished();
|
|
|
|
};
|
|
|
|
|
|
/** Intermediate base class adding functionality that allows client to query the rendered image.
|
|
* The image can be queried even while the rendering is still in progress to get intermediate result
|
|
*
|
|
* @note added in 2.4
|
|
*/
|
|
class QgsMapRendererQImageJob : QgsMapRendererJob
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsmaprendererjob.h>
|
|
%End
|
|
|
|
public:
|
|
QgsMapRendererQImageJob( const QgsMapSettings &settings );
|
|
|
|
//! Get a preview/resulting image
|
|
virtual QImage renderedImage() = 0;
|
|
};
|