Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
sipify batch
  • Loading branch information
3nids committed May 23, 2017
1 parent 90bef91 commit e99f548
Show file tree
Hide file tree
Showing 17 changed files with 1,306 additions and 488 deletions.
13 changes: 0 additions & 13 deletions python/auto_sip.blacklist
Expand Up @@ -2,20 +2,7 @@ core/conversions.sip
core/qgsexception.sip
core/qgis.sip
core/qgsrange.sip
core/qgsvectorsimplifymethod.sip
core/qgscachedfeatureiterator.sip
core/qgscacheindex.sip
core/qgscacheindexfeatureid.sip
core/qgsgeometrycache.sip
core/qgslayerdefinition.sip
core/qgsprojectfiletransform.sip
core/qgsvectorlayereditutils.sip
core/qgsvectorlayerfeatureiterator.sip
core/qgsvirtuallayerdefinition.sip
core/qgsvirtuallayerdefinitionutils.sip
core/qgsmapthemecollection.sip
core/qgsxmlutils.sip
core/annotations/qgsannotation.sip
core/auth/qgsauthcertutils.sip
core/auth/qgsauthconfig.sip
core/auth/qgsauthmanager.sip
Expand Down
276 changes: 257 additions & 19 deletions python/core/annotations/qgsannotation.sip
@@ -1,88 +1,326 @@
%ModuleHeaderCode
#include <qgshtmlannotation.h>
#include <qgssvgannotation.h>
#include <qgstextannotation.h>
%End
/************************************************************************
* This file has been generated automatically from *
* *
* src/core/annotations/qgsannotation.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/





class QgsAnnotation : QObject
{
%Docstring
.. versionadded:: 3.0

Abstract base class for annotation items which are drawn over a map.

QgsAnnotation is an abstract base class for map annotation items. These annotations can be
drawn within a map, and have either a fixed map position (retrieved using mapPosition())
or are placed relative to the map's frame (retrieved using relativePosition()).
Annotations with a fixed map position also have a corresponding
QgsCoordinateReferenceSystem, which can be determined by calling mapPositionCrs().

Derived classes should implement their custom painting routines within
a renderAnnotation() override.
%End

%TypeHeaderCode
#include <qgsannotation.h>
#include "qgsannotation.h"
%End

%ConvertToSubClassCode
if ( dynamic_cast< QgsTextAnnotation* > ( sipCpp ) )
sipType = sipType_QgsTextAnnotation;
else if ( dynamic_cast< QgsSvgAnnotation* > ( sipCpp ) )
sipType = sipType_QgsSvgAnnotation;
else if ( dynamic_cast< QgsHtmlAnnotation* > ( sipCpp ) )
sipType = sipType_QgsHtmlAnnotation;
else
sipType = NULL;
if ( dynamic_cast< QgsTextAnnotation * >( sipCpp ) )
sipType = sipType_QgsTextAnnotation;
else if ( dynamic_cast< QgsSvgAnnotation * >( sipCpp ) )
sipType = sipType_QgsSvgAnnotation;
else if ( dynamic_cast< QgsHtmlAnnotation * >( sipCpp ) )
sipType = sipType_QgsHtmlAnnotation;
else
sipType = NULL;
%End

public:

QgsAnnotation( QObject *parent /TransferThis/ = 0 );
%Docstring
Constructor for QgsAnnotation.
%End

virtual QgsAnnotation *clone() const = 0 /Factory/;
%Docstring
Clones the annotation, returning a new copy of the annotation
reflecting the annotation's current state.
:rtype: QgsAnnotation
%End

bool isVisible() const;
%Docstring
Returns true if the annotation is visible and should be rendered.
.. seealso:: setVisible()
:rtype: bool
%End

void setVisible( bool visible );
%Docstring
Sets whether the annotation is visible and should be rendered.
.. seealso:: isVisible()
%End

bool hasFixedMapPosition() const;
%Docstring
Returns true if the annotation is attached to a fixed map position, or
false if the annotation uses a position relative to the current map
extent.
.. seealso:: setHasFixedMapPosition()
.. seealso:: mapPosition()
.. seealso:: relativePosition()
:rtype: bool
%End

void setHasFixedMapPosition( bool fixed );
%Docstring
Sets whether the annotation is attached to a fixed map position, or
uses a position relative to the current map extent.
.. seealso:: hasFixedMapPosition()
%End

QgsPoint mapPosition() const;
%Docstring
Returns the map position of the annotation, if it is attached to a fixed map
position.
.. seealso:: setMapPosition()
.. seealso:: hasFixedMapPosition()
.. seealso:: mapPositionCrs()
:rtype: QgsPoint
%End

void setMapPosition( const QgsPoint &position );
%Docstring
Sets the map position of the annotation, if it is attached to a fixed map
position.
.. seealso:: mapPosition()
%End

QgsCoordinateReferenceSystem mapPositionCrs() const;
%Docstring
Returns the CRS of the map position, or an invalid CRS if the annotation does
not have a fixed map position.
.. seealso:: setMapPositionCrs()
:rtype: QgsCoordinateReferenceSystem
%End

void setMapPositionCrs( const QgsCoordinateReferenceSystem &crs );
%Docstring
Sets the CRS of the map position.
.. seealso:: mapPositionCrs()
%End

QPointF relativePosition() const;
%Docstring
Returns the relative position of the annotation, if it is not attached to a fixed map
position. The coordinates in the return point should be between 0 and 1, and represent
the relative percentage for the position compared to the map width and height.
.. seealso:: setRelativePosition()
:rtype: QPointF
%End

void setRelativePosition( QPointF position );
%Docstring
Sets the relative position of the annotation, if it is not attached to a fixed map
position. The coordinates in the return point should be between 0 and 1, and represent
the relative percentage for the position compared to the map width and height.
.. seealso:: relativePosition()
%End

void setFrameOffsetFromReferencePoint( QPointF offset );
%Docstring
Sets the annotation's frame's offset from the mapPosition() reference point.
.. seealso:: frameOffsetFromReferencePoint()
%End

QPointF frameOffsetFromReferencePoint() const;
%Docstring
Returns the annotation's frame's offset from the mapPosition() reference point.
.. seealso:: setFrameOffsetFromReferencePoint()
:rtype: QPointF
%End

void setFrameSize( QSizeF size );
%Docstring
Sets the size of the annotation's frame (the main area in which
the annotation's content is drawn).
.. seealso:: frameSize()
%End

QSizeF frameSize() const;
%Docstring
Returns the size of the annotation's frame (the main area in which
the annotation's content is drawn).
.. seealso:: setFrameSize()
:rtype: QSizeF
%End

void setContentsMargin( const QgsMargins &margins );
%Docstring
Sets the margins (in millimeters) between the outside of the frame and the annotation
content.
.. seealso:: contentsMargin()
%End

QgsMargins contentsMargin() const;
%Docstring
Returns the margins (in millimeters) between the outside of the frame and the annotation
content.
.. seealso:: setContentsMargin()
:rtype: QgsMargins
%End

void setFillSymbol( QgsFillSymbol *symbol /Transfer/ );
%Docstring
Sets the fill symbol used for rendering the annotation frame. Ownership
of the symbol is transferred to the annotation.
.. seealso:: fillSymbol()
%End

QgsFillSymbol *fillSymbol() const;
%Docstring
Returns the symbol that is used for rendering the annotation frame.
.. seealso:: setFillSymbol()
:rtype: QgsFillSymbol
%End

void render( QgsRenderContext &context ) const;
%Docstring
Renders the annotation to a target render context.
%End

virtual void writeXml( QDomElement& elem, QDomDocument & doc, const QgsReadWriteContext &context ) const = 0;
virtual void readXml( const QDomElement& itemElem, const QgsReadWriteContext &context ) = 0;
virtual void writeXml( QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context ) const = 0;
%Docstring
Writes the annotation state to a DOM element. Derived classes should
call _writeXml() within their implementation of this method.
.. seealso:: readXml()
.. seealso:: _writeXml()
%End

virtual void readXml( const QDomElement &itemElem, const QgsReadWriteContext &context ) = 0;
%Docstring
Restores the annotation's state from a DOM element. Derived classes should
call _readXml() within their implementation of this method.
.. seealso:: writeXml()
.. seealso:: _readXml()
%End

void setMarkerSymbol( QgsMarkerSymbol *symbol /Transfer/ );
%Docstring
Sets the symbol that is drawn at the annotation's map position. Ownership
of the symbol is transferred to the annotation.
.. seealso:: markerSymbol()
%End

QgsMarkerSymbol *markerSymbol() const;
%Docstring
Returns the symbol that is drawn at the annotation's map position.
.. seealso:: setMarkerSymbol()
:rtype: QgsMarkerSymbol
%End

QgsMapLayer *mapLayer() const;
%Docstring
Returns the map layer associated with the annotation. Annotations can be
associated with a map layer if their visibility should be synchronized
with the layer's visibility.
.. seealso:: setMapLayer()
:rtype: QgsMapLayer
%End

void setMapLayer( QgsMapLayer *layer );
%Docstring
Sets the map layer associated with the annotation. Annotations can be
associated with a map layer if their visibility should be synchronized
with the layer's visibility.
.. seealso:: mapLayer()
%End

QgsFeature associatedFeature() const;
%Docstring
Returns the feature associated with the annotation, or an invalid
feature if none has been set.
.. seealso:: setAssociatedFeature()
:rtype: QgsFeature
%End

virtual void setAssociatedFeature( const QgsFeature &feature );
%Docstring
Sets the feature associated with the annotation.
.. seealso:: associatedFeature()
%End

signals:

void appearanceChanged();
%Docstring
Emitted whenever the annotation's appearance changes
%End

void moved();
%Docstring
Emitted when the annotation's position has changed and items need
to be moved to reflect this.
%End

void mapLayerChanged();
%Docstring
Emitted when the map layer associated with the annotation changes.
%End

protected:

virtual void renderAnnotation( QgsRenderContext &context, QSizeF size ) const = 0;
%Docstring
Renders the annotation's contents to a target /a context at the specified /a size.
Derived classes should implement their custom annotation drawing logic here.
%End

virtual QSizeF minimumFrameSize() const;
%Docstring
Returns the minimum frame size for the annotation. Subclasses should implement this if they
cannot be resized smaller than a certain minimum size.
:rtype: QSizeF
%End

void _writeXml( QDomElement &itemElem, QDomDocument &doc, const QgsReadWriteContext &context ) const;
%Docstring
Writes common annotation properties to a DOM element.
This method should be called from subclasses in their writeXml method.
.. seealso:: writeXml()
.. seealso:: _readXml()
%End

void _writeXml( QDomElement& itemElem, QDomDocument& doc, const QgsReadWriteContext &context ) const;
void _readXml( const QDomElement& annotationElem, const QgsReadWriteContext &context );
void _readXml( const QDomElement &annotationElem, const QgsReadWriteContext &context );
%Docstring
Reads common annotation properties from a DOM element.
This method should be called from subclasses in their readXml method.
.. seealso:: readXml()
.. seealso:: _writeXml()
%End

void copyCommonProperties( QgsAnnotation *target ) const;
%Docstring
Copies common annotation properties to the ``targe``
annotation.
Can be used within QgsAnnotation.clone() implementations
to assist with creating copies.
%End

};


/************************************************************************
* This file has been generated automatically from *
* *
* src/core/annotations/qgsannotation.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/

0 comments on commit e99f548

Please sign in to comment.