qgsmapcanvas.cpp

Go to the documentation of this file.

/***************************************************************************
qgsmapcanvas.cpp  -  description
------------------ -
begin                : Sun Jun 30 2002
copyright            : (C) 2002 by Gary E.Sherman
email                : sherman at mrcc.com
***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 ***************************************************************************/
 
#include "qgsmapcanvas.h"
 
#include <cmath>
#include <memory>
 
#include "qgis.h"
#include "qgs2dmapcontroller.h"
#include "qgsannotationlayer.h"
#include "qgsapplication.h"
#include "qgscoordinatereferencesystemregistry.h"
#include "qgscoordinatereferencesystemutils.h"
#include "qgscoordinatetransformcontext.h"
#include "qgscustomdrophandler.h"
#include "qgsexception.h"
#include "qgsexpressioncontextutils.h"
#include "qgsfeatureiterator.h"
#include "qgsgrouplayer.h"
#include "qgsimagecache.h"
#include "qgslabelingresults.h"
#include "qgslogger.h"
#include "qgsmapcanvasannotationitem.h"
#include "qgsmapcanvasmap.h"
#include "qgsmapcanvassnappingutils.h"
#include "qgsmaplayer.h"
#include "qgsmaplayerelevationproperties.h"
#include "qgsmaplayertemporalproperties.h"
#include "qgsmaplayerutils.h"
#include "qgsmapmouseevent.h"
#include "qgsmaprenderercache.h"
#include "qgsmaprenderercustompainterjob.h"
#include "qgsmaprendererjob.h"
#include "qgsmaprendererparalleljob.h"
#include "qgsmaprenderersequentialjob.h"
#include "qgsmapsettingsutils.h"
#include "qgsmapthemecollection.h"
#include "qgsmaptoolpan.h"
#include "qgsmaptopixel.h"
#include "qgsmessagebar.h"
#include "qgsmessagelog.h"
#include "qgsmimedatautils.h"
#include "qgsoverlaywidgetlayout.h"
#include "qgspainting.h"
#include "qgsproject.h"
#include "qgsprojectionselectiondialog.h"
#include "qgsprojectviewsettings.h"
#include "qgsreferencedgeometry.h"
#include "qgsrendereditemresults.h"
#include "qgsrubberband.h"
#include "qgsruntimeprofiler.h"
#include "qgsscreenhelper.h"
#include "qgssettings.h"
#include "qgssettingsentryenumflag.h"
#include "qgssettingsentryimpl.h"
#include "qgssettingsregistrygui.h"
#include "qgssettingstree.h"
#include "qgsstatusbar.h"
#include "qgssvgcache.h"
#include "qgssymbollayerutils.h"
#include "qgstemporalcontroller.h"
#include "qgstemporalnavigationobject.h"
#include "qgsuserinputwidget.h"
#include "qgsvectorlayer.h"
#include "qgsvectortilelayer.h"
 
#include <QApplication>
#include <QClipboard>
#include <QCursor>
#include <QDir>
#include <QFile>
#include <QGraphicsItem>
#include <QGraphicsScene>
#include <QGraphicsView>
#include <QKeyEvent>
#include <QMenu>
#include <QPaintEvent>
#include <QPainter>
#include <QPixmap>
#include <QPropertyAnimation>
#include <QRect>
#include <QResizeEvent>
#include <QScreen>
#include <QString>
#include <QStringList>
#include <QTextStream>
#include <QVariantAnimation>
#include <QWheelEvent>
#include <QWindow>
#include <QtGlobal>
 
#include "moc_qgsmapcanvas.cpp"
 
using namespace Qt::StringLiterals;
 
const QgsSettingsEntryString *QgsMapCanvas::settingsCustomCoordinateCrs = new QgsSettingsEntryString( u"custom-coordinate-crs"_s, QgsSettingsTree::sTreeMap, QString() );
const QgsSettingsEntryBool *QgsMapCanvas::settingsMainCanvasPreviewJobs
  = new QgsSettingsEntryBool( u"main-canvas-preview-jobs"_s, QgsSettingsTree::sTreeRendering, true, u"Whether the main map canvas displays preview tiles while rendering"_s );
const QgsSettingsEntryBool *QgsMapCanvas::settingsEnableRenderCaching
  = new QgsSettingsEntryBool( u"enable-render-caching"_s, QgsSettingsTree::sTreeRendering, true, u"Whether map rendering uses a cache to speed up redraws"_s );

//TODO QGIS 5.0 - remove
class QgsMapCanvas::CanvasProperties
{
  public:
    CanvasProperties() = default;

    bool mouseButtonDown { false };

    QPoint mouseLastXY;

    QPoint rubberStartPoint;

    bool panSelectorDown { false };
};
 
 
QgsMapCanvas::QgsMapCanvas( QWidget *parent )
  : QGraphicsView( parent )
  , mCanvasProperties( new CanvasProperties )
  , mExpressionContextScope( tr( "Map Canvas" ) )
{
  mScene = new QGraphicsScene();
  mLayout = new QgsOverlayWidgetLayout();
  setLayout( mLayout );
 
  setScene( mScene );
  setHorizontalScrollBarPolicy( Qt::ScrollBarAlwaysOff );
  setVerticalScrollBarPolicy( Qt::ScrollBarAlwaysOff );
  setMouseTracking( true );
  setFocusPolicy( Qt::StrongFocus );
 
  mScreenHelper = new QgsScreenHelper( this );
  connect( mScreenHelper, &QgsScreenHelper::screenDpiChanged, this, &QgsMapCanvas::updateDevicePixelFromScreen );
 
  mResizeTimer = new QTimer( this );
  mResizeTimer->setSingleShot( true );
  connect( mResizeTimer, &QTimer::timeout, this, &QgsMapCanvas::refresh );
 
  mRefreshTimer = new QTimer( this );
  mRefreshTimer->setSingleShot( true );
  connect( mRefreshTimer, &QTimer::timeout, this, &QgsMapCanvas::refreshMap );
 
  // create map canvas item which will show the map
  mMap = new QgsMapCanvasMap( this );
 
  // project handling
  connect( QgsProject::instance(), &QgsProject::readProject, this, &QgsMapCanvas::readProject );
  connect( QgsProject::instance(), &QgsProject::writeProject, this, &QgsMapCanvas::writeProject );
 
  connect( QgsProject::instance()->mainAnnotationLayer(), &QgsMapLayer::repaintRequested, this, &QgsMapCanvas::layerRepaintRequested );
  connect( QgsProject::instance()->mapThemeCollection(), &QgsMapThemeCollection::mapThemeChanged, this, &QgsMapCanvas::mapThemeChanged );
  connect( QgsProject::instance()->mapThemeCollection(), &QgsMapThemeCollection::mapThemeRenamed, this, &QgsMapCanvas::mapThemeRenamed );
  connect( QgsProject::instance()->mapThemeCollection(), &QgsMapThemeCollection::mapThemesChanged, this, &QgsMapCanvas::projectThemesChanged );
 
  {
    QgsScopedRuntimeProfile profile( "Map settings initialization" );
    mSettings.setFlag( Qgis::MapSettingsFlag::DrawEditingInfo );
    mSettings.setFlag( Qgis::MapSettingsFlag::UseRenderingOptimization );
    mSettings.setFlag( Qgis::MapSettingsFlag::RenderPartialOutput );
    mSettings.setFlag( Qgis::MapSettingsFlag::DrawLabelSelection );
    mSettings.setEllipsoid( QgsProject::instance()->ellipsoid() );
    connect( QgsProject::instance(), &QgsProject::ellipsoidChanged, this, [this] {
      mSettings.setEllipsoid( QgsProject::instance()->ellipsoid() );
      refresh();
    } );
    mSettings.setTransformContext( QgsProject::instance()->transformContext() );
    connect( QgsProject::instance(), &QgsProject::transformContextChanged, this, [this] {
      mSettings.setTransformContext( QgsProject::instance()->transformContext() );
      emit transformContextChanged();
      refresh();
    } );
 
    mSettings.setScaleMethod( QgsProject::instance()->scaleMethod() );
    connect( QgsProject::instance(), &QgsProject::scaleMethodChanged, this, [this] {
      mSettings.setScaleMethod( QgsProject::instance()->scaleMethod() );
      updateScale();
      refresh();
    } );
 
    connect( QgsApplication::coordinateReferenceSystemRegistry(), &QgsCoordinateReferenceSystemRegistry::userCrsChanged, this, [this] {
      QgsCoordinateReferenceSystem crs = mSettings.destinationCrs();
      crs.updateDefinition();
      if ( mSettings.destinationCrs() != crs )
      {
        // user crs has changed definition, refresh the map
        setDestinationCrs( crs );
      }
    } );
  }
 
  // refresh canvas when a remote svg/image has finished downloading
  connect( QgsApplication::svgCache(), &QgsSvgCache::remoteSvgFetched, this, &QgsMapCanvas::redrawAllLayers );
  connect( QgsApplication::imageCache(), &QgsImageCache::remoteImageFetched, this, &QgsMapCanvas::redrawAllLayers );
  // refresh canvas when project color scheme is changed -- if layers use project colors, they need to be redrawn
  connect( QgsProject::instance(), &QgsProject::projectColorsChanged, this, &QgsMapCanvas::redrawAllLayers );
 
  //segmentation parameters
  mSettings.setSegmentationTolerance( QgsSettingsRegistryGui::settingsSegmentationTolerance->value() );
  mSettings.setSegmentationToleranceType( QgsSettingsRegistryGui::settingsSegmentationToleranceType->value() );
 
  mWheelZoomFactor = QgsSettingsRegistryGui::settingsZoomFactor->value();
 
  QSize s = viewport()->size();
  mSettings.setOutputSize( s );
 
  mSettings.setRendererUsage( Qgis::RendererUsage::View );
 
  setSceneRect( 0, 0, s.width(), s.height() );
  mScene->setSceneRect( QRectF( 0, 0, s.width(), s.height() ) );
 
  moveCanvasContents( true );
 
  connect( &mMapUpdateTimer, &QTimer::timeout, this, &QgsMapCanvas::mapUpdateTimeout );
  mMapUpdateTimer.setInterval( 250 );
 
#ifdef Q_OS_WIN
  // Enable touch event on Windows.
  // Qt on Windows needs to be told it can take touch events or else it ignores them.
  grabGesture( Qt::PinchGesture );
  grabGesture( Qt::TapAndHoldGesture );
  viewport()->setAttribute( Qt::WA_AcceptTouchEvents );
#endif
 
  mPreviewEffect = new QgsPreviewEffect( this );
  viewport()->setGraphicsEffect( mPreviewEffect );
 
  mZoomCursor = QgsApplication::getThemeCursor( QgsApplication::Cursor::ZoomIn );
 
  connect( &mAutoRefreshTimer, &QTimer::timeout, this, &QgsMapCanvas::autoRefreshTriggered );
 
  connect( this, &QgsMapCanvas::extentsChanged, this, &QgsMapCanvas::updateCanvasItemPositions );
 
  setInteractive( false );
 
  // make sure we have the same default in QgsMapSettings and the scene's background brush
  // (by default map settings has white bg color, scene background brush is black)
  setCanvasColor( mSettings.backgroundColor() );
 
  setTemporalRange( mSettings.temporalRange() );
  refresh();
}
 
 
QgsMapCanvas::~QgsMapCanvas()
{
  if ( mMapTool )
  {
    mMapTool->deactivate();
    disconnect( mMapTool, &QObject::destroyed, this, &QgsMapCanvas::mapToolDestroyed );
    mMapTool = nullptr;
  }
 
  // we also clear the canvas pointer for all child map tools. We're now in a partially destroyed state and it's
  // no longer safe for map tools to try to cleanup things in the canvas during their destruction (such as removing
  // associated canvas items)
  // NOTE -- it may be better to just delete the map tool children here upfront?
  const QList<QgsMapTool *> tools = findChildren<QgsMapTool *>();
  for ( QgsMapTool *tool : tools )
  {
    tool->mCanvas = nullptr;
  }
 
  cancelJobs();
 
  // delete canvas items prior to deleting the canvas
  // because they might try to update canvas when it's
  // already being destructed, ends with segfault
  qDeleteAll( mScene->items() );
 
  mScene->deleteLater(); // crashes in python tests on windows
}
 
void QgsMapCanvas::addOverlayWidget( QWidget *widget, Qt::Edge edge )
{
  mLayout->addWidget( widget, edge );
}
 
void QgsMapCanvas::cancelJobs()
{
  // rendering job may still end up writing into canvas map item
  // so kill it before deleting canvas items
  if ( mJob )
  {
    whileBlocking( mJob )->cancel();
    delete mJob;
    mJob = nullptr;
  }
 
  for ( auto previewJob = mPreviewJobs.constBegin(); previewJob != mPreviewJobs.constEnd(); ++previewJob )
  {
    if ( *previewJob )
    {
      whileBlocking( *previewJob )->cancel();
      delete *previewJob;
    }
  }
  mPreviewJobs.clear();
}
 
void QgsMapCanvas::setMagnificationFactor( double factor, const QgsPointXY *center )
{
  // do not go higher or lower than min max magnification ratio
  double magnifierMin = QgsGuiUtils::CANVAS_MAGNIFICATION_MIN;
  double magnifierMax = QgsGuiUtils::CANVAS_MAGNIFICATION_MAX;
  factor = std::clamp( factor, magnifierMin, magnifierMax );
 
  // the magnifier widget is in integer percent
  if ( !qgsDoubleNear( factor, mSettings.magnificationFactor(), 0.01 ) )
  {
    mSettings.setMagnificationFactor( factor, center );
    refresh();
    emit magnificationChanged( factor );
  }
}
 
double QgsMapCanvas::magnificationFactor() const
{
  return mSettings.magnificationFactor();
}
 
void QgsMapCanvas::enableAntiAliasing( bool flag )
{
  mSettings.setFlag( Qgis::MapSettingsFlag::Antialiasing, flag );
  mSettings.setFlag( Qgis::MapSettingsFlag::HighQualityImageTransforms, flag );
}
 
bool QgsMapCanvas::antiAliasingEnabled() const
{
  return mSettings.testFlag( Qgis::MapSettingsFlag::Antialiasing );
}
 
void QgsMapCanvas::enableMapTileRendering( bool flag )
{
  mSettings.setFlag( Qgis::MapSettingsFlag::RenderMapTile, flag );
}
 
QgsMapLayer *QgsMapCanvas::layer( int index )
{
  QList<QgsMapLayer *> layers = mapSettings().layers();
  if ( index >= 0 && index < layers.size() )
    return layers[index];
  else
    return nullptr;
}
 
QgsMapLayer *QgsMapCanvas::layer( const QString &id )
{
  // first check for layers from canvas map settings
  const QList<QgsMapLayer *> layers = mapSettings().layers();
  for ( QgsMapLayer *layer : layers )
  {
    if ( layer && layer->id() == id )
      return layer;
  }
 
  // else fallback to searching project layers
  // TODO: allow a specific project to be associated with a canvas!
  return QgsProject::instance()->mapLayer( id );
}
 
void QgsMapCanvas::setCurrentLayer( QgsMapLayer *layer )
{
  if ( mCurrentLayer == layer )
    return;
 
  mCurrentLayer = layer;
  emit currentLayerChanged( layer );
}
 
double QgsMapCanvas::scale() const
{
  return mapSettings().scale();
}
 
bool QgsMapCanvas::isDrawing()
{
  return nullptr != mJob;
} // isDrawing
 
// return the current coordinate transform based on the extents and
// device size
const QgsMapToPixel *QgsMapCanvas::getCoordinateTransform()
{
  return &mapSettings().mapToPixel();
}
 
void QgsMapCanvas::setLayers( const QList<QgsMapLayer *> &layers )
{
  // following a theme => request denied!
  if ( !mTheme.isEmpty() )
    return;
 
  setLayersPrivate( layers );
}
 
void QgsMapCanvas::setFlags( Qgis::MapCanvasFlags flags )
{
  mFlags = flags;
}
 
Qgis::MapCanvasFlags QgsMapCanvas::flags() const
{
  return mFlags;
}
 
