You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

101 lines
3.1 KiB
C++

/* -*- mode: C++ ; c-file-style: "stroustrup" -*- *****************************
* Qwt Widget Library
* Copyright (C) 1997 Josef Wilgen
* Copyright (C) 2002 Uwe Rathmann
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the Qwt License, Version 1.0
*****************************************************************************/
#ifndef QWT_PLOT_DIRECT_PAINTER_H
#define QWT_PLOT_DIRECT_PAINTER_H
#include "qwt_global.h"
#include <qobject.h>
class QRegion;
class QwtPlotSeriesItem;
/*!
\brief Painter object trying to paint incrementally
Often applications want to display samples while they are
collected. When there are too many samples complete replots
will be expensive to be processed in a collection cycle.
QwtPlotDirectPainter offers an API to paint
subsets ( f.e all additions points ) without erasing/repainting
the plot canvas.
On certain environments it might be important to calculate a proper
clip region before painting. F.e. for Qt Embedded only the clipped part
of the backing store will be copied to a ( maybe unaccelerated )
frame buffer.
\warning Incremental painting will only help when no replot is triggered
by another operation ( like changing scales ) and nothing needs
to be erased.
*/
class QWT_EXPORT QwtPlotDirectPainter: public QObject
{
public:
/*!
\brief Paint attributes
\sa setAttribute(), testAttribute(), drawSeries()
*/
enum Attribute
{
/*!
Initializing a QPainter is an expensive operation.
When AtomicPainter is set each call of drawSeries() opens/closes
a temporary QPainter. Otherwise QwtPlotDirectPainter tries to
use the same QPainter as long as possible.
*/
AtomicPainter = 0x01,
/*!
When FullRepaint is set the plot canvas is explicitly repainted
after the samples have been rendered.
*/
FullRepaint = 0x02,
/*!
When QwtPlotCanvas::BackingStore is enabled the painter
has to paint to the backing store and the widget. In certain
situations/environments it might be faster to paint to
the backing store only and then copy the backing store to the canvas.
This flag can also be useful for settings, where Qt fills the
the clip region with the widget background.
*/
CopyBackingStore = 0x04
};
//! Paint attributes
typedef QFlags<Attribute> Attributes;
QwtPlotDirectPainter( QObject *parent = NULL );
virtual ~QwtPlotDirectPainter();
void setAttribute( Attribute, bool on );
bool testAttribute( Attribute ) const;
void setClipping( bool );
bool hasClipping() const;
void setClipRegion( const QRegion & );
QRegion clipRegion() const;
void drawSeries( QwtPlotSeriesItem *, int from, int to );
void reset();
virtual bool eventFilter( QObject *, QEvent * );
private:
class PrivateData;
PrivateData *d_data;
};
Q_DECLARE_OPERATORS_FOR_FLAGS( QwtPlotDirectPainter::Attributes )
#endif