sharpetronics/QGIS
1
0
Fork 0
mirror of https://github.com/qgis/QGIS.git synced 2025-02-25 00:58:06 -05:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #427 from matthias-kuhn/rubberband-doc

Browse Source 
Documentation update for QgsRubberband
This commit is contained in:
mhugent 2013-02-12 07:03:13 -08:00
commit df412ece90
2 changed files with 121 additions and 52 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
src/gui/qgsrubberband.cpp
View File

@ -111,7 +111,7 @@ void QgsRubberBand::reset( bool isPolygon )
/*! /*!
Add a point to the shape being created. Add a point to the shape being created.
*/ */
void QgsRubberBand::addPoint( const QgsPoint & p, bool do_update /* = true */, int geometryIndex ) void QgsRubberBand::addPoint( const QgsPoint & p, bool doUpdate /* = true */, int geometryIndex )
{ {
if ( geometryIndex < 0 ) if ( geometryIndex < 0 )
{ {
@ -139,7 +139,7 @@ void QgsRubberBand::addPoint( const QgsPoint & p, bool do_update /* = true */, i
} }
if ( do_update ) if ( doUpdate )
{ {
updateRect(); updateRect();
update(); update();

169
src/gui/qgsrubberband.h
View File

@ -27,6 +27,7 @@ class QPaintEvent;
/** \ingroup gui /** \ingroup gui
* A class for drawing transient features (e.g. digitising lines) on the map. * A class for drawing transient features (e.g. digitising lines) on the map.
* It may be used
*/ */
class GUI_EXPORT QgsRubberBand: public QgsMapCanvasItem class GUI_EXPORT QgsRubberBand: public QgsMapCanvasItem
{ {
@ -36,109 +37,175 @@ class GUI_EXPORT QgsRubberBand: public QgsMapCanvasItem
* Added in 1.9 */ * Added in 1.9 */
enum IconType enum IconType
{ {
/**
* No icon is used
*/
ICON_NONE, ICON_NONE,
/**
* A cross is used to highlight points (+)
*/
ICON_CROSS, ICON_CROSS,
/**
* A cross is used to highlight points (x)
*/
ICON_X, ICON_X,
/**
* A box is used to highlight points (□)
*/
ICON_BOX, ICON_BOX,
/**
* A circle is used to highlight points (○)
*/
ICON_CIRCLE ICON_CIRCLE
}; };
/** /**
* Creates a new RubberBand. * Creates a new RubberBand.
* @param mapCanvas The map canvas to draw onto. It's CRS will be used map points onto screen coordinates. * @param mapCanvas The map canvas to draw onto. It's CRS will be used map points onto screen coordinates.
* @param geometryType Defines how the data should be drawn onto the screen. (Use QGis::Line, QGis::Polygon or QGis::Point) * @param geometryType Defines how the data should be drawn onto the screen. (Use QGis::Line, QGis::Polygon or QGis::Point)
* Added in 1.9. * @note Added in 1.9.
*/ */
QgsRubberBand( QgsMapCanvas* mapCanvas, QGis::GeometryType geometryType = QGis::Line ); QgsRubberBand( QgsMapCanvas* mapCanvas, QGis::GeometryType geometryType = QGis::Line );
/** /**
* Creates a new RubberBand. * Creates a new RubberBand.
* @deprecated * @deprecated Use the constructor which takes QGis::GeometryType as second argument instead
* @param mapCanvas The map canvas to draw onto. It's CRS will be used map points onto screen coordinates. * @param mapCanvas The map canvas to draw onto. It's CRS will be used map points onto screen coordinates.
* @param isPolygon true: draw as (multi-)polygon, false draw as (multi-)linestring * @param isPolygon true: draw as (multi-)polygon, false draw as (multi-)linestring
*/ */
QgsRubberBand( QgsMapCanvas* mapCanvas, bool isPolygon ); QgsRubberBand( QgsMapCanvas* mapCanvas, bool isPolygon );
~QgsRubberBand(); ~QgsRubberBand();
/** Set the color for the rubberband */ /**
* Set the color for the rubberband
* @param color The color used to render this rubberband
*/
void setColor( const QColor & color ); void setColor( const QColor & color );
/** Set the width of the line. Outline width for polygon. */ /**
* Set the width of the line. Outline width for polygon.
* @param width The width for any lines painted for this rubberband
*/
void setWidth( int width ); void setWidth( int width );
/** Set the icon type to highlight point geometries. /**
* Added in 1.9 */ * Set the icon type to highlight point geometries.
* @param icon The icon to visualize point geometries
* @note Added in 1.9
*/
void setIcon( IconType icon ); void setIcon( IconType icon );
/** Set the size of the point icons /**
* Added in 1.9 */ * Set the size of the point icons
* @note Added in 1.9
*/
void setIconSize( int iconSize ); void setIconSize( int iconSize );
/** /**
* Clears all the geometries in this rubberband. * Clears all the geometries in this rubberband.
* Sets the representation type according to geometryType. * Sets the representation type according to geometryType.
* @param geometryType Defines how the data should be drawn onto the screen. (Use QGis::Line, QGis::Polygon or QGis::Point) * @param geometryType Defines how the data should be drawn onto the screen. (Use QGis::Line, QGis::Polygon or QGis::Point)
* Added in 1.9. * @note Added in 1.9.
*/ */
void reset( QGis::GeometryType geometryType = QGis::Line ); void reset( QGis::GeometryType geometryType = QGis::Line );
/** /**
* @deprecated * @deprecated Use the reset method which takes QGis::GeometryType as second argument instead
* Clears all the geometries in this rubberband. * Clears all the geometries in this rubberband.
* Sets the representation type according to isPolygon. * Sets the representation type according to isPolygon.
* @param isPolygon true: draw as (multi-)polygon, false draw as (multi-)linestring * @param isPolygon true: draw as (multi-)polygon, false draw as (multi-)linestring
*/ */
void reset( bool isPolygon ); void reset( bool isPolygon );
//! Add point to rubberband and update canvas /**
//! If adding more points consider using update=false for better performance * Add a vertex to the rubberband and update canvas.
//! geometryIndex is the index of the feature part (in case of multipart geometries) * The rendering of the vertex depends on the current GeometryType and icon.
void addPoint( const QgsPoint & p, bool update = true, int geometryIndex = 0 ); * If adding more points consider using update=false for better performance
* @param p The vertex/point to add
* @param doUpdate Should the map canvas be updated immediately?
* @param geometryIndex The index of the feature part (in case of multipart geometries)
*/
void addPoint( const QgsPoint & p, bool doUpdate = true, int geometryIndex = 0 );
//!Removes the last point. Most useful in connection with undo operations /**
* Removes the last point. Most useful in connection with undo operations
*/
void removeLastPoint( int geometryIndex = 0 ); void removeLastPoint( int geometryIndex = 0 );
/**
* Moves the rubber band point specified by index. Note that if the rubber band is
* not used to track the last mouse position, the first point of the rubber band has two vertices
*/
void movePoint( const QgsPoint & p, int geometryIndex = 0 ); void movePoint( const QgsPoint & p, int geometryIndex = 0 );
/**Moves the rubber band point specified by index. Note that if the rubber band is
not used to track the last mouse position, the first point of the rubber band has two vertices*/ /**
* Moves the rubber band point specified by index. Note that if the rubber band is
* not used to track the last mouse position, the first point of the rubber band has two vertices
*/
void movePoint( int index, const QgsPoint& p, int geometryIndex = 0 ); void movePoint( int index, const QgsPoint& p, int geometryIndex = 0 );
/**Sets this rubber band to the geometry of an existing feature. /**
This is useful for feature highlighting. * Sets this rubber band to the geometry of an existing feature.
In contrast to addGeometry, this method does also change the geometry type of the rubberband. * This is useful for feature highlighting.
@param geom the geometry object * In contrast to {@link addGeometry}, this method does also change the geometry type of the rubberband.
@param layer the layer containing the feature, used for coord transformation to map * @param geom the geometry object
crs. In case of 0 pointer, the coordinates are not going to be transformed. * @param layer the layer containing the feature, used for coord transformation to map
*/ * crs. In case of 0 pointer, the coordinates are not going to be transformed.
*/
void setToGeometry( QgsGeometry* geom, QgsVectorLayer* layer ); void setToGeometry( QgsGeometry* geom, QgsVectorLayer* layer );
/**Sets this rubber band to a map canvas rectangle /**
@param rect rectangle in canvas coordinates * Sets this rubber band to a map canvas rectangle
@note added in version 1.7*/ * @param rect rectangle in canvas coordinates
* @note added in version 1.7
*/
void setToCanvasRectangle( const QRect& rect ); void setToCanvasRectangle( const QRect& rect );
/**Add the geometry of an existing feature to a rubberband /**
This is useful for multi feature highlighting. * Add the geometry of an existing feature to a rubberband
@param geom the geometry object * This is useful for multi feature highlighting.
@param layer the layer containing the feature, used for coord transformation to map * As of 2.0, this method does not change the GeometryType any more. You need to set the GeometryType
crs. In case of 0 pointer, the coordinates are not going to be transformed. * of the rubberband explicitly by calling {@link reset} or {@link setToGeometry} with appropriate arguments.
@note added in 1.5 * {@link setToGeometry} is also to be preferred for backwards-compatibility.
*/ *
* @param geom the geometry object. Will be treated as a collection of vertices.
* @param layer the layer containing the feature, used for coord transformation to map
* crs. In case of 0 pointer, the coordinates are not going to be transformed.
* @note added in 1.5
*/
void addGeometry( QgsGeometry* geom, QgsVectorLayer* layer ); void addGeometry( QgsGeometry* geom, QgsVectorLayer* layer );
/**Adds translation to original coordinates (all in map coordinates)*/ /**
* Adds translation to original coordinates (all in map coordinates)
* @param dx x translation
* @param dy y translation
*/
void setTranslationOffset( double dx, double dy ); void setTranslationOffset( double dx, double dy );
/**Returns number of geometries /**
* added in 1.5 */ * Returns number of geometries
* @return number of geometries
* @note added in 1.5
*/
int size() const; int size() const;
/**Returns count of vertices in all lists of mPoint*/ /**
* Returns count of vertices in all lists of mPoint
* @return The total number of vertices
*/
int numberOfVertices() const; int numberOfVertices() const;
/**Return vertex*/ /**
* Return vertex
* @param i The geometry index
* @param j The vertex index within geometry i
*/
const QgsPoint *getPoint( int i, int j = 0 ) const; const QgsPoint *getPoint( int i, int j = 0 ) const;
/**Returns the rubberband as a Geometry. /**
* added in 1.6 */ * Returns the rubberband as a Geometry.
* @return A geometry object which reflects the current state of the rubberband.
* @note Added in 1.6
*/
QgsGeometry* asGeometry(); QgsGeometry* asGeometry();
protected: protected:
@ -155,14 +222,16 @@ class GUI_EXPORT QgsRubberBand: public QgsMapCanvasItem
int mWidth; int mWidth;
/** The size of the icon for points. /** The size of the icon for points.
* Added in 1.9 */ * @note Added in 1.9 */
int mIconSize; int mIconSize;
/** Icon to be shown. /** Icon to be shown.
* Added in 1.9 */ * @note Added in 1.9 */
IconType mIconType ; IconType mIconType ;
/**Nested lists used for multitypes*/ /**
* Nested lists used for multitypes
*/
QList< QList <QgsPoint> > mPoints; QList< QList <QgsPoint> > mPoints;
QGis::GeometryType mGeometryType; QGis::GeometryType mGeometryType;
double mTranslationOffsetX; double mTranslationOffsetX;