void QgsMapCanvas::setLayersPrivate( const QList<QgsMapLayer *> &layers )
{
  const QList<QgsMapLayer *> oldLayers = mSettings.layers();
 
  // update only if needed
  if ( layers == oldLayers )
    return;
 
  for ( QgsMapLayer *layer : oldLayers )
  {
    disconnect( layer, &QgsMapLayer::repaintRequested, this, &QgsMapCanvas::layerRepaintRequested );
    disconnect( layer, &QgsMapLayer::autoRefreshIntervalChanged, this, &QgsMapCanvas::updateAutoRefreshTimer );
    switch ( layer->type() )
    {
      case Qgis::LayerType::Vector:
      {
        QgsVectorLayer *vlayer = qobject_cast<QgsVectorLayer *>( layer );
        disconnect( vlayer, &QgsVectorLayer::selectionChanged, this, &QgsMapCanvas::selectionChangedSlot );
        disconnect( vlayer, &QgsVectorLayer::rendererChanged, this, &QgsMapCanvas::updateAutoRefreshTimer );
        break;
      }
 
      case Qgis::LayerType::VectorTile:
      {
        QgsVectorTileLayer *vtlayer = qobject_cast<QgsVectorTileLayer *>( layer );
        disconnect( vtlayer, &QgsVectorTileLayer::selectionChanged, this, &QgsMapCanvas::selectionChangedSlot );
        break;
      }
 
      case Qgis::LayerType::Raster:
      case Qgis::LayerType::Plugin:
      case Qgis::LayerType::Mesh:
      case Qgis::LayerType::Annotation:
      case Qgis::LayerType::PointCloud:
      case Qgis::LayerType::Group:
      case Qgis::LayerType::TiledScene:
        break;
    }
  }
 
  mSettings.setLayers( layers );
 
  for ( QgsMapLayer *layer : std::as_const( layers ) )
  {
    if ( !layer )
      continue;
    connect( layer, &QgsMapLayer::repaintRequested, this, &QgsMapCanvas::layerRepaintRequested );
    connect( layer, &QgsMapLayer::autoRefreshIntervalChanged, this, &QgsMapCanvas::updateAutoRefreshTimer );
 
    switch ( layer->type() )
    {
      case Qgis::LayerType::Vector:
      {
        QgsVectorLayer *vlayer = qobject_cast<QgsVectorLayer *>( layer );
        connect( vlayer, &QgsVectorLayer::selectionChanged, this, &QgsMapCanvas::selectionChangedSlot );
        connect( vlayer, &QgsVectorLayer::rendererChanged, this, &QgsMapCanvas::updateAutoRefreshTimer );
        break;
      }
 
      case Qgis::LayerType::VectorTile:
      {
        QgsVectorTileLayer *vtlayer = qobject_cast<QgsVectorTileLayer *>( layer );
        connect( vtlayer, &QgsVectorTileLayer::selectionChanged, this, &QgsMapCanvas::selectionChangedSlot );
        break;
      }
 
      case Qgis::LayerType::Raster:
      case Qgis::LayerType::Plugin:
      case Qgis::LayerType::Mesh:
      case Qgis::LayerType::Annotation:
      case Qgis::LayerType::PointCloud:
      case Qgis::LayerType::Group:
      case Qgis::LayerType::TiledScene:
        break;
    }
  }
 
  QgsDebugMsgLevel( u"Layers have changed, refreshing"_s, 2 );
  emit layersChanged();
 
  updateAutoRefreshTimer();
  refresh();
}
 
 
const QgsMapSettings &QgsMapCanvas::mapSettings() const
{
  return mSettings;
}
 
QgsMapSettings &QgsMapCanvas::mapSettings()
{
  return mSettings;
}
 
void QgsMapCanvas::setDestinationCrs( const QgsCoordinateReferenceSystem &crs )
{
  if ( mSettings.destinationCrs() == crs )
    return;
 
  // try to reproject current extent to the new one
  QgsRectangle rect;
  if ( !mSettings.visibleExtent().isEmpty() && crs.isSameCelestialBody( mSettings.destinationCrs() ) )
  {
    const QgsCoordinateTransform
      transform( mSettings.destinationCrs(), crs, QgsProject::instance(), Qgis::CoordinateTransformationFlag::BallparkTransformsAreAppropriate | Qgis::CoordinateTransformationFlag::IgnoreImpossibleTransformations );
    try
    {
      rect = transform.transformBoundingBox( mSettings.visibleExtent() );
    }
    catch ( QgsCsException &e )
    {
      Q_UNUSED( e )
      QgsDebugError( u"Transform error caught: %1"_s.arg( e.what() ) );
    }
  }
 
  // defer extent and scale changed signals until we've correctly
  // set the destination crs, otherwise slots which connect to these signals
  // may retrieve an outdated CRS for the map canvas
  mBlockExtentChangedSignal++;
  mBlockScaleChangedSignal++;
 
  if ( !rect.isEmpty() )
  {
    // we will be manually calling updateCanvasItemPositions() later, AFTER setting the updating the mSettings destination CRS, and we don't
    // want to do that twice!
    mBlockItemPositionUpdates++;
    setExtent( rect );
    mBlockItemPositionUpdates--;
  }
 
  mBlockExtentChangedSignal--;
  mBlockScaleChangedSignal--;
 
  mSettings.setDestinationCrs( crs );
  updateScale();
  emitExtentsChanged();
 
  updateCanvasItemPositions();
 
  QgsDebugMsgLevel( u"refreshing after destination CRS changed"_s, 2 );
  refresh();
 
  emit destinationCrsChanged();
}
 
void QgsMapCanvas::setTemporalController( QgsTemporalController *controller )
{
  if ( mController )
    disconnect( mController, &QgsTemporalController::updateTemporalRange, this, &QgsMapCanvas::setTemporalRange );
  if ( QgsTemporalNavigationObject *temporalNavigationObject = qobject_cast<QgsTemporalNavigationObject *>( mController ) )
  {
    disconnect( temporalNavigationObject, &QgsTemporalNavigationObject::navigationModeChanged, this, &QgsMapCanvas::temporalControllerModeChanged );
 
    // clear any existing animation settings from map settings. We don't do this on every render, as a 3rd party plugin
    // might be in control of these!
    mSettings.setFrameRate( -1 );
    mSettings.setCurrentFrame( -1 );
  }
 
  mController = controller;
  connect( mController, &QgsTemporalController::updateTemporalRange, this, &QgsMapCanvas::setTemporalRange );
  if ( QgsTemporalNavigationObject *temporalNavigationObject = qobject_cast<QgsTemporalNavigationObject *>( mController ) )
    connect( temporalNavigationObject, &QgsTemporalNavigationObject::navigationModeChanged, this, &QgsMapCanvas::temporalControllerModeChanged );
}
 
void QgsMapCanvas::temporalControllerModeChanged()
{
  if ( QgsTemporalNavigationObject *temporalNavigationObject = qobject_cast<QgsTemporalNavigationObject *>( mController ) )
  {
    switch ( temporalNavigationObject->navigationMode() )
    {
      case Qgis::TemporalNavigationMode::Animated:
      case Qgis::TemporalNavigationMode::Movie:
        mSettings.setFrameRate( temporalNavigationObject->framesPerSecond() );
        mSettings.setCurrentFrame( temporalNavigationObject->currentFrameNumber() );
        break;
 
      case Qgis::TemporalNavigationMode::Disabled:
      case Qgis::TemporalNavigationMode::FixedRange:
        // clear any existing animation settings from map settings. We don't do this on every render, as a 3rd party plugin
        // might be in control of these!
        mSettings.setFrameRate( -1 );
        mSettings.setCurrentFrame( -1 );
        break;
    }
  }
}
 
const QgsTemporalController *QgsMapCanvas::temporalController() const
{
  return mController;
}
 
void QgsMapCanvas::setMapSettingsFlags( Qgis::MapSettingsFlags flags )
{
  mSettings.setFlags( flags );
  clearCache();
  refresh();
}
 
const QgsLabelingResults *QgsMapCanvas::labelingResults( bool allowOutdatedResults ) const
{
  if ( !allowOutdatedResults && mLabelingResultsOutdated )
    return nullptr;
 
  return mLabelingResults.get();
}
 
const QgsRenderedItemResults *QgsMapCanvas::renderedItemResults( bool allowOutdatedResults ) const
{
  if ( !allowOutdatedResults && mRenderedItemResultsOutdated )
    return nullptr;
 
  return mRenderedItemResults.get();
}
 
void QgsMapCanvas::setCachingEnabled( bool enabled )
{
  if ( enabled == isCachingEnabled() )
    return;
 
  if ( mJob && mJob->isActive() )
  {
    // wait for the current rendering to finish, before touching the cache
    mJob->waitForFinished();
  }
 
  if ( enabled )
  {
    mCache = std::make_unique<QgsMapRendererCache>();
  }
  else
  {
    mCache.reset();
  }
  mPreviousRenderedItemResults.reset();
}
 
bool QgsMapCanvas::isCachingEnabled() const
{
  return nullptr != mCache.get();
}
 
void QgsMapCanvas::clearCache()
{
  if ( mCache )
    mCache->clear();
 
  if ( mPreviousRenderedItemResults )
    mPreviousRenderedItemResults.reset();
  if ( mRenderedItemResults )
    mRenderedItemResults.reset();
}
 
QgsMapRendererCache *QgsMapCanvas::cache()
{
  return mCache.get();
}
 
void QgsMapCanvas::setParallelRenderingEnabled( bool enabled )
{
  mUseParallelRendering = enabled;
}
 
bool QgsMapCanvas::isParallelRenderingEnabled() const
{
  return mUseParallelRendering;
}
 
void QgsMapCanvas::setMapUpdateInterval( int timeMilliseconds )
{
  mMapUpdateTimer.setInterval( timeMilliseconds );
}
 
int QgsMapCanvas::mapUpdateInterval() const
{
  return mMapUpdateTimer.interval();
}
 
 
QgsMapLayer *QgsMapCanvas::currentLayer()
{
  return mCurrentLayer;
}
 
QgsExpressionContextScope *QgsMapCanvas::defaultExpressionContextScope() const
{
  QgsExpressionContextScope *s = new QgsExpressionContextScope( QObject::tr( "Map Canvas" ) );
  s->setVariable( u"canvas_cursor_point"_s, QgsGeometry::fromPointXY( cursorPoint() ), true );
  return s;
}
 
QgsExpressionContext QgsMapCanvas::createExpressionContext() const
{
  //build the expression context
  QgsExpressionContext expressionContext;
  expressionContext
    << QgsExpressionContextUtils::globalScope()
    << QgsExpressionContextUtils::projectScope( QgsProject::instance() )
    << QgsExpressionContextUtils::atlasScope( nullptr )
    << QgsExpressionContextUtils::mapSettingsScope( mSettings );
  if ( QgsExpressionContextScopeGenerator *generator = dynamic_cast<QgsExpressionContextScopeGenerator *>( mController ) )
  {
    expressionContext << generator->createExpressionContextScope();
  }
  expressionContext << defaultExpressionContextScope() << new QgsExpressionContextScope( mExpressionContextScope );
  return expressionContext;
}
 
void QgsMapCanvas::refresh()
{
  if ( !mSettings.hasValidSettings() )
  {
    QgsDebugMsgLevel( u"CANVAS refresh - invalid settings -> nothing to do"_s, 2 );
    return;
  }
 
  if ( !mRenderFlag || mFrozen )
  {
    QgsDebugMsgLevel( u"CANVAS render flag off"_s, 2 );
    return;
  }
 
  if ( mRefreshScheduled )
  {
    QgsDebugMsgLevel( u"CANVAS refresh already scheduled"_s, 2 );
    return;
  }
 
  mRefreshScheduled = true;
 
  QgsDebugMsgLevel( u"CANVAS refresh scheduling"_s, 2 );
 
  // schedule a refresh
  mRefreshTimer->start( 1 );
 
  mLabelingResultsOutdated = true;
  mRenderedItemResultsOutdated = true;
}
 
QList<QgsMapLayer *> filterLayersForRender( const QList<QgsMapLayer *> &layers )
{
  QList<QgsMapLayer *> filteredLayers;
  for ( QgsMapLayer *layer : layers )
  {
    if ( QgsAnnotationLayer *annotationLayer = qobject_cast<QgsAnnotationLayer *>( layer ) )
    {
      if ( QgsMapLayer *linkedLayer = annotationLayer->linkedVisibilityLayer() )
      {
        if ( !layers.contains( linkedLayer ) )
          continue;
      }
    }
    filteredLayers.append( layer );
  }
 
  // remove any invalid layers
  filteredLayers.erase( std::remove_if( filteredLayers.begin(), filteredLayers.end(), []( QgsMapLayer *layer ) { return !layer || !layer->isValid(); } ), filteredLayers.end() );
 
  return filteredLayers;
}
 
void QgsMapCanvas::refreshMap()
{
  Q_ASSERT( mRefreshScheduled );
 
  QgsDebugMsgLevel( u"CANVAS refresh!"_s, 3 );
 
  stopRendering(); // if any...
  stopPreviewJobs();
 
  if ( mCacheInvalidations.testFlag( CacheInvalidationType::Temporal ) )
  {
    clearTemporalCache();
    mCacheInvalidations &= ~( static_cast<int>( CacheInvalidationType::Temporal ) );
  }
  if ( mCacheInvalidations.testFlag( CacheInvalidationType::Elevation ) )
  {
    clearElevationCache();
    mCacheInvalidations &= ~( static_cast<int>( CacheInvalidationType::Elevation ) );
  }
 
  mSettings.setExpressionContext( createExpressionContext() );
 
  // if using the temporal controller in animation mode, get the frame settings from that
  if ( QgsTemporalNavigationObject *temporalNavigationObject = dynamic_cast<QgsTemporalNavigationObject *>( mController ) )
  {
    switch ( temporalNavigationObject->navigationMode() )
    {
      case Qgis::TemporalNavigationMode::Animated:
      case Qgis::TemporalNavigationMode::Movie:
        mSettings.setFrameRate( temporalNavigationObject->framesPerSecond() );
        mSettings.setCurrentFrame( temporalNavigationObject->currentFrameNumber() );
        break;
 
      case Qgis::TemporalNavigationMode::Disabled:
      case Qgis::TemporalNavigationMode::FixedRange:
        break;
    }
  }
 
  mSettings.setPathResolver( QgsProject::instance()->pathResolver() );
 
  if ( !mTheme.isEmpty() )
  {
    // IMPORTANT: we MUST set the layer style overrides here! (At the time of writing this
    // comment) retrieving layer styles from the theme collection gives an XML snapshot of the
    // current state of the style. If we had stored the style overrides earlier (such as in
    // mapThemeChanged slot) then this xml could be out of date...
    // TODO: if in future QgsMapThemeCollection::mapThemeStyleOverrides is changed to
    // just return the style name, we can instead set the overrides in mapThemeChanged and not here
    mSettings.setLayerStyleOverrides( QgsProject::instance()->mapThemeCollection()->mapThemeStyleOverrides( mTheme ) );
  }
 
  // render main annotation layer above all other layers
  QgsMapSettings renderSettings = mSettings;
  QList<QgsMapLayer *> allLayers = renderSettings.layers();
  if ( mFlags & Qgis::MapCanvasFlag::ShowMainAnnotationLayer )
    allLayers.insert( 0, QgsProject::instance()->mainAnnotationLayer() );
 
  renderSettings.setLayers( filterLayersForRender( allLayers ) );
 
  // create the renderer job
 
  QgsApplication::profiler()->clear( u"rendering"_s );
 
  Q_ASSERT( !mJob );
  mJobCanceled = false;
  if ( mUseParallelRendering )
    mJob = new QgsMapRendererParallelJob( renderSettings );
  else
    mJob = new QgsMapRendererSequentialJob( renderSettings );
 
  connect( mJob, &QgsMapRendererJob::finished, this, &QgsMapCanvas::rendererJobFinished );
  mJob->setCache( mCache.get() );
  mJob->setLayerRenderingTimeHints( mLastLayerRenderTime );
 
  mJob->start();
 
  // from now on we can accept refresh requests again
  // this must be reset only after the job has been started, because
  // some providers (yes, it's you WCS and AMS!) during preparation
  // do network requests and start an internal event loop, which may
  // end up calling refresh() and would schedule another refresh,
  // deleting the one we have just started.
  mRefreshScheduled = false;
 
  mMapUpdateTimer.start();
 
  emit renderStarting();
}
 
