mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
c26ed69c6b
Qt5 allows runtime detection of touch devices. This commit reworks the current touch map tool by pulling its behavior into the normal pan tool when a touch device is detected. It avoids the need for a seperate map tool for touch interaction, and also avoids having this tool always appear on the Windows builds (regardless of the presence of a touch device)
533 lines
18 KiB
Plaintext
533 lines
18 KiB
Plaintext
/** \ingroup gui
|
|
* Map canvas is a class for displaying all GIS data types on a canvas.
|
|
*/
|
|
|
|
class QgsMapCanvas : QGraphicsView
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsmapcanvas.h>
|
|
%End
|
|
|
|
%ConvertToSubClassCode
|
|
if (dynamic_cast<QgsMapCanvas*>(sipCpp) != NULL)
|
|
sipType = sipType_QgsMapCanvas;
|
|
else
|
|
sipType = NULL;
|
|
%End
|
|
|
|
public:
|
|
|
|
//! Constructor
|
|
QgsMapCanvas( QWidget * parent /TransferThis/ = 0 );
|
|
|
|
~QgsMapCanvas();
|
|
|
|
//! Returns the magnification factor
|
|
//! @note added in 2.16
|
|
double magnificationFactor() const;
|
|
|
|
//! Set list of layers that should be shown in the canvas
|
|
//! @note added in 3.0
|
|
void setLayers( const QList<QgsMapLayer*>& layers );
|
|
|
|
void setCurrentLayer( QgsMapLayer* layer );
|
|
|
|
//! Get access to properties used for map rendering
|
|
//! @note added in 2.4
|
|
const QgsMapSettings& mapSettings() const /KeepReference/;
|
|
|
|
//! sets whether to use projections for this layer set
|
|
//! @note added in 2.4
|
|
void setCrsTransformEnabled( bool enabled );
|
|
|
|
//! sets destination coordinate reference system
|
|
//! @note added in 2.4
|
|
void setDestinationCrs( const QgsCoordinateReferenceSystem& crs );
|
|
|
|
//! Get access to the labeling results (may be null)
|
|
//! @note added in 2.4
|
|
const QgsLabelingResults* labelingResults() const;
|
|
|
|
//! Set whether to cache images of rendered layers
|
|
//! @note added in 2.4
|
|
void setCachingEnabled( bool enabled );
|
|
|
|
//! Check whether images of rendered layers are curerently being cached
|
|
//! @note added in 2.4
|
|
bool isCachingEnabled() const;
|
|
|
|
//! Make sure to remove any rendered images from cache (does nothing if cache is not enabled)
|
|
//! @note added in 2.4
|
|
void clearCache();
|
|
|
|
//! Reload all layers, clear the cache and refresh the canvas
|
|
//! @note added in 2.9
|
|
void refreshAllLayers();
|
|
|
|
//! Set whether the layers are rendered in parallel or sequentially
|
|
//! @note added in 2.4
|
|
void setParallelRenderingEnabled( bool enabled );
|
|
|
|
//! Check whether the layers are rendered in parallel or sequentially
|
|
//! @note added in 2.4
|
|
bool isParallelRenderingEnabled() const;
|
|
|
|
//! Set how often map preview should be updated while it is being rendered (in milliseconds)
|
|
//! @note added in 2.4
|
|
void setMapUpdateInterval( int timeMilliseconds );
|
|
|
|
//! Find out how often map preview should be updated while it is being rendered (in milliseconds)
|
|
//! @note added in 2.4
|
|
int mapUpdateInterval() const;
|
|
|
|
//! Get the last reported scale of the canvas
|
|
double scale();
|
|
|
|
//! Returns the mapUnitsPerPixel (map units per pixel) for the canvas
|
|
double mapUnitsPerPixel() const;
|
|
|
|
//! Returns the current zoom extent of the map canvas
|
|
QgsRectangle extent() const;
|
|
//! Returns the combined extent for all layers on the map canvas
|
|
QgsRectangle fullExtent() const;
|
|
|
|
//! Set the extent of the map canvas
|
|
void setExtent( const QgsRectangle &r, bool magnified = false );
|
|
|
|
//! Get the current map canvas rotation in clockwise degrees
|
|
//! @note added in 2.8
|
|
double rotation() const;
|
|
|
|
//! Set the rotation of the map canvas in clockwise degrees
|
|
//! @note added in 2.8
|
|
void setRotation( double degrees );
|
|
|
|
//! Set the center of the map canvas, in geographical coordinates
|
|
//! @note added in 2.8
|
|
void setCenter( const QgsPoint& center );
|
|
|
|
//! Get map center, in geographical coordinates
|
|
//! @note added in 2.8
|
|
QgsPoint center() const;
|
|
|
|
//! Zoom to the full extent of all layers
|
|
void zoomToFullExtent();
|
|
|
|
//! Zoom to the previous extent (view)
|
|
void zoomToPreviousExtent();
|
|
|
|
//! Zoom to the next extent (view)
|
|
void zoomToNextExtent();
|
|
|
|
// ! Clears the list of extents and sets current extent as first item
|
|
void clearExtentHistory();
|
|
|
|
/** Zoom to the extent of the selected features of current (vector) layer.
|
|
* @param layer optionally specify different than current layer
|
|
*/
|
|
void zoomToSelected( QgsVectorLayer* layer = 0 );
|
|
|
|
/** Set canvas extent to the bounding box of a set of features
|
|
@param layer the vector layer
|
|
@param ids the feature ids*/
|
|
void zoomToFeatureIds( QgsVectorLayer* layer, const QgsFeatureIds& ids );
|
|
|
|
/** Centers canvas extent to feature ids
|
|
@param layer the vector layer
|
|
@param ids the feature ids*/
|
|
void panToFeatureIds( QgsVectorLayer* layer, const QgsFeatureIds& ids );
|
|
|
|
//! Pan to the selected features of current (vector) layer keeping same extent.
|
|
void panToSelected( QgsVectorLayer* layer = 0 );
|
|
|
|
//! \brief Sets the map tool currently being used on the canvas
|
|
void setMapTool( QgsMapTool* mapTool );
|
|
|
|
/** \brief Unset the current map tool or last non zoom tool
|
|
*
|
|
* This is called from destructor of map tools to make sure
|
|
* that this map tool won't be used any more.
|
|
* You don't have to call it manualy, QgsMapTool takes care of it.
|
|
*/
|
|
void unsetMapTool( QgsMapTool* mapTool );
|
|
|
|
//! Returns the currently active tool
|
|
QgsMapTool* mapTool();
|
|
|
|
//! Write property of QColor bgColor.
|
|
void setCanvasColor( const QColor & _newVal );
|
|
//! Read property of QColor bgColor.
|
|
QColor canvasColor() const;
|
|
|
|
//! Set color of selected vector features
|
|
//! @note added in 2.4
|
|
void setSelectionColor( const QColor& color );
|
|
|
|
//! Emits signal scaleChanged to update scale in main window
|
|
void updateScale();
|
|
|
|
//! return the map layer at position index in the layer stack
|
|
QgsMapLayer *layer( int index );
|
|
|
|
//! return number of layers on the map
|
|
int layerCount() const;
|
|
|
|
//! return list of layers within map canvas.
|
|
QList<QgsMapLayer*> layers() const;
|
|
|
|
/**
|
|
* Freeze/thaw the map canvas. This is used to prevent the canvas from
|
|
* responding to events while layers are being added/removed etc.
|
|
* @param frz Boolean specifying if the canvas should be frozen (true) or
|
|
* thawed (false). Default is true.
|
|
*
|
|
* TODO remove in QGIS 3
|
|
*/
|
|
void freeze( bool frz = true );
|
|
|
|
/**
|
|
* Accessor for frozen status of canvas
|
|
*
|
|
* TODO remove in QGIS 3
|
|
*/
|
|
bool isFrozen();
|
|
|
|
//! Set map units (needed by project properties dialog)
|
|
void setMapUnits( QgsUnitTypes::DistanceUnit mapUnits );
|
|
|
|
//! Get the current canvas map units
|
|
QgsUnitTypes::DistanceUnit mapUnits() const;
|
|
|
|
//! Getter for stored overrides of styles for layers.
|
|
//! @note added in 2.12
|
|
QMap<QString, QString> layerStyleOverrides() const;
|
|
|
|
//! Setter for stored overrides of styles for layers.
|
|
//! @note added in 2.12
|
|
void setLayerStyleOverrides( const QMap<QString, QString>& overrides );
|
|
|
|
//! Get the current coordinate transform
|
|
const QgsMapToPixel* getCoordinateTransform();
|
|
|
|
//! Find out whether rendering is in progress
|
|
bool isDrawing();
|
|
|
|
//! returns current layer (set by legend widget)
|
|
QgsMapLayer* currentLayer();
|
|
|
|
//! set wheel zoom factor (should be greater than 1)
|
|
void setWheelFactor( double factor );
|
|
|
|
//! Zoom to a specific scale
|
|
void zoomScale( double scale );
|
|
|
|
//! Zoom with the factor supplied. Factor > 1 zooms out, interval (0,1) zooms in
|
|
//! If point is given, re-center on it
|
|
void zoomByFactor( double scaleFactor, const QgsPoint *center = 0 );
|
|
|
|
//! Zooms in/out with a given center
|
|
void zoomWithCenter( int x, int y, bool zoomIn );
|
|
|
|
//! Zooms to feature extent. Adds a small margin around the extent
|
|
//! and does a pan if rect is empty (point extent)
|
|
void zoomToFeatureExtent( QgsRectangle& rect );
|
|
|
|
//! Returns whether the scale is locked, so zooming can be performed using magnication.
|
|
//! @note added in 2.16
|
|
//! @see setScaleLocked()
|
|
bool scaleLocked() const;
|
|
|
|
//! used to determine if anti-aliasing is enabled or not
|
|
void enableAntiAliasing( bool theFlag );
|
|
|
|
//! true if antialising is enabled
|
|
bool antiAliasingEnabled() const;
|
|
|
|
//! sets map tile rendering flag
|
|
void enableMapTileRendering( bool theFlag );
|
|
|
|
// following 2 methods should be moved elsewhere or changed to private
|
|
// currently used by pan map tool
|
|
//! Ends pan action and redraws the canvas.
|
|
void panActionEnd( QPoint releasePoint );
|
|
|
|
//! Called when mouse is moving and pan is activated
|
|
void panAction( QMouseEvent * event );
|
|
|
|
//! returns last position of mouse cursor
|
|
QPoint mouseLastXY();
|
|
|
|
/** Enables a preview mode for the map canvas
|
|
* @param previewEnabled set to true to enable a preview mode
|
|
* @see setPreviewMode
|
|
* @note added in 2.3 */
|
|
void setPreviewModeEnabled( bool previewEnabled );
|
|
|
|
/** Returns whether a preview mode is enabled for the map canvas
|
|
* @returns true if a preview mode is currently enabled
|
|
* @see setPreviewModeEnabled
|
|
* @see previewMode
|
|
* @note added in 2.3 */
|
|
bool previewModeEnabled() const;
|
|
|
|
/** Sets a preview mode for the map canvas. This setting only has an effect if
|
|
* previewModeEnabled is true.
|
|
* @param mode preview mode for the canvas
|
|
* @see previewMode
|
|
* @see setPreviewModeEnabled
|
|
* @see previewModeEnabled
|
|
* @note added in 2.3 */
|
|
void setPreviewMode( QgsPreviewEffect::PreviewMode mode );
|
|
|
|
/** Returns the current preview mode for the map canvas. This setting only has an effect if
|
|
* previewModeEnabled is true.
|
|
* @returns preview mode for map canvas
|
|
* @see setPreviewMode
|
|
* @see previewModeEnabled
|
|
* @note added in 2.3 */
|
|
QgsPreviewEffect::PreviewMode previewMode() const;
|
|
|
|
/** Return snapping utility class that is associated with map canvas.
|
|
* If no snapping utils instance has been associated previously, an internal will be created for convenience
|
|
* (so map tools do not need to test for existence of the instance).
|
|
*
|
|
* Main canvas in QGIS returns an instance which is always up-to-date with the project's snapping configuration.
|
|
* @note added in 2.8
|
|
*/
|
|
QgsSnappingUtils* snappingUtils() const;
|
|
|
|
/** Assign an instance of snapping utils to the map canvas.
|
|
* The instance is not owned by the canvas, so it is possible to use one instance in multiple canvases.
|
|
*
|
|
* For main canvas in QGIS, do not associate a different instance from the existing one (it is updated from
|
|
* the project's snapping configuration).
|
|
* @note added in 2.8
|
|
*/
|
|
void setSnappingUtils( QgsSnappingUtils* utils );
|
|
|
|
/** Sets an expression context scope for the map canvas. This scope is injected into the expression
|
|
* context used for rendering the map, and can be used to apply specific variable overrides for
|
|
* expression evaluation for the map canvas render. This method will overwrite the existing expression
|
|
* context scope for the canvas.
|
|
* @param scope new expression context scope
|
|
* @note added in QGIS 2.12
|
|
* @see expressionContextScope()
|
|
*/
|
|
void setExpressionContextScope( const QgsExpressionContextScope& scope );
|
|
|
|
/** Returns a reference to the expression context scope for the map canvas. This scope is injected
|
|
* into the expression context used for rendering the map, and can be used to apply specific variable
|
|
* overrides for expression evaluation for the map canvas render.
|
|
* @note added in QGIS 2.12
|
|
* @see setExpressionContextScope()
|
|
*/
|
|
QgsExpressionContextScope& expressionContextScope();
|
|
|
|
/** Returns a const reference to the expression context scope for the map canvas.
|
|
* @note added in QGIS 2.12
|
|
* @see setExpressionContextScope()
|
|
* @note not available in python bindings
|
|
*/
|
|
// const QgsExpressionContextScope& expressionContextScope() const;
|
|
|
|
/** Sets the segmentation tolerance applied when rendering curved geometries
|
|
@param tolerance the segmentation tolerance*/
|
|
void setSegmentationTolerance( double tolerance );
|
|
|
|
/** Sets segmentation tolerance type (maximum angle or maximum difference between curve and approximation)
|
|
@param type the segmentation tolerance typename*/
|
|
void setSegmentationToleranceType( QgsAbstractGeometry::SegmentationToleranceType type );
|
|
|
|
public slots:
|
|
|
|
//! Repaints the canvas map
|
|
void refresh();
|
|
|
|
//! Receives signal about selection change, and pass it on with layer info
|
|
void selectionChangedSlot();
|
|
|
|
//! Save the convtents of the map canvas to disk as an image
|
|
void saveAsImage( const QString& theFileName, QPixmap * QPixmap = 0, const QString& = "PNG" );
|
|
|
|
//! This slot is connected to the visibility change of one or more layers
|
|
void layerStateChange();
|
|
|
|
//! This slot is connected to the layer's CRS change
|
|
void layerCrsChange();
|
|
|
|
//! Whether to suppress rendering or not
|
|
void setRenderFlag( bool theFlag );
|
|
//! State of render suppression flag
|
|
bool renderFlag();
|
|
|
|
//! A simple helper method to find out if on the fly projections are enabled or not
|
|
bool hasCrsTransformEnabled();
|
|
|
|
//! stop rendering (if there is any right now)
|
|
//! @note added in 2.4
|
|
void stopRendering();
|
|
|
|
//! called to read map canvas settings from project
|
|
void readProject( const QDomDocument & );
|
|
|
|
//! called to write map canvas settings to project
|
|
void writeProject( QDomDocument & );
|
|
|
|
//! ask user about datum transformation
|
|
void getDatumTransformInfo( const QgsMapLayer* ml, const QString& srcAuthId, const QString& destAuthId );
|
|
|
|
//! Sets the factor of magnification to apply to the map canvas. Indeed, we
|
|
//! increase/decrease the DPI of the map settings according to this factor
|
|
//! in order to render marker point, labels, ... bigger.
|
|
//! @note added in 2.16
|
|
void setMagnificationFactor( double factor );
|
|
|
|
//! Lock the scale, so zooming can be performed using magnication
|
|
//! @note added in 2.16
|
|
//! @see scaleLocked()
|
|
void setScaleLocked( bool isLocked );
|
|
|
|
//! Zoom in with fixed factor
|
|
void zoomIn();
|
|
|
|
//! Zoom out with fixed factor
|
|
void zoomOut();
|
|
|
|
signals:
|
|
|
|
/** Emits current mouse position
|
|
\note changed in 1.3 */
|
|
void xyCoordinates( const QgsPoint &p );
|
|
|
|
//! Emitted when the scale of the map changes
|
|
void scaleChanged( double );
|
|
|
|
//! Emitted when the extents of the map change
|
|
void extentsChanged();
|
|
|
|
//! Emitted when the rotation of the map changes
|
|
//! @note added in 2.8
|
|
void rotationChanged( double );
|
|
|
|
//! Emitted when the scale of the map changes
|
|
//! @note added in 2.16
|
|
void magnificationChanged( double );
|
|
|
|
/** Emitted when the canvas has rendered.
|
|
* Passes a pointer to the painter on which the map was drawn. This is
|
|
* useful for plugins that wish to draw on the map after it has been
|
|
* rendered. Passing the painter allows plugins to work when the map is
|
|
* being rendered onto a pixmap other than the mapCanvas own pixmap member.
|
|
*
|
|
*/
|
|
//! TODO: deprecate when decorations are reimplemented as map canvas items
|
|
//! - anything related to rendering progress is not visible outside of map canvas
|
|
//! - additional drawing shall be done directly within the renderer job or independently as a map canvas item
|
|
void renderComplete( QPainter * );
|
|
|
|
// ### QGIS 3: renamte to mapRefreshFinished()
|
|
//! Emitted when canvas finished a refresh request.
|
|
void mapCanvasRefreshed();
|
|
|
|
// ### QGIS 3: rename to mapRefreshStarted()
|
|
//! Emitted when the canvas is about to be rendered.
|
|
void renderStarting();
|
|
|
|
//! Emitted when a new set of layers has been received
|
|
void layersChanged();
|
|
|
|
//! Emit key press event
|
|
void keyPressed( QKeyEvent * e );
|
|
|
|
//! Emit key release event
|
|
void keyReleased( QKeyEvent * e );
|
|
|
|
//! Emit map tool changed event
|
|
void mapToolSet( QgsMapTool *tool );
|
|
|
|
/** Emit map tool changed with the old tool
|
|
* @note added in 2.3
|
|
*/
|
|
void mapToolSet( QgsMapTool *newTool, QgsMapTool* oldTool );
|
|
|
|
// ### QGIS 3: remove the signal
|
|
//! Emitted when selection in any layer gets changed
|
|
void selectionChanged( QgsMapLayer * layer );
|
|
|
|
//! Emitted when zoom last status changed
|
|
void zoomLastStatusChanged( bool );
|
|
|
|
//! Emitted when zoom next status changed
|
|
void zoomNextStatusChanged( bool );
|
|
|
|
//! Emitted when on-the-fly projection has been turned on/off
|
|
//! @note added in 2.4
|
|
void hasCrsTransformEnabledChanged( bool flag );
|
|
|
|
//! Emitted when map CRS has changed
|
|
//! @note added in 2.4
|
|
void destinationCrsChanged();
|
|
|
|
//! Emitted when map units are changed
|
|
//! @note added in 2.4
|
|
void mapUnitsChanged();
|
|
|
|
//! Emitted when the current layer is changed
|
|
//! @note added in 2.8
|
|
void currentLayerChanged( QgsMapLayer* layer );
|
|
|
|
//! Emitted when the configuration of overridden layer styles changes
|
|
//! @note added in 2.12
|
|
void layerStyleOverridesChanged();
|
|
|
|
//! emit a message (usually to be displayed in a message bar)
|
|
void messageEmitted( const QString& title, const QString& message, QgsMessageBar::MessageLevel = QgsMessageBar::INFO );
|
|
|
|
protected:
|
|
|
|
//! Overridden standard event to be gestures aware
|
|
bool event( QEvent * e );
|
|
|
|
//! Overridden key press event
|
|
void keyPressEvent( QKeyEvent * e );
|
|
|
|
//! Overridden key release event
|
|
void keyReleaseEvent( QKeyEvent * e );
|
|
|
|
//! Overridden mouse double click event
|
|
void mouseDoubleClickEvent( QMouseEvent * e );
|
|
|
|
//! Overridden mouse move event
|
|
void mouseMoveEvent( QMouseEvent * e );
|
|
|
|
//! Overridden mouse press event
|
|
void mousePressEvent( QMouseEvent * e );
|
|
|
|
//! Overridden mouse release event
|
|
void mouseReleaseEvent( QMouseEvent * e );
|
|
|
|
//! Overridden mouse wheel event
|
|
void wheelEvent( QWheelEvent * e );
|
|
|
|
//! Overridden resize event
|
|
void resizeEvent( QResizeEvent * e );
|
|
|
|
//! Overridden paint event
|
|
void paintEvent( QPaintEvent * e );
|
|
|
|
//! Overridden drag enter event
|
|
void dragEnterEvent( QDragEnterEvent * e );
|
|
|
|
//! called when panning is in action, reset indicates end of panning
|
|
void moveCanvasContents( bool reset = false );
|
|
|
|
//! called on resize or changed extent to notify canvas items to change their rectangle
|
|
void updateCanvasItemPositions();
|
|
|
|
//! Make sure the datum transform store is properly populated
|
|
void updateDatumTransformEntries();
|
|
|
|
private:
|
|
void connectNotify( const char * signal );
|
|
}; // class QgsMapCanvas
|