/usr/include/qgis/qgsmapcanvasitem.h is in libqgis-dev 1.7.4+1.7.5~20120320-1.1+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 | /***************************************************************************
qgsmapcanvasitem.h - base class for map canvas items
----------------------
begin : February 2006
copyright : (C) 2006 by Martin Dobias
email : wonder.sk at gmail dot 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. *
* *
***************************************************************************/
/* $Id$ */
#ifndef QGSMAPCANVASITEM_H
#define QGSMAPCANVASITEM_H
#include <QGraphicsItem>
#include "qgsrectangle.h"
class QgsMapCanvas;
class QgsRenderContext;
class QPainter;
/** \ingroup gui
* An abstract class for items that can be placed on the
* map canvas.
*/
class GUI_EXPORT QgsMapCanvasItem : public QGraphicsItem
{
protected:
//! protected constructor: cannot be constructed directly
QgsMapCanvasItem( QgsMapCanvas* mapCanvas );
virtual ~QgsMapCanvasItem();
//! function to be implemented by derived classes
virtual void paint( QPainter * painter ) = 0;
//! paint function called by map canvas
virtual void paint( QPainter * painter,
const QStyleOptionGraphicsItem * option,
QWidget * widget = 0 );
//! schedules map canvas for repaint
void updateCanvas();
/**Sets render context parameters
@param p painter for rendering
@param context out: configured context
@return true in case of success
@note added in version 1.5*/
bool setRenderContextVariables( QPainter* p, QgsRenderContext& context ) const;
public:
//! called on changed extent or resize event to update position of the item
virtual void updatePosition();
//! default implementation for canvas items
virtual QRectF boundingRect() const;
//! sets current offset, to be called from QgsMapCanvas
void setPanningOffset( const QPoint& point );
//! returns canvas item rectangle
QgsRectangle rect() const;
//! sets canvas item rectangle
void setRect( const QgsRectangle& r );
//! transformation from screen coordinates to map coordinates
QgsPoint toMapCoordinates( const QPoint& point );
//! transformation from map coordinates to screen coordinates
QPointF toCanvasCoordinates( const QgsPoint& point );
protected:
//! pointer to map canvas
QgsMapCanvas* mMapCanvas;
//! canvas item rectangle (in map coordinates)
QgsRectangle mRect;
//! offset from normal position due current panning operation,
//! used when converting map coordinates to move map canvas items
QPoint mPanningOffset;
//! cached size of the item (to return in boundingRect())
QSizeF mItemSize;
};
#endif
|