void QgsMapCanvas::mapThemeChanged( const QString &theme )
{
  if ( theme == mTheme )
  {
    // set the canvas layers to match the new layers contained in the map theme
    // NOTE: we do this when the theme layers change and not when we are refreshing the map
    // as setLayers() sets up necessary connections to handle changes to the layers
    setLayersPrivate( QgsProject::instance()->mapThemeCollection()->mapThemeVisibleLayers( mTheme ) );
    // IMPORTANT: we don't set the layer style overrides here! (At the time of writing this
    // comment) retrieving layer styles from the theme collection gives an XML snapshot of the
    // current state of the style. If changes were made to the style then this xml
    // snapshot goes out of sync...
    // TODO: if in future QgsMapThemeCollection::mapThemeStyleOverrides is changed to
    // just return the style name, we can instead set the overrides here and not in refreshMap()
 
    clearCache();
    refresh();
  }
}
 
void QgsMapCanvas::mapThemeRenamed( const QString &theme, const QString &newTheme )
{
  if ( mTheme.isEmpty() || theme != mTheme )
  {
    return;
  }
 
  setTheme( newTheme );
  refresh();
}
 
void QgsMapCanvas::rendererJobFinished()
{
  QgsDebugMsgLevel( u"CANVAS finish! %1"_s.arg( !mJobCanceled ), 2 );
 
  mMapUpdateTimer.stop();
 
  notifyRendererErrors( mJob->errors() );
 
  if ( !mJobCanceled )
  {
    // take labeling results before emitting renderComplete, so labeling map tools
    // connected to signal work with correct results
    if ( !mJob->usedCachedLabels() )
    {
      mLabelingResults.reset( mJob->takeLabelingResults() );
    }
    mLabelingResultsOutdated = false;
 
    std::unique_ptr<QgsRenderedItemResults> renderedItemResults( mJob->takeRenderedItemResults() );
    // if a layer was redrawn from the cached version, we should copy any existing rendered item results from that layer
    if ( mRenderedItemResults )
    {
      renderedItemResults->transferResults( mRenderedItemResults.get(), mJob->layersRedrawnFromCache() );
    }
    if ( mPreviousRenderedItemResults )
    {
      // also transfer any results from previous renders which happened before this
      renderedItemResults->transferResults( mPreviousRenderedItemResults.get(), mJob->layersRedrawnFromCache() );
    }
 
    if ( mCache && !mPreviousRenderedItemResults )
      mPreviousRenderedItemResults = std::make_unique<QgsRenderedItemResults>( mJob->mapSettings().extent() );
 
    if ( mRenderedItemResults && mPreviousRenderedItemResults )
    {
      // for other layers which ARE present in the most recent rendered item results BUT were not part of this render, we
      // store the results in a temporary store in case they are later switched back on and the layer's image is taken
      // from the cache
      mPreviousRenderedItemResults->transferResults( mRenderedItemResults.get() );
    }
    if ( mPreviousRenderedItemResults )
    {
      mPreviousRenderedItemResults->eraseResultsFromLayers( mJob->mapSettings().layerIds() );
    }
 
    mRenderedItemResults = std::move( renderedItemResults );
    mRenderedItemResultsOutdated = false;
 
    QImage img = mJob->renderedImage();
 
    // emit renderComplete to get our decorations drawn and to handle computed statistics
    QPainter p( &img );
    emit renderComplete( &p );
 
    if ( QgsMapRendererJob::settingsLogCanvasRefreshEvent->value() )
    {
      QString logMsg = tr( "Canvas refresh: %1 ms" ).arg( mJob->renderingTime() );
      QgsMessageLog::logMessage( logMsg, tr( "Rendering" ) );
    }
 
    if ( mDrawRenderingStats )
    {
      int w = img.width(), h = img.height();
      QFont fnt = p.font();
      fnt.setBold( true );
      p.setFont( fnt );
      int lh = p.fontMetrics().height() * 2;
      QRect r( 0, h - lh, w, lh );
      p.setPen( Qt::NoPen );
      p.setBrush( QColor( 0, 0, 0, 110 ) );
      p.drawRect( r );
      p.setPen( Qt::white );
      QString msg = u"%1 :: %2 ms"_s.arg( mUseParallelRendering ? u"PARALLEL"_s : u"SEQUENTIAL"_s ).arg( mJob->renderingTime() );
      p.drawText( r, msg, QTextOption( Qt::AlignCenter ) );
    }
 
    p.end();
 
    mMap->setContent( img, imageRect( img, mSettings ) );
 
    mLastLayerRenderTime.clear();
    const auto times = mJob->perLayerRenderingTime();
    for ( auto it = times.constBegin(); it != times.constEnd(); ++it )
    {
      mLastLayerRenderTime.insert( it.key()->id(), it.value() );
    }
    if ( mUsePreviewJobs && !mRefreshAfterJob )
      startPreviewJobs();
  }
  else
  {
    mRefreshAfterJob = false;
  }
 
  // now we are in a slot called from mJob - do not delete it immediately
  // so the class is still valid when the execution returns to the class
  mJob->deleteLater();
  mJob = nullptr;
 
  emit mapCanvasRefreshed();
 
  if ( mRefreshAfterJob )
  {
    mRefreshAfterJob = false;
    refresh();
  }
}
 
void QgsMapCanvas::previewJobFinished()
{
  QgsMapRendererQImageJob *job = qobject_cast<QgsMapRendererQImageJob *>( sender() );
  Q_ASSERT( job );
 
  if ( mMap )
  {
    mMap->addPreviewImage( job->renderedImage(), job->mapSettings().visiblePolygon() );
    mPreviewJobs.removeAll( job );
 
    int number = job->property( "number" ).toInt();
    if ( number < 8 )
    {
      startPreviewJob( number + 1 );
    }
 
    delete job;
  }
}
 
QgsRectangle QgsMapCanvas::imageRect( const QImage &img, const QgsMapSettings &mapSettings )
{
  // This is a hack to pass QgsMapCanvasItem::setRect what it
  // expects (encoding of position and size of the item)
  const QgsMapToPixel &m2p = mapSettings.mapToPixel();
  QgsPointXY topLeft = m2p.toMapCoordinates( 0, 0 );
#ifdef QGISDEBUG
  // do not assert this, since it might lead to crashes when changing screen while rendering
  if ( img.devicePixelRatio() != mapSettings.devicePixelRatio() )
  {
    QgsLogger::warning( u"The renderer map has a wrong device pixel ratio"_s );
  }
#endif
  double res = m2p.mapUnitsPerPixel() / img.devicePixelRatioF();
  QgsRectangle rect( topLeft.x(), topLeft.y(), topLeft.x() + img.width() * res, topLeft.y() - img.height() * res );
  return rect;
}
 
QgsStatusBar *QgsMapCanvas::statusBar()
{
  return mStatusBar.data();
}
 
void QgsMapCanvas::setStatusBar( QgsStatusBar *bar )
{
  mStatusBar = bar;
}
 
void QgsMapCanvas::setMessageBar( QgsMessageBar *bar )
{
  mMessageBar = bar;
}
 
QgsMessageBar *QgsMapCanvas::messageBar()
{
  return mMessageBar.data();
}
 
void QgsMapCanvas::setUserInputWidget( QgsUserInputWidget *userInputWidget )
{
  mUserInputWidget = userInputWidget;
}
 
QgsUserInputWidget *QgsMapCanvas::userInputWidget()
{
  return mUserInputWidget.data();
}
 
bool QgsMapCanvas::previewJobsEnabled() const
{
  return mUsePreviewJobs;
}
 
void QgsMapCanvas::setPreviewJobsEnabled( bool enabled )
{
  mUsePreviewJobs = enabled;
}
 
void QgsMapCanvas::setCustomDropHandlers( const QVector<QPointer<QgsCustomDropHandler>> &handlers )
{
  mDropHandlers = handlers;
}
 
void QgsMapCanvas::clearTemporalCache()
{
  if ( mCache )
  {
    bool invalidateLabels = false;
    const QList<QgsMapLayer *> layerList = mapSettings().layers();
    for ( QgsMapLayer *layer : layerList )
    {
      bool alreadyInvalidatedThisLayer = false;
      if ( QgsVectorLayer *vl = qobject_cast<QgsVectorLayer *>( layer ) )
      {
        if ( vl->renderer() && QgsSymbolLayerUtils::rendererFrameRate( vl->renderer() ) > -1 )
        {
          // layer has an animated symbol assigned, so we have to redraw it regardless of whether
          // or not it has temporal settings
          mCache->invalidateCacheForLayer( layer );
          alreadyInvalidatedThisLayer = true;
          // we can't shortcut and "continue" here, as we still need to check whether the layer
          // will cause label invalidation using the logic below
        }
      }
 
      if ( layer->temporalProperties() && layer->temporalProperties()->isActive() )
      {
        if ( QgsVectorLayer *vl = qobject_cast<QgsVectorLayer *>( layer ) )
        {
          if ( vl->labelsEnabled() || vl->diagramsEnabled() || ( vl->renderer() && vl->renderer()->flags().testFlag( Qgis::FeatureRendererFlag::AffectsLabeling ) ) )
            invalidateLabels = true;
        }
 
        if ( layer->temporalProperties()->flags() & QgsTemporalProperty::FlagDontInvalidateCachedRendersWhenRangeChanges )
          continue;
 
        if ( !alreadyInvalidatedThisLayer )
        {
          mCache->invalidateCacheForLayer( layer );
        }
      }
      else if ( QgsGroupLayer *gl = qobject_cast<QgsGroupLayer *>( layer ) )
      {
        const QList<QgsMapLayer *> childLayerList = gl->childLayers();
        for ( QgsMapLayer *childLayer : childLayerList )
        {
          if ( childLayer->temporalProperties() && childLayer->temporalProperties()->isActive() )
          {
            if ( childLayer->temporalProperties()->flags() & QgsTemporalProperty::FlagDontInvalidateCachedRendersWhenRangeChanges )
              continue;
 
            mCache->invalidateCacheForLayer( layer );
            break;
          }
        }
      }
    }
 
    if ( invalidateLabels )
    {
      mCache->clearCacheImage( u"_labels_"_s );
      mCache->clearCacheImage( u"_preview_labels_"_s );
    }
  }
}
 
void QgsMapCanvas::clearElevationCache()
{
  if ( mCache )
  {
    bool invalidateLabels = false;
    const QList<QgsMapLayer *> layerList = mapSettings().layers();
    for ( QgsMapLayer *layer : layerList )
    {
      if ( layer->elevationProperties() && layer->elevationProperties()->hasElevation() )
      {
        if ( QgsVectorLayer *vl = qobject_cast<QgsVectorLayer *>( layer ) )
        {
          if ( vl->labelsEnabled() || vl->diagramsEnabled() || ( vl->renderer() && vl->renderer()->flags().testFlag( Qgis::FeatureRendererFlag::AffectsLabeling ) ) )
            invalidateLabels = true;
        }
 
        if ( layer->elevationProperties()->flags() & QgsMapLayerElevationProperties::FlagDontInvalidateCachedRendersWhenRangeChanges )
          continue;
 
        mCache->invalidateCacheForLayer( layer );
      }
      else if ( QgsGroupLayer *gl = qobject_cast<QgsGroupLayer *>( layer ) )
      {
        const QList<QgsMapLayer *> childLayerList = gl->childLayers();
        for ( QgsMapLayer *childLayer : childLayerList )
        {
          if ( childLayer->elevationProperties() && childLayer->elevationProperties()->hasElevation() )
          {
            if ( childLayer->elevationProperties()->flags() & QgsMapLayerElevationProperties::FlagDontInvalidateCachedRendersWhenRangeChanges )
              continue;
 
            mCache->invalidateCacheForLayer( layer );
            break;
          }
        }
      }
    }
 
    if ( invalidateLabels )
    {
      mCache->clearCacheImage( u"_labels_"_s );
      mCache->clearCacheImage( u"_preview_labels_"_s );
    }
  }
}
 
void QgsMapCanvas::showContextMenu( QgsMapMouseEvent *event )
{
  const QgsPointXY mapPoint = event->originalMapPoint();
 
  QMenu menu;
 
  QMenu *copyCoordinateMenu = new QMenu( tr( "Copy Coordinate" ), &menu );
  copyCoordinateMenu->setIcon( QgsApplication::getThemeIcon( u"/mActionEditCopy.svg"_s ) );
 
  auto addCoordinateFormat = [&, this]( const QString identifier, const QgsCoordinateReferenceSystem &crs ) {
    const QgsCoordinateTransform ct( mSettings.destinationCrs(), crs, mSettings.transformContext() );
    try
    {
      const QgsPointXY transformedPoint = ct.transform( mapPoint );
 
      // calculate precision based on visible map extent -- if user is zoomed in, we get better precision!
      int displayPrecision = 0;
      try
      {
        QgsCoordinateTransform extentTransform = ct;
        extentTransform.setBallparkTransformsAreAppropriate( true );
        QgsRectangle extentReproj = extentTransform.transformBoundingBox( extent() );
        const double mapUnitsPerPixel = ( extentReproj.width() / width() + extentReproj.height() / height() ) * 0.5;
        if ( mapUnitsPerPixel > 10 )
          displayPrecision = 0;
        else if ( mapUnitsPerPixel > 1 )
          displayPrecision = 1;
        else if ( mapUnitsPerPixel > 0.1 )
          displayPrecision = 2;
        else if ( mapUnitsPerPixel > 0.01 )
          displayPrecision = 3;
        else if ( mapUnitsPerPixel > 0.001 )
          displayPrecision = 4;
        else if ( mapUnitsPerPixel > 0.0001 )
          displayPrecision = 5;
        else if ( mapUnitsPerPixel > 0.00001 )
          displayPrecision = 6;
        else if ( mapUnitsPerPixel > 0.000001 )
          displayPrecision = 7;
        else if ( mapUnitsPerPixel > 0.0000001 )
          displayPrecision = 8;
        else
          displayPrecision = 9;
      }
      catch ( QgsCsException & )
      {
        displayPrecision = crs.mapUnits() == Qgis::DistanceUnit::Degrees ? 5 : 3;
      }
 
      const QList<Qgis::CrsAxisDirection> axisList = crs.axisOrdering();
      QString firstSuffix;
      QString secondSuffix;
      if ( axisList.size() >= 2 )
      {
        firstSuffix = QgsCoordinateReferenceSystemUtils::axisDirectionToAbbreviatedString( axisList.at( 0 ) );
        secondSuffix = QgsCoordinateReferenceSystemUtils::axisDirectionToAbbreviatedString( axisList.at( 1 ) );
      }
 
      QString firstNumber;
      QString secondNumber;
      if ( QgsCoordinateReferenceSystemUtils::defaultCoordinateOrderForCrs( crs ) == Qgis::CoordinateOrder::YX )
      {
        firstNumber = QString::number( transformedPoint.y(), 'f', displayPrecision );
        secondNumber = QString::number( transformedPoint.x(), 'f', displayPrecision );
      }
      else
      {
        firstNumber = QString::number( transformedPoint.x(), 'f', displayPrecision );
        secondNumber = QString::number( transformedPoint.y(), 'f', displayPrecision );
      }
 
      QAction *copyCoordinateAction = new QAction( u"%5 (%1%2, %3%4)"_s.arg( firstNumber, firstSuffix, secondNumber, secondSuffix, identifier ), &menu );
 
      connect( copyCoordinateAction, &QAction::triggered, this, [firstNumber, secondNumber, transformedPoint] {
        QClipboard *clipboard = QApplication::clipboard();
 
        const QString coordinates = firstNumber + ',' + secondNumber;
 
        //if we are on x11 system put text into selection ready for middle button pasting
        if ( clipboard->supportsSelection() )
        {
          clipboard->setText( coordinates, QClipboard::Selection );
        }
        clipboard->setText( coordinates, QClipboard::Clipboard );
      } );
      copyCoordinateMenu->addAction( copyCoordinateAction );
    }
    catch ( QgsCsException & )
    {}
  };
 
  addCoordinateFormat( tr( "Map CRS — %1" ).arg( mSettings.destinationCrs().userFriendlyIdentifier( Qgis::CrsIdentifierType::MediumString ) ), mSettings.destinationCrs() );
  QgsCoordinateReferenceSystem wgs84( u"EPSG:4326"_s );
  if ( mSettings.destinationCrs() != wgs84 && mSettings.destinationCrs().isSameCelestialBody( wgs84 ) )
    addCoordinateFormat( wgs84.userFriendlyIdentifier( Qgis::CrsIdentifierType::MediumString ), wgs84 );
 
  QgsSettings settings;
  const QString customCrsString = QgsMapCanvas::settingsCustomCoordinateCrs->value();
  if ( !customCrsString.isEmpty() )
  {
    QgsCoordinateReferenceSystem customCrs( customCrsString );
    if ( customCrs != mSettings.destinationCrs() && customCrs != QgsCoordinateReferenceSystem( u"EPSG:4326"_s ) )
    {
      addCoordinateFormat( customCrs.userFriendlyIdentifier( Qgis::CrsIdentifierType::MediumString ), customCrs );
    }
  }
  copyCoordinateMenu->addSeparator();
  QAction *setCustomCrsAction = new QAction( tr( "Set Custom CRS…" ), &menu );
  connect( setCustomCrsAction, &QAction::triggered, this, [this, customCrsString] {
    QgsProjectionSelectionDialog selector( this );
    selector.setCrs( QgsCoordinateReferenceSystem( customCrsString ) );
    if ( selector.exec() )
    {
      QgsMapCanvas::settingsCustomCoordinateCrs->setValue( selector.crs().authid().isEmpty() ? selector.crs().toWkt( Qgis::CrsWktVariant::Preferred ) : selector.crs().authid() );
    }
  } );
  copyCoordinateMenu->addAction( setCustomCrsAction );
 
  menu.addMenu( copyCoordinateMenu );
 
  if ( mMapTool )
    if ( !mapTool()->populateContextMenuWithEvent( &menu, event ) )
      mMapTool->populateContextMenu( &menu );
 
  emit contextMenuAboutToShow( &menu, event );
 
  if ( !menu.isEmpty() ) // menu can be empty after populateContextMenu() and contextMenuAboutToShow()
    menu.exec( event->globalPos() );
}
 
