class QgsInvertedPolygonRenderer : QgsFeatureRendererV2
{
%TypeHeaderCode
#include <qgsinvertedpolygonrenderer.h>
%End
  public:

  /** Constructor
   * @param embeddedRenderer optional embeddedRenderer. If null, a default one will be assigned
   */
  QgsInvertedPolygonRenderer( const QgsFeatureRendererV2* embeddedRenderer /Transfer/ = 0 );
  virtual ~QgsInvertedPolygonRenderer();

  /** Used to clone this feature renderer.*/
  virtual QgsFeatureRendererV2* clone() /Factory/;

  virtual void startRender( QgsRenderContext& context, const QgsFields& fields );

  /** Renders a given feature.
   * This will here collect features. The actual rendering will be postponed to stopRender()
   * @param feature the feature to render
   * @param context the rendering context
   * @param layer the symbol layer to render, if that makes sense
   * @param selected whether this feature has been selected (this will add decorations)
   * @param drawVertexMarker whether this feature has vertex markers (in edit mode usually)
   * @returns true if the rendering was ok
   */
  virtual bool renderFeature( QgsFeature& feature, QgsRenderContext& context, int layer = -1, bool selected = false, bool drawVertexMarker = false );

  /**
   * The actual rendering will take place here.
   * Features collected during renderFeature() are rendered using the embedded feature renderer
   */
  virtual void stopRender( QgsRenderContext& context );

  /** @returns a textual reprensation of the renderer */
  virtual QString dump() const;

  /** Proxy that will call this method on the embedded renderer. */
  virtual QList<QString> usedAttributes();
  /** Proxy that will call this method on the embedded renderer. */
  virtual int capabilities();
  /** Proxy that will call this method on the embedded renderer. */
  virtual QgsSymbolV2List symbols();
  /** Proxy that will call this method on the embedded renderer. */
  virtual QgsSymbolV2* symbolForFeature( QgsFeature& feature );
  /** Proxy that will call this method on the embedded renderer. */
  virtual QgsSymbolV2List symbolsForFeature( QgsFeature& feat );
  /** Proxy that will call this method on the embedded renderer. */
  virtual QgsLegendSymbologyList legendSymbologyItems( QSize iconSize );
  /** Proxy that will call this method on the embedded renderer. */
  virtual bool willRenderFeature( QgsFeature& feat );

  /** Creates a renderer out of an XML, for loading*/
  static QgsFeatureRendererV2* create( QDomElement& element ) /Factory/;

  /** Creates an XML representation of the renderer. Used for saving purpose
   * @param doc the XML document where to create the XML subtree
   * @returns the created XML subtree
   */
  virtual QDomElement save( QDomDocument& doc );

  /** sets the embedded renderer
   * @param subRenderer the embedded renderer (will be cloned)
   */
  void setEmbeddedRenderer( const QgsFeatureRendererV2* subRenderer );
  /** @returns the current embedded renderer
   */
  const QgsFeatureRendererV2* embeddedRenderer() const;
};