Quantum GIS API Documentation
1.7.4
|
Map canvas is a class for displaying all GIS data types on a canvas. More...
#include <qgsmapcanvas.h>
Classes | |
class | CanvasProperties |
Public Types | |
enum | WheelAction { WheelZoom, WheelZoomAndRecenter, WheelZoomToMouseCursor, WheelNothing } |
Public Slots | |
void | refresh () |
Repaints the canvas map. | |
void | selectionChangedSlot () |
Receives signal about selection change, and pass it on with layer info. | |
void | saveAsImage (QString theFileName, QPixmap *QPixmap=0, QString="PNG") |
Save the convtents of the map canvas to disk as an image. | |
void | layerStateChange () |
This slot is connected to the visibility change of one or more layers. | |
void | setRenderFlag (bool theFlag) |
Whether to suppress rendering or not. | |
bool | renderFlag () |
State of render suppression flag. | |
bool | hasCrsTransformEnabled () |
A simple helper method to find out if on the fly projections are enabled or not. | |
void | mapUnitsChanged () |
The map units may have changed, so cope with that. | |
void | updateMap () |
updates pixmap on render progress | |
void | showError (QgsMapLayer *mapLayer) |
show whatever error is exposed by the QgsMapLayer. | |
void | readProject (const QDomDocument &) |
called to read map canvas settings from project | |
void | writeProject (QDomDocument &) |
called to write map canvas settings to project | |
Signals | |
void | setProgress (int, int) |
Let the owner know how far we are with render operations. | |
void | xyCoordinates (const QgsPoint &p) |
emits current mouse position | |
void | scaleChanged (double) |
Emitted when the scale of the map changes. | |
void | extentsChanged () |
Emitted when the extents of the map change. | |
void | renderComplete (QPainter *) |
Emitted when the canvas has rendered. | |
void | renderStarting () |
Emitted when the canvas is about to be rendered. | |
void | layersChanged () |
Emitted when a new set of layers has been received. | |
void | keyPressed (QKeyEvent *e) |
Emit key press event. | |
void | keyReleased (QKeyEvent *e) |
Emit key release event. | |
void | mapToolSet (QgsMapTool *tool) |
Emit map tool changed event. | |
void | selectionChanged (QgsMapLayer *layer) |
Emitted when selection in any layer gets changed. | |
void | zoomLastStatusChanged (bool) |
Emitted when zoom last status changed. | |
void | zoomNextStatusChanged (bool) |
Emitted when zoom next status changed. | |
Public Member Functions | |
QgsMapCanvas (QWidget *parent=0, const char *name=0) | |
Constructor. | |
~QgsMapCanvas () | |
Destructor. | |
void | setLayerSet (QList< QgsMapCanvasLayer > &layers) |
void | setCurrentLayer (QgsMapLayer *layer) |
void | updateOverview () |
void | enableOverviewMode (QgsMapOverviewCanvas *overview) |
QgsMapCanvasMap * | map () |
QgsMapRenderer * | mapRenderer () |
Q_DECL_DEPRECATED QPixmap & | canvasPixmap () |
Accessor for the canvas pixmap. | |
QPaintDevice & | canvasPaintDevice () |
Accessor for the canvas paint device. | |
double | scale () |
Get the last reported scale of the canvas. | |
void | clear () |
Clear the map canvas. | |
double | mapUnitsPerPixel () const |
Returns the mapUnitsPerPixel (map units per pixel) for the canvas. | |
QgsRectangle | extent () const |
Returns the current zoom exent of the map canvas. | |
QgsRectangle | fullExtent () const |
Returns the combined exent for all layers on the map canvas. | |
void | setExtent (QgsRectangle const &r) |
Set the extent of the map canvas. | |
void | zoomToFullExtent () |
Zoom to the full extent of all layers. | |
void | zoomToPreviousExtent () |
Zoom to the previous extent (view) | |
void | zoomToNextExtent () |
Zoom to the Next extent (view) | |
void | clearExtentHistory () |
void | zoomToSelected (QgsVectorLayer *layer=NULL) |
Zoom to the extent of the selected features of current (vector) layer. | |
void | setMapTool (QgsMapTool *mapTool) |
Sets the map tool currently being used on the canvas. | |
void | unsetMapTool (QgsMapTool *mapTool) |
Unset the current map tool or last non zoom tool. | |
QgsMapTool * | mapTool () |
Returns the currently active tool. | |
virtual void | setCanvasColor (const QColor &_newVal) |
Write property of QColor bgColor. | |
virtual QColor | canvasColor () const |
Read property of QColor bgColor. | |
void | updateScale () |
Emits signal scalChanged to update scale in main window. | |
void | updateFullExtent () |
Updates the full extent. | |
QgsMapLayer * | layer (int index) |
return the map layer at position index in the layer stack | |
int | layerCount () const |
return number of layers on the map | |
QList< QgsMapLayer * > | layers () const |
return list of layers within map canvas. Added in v1.5 | |
void | freeze (bool frz=true) |
bool | isFrozen () |
void | setDirty (bool _dirty) |
Flag the canvas as dirty and needed a refresh. | |
bool | isDirty () const |
Return the state of the canvas (dirty or not) | |
void | setMapUnits (QGis::UnitType mapUnits) |
Set map units (needed by project properties dialog) | |
QGis::UnitType | mapUnits () const |
Get the current canvas map units. | |
const QgsMapToPixel * | getCoordinateTransform () |
Get the current coordinate transform. | |
bool | isDrawing () |
true if canvas currently drawing | |
QgsMapLayer * | currentLayer () |
returns current layer (set by legend widget) | |
void | setWheelAction (WheelAction action, double factor=2) |
set wheel action and zoom factor (should be greater than 1) | |
void | zoomIn () |
Zoom in with fixed factor. | |
void | zoomOut () |
Zoom out with fixed factor. | |
void | zoomScale (double scale) |
Zoom to a specific scale. | |
void | zoomByFactor (double scaleFactor) |
Zoom with the factor supplied. Factor > 1 zooms out, interval (0,1) zooms in. | |
void | zoomWithCenter (int x, int y, bool zoomIn) |
Zooms in/out with a given center. | |
void | enableAntiAliasing (bool theFlag) |
used to determine if anti-aliasing is enabled or not | |
bool | antiAliasingEnabled () const |
true if antialising is enabled | |
void | useImageToRender (bool theFlag) |
Select which Qt class to render with. | |
void | panActionEnd (QPoint releasePoint) |
Ends pan action and redraws the canvas. | |
void | panAction (QMouseEvent *event) |
Called when mouse is moving and pan is activated. | |
QPoint | mouseLastXY () |
returns last position of mouse cursor | |
Protected Member Functions | |
void | keyPressEvent (QKeyEvent *e) |
Overridden key press event. | |
void | keyReleaseEvent (QKeyEvent *e) |
Overridden key release event. | |
void | mouseDoubleClickEvent (QMouseEvent *e) |
Overridden mouse double click event. | |
void | mouseMoveEvent (QMouseEvent *e) |
Overridden mouse move event. | |
void | mousePressEvent (QMouseEvent *e) |
Overridden mouse press event. | |
void | mouseReleaseEvent (QMouseEvent *e) |
Overridden mouse release event. | |
void | wheelEvent (QWheelEvent *e) |
Overridden mouse wheel event. | |
void | resizeEvent (QResizeEvent *e) |
Overridden resize event. | |
void | paintEvent (QPaintEvent *e) |
Overridden paint event. | |
void | moveCanvasContents (bool reset=false) |
called when panning is in action, reset indicates end of panning | |
void | updateCanvasItemPositions () |
called on resize or changed extent to notify canvas items to change their rectangle | |
Protected Attributes | |
std::auto_ptr< CanvasProperties > | mCanvasProperties |
Handle pattern for implementation object. | |
Private Member Functions | |
QgsMapCanvas (QgsMapCanvas const &) | |
this class is non-copyable | |
void | connectNotify (const char *signal) |
debugging member invoked when a connect() is made to this object | |
Private Attributes | |
QgsMapRenderer * | mMapRenderer |
all map rendering is done in this class | |
QgsMapCanvasMap * | mMap |
owns pixmap with rendered map and controls rendering | |
QgsMapOverviewCanvas * | mMapOverview |
map overview widget - it's controlled by QgsMapCanvas | |
bool | mDrawing |
Flag indicating a map refresh is in progress. | |
bool | mFrozen |
Flag indicating if the map canvas is frozen. | |
bool | mDirty |
Flag to track the state of the Map canvas. | |
bool | mRenderFlag |
determines whether user has requested to suppress rendering | |
QList< QPair< int, int > > | mResizeQueue |
Resize events that have been ignored because the canvas is busy with rendering may put their sizes into this list. | |
QgsMapLayer * | mCurrentLayer |
current layer in legend | |
QGraphicsScene * | mScene |
graphics scene manages canvas items | |
QgsMapTool * | mMapTool |
pointer to current map tool | |
QgsMapTool * | mLastNonZoomMapTool |
previous tool if current is for zooming/panning | |
QList< QgsRectangle > | mLastExtent |
recently used extent | |
int | mLastExtentIndex |
double | mWheelZoomFactor |
Scale factor multiple for default zoom in/out. | |
WheelAction | mWheelAction |
Mouse wheel action. | |
QSize | mNewSize |
resize canvas size | |
bool | mPainting |
currently in paint event | |
bool | mAntiAliasing |
indicates whether antialiasing will be used for rendering |
Map canvas is a class for displaying all GIS data types on a canvas.
Definition at line 94 of file qgsmapcanvas.h.
Definition at line 100 of file qgsmapcanvas.h.
QgsMapCanvas::QgsMapCanvas | ( | QWidget * | parent = 0 , |
const char * | name = 0 |
||
) |
Constructor.
Definition at line 80 of file qgsmapcanvas.cpp.
References QgsProject::instance(), mCurrentLayer, mDirty, mDrawing, mFrozen, mLastExtentIndex, mLastNonZoomMapTool, mMap, mMapOverview, mMapRenderer, mMapTool, moveCanvasContents(), mRenderFlag, mScene, readProject(), QgsMapCanvasMap::resize(), setWheelAction(), showError(), WheelZoom, and writeProject().
Destructor.
Definition at line 136 of file qgsmapcanvas.cpp.
References QgsMapTool::deactivate(), mLastNonZoomMapTool, mMapRenderer, mMapTool, and mScene.
QgsMapCanvas::QgsMapCanvas | ( | QgsMapCanvas const & | ) | [private] |
this class is non-copyable
Otherwise std::auto_ptr would pass the object responsiblity on to the copy like a hot potato leaving the copyer in a weird state.
bool QgsMapCanvas::antiAliasingEnabled | ( | ) | const [inline] |
true if antialising is enabled
Definition at line 248 of file qgsmapcanvas.h.
Referenced by QgsMapCanvasItem::paint().
QColor QgsMapCanvas::canvasColor | ( | ) | const [virtual] |
Read property of QColor bgColor.
Definition at line 1197 of file qgsmapcanvas.cpp.
References mScene.
Referenced by QgsQuickPrint::setMapCanvas().
QPaintDevice & QgsMapCanvas::canvasPaintDevice | ( | ) |
Accessor for the canvas paint device.
Definition at line 1267 of file qgsmapcanvas.cpp.
References mMap, and QgsMapCanvasMap::paintDevice().
Referenced by canvasPixmap().
QPixmap & QgsMapCanvas::canvasPixmap | ( | ) |
Accessor for the canvas pixmap.
Definition at line 1242 of file qgsmapcanvas.cpp.
References canvasPaintDevice(), mMap, and QgsMapCanvasMap::paintDevice().
void QgsMapCanvas::clear | ( | ) |
Clear the map canvas.
Definition at line 557 of file qgsmapcanvas.cpp.
References setDirty().
Referenced by refresh().
void QgsMapCanvas::clearExtentHistory | ( | ) |
Definition at line 635 of file qgsmapcanvas.cpp.
References extent(), mLastExtent, mLastExtentIndex, zoomLastStatusChanged(), and zoomNextStatusChanged().
Referenced by readProject().
void QgsMapCanvas::connectNotify | ( | const char * | signal | ) | [private] |
debugging member invoked when a connect() is made to this object
Definition at line 1309 of file qgsmapcanvas.cpp.
References QgsDebugMsg.
returns current layer (set by legend widget)
Definition at line 364 of file qgsmapcanvas.cpp.
References mCurrentLayer.
Referenced by setLayerSet(), QgsMapCanvasSnapper::snapToBackgroundLayers(), and QgsMapCanvasSnapper::snapToCurrentLayer().
void QgsMapCanvas::enableAntiAliasing | ( | bool | theFlag | ) |
used to determine if anti-aliasing is enabled or not
Definition at line 165 of file qgsmapcanvas.cpp.
References QgsMapCanvasMap::enableAntiAliasing(), QgsMapOverviewCanvas::enableAntiAliasing(), mAntiAliasing, mMap, and mMapOverview.
void QgsMapCanvas::enableOverviewMode | ( | QgsMapOverviewCanvas * | overview | ) |
Definition at line 328 of file qgsmapcanvas.cpp.
References hasCrsTransformEnabled(), mMapOverview, and mMapRenderer.
QgsRectangle QgsMapCanvas::extent | ( | ) | const |
Returns the current zoom exent of the map canvas.
Definition at line 472 of file qgsmapcanvas.cpp.
References QgsMapRenderer::extent(), and mMapRenderer.
Referenced by QgsRubberBand::addGeometry(), QgsMapToolZoom::canvasReleaseEvent(), clearExtentHistory(), QgsMapOverviewCanvas::drawExtentRect(), QgsMapTip::fetchFeature(), QgsMapOverviewCanvas::mouseReleaseEvent(), setExtent(), QgsFormAnnotationItem::setFeatureForMapPosition(), wheelEvent(), zoomToFullExtent(), and zoomToSelected().
void QgsMapCanvas::extentsChanged | ( | ) | [signal] |
Emitted when the extents of the map change.
Referenced by paintEvent(), setExtent(), zoomToNextExtent(), and zoomToPreviousExtent().
void QgsMapCanvas::freeze | ( | bool | frz = true | ) |
Freeze/thaw the map canvas. This is used to prevent the canvas from responding to events while layers are being added/removed etc.
frz | Boolean specifying if the canvas should be frozen (true) or thawed (false). Default is true. |
Definition at line 1231 of file qgsmapcanvas.cpp.
References mFrozen.
QgsRectangle QgsMapCanvas::fullExtent | ( | ) | const |
Returns the combined exent for all layers on the map canvas.
Definition at line 477 of file qgsmapcanvas.cpp.
References QgsMapRenderer::fullExtent(), and mMapRenderer.
Referenced by setLayerSet(), updateFullExtent(), and zoomToFullExtent().
const QgsMapToPixel * QgsMapCanvas::getCoordinateTransform | ( | ) |
Get the current coordinate transform.
Definition at line 230 of file qgsmapcanvas.cpp.
References QgsMapRenderer::coordinateTransform(), and mMapRenderer.
Referenced by QgsMapToolPan::canvasReleaseEvent(), QgsMapToolZoom::canvasReleaseEvent(), mouseMoveEvent(), panActionEnd(), QgsRubberBand::setToCanvasRectangle(), QgsMapCanvasItem::toCanvasCoordinates(), QgsMapTool::toCanvasCoordinates(), QgsMapCanvasItem::toMapCoordinates(), QgsMapTool::toMapCoordinates(), wheelEvent(), and zoomWithCenter().
bool QgsMapCanvas::hasCrsTransformEnabled | ( | ) | [slot] |
A simple helper method to find out if on the fly projections are enabled or not.
Definition at line 646 of file qgsmapcanvas.cpp.
References QgsMapRenderer::hasCrsTransformEnabled(), and mMapRenderer.
Referenced by enableOverviewMode().
bool QgsMapCanvas::isDirty | ( | ) | const |
Return the state of the canvas (dirty or not)
Definition at line 215 of file qgsmapcanvas.cpp.
References mDirty.
bool QgsMapCanvas::isDrawing | ( | ) |
true if canvas currently drawing
Definition at line 222 of file qgsmapcanvas.cpp.
References mDrawing.
bool QgsMapCanvas::isFrozen | ( | ) |
Accessor for frozen status of canvas
Definition at line 1236 of file qgsmapcanvas.cpp.
References mFrozen.
void QgsMapCanvas::keyPressed | ( | QKeyEvent * | e | ) | [signal] |
Emit key press event.
Referenced by keyPressEvent().
void QgsMapCanvas::keyPressEvent | ( | QKeyEvent * | e | ) | [protected] |
Overridden key press event.
Definition at line 716 of file qgsmapcanvas.cpp.
References QgsMapRenderer::extent(), keyPressed(), QgsMapTool::keyPressEvent(), mCanvasProperties, mDrawing, mMapRenderer, mMapTool, QgsDebugMsg, refresh(), setExtent(), QgsRectangle::setXMaximum(), QgsRectangle::setXMinimum(), QgsRectangle::setYMaximum(), QgsRectangle::setYMinimum(), QgsRectangle::xMaximum(), QgsRectangle::xMinimum(), QgsRectangle::yMaximum(), QgsRectangle::yMinimum(), zoomIn(), and zoomOut().
void QgsMapCanvas::keyReleased | ( | QKeyEvent * | e | ) | [signal] |
Emit key release event.
Referenced by keyReleaseEvent().
void QgsMapCanvas::keyReleaseEvent | ( | QKeyEvent * | e | ) | [protected] |
Overridden key release event.
Definition at line 816 of file qgsmapcanvas.cpp.
References keyReleased(), QgsMapTool::keyReleaseEvent(), mCanvasProperties, mDrawing, mMapTool, panActionEnd(), and QgsDebugMsg.
QgsMapLayer * QgsMapCanvas::layer | ( | int | index | ) |
return the map layer at position index in the layer stack
Definition at line 190 of file qgsmapcanvas.cpp.
References QgsMapLayerRegistry::instance(), layers(), QgsMapRenderer::layerSet(), QgsMapLayerRegistry::mapLayer(), and mMapRenderer.
Referenced by layers(), selectionChangedSlot(), setCurrentLayer(), and setLayerSet().
int QgsMapCanvas::layerCount | ( | ) | const |
return number of layers on the map
Definition at line 1202 of file qgsmapcanvas.cpp.
References QgsMapRenderer::layerSet(), and mMapRenderer.
Referenced by setLayerSet().
QList< QgsMapLayer * > QgsMapCanvas::layers | ( | ) | const |
return list of layers within map canvas. Added in v1.5
Definition at line 1208 of file qgsmapcanvas.cpp.
References QgsMapLayerRegistry::instance(), layer(), QgsMapRenderer::layerSet(), QgsMapLayerRegistry::mapLayer(), and mMapRenderer.
Referenced by layer(), and QgsFormAnnotationItem::updateVisibility().
void QgsMapCanvas::layersChanged | ( | ) | [signal] |
Emitted when a new set of layers has been received.
Referenced by setLayerSet().
void QgsMapCanvas::layerStateChange | ( | ) | [slot] |
This slot is connected to the visibility change of one or more layers.
Definition at line 1221 of file qgsmapcanvas.cpp.
References refresh().
Definition at line 179 of file qgsmapcanvas.cpp.
References mMap.
Definition at line 184 of file qgsmapcanvas.cpp.
References mMapRenderer.
Referenced by QgsRubberBand::addGeometry(), QgsMapOverviewCanvas::destinationSrsChanged(), QgsMapCanvasSnapper::QgsMapCanvasSnapper(), QgsMapCanvasMap::render(), QgsMapCanvasMap::resize(), QgsQuickPrint::setMapCanvas(), QgsMapCanvasSnapper::setMapCanvas(), QgsMapCanvasItem::setRenderContextVariables(), QgsMapCanvasSnapper::snapToBackgroundLayers(), QgsMapCanvasSnapper::snapToCurrentLayer(), QgsMapTool::toLayerCoordinates(), and QgsMapTool::toMapCoordinates().
Returns the currently active tool.
Definition at line 1316 of file qgsmapcanvas.cpp.
References mMapTool.
void QgsMapCanvas::mapToolSet | ( | QgsMapTool * | tool | ) | [signal] |
Emit map tool changed event.
Referenced by setMapTool(), and unsetMapTool().
QGis::UnitType QgsMapCanvas::mapUnits | ( | ) | const |
Get the current canvas map units.
Definition at line 1285 of file qgsmapcanvas.cpp.
References QgsMapRenderer::mapUnits(), and mMapRenderer.
void QgsMapCanvas::mapUnitsChanged | ( | ) | [slot] |
The map units may have changed, so cope with that.
Definition at line 651 of file qgsmapcanvas.cpp.
References refresh(), and updateScale().
double QgsMapCanvas::mapUnitsPerPixel | ( | ) | const |
Returns the mapUnitsPerPixel (map units per pixel) for the canvas.
Definition at line 1272 of file qgsmapcanvas.cpp.
References QgsMapRenderer::mapUnitsPerPixel(), and mMapRenderer.
Referenced by saveAsImage().
void QgsMapCanvas::mouseDoubleClickEvent | ( | QMouseEvent * | e | ) | [protected] |
Overridden mouse double click event.
Definition at line 854 of file qgsmapcanvas.cpp.
References QgsMapTool::canvasDoubleClickEvent(), mDrawing, and mMapTool.
QPoint QgsMapCanvas::mouseLastXY | ( | ) |
returns last position of mouse cursor
Definition at line 1438 of file qgsmapcanvas.cpp.
References mCanvasProperties.
void QgsMapCanvas::mouseMoveEvent | ( | QMouseEvent * | e | ) | [protected] |
Overridden mouse move event.
Definition at line 1105 of file qgsmapcanvas.cpp.
References QgsMapTool::canvasMoveEvent(), getCoordinateTransform(), mCanvasProperties, mDrawing, mMapTool, panAction(), QgsMapToPixel::toMapCoordinates(), and xyCoordinates().
void QgsMapCanvas::mousePressEvent | ( | QMouseEvent * | e | ) | [protected] |
Overridden mouse press event.
Definition at line 867 of file qgsmapcanvas.cpp.
References QgsMapTool::canvasPressEvent(), mCanvasProperties, mDrawing, and mMapTool.
void QgsMapCanvas::mouseReleaseEvent | ( | QMouseEvent * | e | ) | [protected] |
Overridden mouse release event.
Definition at line 899 of file qgsmapcanvas.cpp.
References QgsMapTool::canvasReleaseEvent(), QgsVectorLayer::isEditable(), QgsMapTool::isEditTool(), QgsMapTool::isTransient(), mCanvasProperties, mCurrentLayer, mDrawing, mLastNonZoomMapTool, mMapTool, panActionEnd(), QgsDebugMsg, and setMapTool().
void QgsMapCanvas::moveCanvasContents | ( | bool | reset = false | ) | [protected] |
called when panning is in action, reset indicates end of panning
Definition at line 1383 of file qgsmapcanvas.cpp.
References mCanvasProperties, mDrawing, mMap, mScene, QgsMapCanvasMap::setPanningOffset(), QgsMapCanvasItem::setPanningOffset(), and updateCanvasItemPositions().
Referenced by panAction(), panActionEnd(), and QgsMapCanvas().
void QgsMapCanvas::paintEvent | ( | QPaintEvent * | e | ) | [protected] |
Overridden paint event.
Definition at line 952 of file qgsmapcanvas.cpp.
References extentsChanged(), mDrawing, mMap, mMapRenderer, mNewSize, mPainting, mScene, refresh(), QgsMapRenderer::rendererContext(), QgsMapCanvasMap::resize(), QgsRenderContext::setRenderingStopped(), updateCanvasItemPositions(), and updateScale().
void QgsMapCanvas::panAction | ( | QMouseEvent * | event | ) |
Called when mouse is moving and pan is activated.
Definition at line 1369 of file qgsmapcanvas.cpp.
References mDrawing, and moveCanvasContents().
Referenced by QgsMapToolPan::canvasMoveEvent(), and mouseMoveEvent().
void QgsMapCanvas::panActionEnd | ( | QPoint | releasePoint | ) |
Ends pan action and redraws the canvas.
Definition at line 1321 of file qgsmapcanvas.cpp.
References QgsMapRenderer::extent(), getCoordinateTransform(), mCanvasProperties, mDrawing, mMapRenderer, moveCanvasContents(), refresh(), setExtent(), QgsRectangle::setXMinimum(), QgsMapToPixel::toMapCoordinates(), QgsPoint::x(), and QgsPoint::y().
Referenced by QgsMapToolPan::canvasReleaseEvent(), keyReleaseEvent(), and mouseReleaseEvent().
void QgsMapCanvas::readProject | ( | const QDomDocument & | doc | ) | [slot] |
called to read map canvas settings from project
Definition at line 1443 of file qgsmapcanvas.cpp.
References clearExtentHistory(), mMapRenderer, QgsDebugMsg, and QgsMapRenderer::readXML().
Referenced by QgsMapCanvas().
void QgsMapCanvas::refresh | ( | ) | [slot] |
Repaints the canvas map.
Definition at line 370 of file qgsmapcanvas.cpp.
References clear(), mDirty, mDrawing, mFrozen, mMap, mMapTool, mRenderFlag, QgsMapCanvasMap::paintDevice(), QgsMapCanvasMap::render(), QgsMapTool::renderComplete(), renderComplete(), and renderStarting().
Referenced by QgsMapToolPan::canvasReleaseEvent(), QgsMapToolZoom::canvasReleaseEvent(), keyPressEvent(), layerStateChange(), mapUnitsChanged(), QgsMapOverviewCanvas::mouseReleaseEvent(), paintEvent(), panActionEnd(), selectionChangedSlot(), setLayerSet(), setRenderFlag(), updateFullExtent(), useImageToRender(), wheelEvent(), zoomByFactor(), zoomToFullExtent(), zoomToNextExtent(), zoomToPreviousExtent(), zoomToSelected(), and zoomWithCenter().
void QgsMapCanvas::renderComplete | ( | QPainter * | ) | [signal] |
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.
Referenced by refresh(), and saveAsImage().
bool QgsMapCanvas::renderFlag | ( | ) | [inline, slot] |
State of render suppression flag.
Definition at line 281 of file qgsmapcanvas.h.
void QgsMapCanvas::renderStarting | ( | ) | [signal] |
void QgsMapCanvas::resizeEvent | ( | QResizeEvent * | e | ) | [protected] |
void QgsMapCanvas::saveAsImage | ( | QString | theFileName, |
QPixmap * | QPixmap = 0 , |
||
QString | theFormat = "PNG" |
||
) | [slot] |
Save the convtents of the map canvas to disk as an image.
Definition at line 417 of file qgsmapcanvas.cpp.
References QgsMapRenderer::extent(), mapUnitsPerPixel(), mMap, mMapRenderer, QgsMapCanvasMap::paintDevice(), QgsMapRenderer::render(), renderComplete(), QgsRectangle::xMinimum(), and QgsRectangle::yMaximum().
double QgsMapCanvas::scale | ( | void | ) |
Get the last reported scale of the canvas.
Definition at line 205 of file qgsmapcanvas.cpp.
References mMapRenderer, and QgsMapRenderer::scale().
Referenced by QgsMapCanvasItem::setRenderContextVariables(), updateScale(), and zoomScale().
void QgsMapCanvas::scaleChanged | ( | double | ) | [signal] |
Emitted when the scale of the map changes.
Referenced by updateScale().
void QgsMapCanvas::selectionChanged | ( | QgsMapLayer * | layer | ) | [signal] |
Emitted when selection in any layer gets changed.
Referenced by selectionChangedSlot(), and setLayerSet().
void QgsMapCanvas::selectionChangedSlot | ( | ) | [slot] |
Receives signal about selection change, and pass it on with layer info.
Definition at line 1491 of file qgsmapcanvas.cpp.
References layer(), refresh(), and selectionChanged().
Referenced by setLayerSet().
void QgsMapCanvas::setCanvasColor | ( | const QColor & | theColor | ) | [virtual] |
Write property of QColor bgColor.
Definition at line 1179 of file qgsmapcanvas.cpp.
References mMap, mScene, and QgsMapCanvasMap::setBackgroundColor().
void QgsMapCanvas::setCurrentLayer | ( | QgsMapLayer * | layer | ) |
Definition at line 200 of file qgsmapcanvas.cpp.
References layer(), and mCurrentLayer.
void QgsMapCanvas::setDirty | ( | bool | _dirty | ) |
Flag the canvas as dirty and needed a refresh.
Definition at line 210 of file qgsmapcanvas.cpp.
References mDirty.
Referenced by clear().
void QgsMapCanvas::setExtent | ( | QgsRectangle const & | r | ) |
Set the extent of the map canvas.
Definition at line 497 of file qgsmapcanvas.cpp.
References QgsRectangle::center(), QgsMapOverviewCanvas::drawExtentRect(), extent(), extentsChanged(), QgsRectangle::height(), QgsRectangle::isEmpty(), mDrawing, mLastExtent, mLastExtentIndex, mMapOverview, mMapRenderer, QgsDebugMsg, QgsMapRenderer::setExtent(), updateCanvasItemPositions(), updateScale(), QgsRectangle::width(), QgsPoint::x(), QgsPoint::y(), zoomLastStatusChanged(), and zoomNextStatusChanged().
Referenced by QgsMapToolPan::canvasReleaseEvent(), QgsMapToolZoom::canvasReleaseEvent(), keyPressEvent(), QgsMapOverviewCanvas::mouseReleaseEvent(), panActionEnd(), wheelEvent(), zoomByFactor(), zoomToFullExtent(), zoomToSelected(), and zoomWithCenter().
void QgsMapCanvas::setLayerSet | ( | QList< QgsMapCanvasLayer > & | layers | ) |
Definition at line 235 of file qgsmapcanvas.cpp.
References currentLayer(), fullExtent(), QgsMapLayer::id(), QgsMapCanvasLayer::isInOverview(), QgsMapCanvasLayer::isVisible(), QgsMapCanvasLayer::layer(), layer(), layerCount(), layersChanged(), QgsMapOverviewCanvas::layerSet(), QgsMapRenderer::layerSet(), mDrawing, mMapOverview, mMapRenderer, QgsDebugMsg, refresh(), selectionChanged(), selectionChangedSlot(), QgsMapOverviewCanvas::setLayerSet(), QgsMapRenderer::setLayerSet(), QgsMapOverviewCanvas::updateFullExtent(), updateMap(), and updateOverview().
void QgsMapCanvas::setMapTool | ( | QgsMapTool * | mapTool | ) |
Sets the map tool currently being used on the canvas.
Definition at line 1134 of file qgsmapcanvas.cpp.
References QgsMapTool::activate(), QgsMapTool::deactivate(), QgsMapTool::isTransient(), mapToolSet(), mLastNonZoomMapTool, and mMapTool.
Referenced by mouseReleaseEvent().
void QgsMapCanvas::setMapUnits | ( | QGis::UnitType | mapUnits | ) |
Set map units (needed by project properties dialog)
Definition at line 1278 of file qgsmapcanvas.cpp.
References mMapRenderer, QgsDebugMsg, and QgsMapRenderer::setMapUnits().
void QgsMapCanvas::setProgress | ( | int | , |
int | |||
) | [signal] |
Let the owner know how far we are with render operations.
void QgsMapCanvas::setRenderFlag | ( | bool | theFlag | ) | [slot] |
Whether to suppress rendering or not.
Definition at line 1291 of file qgsmapcanvas.cpp.
References mMapRenderer, mRenderFlag, refresh(), QgsMapRenderer::rendererContext(), and QgsRenderContext::setRenderingStopped().
void QgsMapCanvas::setWheelAction | ( | WheelAction | action, |
double | factor = 2 |
||
) |
set wheel action and zoom factor (should be greater than 1)
Definition at line 1067 of file qgsmapcanvas.cpp.
References mWheelAction, and mWheelZoomFactor.
Referenced by QgsMapCanvas().
void QgsMapCanvas::showError | ( | QgsMapLayer * | mapLayer | ) | [slot] |
show whatever error is exposed by the QgsMapLayer.
Definition at line 1418 of file qgsmapcanvas.cpp.
References QgsMapLayer::lastError(), QgsMapLayer::lastErrorTitle(), QgsMapLayer::name(), and QgsMessageViewer::setMessageAsPlainText().
Referenced by QgsMapCanvas().
void QgsMapCanvas::unsetMapTool | ( | QgsMapTool * | mapTool | ) |
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.
Definition at line 1162 of file qgsmapcanvas.cpp.
References QgsMapTool::deactivate(), mapToolSet(), mLastNonZoomMapTool, and mMapTool.
Referenced by QgsMapTool::~QgsMapTool().
void QgsMapCanvas::updateCanvasItemPositions | ( | ) | [protected] |
called on resize or changed extent to notify canvas items to change their rectangle
Definition at line 998 of file qgsmapcanvas.cpp.
References mScene, and QgsMapCanvasItem::updatePosition().
Referenced by moveCanvasContents(), paintEvent(), setExtent(), zoomToNextExtent(), and zoomToPreviousExtent().
void QgsMapCanvas::updateFullExtent | ( | ) |
Updates the full extent.
Definition at line 482 of file qgsmapcanvas.cpp.
References fullExtent(), mMapOverview, mMapRenderer, QgsDebugMsg, refresh(), QgsMapOverviewCanvas::updateFullExtent(), QgsMapRenderer::updateFullExtent(), and updateOverview().
void QgsMapCanvas::updateMap | ( | ) | [slot] |
updates pixmap on render progress
Definition at line 408 of file qgsmapcanvas.cpp.
References mMap, and QgsMapCanvasMap::updateContents().
Referenced by setLayerSet().
void QgsMapCanvas::updateOverview | ( | ) |
Definition at line 354 of file qgsmapcanvas.cpp.
References mMapOverview, and QgsMapOverviewCanvas::refresh().
Referenced by setLayerSet(), and updateFullExtent().
void QgsMapCanvas::updateScale | ( | ) |
Emits signal scalChanged to update scale in main window.
Definition at line 549 of file qgsmapcanvas.cpp.
References mMapRenderer, scale(), QgsMapRenderer::scale(), and scaleChanged().
Referenced by mapUnitsChanged(), paintEvent(), setExtent(), zoomToNextExtent(), and zoomToPreviousExtent().
void QgsMapCanvas::useImageToRender | ( | bool | theFlag | ) |
Select which Qt class to render with.
Definition at line 173 of file qgsmapcanvas.cpp.
References mMap, refresh(), and QgsMapCanvasMap::useImageToRender().
void QgsMapCanvas::wheelEvent | ( | QWheelEvent * | e | ) | [protected] |
Overridden mouse wheel event.
Definition at line 1016 of file qgsmapcanvas.cpp.
References QgsRectangle::center(), QgsMapRenderer::extent(), extent(), getCoordinateTransform(), mDrawing, mMapRenderer, mWheelAction, mWheelZoomFactor, QgsDebugMsg, refresh(), QgsRectangle::scale(), setExtent(), WheelNothing, WheelZoom, WheelZoomAndRecenter, WheelZoomToMouseCursor, zoomIn(), zoomOut(), and zoomWithCenter().
void QgsMapCanvas::writeProject | ( | QDomDocument & | doc | ) | [slot] |
called to write map canvas settings to project
Definition at line 1459 of file qgsmapcanvas.cpp.
References mMapRenderer, QgsDebugMsg, and QgsMapRenderer::writeXML().
Referenced by QgsMapCanvas().
void QgsMapCanvas::xyCoordinates | ( | const QgsPoint & | p | ) | [signal] |
void QgsMapCanvas::zoomByFactor | ( | double | scaleFactor | ) |
Zoom with the factor supplied. Factor > 1 zooms out, interval (0,1) zooms in.
Definition at line 1478 of file qgsmapcanvas.cpp.
References QgsMapRenderer::extent(), mDrawing, mMapRenderer, refresh(), QgsRectangle::scale(), and setExtent().
Referenced by zoomIn(), zoomOut(), and zoomScale().
void QgsMapCanvas::zoomIn | ( | ) |
Zoom in with fixed factor.
Definition at line 1073 of file qgsmapcanvas.cpp.
References mWheelZoomFactor, and zoomByFactor().
Referenced by keyPressEvent(), and wheelEvent().
void QgsMapCanvas::zoomLastStatusChanged | ( | bool | ) | [signal] |
Emitted when zoom last status changed.
Referenced by clearExtentHistory(), setExtent(), zoomToNextExtent(), and zoomToPreviousExtent().
void QgsMapCanvas::zoomNextStatusChanged | ( | bool | ) | [signal] |
Emitted when zoom next status changed.
Referenced by clearExtentHistory(), setExtent(), zoomToNextExtent(), and zoomToPreviousExtent().
void QgsMapCanvas::zoomOut | ( | ) |
Zoom out with fixed factor.
Definition at line 1078 of file qgsmapcanvas.cpp.
References mWheelZoomFactor, and zoomByFactor().
Referenced by keyPressEvent(), and wheelEvent().
void QgsMapCanvas::zoomScale | ( | double | scale | ) |
Zoom to a specific scale.
Definition at line 1083 of file qgsmapcanvas.cpp.
References scale(), and zoomByFactor().
void QgsMapCanvas::zoomToFullExtent | ( | ) |
Zoom to the full extent of all layers.
Definition at line 566 of file qgsmapcanvas.cpp.
References extent(), fullExtent(), QgsRectangle::isEmpty(), mDrawing, refresh(), QgsRectangle::scale(), and setExtent().
void QgsMapCanvas::zoomToNextExtent | ( | ) |
Zoom to the Next extent (view)
Definition at line 612 of file qgsmapcanvas.cpp.
References QgsMapOverviewCanvas::drawExtentRect(), extentsChanged(), mDrawing, mLastExtent, mLastExtentIndex, mMapOverview, mMapRenderer, refresh(), QgsMapRenderer::setExtent(), updateCanvasItemPositions(), updateScale(), zoomLastStatusChanged(), and zoomNextStatusChanged().
void QgsMapCanvas::zoomToPreviousExtent | ( | ) |
Zoom to the previous extent (view)
Definition at line 587 of file qgsmapcanvas.cpp.
References QgsMapOverviewCanvas::drawExtentRect(), extentsChanged(), mDrawing, mLastExtent, mLastExtentIndex, mMapOverview, mMapRenderer, refresh(), QgsMapRenderer::setExtent(), updateCanvasItemPositions(), updateScale(), zoomLastStatusChanged(), and zoomNextStatusChanged().
void QgsMapCanvas::zoomToSelected | ( | QgsVectorLayer * | layer = NULL | ) |
Zoom to the extent of the selected features of current (vector) layer.
Added in version 1.2: optionally specify different than current layer
Definition at line 669 of file qgsmapcanvas.cpp.
References QgsVectorLayer::boundingBoxOfSelected(), QgsRectangle::center(), QgsRectangle::expand(), extent(), QgsRectangle::isEmpty(), QgsMapRenderer::layerExtentToOutputExtent(), mCurrentLayer, mDrawing, mMapRenderer, refresh(), QgsRectangle::scale(), QgsVectorLayer::selectedFeatureCount(), and setExtent().
void QgsMapCanvas::zoomWithCenter | ( | int | x, |
int | y, | ||
bool | zoomIn | ||
) |
Zooms in/out with a given center.
Definition at line 1088 of file qgsmapcanvas.cpp.
References QgsMapRenderer::extent(), getCoordinateTransform(), mDrawing, mMapRenderer, mWheelZoomFactor, refresh(), QgsRectangle::scale(), setExtent(), and QgsMapToPixel::toMapPoint().
Referenced by QgsMapToolZoom::canvasReleaseEvent(), and wheelEvent().
bool QgsMapCanvas::mAntiAliasing [private] |
indicates whether antialiasing will be used for rendering
Definition at line 470 of file qgsmapcanvas.h.
Referenced by enableAntiAliasing().
std::auto_ptr<CanvasProperties> QgsMapCanvas::mCanvasProperties [protected] |
Handle pattern for implementation object.
Definition at line 387 of file qgsmapcanvas.h.
Referenced by keyPressEvent(), keyReleaseEvent(), mouseLastXY(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), moveCanvasContents(), and panActionEnd().
QgsMapLayer* QgsMapCanvas::mCurrentLayer [private] |
current layer in legend
Definition at line 442 of file qgsmapcanvas.h.
Referenced by currentLayer(), mouseReleaseEvent(), QgsMapCanvas(), setCurrentLayer(), and zoomToSelected().
bool QgsMapCanvas::mDirty [private] |
Flag to track the state of the Map canvas.
The canvas is flagged as dirty by any operation that changes the state of the layers or the view extent. If the canvas is not dirty, paint events are handled by bit-blitting the stored canvas bitmap to the canvas. This improves performance by not reading the data source when no real change has occurred
Definition at line 426 of file qgsmapcanvas.h.
Referenced by isDirty(), QgsMapCanvas(), refresh(), and setDirty().
bool QgsMapCanvas::mDrawing [private] |
Flag indicating a map refresh is in progress.
Definition at line 412 of file qgsmapcanvas.h.
Referenced by isDrawing(), keyPressEvent(), keyReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), moveCanvasContents(), paintEvent(), panAction(), panActionEnd(), QgsMapCanvas(), refresh(), setExtent(), setLayerSet(), wheelEvent(), zoomByFactor(), zoomToFullExtent(), zoomToNextExtent(), zoomToPreviousExtent(), zoomToSelected(), and zoomWithCenter().
bool QgsMapCanvas::mFrozen [private] |
Flag indicating if the map canvas is frozen.
Definition at line 415 of file qgsmapcanvas.h.
Referenced by freeze(), isFrozen(), QgsMapCanvas(), and refresh().
QList<QgsRectangle> QgsMapCanvas::mLastExtent [private] |
recently used extent
Definition at line 454 of file qgsmapcanvas.h.
Referenced by clearExtentHistory(), setExtent(), zoomToNextExtent(), and zoomToPreviousExtent().
int QgsMapCanvas::mLastExtentIndex [private] |
Definition at line 455 of file qgsmapcanvas.h.
Referenced by clearExtentHistory(), QgsMapCanvas(), setExtent(), zoomToNextExtent(), and zoomToPreviousExtent().
QgsMapTool* QgsMapCanvas::mLastNonZoomMapTool [private] |
previous tool if current is for zooming/panning
Definition at line 451 of file qgsmapcanvas.h.
Referenced by mouseReleaseEvent(), QgsMapCanvas(), setMapTool(), unsetMapTool(), and ~QgsMapCanvas().
QgsMapCanvasMap* QgsMapCanvas::mMap [private] |
owns pixmap with rendered map and controls rendering
Definition at line 406 of file qgsmapcanvas.h.
Referenced by canvasPaintDevice(), canvasPixmap(), enableAntiAliasing(), map(), moveCanvasContents(), paintEvent(), QgsMapCanvas(), refresh(), saveAsImage(), setCanvasColor(), updateMap(), and useImageToRender().
QgsMapOverviewCanvas* QgsMapCanvas::mMapOverview [private] |
map overview widget - it's controlled by QgsMapCanvas
Definition at line 409 of file qgsmapcanvas.h.
Referenced by enableAntiAliasing(), enableOverviewMode(), QgsMapCanvas(), setExtent(), setLayerSet(), updateFullExtent(), updateOverview(), zoomToNextExtent(), and zoomToPreviousExtent().
QgsMapRenderer* QgsMapCanvas::mMapRenderer [private] |
all map rendering is done in this class
Definition at line 403 of file qgsmapcanvas.h.
Referenced by enableOverviewMode(), extent(), fullExtent(), getCoordinateTransform(), hasCrsTransformEnabled(), keyPressEvent(), layer(), layerCount(), layers(), mapRenderer(), mapUnits(), mapUnitsPerPixel(), paintEvent(), panActionEnd(), QgsMapCanvas(), readProject(), saveAsImage(), scale(), setExtent(), setLayerSet(), setMapUnits(), setRenderFlag(), updateFullExtent(), updateScale(), wheelEvent(), writeProject(), zoomByFactor(), zoomToNextExtent(), zoomToPreviousExtent(), zoomToSelected(), zoomWithCenter(), and ~QgsMapCanvas().
QgsMapTool* QgsMapCanvas::mMapTool [private] |
pointer to current map tool
Definition at line 448 of file qgsmapcanvas.h.
Referenced by keyPressEvent(), keyReleaseEvent(), mapTool(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), QgsMapCanvas(), refresh(), setMapTool(), unsetMapTool(), and ~QgsMapCanvas().
QSize QgsMapCanvas::mNewSize [private] |
resize canvas size
Definition at line 464 of file qgsmapcanvas.h.
Referenced by paintEvent(), and resizeEvent().
bool QgsMapCanvas::mPainting [private] |
bool QgsMapCanvas::mRenderFlag [private] |
determines whether user has requested to suppress rendering
Definition at line 429 of file qgsmapcanvas.h.
Referenced by QgsMapCanvas(), refresh(), and setRenderFlag().
QList< QPair<int, int> > QgsMapCanvas::mResizeQueue [private] |
Resize events that have been ignored because the canvas is busy with rendering may put their sizes into this list.
The canvas then picks up the last entry in case a lot of resize events arrive in short time
Definition at line 434 of file qgsmapcanvas.h.
QGraphicsScene* QgsMapCanvas::mScene [private] |
graphics scene manages canvas items
Definition at line 445 of file qgsmapcanvas.h.
Referenced by canvasColor(), moveCanvasContents(), paintEvent(), QgsMapCanvas(), setCanvasColor(), updateCanvasItemPositions(), and ~QgsMapCanvas().
WheelAction QgsMapCanvas::mWheelAction [private] |
Mouse wheel action.
Definition at line 461 of file qgsmapcanvas.h.
Referenced by setWheelAction(), and wheelEvent().
double QgsMapCanvas::mWheelZoomFactor [private] |
Scale factor multiple for default zoom in/out.
Definition at line 458 of file qgsmapcanvas.h.
Referenced by setWheelAction(), wheelEvent(), zoomIn(), zoomOut(), and zoomWithCenter().