void QgsMapCanvas::notifyRendererErrors( const QgsMapRendererJob::Errors &errors )
{
  const QDateTime currentTime = QDateTime::currentDateTime();
 
  // remove errors too old
  for ( const QgsMapRendererJob::Error &error : errors )
  {
    const QString errorKey = error.layerID + ':' + error.message;
    if ( mRendererErrors.contains( errorKey ) )
    {
      const QDateTime sameErrorTime = mRendererErrors.value( errorKey );
 
      if ( sameErrorTime.secsTo( currentTime ) < 60 )
        continue;
    }
 
    mRendererErrors[errorKey] = currentTime;
 
    if ( QgsMapLayer *layer = QgsProject::instance()->mapLayer( error.layerID ) )
      emit renderErrorOccurred( error.message, layer );
  }
}
 
void QgsMapCanvas::updateDevicePixelFromScreen()
{
  mSettings.setDevicePixelRatio( static_cast<float>( devicePixelRatioF() ) );
  // TODO: QGIS 5 -> always respect screen dpi
  if ( QgsSettingsRegistryGui::settingsRespectScreenDPI->value() )
  {
    if ( window()->windowHandle() )
    {
      mSettings.setOutputDpi( window()->windowHandle()->screen()->physicalDotsPerInch() );
      mSettings.setDpiTarget( window()->windowHandle()->screen()->physicalDotsPerInch() );
    }
  }
  else
  {
    // Fallback: compatibility with QGIS <= 3.20; always assume low dpi screens
    mSettings.setOutputDpi( window()->windowHandle()->screen()->logicalDotsPerInch() );
    mSettings.setDpiTarget( window()->windowHandle()->screen()->logicalDotsPerInch() );
  }
  refresh();
}
 
void QgsMapCanvas::onElevationShadingRendererChanged()
{
  if ( !mProject )
    return;
  bool wasDeactivated = !mSettings.elevationShadingRenderer().isActive();
  mSettings.setElevationShadingRenderer( mProject->elevationShadingRenderer() );
  if ( mCache && wasDeactivated )
    mCache->clear();
  refresh();
}
 
void QgsMapCanvas::setTemporalRange( const QgsDateTimeRange &dateTimeRange )
{
  if ( temporalRange() == dateTimeRange )
    return;
 
  mSettings.setTemporalRange( dateTimeRange );
  mSettings.setIsTemporal( dateTimeRange.begin().isValid() || dateTimeRange.end().isValid() );
 
  emit temporalRangeChanged();
 
  // we need to discard any previously cached images which have temporal properties enabled, so that these will be updated when
  // the canvas is redrawn
  mCacheInvalidations |= CacheInvalidationType::Temporal;
 
  autoRefreshTriggered();
}
 
const QgsDateTimeRange &QgsMapCanvas::temporalRange() const
{
  return mSettings.temporalRange();
}
 
void QgsMapCanvas::installInteractionBlocker( QgsMapCanvasInteractionBlocker *blocker )
{
  mInteractionBlockers.append( blocker );
}
 
void QgsMapCanvas::removeInteractionBlocker( QgsMapCanvasInteractionBlocker *blocker )
{
  mInteractionBlockers.removeAll( blocker );
}
 
bool QgsMapCanvas::allowInteraction( QgsMapCanvasInteractionBlocker::Interaction interaction ) const
{
  for ( const QgsMapCanvasInteractionBlocker *block : mInteractionBlockers )
  {
    if ( block->blockCanvasInteraction( interaction ) )
      return false;
  }
  return true;
}
 
void QgsMapCanvas::setMapController( QgsAbstract2DMapController *controller )
{
  if ( mMapController )
  {
    delete mMapController;
    mMapController = nullptr;
  }
 
  if ( !controller )
    return;
 
  mMapController = controller;
  mMapController->setParent( this );
 
#if 0
  // connect high level signals to the canvas, e.g.
  connect( mMapController, &QgsAbstract2DMapController::zoomMap, this, []( double factor ) { zoomByFactor( factor ); } );
#endif
}
 
void QgsMapCanvas::mapUpdateTimeout()
{
  if ( mJob )
  {
    const QImage &img = mJob->renderedImage();
    mMap->setContent( img, imageRect( img, mSettings ) );
  }
}
 
void QgsMapCanvas::stopRendering()
{
  if ( mJob )
  {
    QgsDebugMsgLevel( u"CANVAS stop rendering!"_s, 2 );
    mJobCanceled = true;
    disconnect( mJob, &QgsMapRendererJob::finished, this, &QgsMapCanvas::rendererJobFinished );
    connect( mJob, &QgsMapRendererQImageJob::finished, mJob, &QgsMapRendererQImageJob::deleteLater );
    mJob->cancelWithoutBlocking();
    mJob = nullptr;
    emit mapRefreshCanceled();
  }
  stopPreviewJobs();
}
 
//the format defaults to "PNG" if not specified
void QgsMapCanvas::saveAsImage( const QString &fileName, QPixmap *theQPixmap, const QString &format )
{
  QPainter painter;
  QImage image;
 
  //
  //check if the optional QPaintDevice was supplied
  //
  if ( theQPixmap )
  {
    image = theQPixmap->toImage();
    painter.begin( &image );
 
    // render
    QgsMapRendererCustomPainterJob job( mSettings, &painter );
    job.start();
    job.waitForFinished();
    emit renderComplete( &painter );
  }
  else //use the map view
  {
    image = mMap->contentImage().copy();
    painter.begin( &image );
  }
 
  // draw annotations
  QStyleOptionGraphicsItem option;
  option.initFrom( this );
  QGraphicsItem *item = nullptr;
  QListIterator<QGraphicsItem *> i( items() );
  i.toBack();
  while ( i.hasPrevious() )
  {
    item = i.previous();
 
    if ( !( item && dynamic_cast<QgsMapCanvasAnnotationItem *>( item ) ) )
    {
      continue;
    }
 
    QgsScopedQPainterState painterState( &painter );
 
    QPointF itemScenePos = item->scenePos();
    painter.translate( itemScenePos.x(), itemScenePos.y() );
 
    item->paint( &painter, &option );
  }
 
  painter.end();
  image.save( fileName, format.toLocal8Bit().data() );
 
  QFileInfo myInfo = QFileInfo( fileName );
 
  // build the world file name
  QString outputSuffix = myInfo.suffix();
  QString myWorldFileName = myInfo.absolutePath() + '/' + myInfo.completeBaseName() + '.' + outputSuffix.at( 0 ) + outputSuffix.at( myInfo.suffix().size() - 1 ) + 'w';
  QFile myWorldFile( myWorldFileName );
  if ( !myWorldFile.open( QIODevice::WriteOnly | QIODevice::Truncate ) ) //don't use QIODevice::Text
  {
    return;
  }
  QTextStream myStream( &myWorldFile );
  myStream << QgsMapSettingsUtils::worldFileContent( mapSettings() );
}
 
QgsRectangle QgsMapCanvas::extent() const
{
  return mapSettings().visibleExtent();
}
 
QgsRectangle QgsMapCanvas::fullExtent() const
{
  return QgsMapLayerUtils::combinedExtent( mSettings.layers(), mapSettings().destinationCrs(), QgsProject::instance()->transformContext() );
}
 
QgsRectangle QgsMapCanvas::projectExtent() const
{
  const QgsReferencedRectangle extent = mProject ? mProject->viewSettings()->fullExtent() : QgsProject::instance()->viewSettings()->fullExtent();
  QgsCoordinateTransform ct( extent.crs(), mapSettings().destinationCrs(), mProject ? mProject->transformContext() : QgsProject::instance()->transformContext() );
  ct.setBallparkTransformsAreAppropriate( true );
  QgsRectangle rect;
  try
  {
    rect = ct.transformBoundingBox( extent );
  }
  catch ( QgsCsException & )
  {
    rect = mapSettings().fullExtent();
  }
 
  return rect;
}
 
void QgsMapCanvas::setExtent( const QgsRectangle &r, bool magnified )
{
  QgsRectangle current = extent();
 
  if ( ( r == current ) && magnified )
    return;
 
  if ( r.isEmpty() )
  {
    if ( !mSettings.hasValidSettings() )
    {
      // we can't even just move the map center
      QgsDebugMsgLevel( u"Empty extent - ignoring"_s, 2 );
      return;
    }
 
    // ### QGIS 3: do not allow empty extent - require users to call setCenter() explicitly
    QgsDebugMsgLevel( u"Empty extent - keeping old scale with new center!"_s, 2 );
 
    setCenter( r.center() );
  }
  else
  {
    // If scale is locked we need to maintain the current scale, so we
    // - magnify and recenter the map
    // - restore locked scale
    if ( mScaleLocked && magnified )
    {
      ScaleRestorer restorer( this );
      const double ratio { mapSettings().extent().width() / mapSettings().extent().height() };
      const double factor { r.width() / r.height() > ratio ? mapSettings().extent().width() / r.width() : mapSettings().extent().height() / r.height() };
      const double scaleFactor { std::clamp( mSettings.magnificationFactor() * factor, QgsGuiUtils::CANVAS_MAGNIFICATION_MIN, QgsGuiUtils::CANVAS_MAGNIFICATION_MAX ) };
      const QgsPointXY newCenter { r.center() };
      mSettings.setMagnificationFactor( scaleFactor, &newCenter );
      emit magnificationChanged( scaleFactor );
    }
    else
    {
      mSettings.setExtent( r, magnified );
    }
  }
  emitExtentsChanged();
  updateScale();
 
  //clear all extent items after current index
  for ( int i = mLastExtent.size() - 1; i > mLastExtentIndex; i-- )
  {
    mLastExtent.removeAt( i );
  }
 
  if ( !mLastExtent.isEmpty() && mLastExtent.last() != mSettings.extent() )
  {
    mLastExtent.append( mSettings.extent() );
  }
 
  // adjust history to no more than 100
  if ( mLastExtent.size() > 100 )
  {
    mLastExtent.removeAt( 0 );
  }
 
  // the last item is the current extent
  mLastExtentIndex = mLastExtent.size() - 1;
 
  // update controls' enabled state
  emit zoomLastStatusChanged( mLastExtentIndex > 0 );
  emit zoomNextStatusChanged( mLastExtentIndex < mLastExtent.size() - 1 );
}
 
bool QgsMapCanvas::setReferencedExtent( const QgsReferencedRectangle &extent )
{
  QgsRectangle canvasExtent = extent;
  if ( extent.crs() != mapSettings().destinationCrs() )
  {
    QgsCoordinateTransform ct( extent.crs(), mapSettings().destinationCrs(), QgsProject::instance() );
    ct.setBallparkTransformsAreAppropriate( true );
    canvasExtent = ct.transformBoundingBox( extent );
 
    if ( canvasExtent.isEmpty() )
    {
      return false;
    }
  }
 
  setExtent( canvasExtent, true );
  return true;
}
 
void QgsMapCanvas::setCenter( const QgsPointXY &center )
{
  const QgsRectangle r = mapSettings().extent();
  const double xMin = center.x() - r.width() / 2.0;
  const double yMin = center.y() - r.height() / 2.0;
  const QgsRectangle rect( xMin, yMin, xMin + r.width(), yMin + r.height() );
  if ( !rect.isEmpty() )
  {
    setExtent( rect, true );
  }
} // setCenter
 
QgsPointXY QgsMapCanvas::center() const
{
  QgsRectangle r = mapSettings().extent();
  return r.center();
}
 
QgsPointXY QgsMapCanvas::cursorPoint() const
{
  return mCursorPoint;
}
 
double QgsMapCanvas::rotation() const
{
  return mapSettings().rotation();
}
 
void QgsMapCanvas::setRotation( double degrees )
{
  double current = rotation();
 
  if ( qgsDoubleNear( degrees, current ) )
    return;
 
  mSettings.setRotation( degrees );
  emit rotationChanged( degrees );
  emitExtentsChanged(); // visible extent changes with rotation
}
 
void QgsMapCanvas::updateScale()
{
  if ( !mBlockScaleChangedSignal )
    emit scaleChanged( mapSettings().scale() );
}
 
void QgsMapCanvas::zoomToFullExtent()
{
  QgsRectangle extent = fullExtent();
  // If the full extent is an empty set, don't do the zoom
  if ( !extent.isEmpty() )
  {
    // Add a 5% margin around the full extent
    extent.scale( 1.05 );
    setExtent( extent, true );
  }
  refresh();
}
 
void QgsMapCanvas::zoomToProjectExtent()
{
  QgsRectangle extent = projectExtent();
 
  // If the full extent is an empty set, don't do the zoom
  if ( !extent.isEmpty() )
  {
    // Add a 5% margin around the full extent
    extent.scale( 1.05 );
    setExtent( extent, true );
  }
  refresh();
}
 
void QgsMapCanvas::zoomToPreviousExtent()
{
  if ( mLastExtentIndex > 0 )
  {
    mLastExtentIndex--;
    mSettings.setExtent( mLastExtent[mLastExtentIndex] );
    emitExtentsChanged();
    updateScale();
    refresh();
    // update controls' enabled state
    emit zoomLastStatusChanged( mLastExtentIndex > 0 );
    emit zoomNextStatusChanged( mLastExtentIndex < mLastExtent.size() - 1 );
  }
 
} // zoomToPreviousExtent
 
void QgsMapCanvas::zoomToNextExtent()
{
  if ( mLastExtentIndex < mLastExtent.size() - 1 )
  {
    mLastExtentIndex++;
    mSettings.setExtent( mLastExtent[mLastExtentIndex] );
    emitExtentsChanged();
    updateScale();
    refresh();
    // update controls' enabled state
    emit zoomLastStatusChanged( mLastExtentIndex > 0 );
    emit zoomNextStatusChanged( mLastExtentIndex < mLastExtent.size() - 1 );
  }
} // zoomToNextExtent
 
void QgsMapCanvas::clearExtentHistory()
{
  mLastExtent.clear();                      // clear the zoom history list
  mLastExtent.append( mSettings.extent() ); // set the current extent in the list
  mLastExtentIndex = mLastExtent.size() - 1;
  // update controls' enabled state
  emit zoomLastStatusChanged( mLastExtentIndex > 0 );
  emit zoomNextStatusChanged( mLastExtentIndex < mLastExtent.size() - 1 );
} // clearExtentHistory
 
QgsRectangle QgsMapCanvas::optimalExtentForPointLayer( QgsVectorLayer *layer, const QgsPointXY &center, int scaleFactor )
{
  QgsRectangle rect( center, center );
 
  if ( layer->geometryType() == Qgis::GeometryType::Point )
  {
    QgsPointXY centerLayerCoordinates = mSettings.mapToLayerCoordinates( layer, center );
    QgsRectangle extentRect = mSettings.mapToLayerCoordinates( layer, extent() ).scaled( 1.0 / scaleFactor, &centerLayerCoordinates );
    QgsFeatureRequest req = QgsFeatureRequest().setFilterRect( extentRect ).setLimit( 1000 ).setNoAttributes();
    QgsFeatureIterator fit = layer->getFeatures( req );
    QgsFeature f;
    QgsPointXY closestPoint;
    double closestSquaredDistance = pow( extentRect.width(), 2.0 ) + pow( extentRect.height(), 2.0 );
    bool pointFound = false;
    while ( fit.nextFeature( f ) )
    {
      QgsPointXY point = f.geometry().asPoint();
      double sqrDist = point.sqrDist( centerLayerCoordinates );
      if ( sqrDist > closestSquaredDistance || sqrDist < 4 * std::numeric_limits<double>::epsilon() )
        continue;
      pointFound = true;
      closestPoint = point;
      closestSquaredDistance = sqrDist;
    }
    if ( pointFound )
    {
      // combine selected point with closest point and scale this rect
      rect.combineExtentWith( mSettings.layerToMapCoordinates( layer, closestPoint ) );
      rect.scale( scaleFactor, &center );
    }
  }
  return rect;
}
 
void QgsMapCanvas::zoomToSelected( QgsMapLayer *layer )
{
  QgsTemporaryCursorOverride cursorOverride( Qt::WaitCursor );
 
  if ( !layer )
  {
    // use current layer by default
    layer = mCurrentLayer;
  }
 
  if ( !layer || !layer->isSpatial() )
    return;
 
  QgsRectangle rect;
 
  switch ( layer->type() )
  {
    case Qgis::LayerType::Vector:
    {
      QgsVectorLayer *vlayer = qobject_cast<QgsVectorLayer *>( layer );
      if ( vlayer->selectedFeatureCount() == 0 )
        return;
 
      rect = vlayer->boundingBoxOfSelected();
      if ( rect.isNull() )
      {
        cursorOverride.release();
        emit messageEmitted( tr( "Cannot zoom to selected feature(s)" ), tr( "No extent could be determined." ), Qgis::MessageLevel::Warning );
        return;
      }
 
      rect = mapSettings().layerExtentToOutputExtent( layer, rect );
 
      // zoom in if point cannot be distinguished from others
      // also check that rect is empty, as it might not in case of multi points
      if ( vlayer->geometryType() == Qgis::GeometryType::Point && rect.isEmpty() )
      {
        rect = optimalExtentForPointLayer( vlayer, rect.center() );
      }
      break;
    }
 
    case Qgis::LayerType::VectorTile:
    {
      QgsVectorTileLayer *vtLayer = qobject_cast<QgsVectorTileLayer *>( layer );
      if ( vtLayer->selectedFeatureCount() == 0 )
        return;
 
      const QList<QgsFeature> selectedFeatures = vtLayer->selectedFeatures();
      for ( const QgsFeature &feature : selectedFeatures )
      {
        if ( !feature.hasGeometry() )
          continue;
 
        rect.combineExtentWith( feature.geometry().boundingBox() );
      }
 
      if ( rect.isNull() )
      {
        cursorOverride.release();
        emit messageEmitted( tr( "Cannot zoom to selected feature(s)" ), tr( "No extent could be determined." ), Qgis::MessageLevel::Warning );
        return;
      }
 
      rect = mapSettings().layerExtentToOutputExtent( layer, rect );
      break;
    }
 
    case Qgis::LayerType::Raster:
    case Qgis::LayerType::Plugin:
    case Qgis::LayerType::Mesh:
    case Qgis::LayerType::Annotation:
    case Qgis::LayerType::PointCloud:
    case Qgis::LayerType::Group:
    case Qgis::LayerType::TiledScene:
      return; // not supported
  }
 
  zoomToFeatureExtent( rect );
}
 
void QgsMapCanvas::zoomToSelected( const QList<QgsMapLayer *> &layers )
{
  QgsRectangle rect;
  rect.setNull();
  QgsRectangle selectionExtent;
  selectionExtent.setNull();
 
  for ( QgsMapLayer *mapLayer : layers )
  {
    if ( !mapLayer || !mapLayer->isSpatial() )
      continue;
 
    switch ( mapLayer->type() )
    {
      case Qgis::LayerType::Vector:
      {
        QgsVectorLayer *layer = qobject_cast<QgsVectorLayer *>( mapLayer );
 
        if ( layer->selectedFeatureCount() == 0 )
          continue;
 
        rect = layer->boundingBoxOfSelected();
 
        if ( rect.isNull() )
          continue;
 
        rect = mapSettings().layerExtentToOutputExtent( layer, rect );
 
        if ( layer->geometryType() == Qgis::GeometryType::Point && rect.isEmpty() )
          rect = optimalExtentForPointLayer( layer, rect.center() );
 
        selectionExtent.combineExtentWith( rect );
        break;
      }
 
      case Qgis::LayerType::VectorTile:
      {
        QgsVectorTileLayer *vtLayer = qobject_cast<QgsVectorTileLayer *>( mapLayer );
        if ( vtLayer->selectedFeatureCount() == 0 )
          continue;
 
        const QList<QgsFeature> selectedFeatures = vtLayer->selectedFeatures();
        QgsRectangle rect;
        for ( const QgsFeature &feature : selectedFeatures )
        {
          if ( !feature.hasGeometry() )
            continue;
 
          rect.combineExtentWith( feature.geometry().boundingBox() );
        }
 
        rect = mapSettings().layerExtentToOutputExtent( vtLayer, rect );
        selectionExtent.combineExtentWith( rect );
        break;
      }
 
      case Qgis::LayerType::Raster:
      case Qgis::LayerType::Plugin:
      case Qgis::LayerType::Mesh:
      case Qgis::LayerType::Annotation:
      case Qgis::LayerType::PointCloud:
      case Qgis::LayerType::Group:
      case Qgis::LayerType::TiledScene:
        break;
    }
  }
 
  if ( selectionExtent.isNull() )
  {
    emit messageEmitted( tr( "Cannot zoom to selected feature(s)" ), tr( "No extent could be determined." ), Qgis::MessageLevel::Warning );
    return;
  }
 
  zoomToFeatureExtent( selectionExtent );
}
 
void QgsMapCanvas::zoomToLayers( const QList<QgsMapLayer *> &layers )
{
  QgsRectangle extent;
  extent.setNull();
 
  for ( QgsMapLayer *mapLayer : layers )
  {
    QgsRectangle layerExtent = mapLayer->extent();
 
    QgsVectorLayer *vLayer = qobject_cast<QgsVectorLayer *>( mapLayer );
    if ( vLayer )
    {
      if ( vLayer->geometryType() == Qgis::GeometryType::Null )
        continue;
 
      if ( layerExtent.isEmpty() )
      {
        vLayer->updateExtents();
        layerExtent = vLayer->extent();
      }
    }
 
    if ( layerExtent.isNull() )
      continue;
 
    //transform extent
    layerExtent = mapSettings().layerExtentToOutputExtent( mapLayer, layerExtent );
 
    extent.combineExtentWith( layerExtent );
  }
 
  if ( extent.isNull() )
    return;
 
  // Increase bounding box with 5%, so that layer is a bit inside the borders
  extent.scale( 1.05 );
 
  //zoom to bounding box
  setExtent( extent, true );
  refresh();
}
 
QgsDoubleRange QgsMapCanvas::zRange() const
{
  return mSettings.zRange();
}
 
void QgsMapCanvas::setZRange( const QgsDoubleRange &range )
{
  if ( zRange() == range )
    return;
 
  mSettings.setZRange( range );
 
  emit zRangeChanged();
 
  // we need to discard any previously cached images which are elevation aware, so that these will be updated when
  // the canvas is redrawn
  mCacheInvalidations |= CacheInvalidationType::Elevation;
 
  autoRefreshTriggered();
}
 
void QgsMapCanvas::zoomToFeatureExtent( QgsRectangle &rect )
{
  // no selected features, only one selected point feature
  //or two point features with the same x- or y-coordinates
  if ( rect.isEmpty() || !QgsMapSettingsUtils::isValidExtent( rect ) )
  {
    // zoom in
    QgsPointXY c = rect.center();
    rect = extent();
    rect.scale( 1.0, &c );
  }
  //zoom to an area
  else
  {
    // Expand rect to give a bit of space around the selected
    // objects so as to keep them clear of the map boundaries
    // The same 5% should apply to all margins.
    rect.scale( 1.05 );
  }
 
  setExtent( rect, true );
  refresh();
}
 
void QgsMapCanvas::zoomToFeatureIds( QgsVectorLayer *layer, const QgsFeatureIds &ids )
{
  if ( !layer )
  {
    return;
  }
 
  QgsRectangle bbox;
  QString errorMsg;
  if ( boundingBoxOfFeatureIds( ids, layer, bbox, errorMsg ) )
  {
    if ( bbox.isEmpty() )
    {
      bbox = optimalExtentForPointLayer( layer, bbox.center() );
    }
    zoomToFeatureExtent( bbox );
  }
  else
  {
    emit messageEmitted( tr( "Zoom to feature id failed" ), errorMsg, Qgis::MessageLevel::Warning );
  }
}
 
void QgsMapCanvas::panToFeatureIds( QgsVectorLayer *layer, const QgsFeatureIds &ids, bool alwaysRecenter )
{
  if ( !layer )
  {
    return;
  }
 
  QgsRectangle bbox;
  QString errorMsg;
  if ( boundingBoxOfFeatureIds( ids, layer, bbox, errorMsg ) )
  {
    if ( alwaysRecenter || !mapSettings().extent().contains( bbox ) )
      setCenter( bbox.center() );
    refresh();
  }
  else
  {
    emit messageEmitted( tr( "Pan to feature id failed" ), errorMsg, Qgis::MessageLevel::Warning );
  }
}
 
bool QgsMapCanvas::boundingBoxOfFeatureIds( const QgsFeatureIds &ids, QgsVectorLayer *layer, QgsRectangle &bbox, QString &errorMsg ) const
{
  QgsFeatureIterator it = layer->getFeatures( QgsFeatureRequest().setFilterFids( ids ).setNoAttributes() );
  bbox.setNull();
  QgsFeature fet;
  int featureCount = 0;
  errorMsg.clear();
 
  while ( it.nextFeature( fet ) )
  {
    QgsGeometry geom = fet.geometry();
    if ( geom.isNull() )
    {
      errorMsg = tr( "Feature does not have a geometry" );
    }
    else if ( geom.constGet()->isEmpty() )
    {
      errorMsg = tr( "Feature geometry is empty" );
    }
    if ( !errorMsg.isEmpty() )
    {
      return false;
    }
    QgsRectangle r = mapSettings().layerExtentToOutputExtent( layer, geom.boundingBox() );
    bbox.combineExtentWith( r );
    featureCount++;
  }
 
  if ( featureCount != ids.count() )
  {
    errorMsg = tr( "Feature not found" );
    return false;
  }
 
  return true;
}
 
void QgsMapCanvas::panToSelected( QgsMapLayer *layer )
{
  if ( !layer )
  {
    // use current layer by default
    layer = mCurrentLayer;
  }
  if ( !layer || !layer->isSpatial() )
    return;
 
  QgsRectangle rect;
  switch ( layer->type() )
  {
    case Qgis::LayerType::Vector:
    {
      QgsVectorLayer *vLayer = qobject_cast<QgsVectorLayer *>( layer );
      if ( vLayer->selectedFeatureCount() == 0 )
        return;
 
      rect = vLayer->boundingBoxOfSelected();
      break;
    }
    case Qgis::LayerType::VectorTile:
    {
      QgsVectorTileLayer *vtLayer = qobject_cast<QgsVectorTileLayer *>( layer );
      if ( vtLayer->selectedFeatureCount() == 0 )
        return;
 
      const QList<QgsFeature> selectedFeatures = vtLayer->selectedFeatures();
      for ( const QgsFeature &feature : selectedFeatures )
      {
        if ( !feature.hasGeometry() )
          continue;
 
        rect.combineExtentWith( feature.geometry().boundingBox() );
      }
      break;
    }
 
    case Qgis::LayerType::Raster:
    case Qgis::LayerType::Plugin:
    case Qgis::LayerType::Mesh:
    case Qgis::LayerType::Annotation:
    case Qgis::LayerType::PointCloud:
    case Qgis::LayerType::Group:
    case Qgis::LayerType::TiledScene:
      return;
  }
 
  if ( rect.isNull() )
  {
    emit messageEmitted( tr( "Cannot pan to selected feature(s)" ), tr( "No extent could be determined." ), Qgis::MessageLevel::Warning );
    return;
  }
 
  rect = mapSettings().layerExtentToOutputExtent( layer, rect );
  setCenter( rect.center() );
  refresh();
}
 
void QgsMapCanvas::panToSelected( const QList<QgsMapLayer *> &layers )
{
  QgsRectangle selectionExtent;
  selectionExtent.setNull();
 
  for ( QgsMapLayer *mapLayer : layers )
  {
    if ( !mapLayer || !mapLayer->isSpatial() )
      continue;
 
    QgsRectangle rect;
    switch ( mapLayer->type() )
    {
      case Qgis::LayerType::Vector:
      {
        QgsVectorLayer *layer = qobject_cast<QgsVectorLayer *>( mapLayer );
        if ( layer->selectedFeatureCount() == 0 )
          continue;
 
        rect = layer->boundingBoxOfSelected();
 
        if ( rect.isNull() )
          continue;
 
        rect = mapSettings().layerExtentToOutputExtent( layer, rect );
 
        if ( layer->geometryType() == Qgis::GeometryType::Point && rect.isEmpty() )
          rect = optimalExtentForPointLayer( layer, rect.center() );
        break;
      }
 
      case Qgis::LayerType::VectorTile:
      {
        QgsVectorTileLayer *vtLayer = qobject_cast<QgsVectorTileLayer *>( mapLayer );
        if ( vtLayer->selectedFeatureCount() == 0 )
          continue;
 
        const QList<QgsFeature> selectedFeatures = vtLayer->selectedFeatures();
        for ( const QgsFeature &feature : selectedFeatures )
        {
          if ( !feature.hasGeometry() )
            continue;
 
          rect.combineExtentWith( feature.geometry().boundingBox() );
        }
 
        rect = mapSettings().layerExtentToOutputExtent( vtLayer, rect );
        break;
      }
 
      case Qgis::LayerType::Raster:
      case Qgis::LayerType::Plugin:
      case Qgis::LayerType::Mesh:
      case Qgis::LayerType::Annotation:
      case Qgis::LayerType::PointCloud:
      case Qgis::LayerType::Group:
      case Qgis::LayerType::TiledScene:
        continue;
    }
 
    selectionExtent.combineExtentWith( rect );
  }
 
  if ( selectionExtent.isNull() )
  {
    emit messageEmitted( tr( "Cannot pan to selected feature(s)" ), tr( "No extent could be determined." ), Qgis::MessageLevel::Warning );
    return;
  }
 
  setCenter( selectionExtent.center() );
  refresh();
}
 
void QgsMapCanvas::flashFeatureIds( QgsVectorLayer *layer, const QgsFeatureIds &ids, const QColor &color1, const QColor &color2, int flashes, int duration )
{
  if ( !layer )
  {
    return;
  }
 
  QList<QgsGeometry> geoms;
 
  QgsFeatureIterator it = layer->getFeatures( QgsFeatureRequest().setFilterFids( ids ).setNoAttributes() );
  QgsFeature fet;
  while ( it.nextFeature( fet ) )
  {
    if ( !fet.hasGeometry() )
      continue;
    geoms << fet.geometry();
  }
 
  flashGeometries( geoms, layer->crs(), color1, color2, flashes, duration );
}
 
void QgsMapCanvas::flashGeometries( const QList<QgsGeometry> &geometries, const QgsCoordinateReferenceSystem &crs, const QColor &color1, const QColor &color2, int flashes, int duration )
{
  if ( geometries.isEmpty() )
    return;
 
  Qgis::GeometryType geomType = QgsWkbTypes::geometryType( geometries.at( 0 ).wkbType() );
  QgsRubberBand *rb = new QgsRubberBand( this, geomType );
  for ( const QgsGeometry &geom : geometries )
    rb->addGeometry( geom, crs, false );
  rb->updatePosition();
  rb->update();
 
  if ( geomType == Qgis::GeometryType::Line || geomType == Qgis::GeometryType::Point )
  {
    rb->setWidth( 2 );
    rb->setSecondaryStrokeColor( QColor( 255, 255, 255 ) );
  }
  if ( geomType == Qgis::GeometryType::Point )
    rb->setIcon( Qgis::RubberBandIconType::Circle );
 
  QColor startColor = color1;
  if ( !startColor.isValid() )
  {
    if ( geomType == Qgis::GeometryType::Polygon )
    {
      startColor = rb->fillColor();
    }
    else
    {
      startColor = rb->strokeColor();
    }
    startColor.setAlpha( 255 );
  }
  QColor endColor = color2;
  if ( !endColor.isValid() )
  {
    endColor = startColor;
    endColor.setAlpha( 0 );
  }
 
 
  QVariantAnimation *animation = new QVariantAnimation( this );
  connect( animation, &QVariantAnimation::finished, this, [animation, rb] {
    animation->deleteLater();
    delete rb;
  } );
  connect( animation, &QPropertyAnimation::valueChanged, this, [rb, geomType]( const QVariant &value ) {
    QColor c = value.value<QColor>();
    if ( geomType == Qgis::GeometryType::Polygon )
    {
      rb->setFillColor( c );
    }
    else
    {
      rb->setStrokeColor( c );
    }
    rb->update();
  } );
 
  animation->setDuration( duration * flashes );
  animation->setStartValue( endColor );
  double midStep = 0.2 / flashes;
  for ( int i = 0; i < flashes; ++i )
  {
    double start = static_cast<double>( i ) / flashes;
    animation->setKeyValueAt( start + midStep, startColor );
    double end = static_cast<double>( i + 1 ) / flashes;
    if ( !qgsDoubleNear( end, 1.0 ) )
      animation->setKeyValueAt( end, endColor );
  }
  animation->setEndValue( endColor );
  animation->start();
}
 
void QgsMapCanvas::keyPressEvent( QKeyEvent *e )
{
  if ( mCanvasProperties->mouseButtonDown || mCanvasProperties->panSelectorDown )
  {
    emit keyPressed( e );
    return;
  }
 
  // Don't want to interfer with mouse events
  if ( !mCanvasProperties->mouseButtonDown )
  {
    // this is backwards, but we can't change now without breaking api because
    // forever QgsMapTools have had to explicitly mark events as ignored in order to
    // indicate that they've consumed the event and that the default behavior should not
    // be applied..!
    e->accept();
    if ( mMapTool )
    {
      mMapTool->keyPressEvent( e );
      if ( !e->isAccepted() ) // map tool consumed event
        return;
    }
 
    QgsRectangle currentExtent = mapSettings().visibleExtent();
    double dx = std::fabs( currentExtent.width() / 4 );
    double dy = std::fabs( currentExtent.height() / 4 );
 
    switch ( e->key() )
    {
      case Qt::Key_Left:
        QgsDebugMsgLevel( u"Pan left"_s, 2 );
        setCenter( center() - QgsVector( dx, 0 ).rotateBy( rotation() * M_PI / 180.0 ) );
        refresh();
        break;
 
      case Qt::Key_Right:
        QgsDebugMsgLevel( u"Pan right"_s, 2 );
        setCenter( center() + QgsVector( dx, 0 ).rotateBy( rotation() * M_PI / 180.0 ) );
        refresh();
        break;
 
      case Qt::Key_Up:
        QgsDebugMsgLevel( u"Pan up"_s, 2 );
        setCenter( center() + QgsVector( 0, dy ).rotateBy( rotation() * M_PI / 180.0 ) );
        refresh();
        break;
 
      case Qt::Key_Down:
        QgsDebugMsgLevel( u"Pan down"_s, 2 );
        setCenter( center() - QgsVector( 0, dy ).rotateBy( rotation() * M_PI / 180.0 ) );
        refresh();
        break;
 
      case Qt::Key_Space:
        QgsDebugMsgLevel( u"Pressing pan selector"_s, 2 );
 
        //mCanvasProperties->dragging = true;
        if ( !e->isAutoRepeat() )
        {
          mTemporaryCursorOverride = std::make_unique<QgsTemporaryCursorOverride>( Qt::ClosedHandCursor );
          mCanvasProperties->panSelectorDown = true;
          panActionStart( mCanvasProperties->mouseLastXY );
        }
        break;
 
      case Qt::Key_PageUp:
        QgsDebugMsgLevel( u"Zoom in"_s, 2 );
        zoomIn();
        break;
 
      case Qt::Key_PageDown:
        QgsDebugMsgLevel( u"Zoom out"_s, 2 );
        zoomOut();
        break;
 
#if 0
      case Qt::Key_P:
        mUseParallelRendering = !mUseParallelRendering;
        refresh();
        break;
 
      case Qt::Key_S:
        mDrawRenderingStats = !mDrawRenderingStats;
        refresh();
        break;
#endif
 
      default:
        // Pass it on
        if ( !mMapTool )
        {
          e->ignore();
          QgsDebugMsgLevel( "Ignoring key: " + QString::number( e->key() ), 2 );
        }
    }
  }
 
  emit keyPressed( e );
}
 
void QgsMapCanvas::keyReleaseEvent( QKeyEvent *e )
{
  QgsDebugMsgLevel( u"keyRelease event"_s, 2 );
 
  switch ( e->key() )
  {
    case Qt::Key_Space:
      if ( !e->isAutoRepeat() && mCanvasProperties->panSelectorDown )
      {
        QgsDebugMsgLevel( u"Releasing pan selector"_s, 2 );
        mTemporaryCursorOverride.reset();
        mCanvasProperties->panSelectorDown = false;
        panActionEnd( mCanvasProperties->mouseLastXY );
      }
      break;
 
    default:
      // Pass it on
      if ( mMapTool )
      {
        mMapTool->keyReleaseEvent( e );
      }
      else
        e->ignore();
 
      QgsDebugMsgLevel( "Ignoring key release: " + QString::number( e->key() ), 2 );
  }
 
  emit keyReleased( e );
 
} //keyReleaseEvent()
 
 
void QgsMapCanvas::mouseDoubleClickEvent( QMouseEvent *e )
{
  // call handler of current map tool
  if ( mMapTool )
  {
    auto me = std::make_unique<QgsMapMouseEvent>( this, e );
    mMapTool->canvasDoubleClickEvent( me.get() );
  }
} // mouseDoubleClickEvent
 
 
void QgsMapCanvas::beginZoomRect( QPoint pos )
{
  mZoomRect.setRect( 0, 0, 0, 0 );
  mTemporaryCursorOverride = std::make_unique<QgsTemporaryCursorOverride>( mZoomCursor );
  mZoomDragging = true;
  mZoomRubberBand = std::make_unique<QgsRubberBand>( this, Qgis::GeometryType::Polygon );
  QColor color( Qt::blue );
  color.setAlpha( 63 );
  mZoomRubberBand->setColor( color );
  mZoomRect.setTopLeft( pos );
}
 
void QgsMapCanvas::stopZoomRect()
{
  if ( mZoomDragging )
  {
    mZoomDragging = false;
    mZoomRubberBand.reset( nullptr );
    mTemporaryCursorOverride.reset();
  }
}
 
void QgsMapCanvas::endZoomRect( QPoint pos )
{
  stopZoomRect();
 
  // store the rectangle
  mZoomRect.setRight( pos.x() );
  mZoomRect.setBottom( pos.y() );
 
  //account for bottom right -> top left dragging
  mZoomRect = mZoomRect.normalized();
 
  if ( mZoomRect.width() < 5 && mZoomRect.height() < 5 )
  {
    //probably a mistake - would result in huge zoom!
    return;
  }
 
  // set center and zoom
  const QSize &zoomRectSize = mZoomRect.size();
  const QSize &canvasSize = mSettings.outputSize();
  double sfx = static_cast<double>( zoomRectSize.width() ) / canvasSize.width();
  double sfy = static_cast<double>( zoomRectSize.height() ) / canvasSize.height();
  double sf = std::max( sfx, sfy );
 
  QgsPointXY c = mSettings.mapToPixel().toMapCoordinates( mZoomRect.center() );
 
  zoomByFactor( sf, &c );
  refresh();
}
 
void QgsMapCanvas::startPan()
{
  if ( !mCanvasProperties->panSelectorDown )
  {
    mCanvasProperties->panSelectorDown = true;
    mTemporaryCursorOverride = std::make_unique<QgsTemporaryCursorOverride>( Qt::ClosedHandCursor );
    panActionStart( mCanvasProperties->mouseLastXY );
  }
}
 
void QgsMapCanvas::stopPan()
{
  if ( mCanvasProperties->panSelectorDown )
  {
    mCanvasProperties->panSelectorDown = false;
    mTemporaryCursorOverride.reset();
    panActionEnd( mCanvasProperties->mouseLastXY );
  }
}
 
void QgsMapCanvas::mousePressEvent( QMouseEvent *e )
{
  // use shift+middle mouse button for zooming, map tools won't receive any events in that case
  if ( e->button() == Qt::MiddleButton && e->modifiers() & Qt::ShiftModifier )
  {
    beginZoomRect( e->pos() );
    return;
  }
  //use middle mouse button for panning, map tools won't receive any events in that case
  else if ( e->button() == Qt::MiddleButton )
  {
    startPan();
  }
  else
  {
    // If doing a middle-button-click, followed by a right-button-click,
    // cancel the pan or zoomRect action started above.
    stopPan();
    stopZoomRect();
 
    // call handler of current map tool
    if ( mMapTool )
    {
      if ( mMapTool->flags() & QgsMapTool::AllowZoomRect && e->button() == Qt::LeftButton && e->modifiers() & Qt::ShiftModifier )
      {
        beginZoomRect( e->pos() );
        return;
      }
      else if ( mMapTool->flags() & QgsMapTool::ShowContextMenu && e->button() == Qt::RightButton )
      {
        auto me = std::make_unique<QgsMapMouseEvent>( this, e );
        showContextMenu( me.get() );
        return;
      }
      else
      {
        auto me = std::make_unique<QgsMapMouseEvent>( this, e );
        mMapTool->canvasPressEvent( me.get() );
      }
    }
  }
 
  if ( mCanvasProperties->panSelectorDown )
  {
    return;
  }
 
  mCanvasProperties->mouseButtonDown = true;
  mCanvasProperties->rubberStartPoint = e->pos();
}
 
void QgsMapCanvas::mouseReleaseEvent( QMouseEvent *e )
{
  // if using shift+middle mouse button for zooming, end zooming and return
  if ( mZoomDragging && e->button() == Qt::MiddleButton )
  {
    endZoomRect( e->pos() );
    return;
  }
  //use middle mouse button for panning, map tools won't receive any events in that case
  else if ( e->button() == Qt::MiddleButton )
  {
    stopPan();
  }
  else if ( e->button() == Qt::BackButton )
  {
    zoomToPreviousExtent();
    return;
  }
  else if ( e->button() == Qt::ForwardButton )
  {
    zoomToNextExtent();
    return;
  }
  else
  {
    if ( mZoomDragging && e->button() == Qt::LeftButton )
    {
      endZoomRect( e->pos() );
      return;
    }
 
    // call handler of current map tool
    if ( mMapTool )
    {
      auto me = std::make_unique<QgsMapMouseEvent>( this, e );
      mMapTool->canvasReleaseEvent( me.get() );
    }
  }
 
 
  mCanvasProperties->mouseButtonDown = false;
 
  if ( mCanvasProperties->panSelectorDown )
    return;
}
 
void QgsMapCanvas::resizeEvent( QResizeEvent *e )
{
  QGraphicsView::resizeEvent( e );
  mResizeTimer->start( 500 ); // in charge of refreshing canvas
 
  double oldScale = mSettings.scale();
  QSize lastSize = viewport()->size();
  mSettings.setOutputSize( lastSize );
 
  mScene->setSceneRect( QRectF( 0, 0, lastSize.width(), lastSize.height() ) );
 
  moveCanvasContents( true );
 
  if ( mScaleLocked )
  {
    double scaleFactor = oldScale / mSettings.scale();
    QgsRectangle r = mSettings.extent();
    QgsPointXY center = r.center();
    r.scale( scaleFactor, &center );
    mSettings.setExtent( r );
  }
  else
  {
    updateScale();
  }
 
  emitExtentsChanged();
}
 
void QgsMapCanvas::paintEvent( QPaintEvent *e )
{
  // no custom event handling anymore
 
  QGraphicsView::paintEvent( e );
} // paintEvent
 
void QgsMapCanvas::updateCanvasItemPositions()
{
  if ( mBlockItemPositionUpdates )
    return;
 
  const QList<QGraphicsItem *> items = mScene->items();
  for ( QGraphicsItem *gi : items )
  {
    QgsMapCanvasItem *item = dynamic_cast<QgsMapCanvasItem *>( gi );
 
    if ( item )
    {
      item->updatePosition();
    }
  }
}
 
 
void QgsMapCanvas::wheelEvent( QWheelEvent *e )
{
  // Zoom the map canvas in response to a mouse wheel event. Moving the
  // wheel forward (away) from the user zooms in
 
  QgsDebugMsgLevel( "Wheel event delta " + QString::number( e->angleDelta().y() ), 2 );
 
  if ( mMapTool )
  {
    mMapTool->wheelEvent( e );
    if ( e->isAccepted() )
      return;
  }
 
  if ( e->angleDelta().y() == 0 )
  {
    e->accept();
    return;
  }
 
  bool reverseZoom = QgsSettingsRegistryGui::settingsReverseWheelZoom->value();
  bool zoomIn = reverseZoom ? e->angleDelta().y() < 0 : e->angleDelta().y() > 0;
  double zoomFactor = zoomIn ? 1. / zoomInFactor() : zoomOutFactor();
 
  // "Normal" mouse have an angle delta of 120, precision mouses provide data faster, in smaller steps
  zoomFactor = 1.0 + ( zoomFactor - 1.0 ) / 120.0 * std::fabs( e->angleDelta().y() );
 
  if ( e->modifiers() & Qt::ControlModifier )
  {
    //holding ctrl while wheel zooming results in a finer zoom
    zoomFactor = 1.0 + ( zoomFactor - 1.0 ) / 20.0;
  }
 
  double signedWheelFactor = zoomIn ? 1 / zoomFactor : zoomFactor;
 
  // zoom map to mouse cursor by scaling
  QgsPointXY oldCenter = center();
  QgsPointXY mousePos( getCoordinateTransform()->toMapCoordinates( e->position().x(), e->position().y() ) );
  QgsPointXY newCenter( mousePos.x() + ( ( oldCenter.x() - mousePos.x() ) * signedWheelFactor ), mousePos.y() + ( ( oldCenter.y() - mousePos.y() ) * signedWheelFactor ) );
 
  zoomByFactor( signedWheelFactor, &newCenter );
  e->accept();
}
 
void QgsMapCanvas::setWheelFactor( double factor )
{
  mWheelZoomFactor = std::max( factor, 1.01 );
}
 
void QgsMapCanvas::zoomIn()
{
  // magnification is already handled in zoomByFactor
  zoomByFactor( zoomInFactor() );
}
 
void QgsMapCanvas::zoomOut()
{
  // magnification is already handled in zoomByFactor
  zoomByFactor( zoomOutFactor() );
}
 
void QgsMapCanvas::zoomScale( double newScale, bool ignoreScaleLock )
{
  zoomByFactor( newScale / scale(), nullptr, ignoreScaleLock );
}
 
void QgsMapCanvas::zoomWithCenter( int x, int y, bool zoomIn )
{
  double scaleFactor = ( zoomIn ? zoomInFactor() : zoomOutFactor() );
 
  // transform the mouse pos to map coordinates
  QgsPointXY center = getCoordinateTransform()->toMapCoordinates( x, y );
 
  if ( mScaleLocked )
  {
    ScaleRestorer restorer( this );
    setMagnificationFactor( mapSettings().magnificationFactor() / scaleFactor, &center );
  }
  else
  {
    zoomByFactor( scaleFactor, &center );
  }
}
 
void QgsMapCanvas::setScaleLocked( bool isLocked )
{
  if ( mScaleLocked != isLocked )
  {
    mScaleLocked = isLocked;
    emit scaleLockChanged( mScaleLocked );
  }
}
 
void QgsMapCanvas::mouseMoveEvent( QMouseEvent *e )
{
  mCanvasProperties->mouseLastXY = e->pos();
 
  if ( mCanvasProperties->panSelectorDown )
  {
    panAction( e );
  }
  else if ( mZoomDragging )
  {
    mZoomRect.setBottomRight( e->pos() );
    mZoomRubberBand->setToCanvasRectangle( mZoomRect );
    mZoomRubberBand->show();
  }
  else
  {
    // call handler of current map tool
    if ( mMapTool )
    {
      auto me = std::make_unique<QgsMapMouseEvent>( this, e );
      mMapTool->canvasMoveEvent( me.get() );
    }
  }
 
  // show x y on status bar (if we are mid pan operation, then the cursor point hasn't changed!)
  if ( !panOperationInProgress() )
  {
    mCursorPoint = getCoordinateTransform()->toMapCoordinates( mCanvasProperties->mouseLastXY );
    emit xyCoordinates( mCursorPoint );
  }
}
 
void QgsMapCanvas::setMapTool( QgsMapTool *tool, bool clean )
{
  if ( !tool )
    return;
 
  if ( tool == mMapTool )
  {
    mMapTool->reactivate();
    return;
  }
 
  if ( mMapTool )
  {
    if ( clean )
      mMapTool->clean();
 
    disconnect( mMapTool, &QObject::destroyed, this, &QgsMapCanvas::mapToolDestroyed );
    mMapTool->deactivate();
  }
 
  QgsMapTool *oldTool = mMapTool;
 
  // set new map tool and activate it
  mMapTool = tool;
  emit mapToolSet( mMapTool, oldTool );
  if ( mMapTool )
  {
    connect( mMapTool, &QObject::destroyed, this, &QgsMapCanvas::mapToolDestroyed );
    mMapTool->activate();
  }
 
} // setMapTool
 
void QgsMapCanvas::unsetMapTool( QgsMapTool *tool )
{
  if ( mMapTool && mMapTool == tool )
  {
    disconnect( mMapTool, &QObject::destroyed, this, &QgsMapCanvas::mapToolDestroyed );
    QgsMapTool *oldTool = mMapTool;
    mMapTool = nullptr;
    oldTool->deactivate();
    emit mapToolSet( nullptr, oldTool );
    setCursor( Qt::ArrowCursor );
  }
}
 
void QgsMapCanvas::setProject( QgsProject *project )
{
  if ( mProject )
    disconnect( mProject, &QgsProject::elevationShadingRendererChanged, this, &QgsMapCanvas::onElevationShadingRendererChanged );
 
  mProject = project;
 
  if ( mProject )
    connect( mProject, &QgsProject::elevationShadingRendererChanged, this, &QgsMapCanvas::onElevationShadingRendererChanged );
}
 
void QgsMapCanvas::setCanvasColor( const QColor &color )
{
  if ( canvasColor() == color )
    return;
 
  // background of map's pixmap
  mSettings.setBackgroundColor( color );
 
  // background of the QGraphicsView
  QBrush bgBrush( color );
  setBackgroundBrush( bgBrush );
#if 0
  QPalette palette;
  palette.setColor( backgroundRole(), color );
  setPalette( palette );
#endif
 
  // background of QGraphicsScene
  mScene->setBackgroundBrush( bgBrush );
 
  refresh();
 
  emit canvasColorChanged();
}
 
QColor QgsMapCanvas::canvasColor() const
{
  return mScene->backgroundBrush().color();
}
 
void QgsMapCanvas::setSelectionColor( const QColor &color )
{
  if ( mSettings.selectionColor() == color )
    return;
 
  mSettings.setSelectionColor( color );
 
  if ( mCache )
  {
    bool hasSelectedFeatures = false;
    const auto layers = mSettings.layers();
    for ( QgsMapLayer *layer : layers )
    {
      QgsVectorLayer *vlayer = qobject_cast<QgsVectorLayer *>( layer );
      if ( vlayer && vlayer->selectedFeatureCount() )
      {
        hasSelectedFeatures = true;
        break;
      }
    }
 
    if ( hasSelectedFeatures )
    {
      mCache->clear();
      refresh();
    }
  }
}
 
QColor QgsMapCanvas::selectionColor() const
{
  return mSettings.selectionColor();
}
 
int QgsMapCanvas::layerCount() const
{
  return mapSettings().layers().size();
}
 
QList<QgsMapLayer *> QgsMapCanvas::layers( bool expandGroupLayers ) const
{
  return mapSettings().layers( expandGroupLayers );
}
 
void QgsMapCanvas::layerStateChange()
{
  // called when a layer has changed visibility setting
  refresh();
}
 
void QgsMapCanvas::freeze( bool frozen )
{
  mFrozen = frozen;
}
 
bool QgsMapCanvas::isFrozen() const
{
  return mFrozen;
}
 
double QgsMapCanvas::mapUnitsPerPixel() const
{
  return mapSettings().mapUnitsPerPixel();
}
 
Qgis::DistanceUnit QgsMapCanvas::mapUnits() const
{
  return mapSettings().mapUnits();
}
 
QMap<QString, QString> QgsMapCanvas::layerStyleOverrides() const
{
  return mSettings.layerStyleOverrides();
}
 
void QgsMapCanvas::setLayerStyleOverrides( const QMap<QString, QString> &overrides )
{
  if ( overrides == mSettings.layerStyleOverrides() )
    return;
 
  mSettings.setLayerStyleOverrides( overrides );
  clearCache();
  emit layerStyleOverridesChanged();
}
 
void QgsMapCanvas::setTheme( const QString &theme )
{
  if ( mTheme == theme )
    return;
 
  clearCache();
  if ( theme.isEmpty() || !QgsProject::instance()->mapThemeCollection()->hasMapTheme( theme ) )
  {
    mTheme.clear();
    mSettings.setLayerStyleOverrides( QMap<QString, QString>() );
    setLayers( QgsProject::instance()->mapThemeCollection()->masterVisibleLayers() );
    emit themeChanged( QString() );
  }
  else
  {
    mTheme = theme;
    setLayersPrivate( QgsProject::instance()->mapThemeCollection()->mapThemeVisibleLayers( mTheme ) );
    emit themeChanged( theme );
  }
}
 
void QgsMapCanvas::setRenderFlag( bool flag )
{
  mRenderFlag = flag;
 
  if ( mRenderFlag )
  {
    refresh();
  }
  else
    stopRendering();
}
 
#if 0
void QgsMapCanvas::connectNotify( const char *signal )
{
  Q_UNUSED( signal )
  QgsDebugMsgLevel( "QgsMapCanvas connected to " + QString( signal ), 2 );
} //connectNotify
#endif
 
void QgsMapCanvas::layerRepaintRequested( bool deferred )
{
  if ( !deferred )
    refresh();
}
 
void QgsMapCanvas::autoRefreshTriggered()
{
  if ( mJob )
  {
    // canvas is currently being redrawn, so we defer the last requested
    // auto refresh until current rendering job finishes
    mRefreshAfterJob = true;
    return;
  }
 
  refresh();
}
 
void QgsMapCanvas::updateAutoRefreshTimer()
{
  // min auto refresh interval stores the smallest interval between layer auto refreshes. We automatically
  // trigger a map refresh on this minimum interval
  int minAutoRefreshInterval = -1;
  const auto layers = mSettings.layers();
  for ( QgsMapLayer *layer : layers )
  {
    int layerRefreshInterval = 0;
 
    if ( layer->hasAutoRefreshEnabled() && layer->autoRefreshInterval() > 0 )
    {
      layerRefreshInterval = layer->autoRefreshInterval();
    }
    else if ( QgsVectorLayer *vectorLayer = qobject_cast<QgsVectorLayer *>( layer ) )
    {
      if ( const QgsFeatureRenderer *renderer = vectorLayer->renderer() )
      {
        const double rendererRefreshRate = QgsSymbolLayerUtils::rendererFrameRate( renderer );
        if ( rendererRefreshRate > 0 )
        {
          layerRefreshInterval = 1000 / rendererRefreshRate;
        }
      }
    }
 
    if ( layerRefreshInterval == 0 )
      continue;
 
    minAutoRefreshInterval = minAutoRefreshInterval > 0 ? std::min( layerRefreshInterval, minAutoRefreshInterval ) : layerRefreshInterval;
  }
 
  if ( minAutoRefreshInterval > 0 )
  {
    mAutoRefreshTimer.setInterval( minAutoRefreshInterval );
    mAutoRefreshTimer.start();
  }
  else
  {
    mAutoRefreshTimer.stop();
  }
}
 
void QgsMapCanvas::projectThemesChanged()
{
  if ( mTheme.isEmpty() )
    return;
 
  if ( !QgsProject::instance()->mapThemeCollection()->hasMapTheme( mTheme ) )
  {
    // theme has been removed - stop following
    setTheme( QString() );
  }
}
 
QgsMapTool *QgsMapCanvas::mapTool() const
{
  return mMapTool;
}
 
QgsProject *QgsMapCanvas::project()
{
  return mProject;
}
 
void QgsMapCanvas::panActionEnd( QPoint releasePoint )
{
  // move map image and other items to standard position
  moveCanvasContents( true ); // true means reset
 
  // use start and end box points to calculate the extent
  QgsPointXY start = getCoordinateTransform()->toMapCoordinates( mCanvasProperties->rubberStartPoint );
  QgsPointXY end = getCoordinateTransform()->toMapCoordinates( releasePoint );
 
  // modify the center
  double dx = end.x() - start.x();
  double dy = end.y() - start.y();
  QgsPointXY c = center();
  c.set( c.x() - dx, c.y() - dy );
  setCenter( c );
 
  refresh();
}
 
void QgsMapCanvas::panActionStart( QPoint releasePoint )
{
  mCanvasProperties->rubberStartPoint = releasePoint;
 
  mDa = QgsDistanceArea();
  mDa.setEllipsoid( QgsProject::instance()->ellipsoid() );
  mDa.setSourceCrs( mapSettings().destinationCrs(), QgsProject::instance()->transformContext() );
}
 
void QgsMapCanvas::panAction( QMouseEvent *e )
{
  Q_UNUSED( e )
 
  QgsPointXY currentMapPoint = getCoordinateTransform()->toMapCoordinates( e->pos() );
  QgsPointXY startMapPoint = getCoordinateTransform()->toMapCoordinates( mCanvasProperties->rubberStartPoint );
  try
  {
    emit panDistanceBearingChanged( mDa.measureLine( currentMapPoint, startMapPoint ), mDa.lengthUnits(), mDa.bearing( currentMapPoint, startMapPoint ) * 180 / M_PI );
  }
  catch ( QgsCsException & )
  {}
 
  // move all map canvas items
  moveCanvasContents();
}
 
void QgsMapCanvas::moveCanvasContents( bool reset )
{
  QPoint pnt( 0, 0 );
  if ( !reset )
    pnt += mCanvasProperties->mouseLastXY - mCanvasProperties->rubberStartPoint;
 
  setSceneRect( -pnt.x(), -pnt.y(), viewport()->size().width(), viewport()->size().height() );
}
 
void QgsMapCanvas::dropEvent( QDropEvent *event )
{
  if ( QgsMimeDataUtils::isUriList( event->mimeData() ) )
  {
    const QgsMimeDataUtils::UriList lst = QgsMimeDataUtils::decodeUriList( event->mimeData() );
    bool allHandled = true;
    for ( const QgsMimeDataUtils::Uri &uri : lst )
    {
      bool handled = false;
      for ( QgsCustomDropHandler *handler : std::as_const( mDropHandlers ) )
      {
        if ( handler && handler->customUriProviderKey() == uri.providerKey )
        {
          if ( handler->handleCustomUriCanvasDrop( uri, this ) )
          {
            handled = true;
            break;
          }
        }
      }
      if ( !handled )
        allHandled = false;
    }
    if ( allHandled )
      event->accept();
    else
      event->ignore();
  }
  else
  {
    event->ignore();
  }
}
 
void QgsMapCanvas::showEvent( QShowEvent *event )
{
  Q_UNUSED( event )
  updateDevicePixelFromScreen();
}
 
void QgsMapCanvas::emitExtentsChanged()
{
  if ( !mBlockExtentChangedSignal )
    emit extentsChanged();
}
 
QPoint QgsMapCanvas::mouseLastXY()
{
  return mCanvasProperties->mouseLastXY;
}
 
void QgsMapCanvas::setPreviewModeEnabled( bool previewEnabled )
{
  if ( !mPreviewEffect )
  {
    return;
  }
 
  mPreviewEffect->setEnabled( previewEnabled );
}
 
bool QgsMapCanvas::previewModeEnabled() const
{
  if ( !mPreviewEffect )
  {
    return false;
  }
 
  return mPreviewEffect->isEnabled();
}
 
void QgsMapCanvas::setPreviewMode( QgsPreviewEffect::PreviewMode mode )
{
  if ( !mPreviewEffect )
  {
    return;
  }
 
  mPreviewEffect->setMode( mode );
}
 
QgsPreviewEffect::PreviewMode QgsMapCanvas::previewMode() const
{
  if ( !mPreviewEffect )
  {
    return QgsPreviewEffect::PreviewGrayscale;
  }
 
  return mPreviewEffect->mode();
}
 
QgsSnappingUtils *QgsMapCanvas::snappingUtils() const
{
  if ( !mSnappingUtils )
  {
    // associate a dummy instance, but better than null pointer
    QgsMapCanvas *c = const_cast<QgsMapCanvas *>( this );
    c->mSnappingUtils = new QgsMapCanvasSnappingUtils( c, c );
  }
  return mSnappingUtils;
}
 
void QgsMapCanvas::setSnappingUtils( QgsSnappingUtils *utils )
{
  mSnappingUtils = utils;
}
 
void QgsMapCanvas::readProject( const QDomDocument &doc )
{
  QgsProject *project = qobject_cast<QgsProject *>( sender() );
 
  QDomNodeList nodes = doc.elementsByTagName( u"mapcanvas"_s );
  if ( nodes.count() )
  {
    QDomNode node = nodes.item( 0 );
 
    // Search the specific MapCanvas node using the name
    if ( nodes.count() > 1 )
    {
      for ( int i = 0; i < nodes.size(); ++i )
      {
        QDomElement elementNode = nodes.at( i ).toElement();
 
        if ( elementNode.hasAttribute( u"name"_s ) && elementNode.attribute( u"name"_s ) == objectName() )
        {
          node = nodes.at( i );
          break;
        }
      }
    }
 
    QgsMapSettings tmpSettings;
    tmpSettings.readXml( node );
    if ( objectName() != "theMapCanvas"_L1 )
    {
      // never manually set the crs for the main canvas - this is instead connected to the project CRS
      setDestinationCrs( tmpSettings.destinationCrs() );
    }
    if ( QgsProject::instance()->viewSettings()->restoreProjectExtentOnProjectLoad() && objectName() == "theMapCanvas"_L1 )
    {
      zoomToProjectExtent();
    }
    else
    {
      setExtent( tmpSettings.extent() );
    }
    setRotation( tmpSettings.rotation() );
    enableMapTileRendering( tmpSettings.testFlag( Qgis::MapSettingsFlag::RenderMapTile ) );
 
    clearExtentHistory(); // clear the extent history on project load
 
    QDomElement elem = node.toElement();
    if ( elem.hasAttribute( u"theme"_s ) )
    {
      if ( QgsProject::instance()->mapThemeCollection()->hasMapTheme( elem.attribute( u"theme"_s ) ) )
      {
        setTheme( elem.attribute( u"theme"_s ) );
      }
    }
    setAnnotationsVisible( elem.attribute( u"annotationsVisible"_s, u"1"_s ).toInt() );
 
    // restore canvas expression context
    const QDomNodeList scopeElements = elem.elementsByTagName( u"expressionContextScope"_s );
    if ( scopeElements.size() > 0 )
    {
      const QDomElement scopeElement = scopeElements.at( 0 ).toElement();
      mExpressionContextScope.readXml( scopeElement, QgsReadWriteContext() );
    }
  }
  else
  {
    QgsDebugMsgLevel( u"Couldn't read mapcanvas information from project"_s, 2 );
    if ( !project->viewSettings()->defaultViewExtent().isNull() )
    {
      setReferencedExtent( project->viewSettings()->defaultViewExtent() );
    }
 
    setRotation( project->viewSettings()->defaultRotation() );
    clearExtentHistory(); // clear the extent history on project load
  }
}
 
void QgsMapCanvas::writeProject( QDomDocument &doc )
{
  // create node "mapcanvas" and call mMapRenderer->writeXml()
 
  QDomNodeList nl = doc.elementsByTagName( u"qgis"_s );
  if ( !nl.count() )
  {
    QgsDebugError( u"Unable to find qgis element in project file"_s );
    return;
  }
  QDomNode qgisNode = nl.item( 0 ); // there should only be one, so zeroth element OK
 
  QDomElement mapcanvasNode = doc.createElement( u"mapcanvas"_s );
  mapcanvasNode.setAttribute( u"name"_s, objectName() );
  if ( !mTheme.isEmpty() )
    mapcanvasNode.setAttribute( u"theme"_s, mTheme );
  mapcanvasNode.setAttribute( u"annotationsVisible"_s, mAnnotationsVisible );
  qgisNode.appendChild( mapcanvasNode );
 
  mSettings.writeXml( mapcanvasNode, doc );
 
  // store canvas expression context
  QDomElement scopeElement = doc.createElement( u"expressionContextScope"_s );
  QgsExpressionContextScope tmpScope( mExpressionContextScope );
  tmpScope.removeVariable( u"atlas_featurenumber"_s );
  tmpScope.removeVariable( u"atlas_pagename"_s );
  tmpScope.removeVariable( u"atlas_feature"_s );
  tmpScope.removeVariable( u"atlas_featureid"_s );
  tmpScope.removeVariable( u"atlas_geometry"_s );
  tmpScope.writeXml( scopeElement, doc, QgsReadWriteContext() );
  mapcanvasNode.appendChild( scopeElement );
 
  // TODO: store only units, extent, projections, dest CRS
}
 
void QgsMapCanvas::zoomByFactor( double scaleFactor, const QgsPointXY *center, bool ignoreScaleLock )
{
  if ( mScaleLocked && !ignoreScaleLock )
  {
    ScaleRestorer restorer( this );
    setMagnificationFactor( mapSettings().magnificationFactor() / scaleFactor, center );
  }
  else
  {
    QgsRectangle r = mapSettings().extent();
    r.scale( scaleFactor, center );
    setExtent( r, true );
    refresh();
  }
}
 
void QgsMapCanvas::selectionChangedSlot()
{
  // Find out which layer it was that sent the signal.
  QgsMapLayer *layer = qobject_cast<QgsMapLayer *>( sender() );
  if ( layer )
  {
    emit selectionChanged( layer );
    refresh();
  }
}
 
void QgsMapCanvas::dragEnterEvent( QDragEnterEvent *event )
{
  // By default graphics view delegates the drag events to graphics items.
  // But we do not want that and by ignoring the drag enter we let the
  // parent (e.g. QgisApp) to handle drops of map layers etc.
 
  // so we ONLY accept the event if we know in advance that a custom drop handler
  // wants it
 
  if ( QgsMimeDataUtils::isUriList( event->mimeData() ) )
  {
    const QgsMimeDataUtils::UriList lst = QgsMimeDataUtils::decodeUriList( event->mimeData() );
    bool allHandled = true;
    for ( const QgsMimeDataUtils::Uri &uri : lst )
    {
      bool handled = false;
      for ( QgsCustomDropHandler *handler : std::as_const( mDropHandlers ) )
      {
        if ( handler->canHandleCustomUriCanvasDrop( uri, this ) )
        {
          handled = true;
          break;
        }
      }
      if ( !handled )
        allHandled = false;
    }
    if ( allHandled )
      event->accept();
    else
      event->ignore();
  }
  else
  {
    event->ignore();
  }
}
 
bool QgsMapCanvas::viewportEvent( QEvent *event )
{
  if ( event->type() == QEvent::ToolTip && mMapTool && mMapTool->canvasToolTipEvent( qgis::down_cast<QHelpEvent *>( event ) ) )
  {
    return true;
  }
  return QGraphicsView::viewportEvent( event );
}
 
void QgsMapCanvas::mapToolDestroyed()
{
  QgsDebugMsgLevel( u"maptool destroyed"_s, 2 );
  mMapTool = nullptr;
}
 
bool QgsMapCanvas::event( QEvent *e )
{
  if ( e->type() == QEvent::Gesture )
  {
    if ( QTapAndHoldGesture *tapAndHoldGesture = qobject_cast<QTapAndHoldGesture *>( static_cast<QGestureEvent *>( e )->gesture( Qt::TapAndHoldGesture ) ) )
    {
      QPointF pos = tapAndHoldGesture->position();
      pos = mapFromGlobal( QPoint( pos.x(), pos.y() ) );
      QgsPointXY mapPoint = getCoordinateTransform()->toMapCoordinates( pos.x(), pos.y() );
      emit tapAndHoldGestureOccurred( mapPoint, tapAndHoldGesture );
    }
 
    // call handler of current map tool
    if ( mMapTool )
    {
      return mMapTool->gestureEvent( static_cast<QGestureEvent *>( e ) );
    }
  }
 
  // pass other events to base class
  return QGraphicsView::event( e );
}
 
void QgsMapCanvas::refreshAllLayers()
{
  // reload all layers in canvas
  const QList<QgsMapLayer *> layers = mapSettings().layers();
  for ( QgsMapLayer *layer : layers )
  {
    layer->reload();
  }
 
  redrawAllLayers();
}
 
void QgsMapCanvas::redrawAllLayers()
{
  // clear the cache
  clearCache();
 
  // and then refresh
  refresh();
}
 
void QgsMapCanvas::waitWhileRendering()
{
  while ( mRefreshScheduled || mJob )
  {
    QgsApplication::processEvents();
  }
}
 
void QgsMapCanvas::setSegmentationTolerance( double tolerance )
{
  mSettings.setSegmentationTolerance( tolerance );
}
 
void QgsMapCanvas::setSegmentationToleranceType( QgsAbstractGeometry::SegmentationToleranceType type )
{
  mSettings.setSegmentationToleranceType( type );
}
 
QList<QgsMapCanvasAnnotationItem *> QgsMapCanvas::annotationItems() const
{
  QList<QgsMapCanvasAnnotationItem *> annotationItemList;
  const QList<QGraphicsItem *> items = mScene->items();
  for ( QGraphicsItem *gi : items )
  {
    QgsMapCanvasAnnotationItem *aItem = dynamic_cast<QgsMapCanvasAnnotationItem *>( gi );
    if ( aItem )
    {
      annotationItemList.push_back( aItem );
    }
  }
 
  return annotationItemList;
}
 
void QgsMapCanvas::setAnnotationsVisible( bool show )
{
  mAnnotationsVisible = show;
  const QList<QgsMapCanvasAnnotationItem *> items = annotationItems();
  for ( QgsMapCanvasAnnotationItem *item : items )
  {
    item->setVisible( show );
  }
}
 
void QgsMapCanvas::setLabelingEngineSettings( const QgsLabelingEngineSettings &settings )
{
  mSettings.setLabelingEngineSettings( settings );
}
 
const QgsLabelingEngineSettings &QgsMapCanvas::labelingEngineSettings() const
{
  return mSettings.labelingEngineSettings();
}
 
void QgsMapCanvas::setSelectiveMaskingSourceSets( const QVector<QgsSelectiveMaskingSourceSet> &sets )
{
  mSettings.setSelectiveMaskingSourceSets( sets );
}
 
void QgsMapCanvas::startPreviewJobs()
{
  stopPreviewJobs(); //just in case still running
  schedulePreviewJob( 0 );
}
 
void QgsMapCanvas::startPreviewJob( int number )
{
  if ( number == 4 )
    number += 1;
 
  int j = number / 3;
  int i = number % 3;
 
  QgsMapSettings mapSettings = mSettings;
  mapSettings.setRotation( 0 );
  const QgsRectangle mapRect = mapSettings.visibleExtent();
  QgsPointXY jobCenter = mapRect.center();
  const double dx = ( i - 1 ) * mapRect.width();
  const double dy = ( 1 - j ) * mapRect.height();
  if ( !qgsDoubleNear( mSettings.rotation(), 0.0 ) )
  {
    const double radians = mSettings.rotation() * M_PI / 180;
    const double rdx = dx * cos( radians ) - dy * sin( radians );
    const double rdy = dy * cos( radians ) + dx * sin( radians );
    jobCenter.setX( jobCenter.x() + rdx );
    jobCenter.setY( jobCenter.y() + rdy );
  }
  else
  {
    jobCenter.setX( jobCenter.x() + dx );
    jobCenter.setY( jobCenter.y() + dy );
  }
  const QgsRectangle jobExtent = QgsRectangle::fromCenterAndSize( jobCenter, mapRect.width(), mapRect.height() );
 
  //copy settings, only update extent
  QgsMapSettings jobSettings = mSettings;
  jobSettings.setExtent( jobExtent );
  jobSettings.setFlag( Qgis::MapSettingsFlag::DrawLabeling, false );
  jobSettings.setFlag( Qgis::MapSettingsFlag::RenderPreviewJob, true );
  // never profile preview jobs
  jobSettings.setFlag( Qgis::MapSettingsFlag::RecordProfile, false );
 
  // truncate preview layers to fast layers
  const QList<QgsMapLayer *> layers = jobSettings.layers();
  QList<QgsMapLayer *> previewLayers;
  QgsDataProvider::PreviewContext context;
  context.maxRenderingTimeMs = Qgis::MAXIMUM_LAYER_PREVIEW_TIME_MS;
  for ( QgsMapLayer *layer : layers )
  {
    if ( layer->customProperty( u"rendering/noPreviewJobs"_s, false ).toBool() )
    {
      QgsDebugMsgLevel( u"Layer %1 not rendered because it is explicitly blocked from preview jobs"_s.arg( layer->id() ), 3 );
      continue;
    }
    context.lastRenderingTimeMs = mLastLayerRenderTime.value( layer->id(), 0 );
    QgsDataProvider *provider = layer->dataProvider();
    if ( provider && !provider->renderInPreview( context ) )
    {
      QgsDebugMsgLevel( u"Layer %1 not rendered because it does not match the renderInPreview criterion %2"_s.arg( layer->id() ).arg( mLastLayerRenderTime.value( layer->id() ) ), 3 );
      continue;
    }
 
    previewLayers << layer;
  }
  if ( ( mFlags & Qgis::MapCanvasFlag::ShowMainAnnotationLayer ) && QgsProject::instance()->mainAnnotationLayer()->dataProvider()->renderInPreview( context ) )
  {
    previewLayers.insert( 0, QgsProject::instance()->mainAnnotationLayer() );
  }
  jobSettings.setLayers( filterLayersForRender( previewLayers ) );
 
  QgsMapRendererQImageJob *job = new QgsMapRendererSequentialJob( jobSettings );
  job->setProperty( "number", number );
  mPreviewJobs.append( job );
  connect( job, &QgsMapRendererJob::finished, this, &QgsMapCanvas::previewJobFinished );
  job->start();
}
 
void QgsMapCanvas::stopPreviewJobs()
{
  mPreviewTimer.stop();
  for ( auto previewJob = mPreviewJobs.constBegin(); previewJob != mPreviewJobs.constEnd(); ++previewJob )
  {
    if ( *previewJob )
    {
      disconnect( *previewJob, &QgsMapRendererJob::finished, this, &QgsMapCanvas::previewJobFinished );
      connect( *previewJob, &QgsMapRendererQImageJob::finished, *previewJob, &QgsMapRendererQImageJob::deleteLater );
      ( *previewJob )->cancelWithoutBlocking();
    }
  }
  mPreviewJobs.clear();
}
 
void QgsMapCanvas::schedulePreviewJob( int number )
{
  mPreviewTimer.setSingleShot( true );
  mPreviewTimer.setInterval( Qgis::PREVIEW_JOB_DELAY_MS );
  disconnect( mPreviewTimerConnection );
  mPreviewTimerConnection = connect( &mPreviewTimer, &QTimer::timeout, this, [this, number]() { startPreviewJob( number ); } );
  mPreviewTimer.start();
}
 
bool QgsMapCanvas::panOperationInProgress()
{
  if ( mCanvasProperties->panSelectorDown )
    return true;
 
  if ( QgsMapToolPan *panTool = qobject_cast<QgsMapToolPan *>( mMapTool ) )
  {
    if ( panTool->isDragging() )
      return true;
  }
 
  return false;
}
 
int QgsMapCanvas::nextZoomLevel( const QList<double> &resolutions, bool zoomIn ) const
{
  int resolutionLevel = -1;
  double currentResolution = mapUnitsPerPixel();
  int nResolutions = resolutions.size();
 
  for ( int i = 0; i < nResolutions; ++i )
  {
    if ( qgsDoubleNear( resolutions[i], currentResolution, 0.0001 ) )
    {
      resolutionLevel = zoomIn ? ( i - 1 ) : ( i + 1 );
      break;
    }
    else if ( currentResolution <= resolutions[i] )
    {
      resolutionLevel = zoomIn ? ( i - 1 ) : i;
      break;
    }
    resolutionLevel = zoomIn ? i : i + 1;
  }
 
  if ( resolutionLevel < 0 || resolutionLevel >= nResolutions )
  {
    return -1;
  }
  if ( zoomIn && resolutionLevel == nResolutions - 1 && resolutions[nResolutions - 1] < currentResolution / mWheelZoomFactor )
  {
    // Avoid jumping straight to last resolution when zoomed far out and zooming in
    return -1;
  }
  if ( !zoomIn && resolutionLevel == 0 && resolutions[0] > mWheelZoomFactor * currentResolution )
  {
    // Avoid jumping straight to first resolution when zoomed far in and zooming out
    return -1;
  }
  return resolutionLevel;
}
 
double QgsMapCanvas::zoomInFactor() const
{
  if ( !mZoomResolutions.isEmpty() )
  {
    int zoomLevel = nextZoomLevel( mZoomResolutions, true );
    if ( zoomLevel != -1 )
    {
      return mZoomResolutions.at( zoomLevel ) / mapUnitsPerPixel();
    }
  }
  return 1 / mWheelZoomFactor;
}
 
double QgsMapCanvas::zoomOutFactor() const
{
  if ( !mZoomResolutions.isEmpty() )
  {
    int zoomLevel = nextZoomLevel( mZoomResolutions, false );
    if ( zoomLevel != -1 )
    {
      return mZoomResolutions.at( zoomLevel ) / mapUnitsPerPixel();
    }
  }
  return mWheelZoomFactor;
}