Qwt User's Guide
svn
|
#include <qwt_plot_spectrogram.h>
Inherits QwtPlotRasterItem.
Public Types | |
enum | CachePolicy { NoCache, PaintCache } |
enum | DisplayMode { ImageMode = 0x01, ContourMode = 0x02 } |
typedef QFlags< DisplayMode > | DisplayModes |
enum | ItemAttribute { Legend = 0x01, AutoScale = 0x02 } |
typedef QFlags< ItemAttribute > | ItemAttributes |
enum | PaintAttribute { PaintInDeviceResolution = 1 } |
typedef QFlags< PaintAttribute > | PaintAttributes |
enum | RenderHint { RenderAntialiased = 1 } |
typedef QFlags< RenderHint > | RenderHints |
enum | RttiValues { Rtti_PlotItem = 0, Rtti_PlotGrid, Rtti_PlotScale, Rtti_PlotMarker, Rtti_PlotCurve, Rtti_PlotSpectroCurve, Rtti_PlotIntervalCurve, Rtti_PlotHistogram, Rtti_PlotSpectrogram, Rtti_PlotSVG, Rtti_PlotUserItem = 1000 } |
Public Member Functions | |
int | alpha () const |
void | attach (QwtPlot *plot) |
virtual QRectF | boundingRect () const |
CachePolicy | cachePolicy () const |
const QwtColorMap * | colorMap () const |
QList< double > | contourLevels () const |
virtual QPen | contourPen (double level) const |
const QwtRasterData * | data () const |
QwtRasterData * | data () |
QPen | defaultContourPen () const |
void | detach () |
virtual void | draw (QPainter *p, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &rect) const |
virtual void | drawLegendIdentifier (QPainter *, const QRectF &) const |
void | hide () |
virtual QwtInterval | interval (Qt::Axis) const |
void | invalidateCache () |
bool | isVisible () const |
virtual void | itemChanged () |
virtual QWidget * | legendItem () const |
QRectF | paintRect (const QwtScaleMap &, const QwtScaleMap &) const |
virtual QRectF | pixelHint (const QRectF &) const |
QwtPlot * | plot () const |
QwtPlotSpectrogram (const QString &title=QString::null) | |
uint | renderThreadCount () const |
virtual int | rtti () const |
QRectF | scaleRect (const QwtScaleMap &, const QwtScaleMap &) const |
void | setAlpha (int alpha) |
void | setAxes (int xAxis, int yAxis) |
void | setCachePolicy (CachePolicy) |
void | setColorMap (QwtColorMap *) |
void | setConrecFlag (QwtRasterData::ConrecFlag, bool on) |
void | setContourLevels (const QList< double > &) |
void | setData (QwtRasterData *data) |
void | setDefaultContourPen (const QPen &) |
void | setDisplayMode (DisplayMode, bool on=true) |
void | setItemAttribute (ItemAttribute, bool on=true) |
void | setPaintAttribute (PaintAttribute, bool on=true) |
void | setRenderHint (RenderHint, bool on=true) |
void | setRenderThreadCount (uint numThreads) |
void | setTitle (const QString &title) |
void | setTitle (const QwtText &title) |
virtual void | setVisible (bool) |
void | setXAxis (int axis) |
void | setYAxis (int axis) |
void | setZ (double z) |
void | show () |
bool | testConrecFlag (QwtRasterData::ConrecFlag) const |
bool | testDisplayMode (DisplayMode) const |
bool | testItemAttribute (ItemAttribute) const |
bool | testPaintAttribute (PaintAttribute) const |
bool | testRenderHint (RenderHint) const |
const QwtText & | title () const |
virtual void | updateLegend (QwtLegend *) const |
virtual void | updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &) |
int | xAxis () const |
int | yAxis () const |
double | z () const |
virtual | ~QwtPlotSpectrogram () |
Protected Member Functions | |
virtual QSize | contourRasterSize (const QRectF &, const QRect &) const |
virtual void | drawContourLines (QPainter *p, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QwtRasterData::ContourLines &lines) const |
virtual QwtScaleMap | imageMap (Qt::Orientation, const QwtScaleMap &map, const QRectF &area, const QSize &imageSize, double pixelSize) const |
virtual QwtRasterData::ContourLines | renderContourLines (const QRectF &rect, const QSize &raster) const |
virtual QImage | renderImage (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &area, const QSize &imageSize) const |
void | renderTile (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRect &imageRect, QImage *image) const |
A plot item, which displays a spectrogram.
A spectrogram displays threedimenional data, where the 3rd dimension ( the intensity ) is displayed using colors. The colors are calculated from the values using a color map.
In ContourMode contour lines are painted for the contour levels.
typedef QFlags<DisplayMode> QwtPlotSpectrogram::DisplayModes |
Display modes.
typedef QFlags<ItemAttribute> QwtPlotItem::ItemAttributes [inherited] |
Plot Item Attributes.
typedef QFlags<PaintAttribute> QwtPlotRasterItem::PaintAttributes [inherited] |
Paint attributes.
typedef QFlags<RenderHint> QwtPlotItem::RenderHints [inherited] |
Render hints.
enum QwtPlotRasterItem::CachePolicy [inherited] |
The default policy is NoCache
The display mode controls how the raster data will be represented.
enum QwtPlotItem::ItemAttribute [inherited] |
Plot Item Attributes
Legend |
The item is represented on the legend. |
AutoScale |
The boundingRect() of the item is included in the autoscaling calculation. |
enum QwtPlotRasterItem::PaintAttribute [inherited] |
Attributes to modify the drawing algorithm.
PaintInDeviceResolution |
When the image is rendered according to the data pixels ( QwtRasterData::pixelHint() ) it can be expanded to paint device resolution before it is passed to QPainter. The expansion algorithm rounds the pixel borders in the same way as the axis ticks, what is usually better than the scaling algorithm implemented in Qt. Disabling this flag might make sense, to reduce the size of a document/file. If this is possible for a document format depends on the implementation of the specific QPaintEngine. |
enum QwtPlotItem::RenderHint [inherited] |
enum QwtPlotItem::RttiValues [inherited] |
Runtime type information.
RttiValues is used to cast plot items, without having to enable runtime type information of the compiler.
Rtti_PlotItem |
Unspecific value, that can be used, when it doesn't matter. |
Rtti_PlotGrid |
For QwtPlotGrid. |
Rtti_PlotScale |
For QwtPlotScaleItem. |
Rtti_PlotMarker |
For QwtPlotMarker. |
Rtti_PlotCurve |
For QwtPlotCurve. |
Rtti_PlotSpectroCurve |
For QwtPlotSpectroCurve. |
Rtti_PlotIntervalCurve |
For QwtPlotIntervalCurve. |
Rtti_PlotHistogram |
For QwtPlotHistogram. |
Rtti_PlotSpectrogram |
For QwtPlotSpectrogram. |
Rtti_PlotSVG |
For QwtPlotSvgItem. |
Rtti_PlotUserItem |
Values >= Rtti_PlotUserItem are reserved for plot items not implemented in the Qwt library. |
QwtPlotSpectrogram::QwtPlotSpectrogram | ( | const QString & | title = QString::null | ) | [explicit] |
Sets the following item attributes:
The z value is initialized by 8.0.
title | Title |
QwtPlotSpectrogram::~QwtPlotSpectrogram | ( | ) | [virtual] |
Destructor.
int QwtPlotRasterItem::alpha | ( | ) | const [inherited] |
void QwtPlotItem::attach | ( | QwtPlot * | plot | ) | [inherited] |
Attach the item to a plot.
This method will attach a QwtPlotItem to the QwtPlot argument. It will first detach the QwtPlotItem from any plot from a previous call to attach (if necessary). If a NULL argument is passed, it will detach from any QwtPlot it was attached to.
plot | Plot widget |
QRectF QwtPlotRasterItem::boundingRect | ( | ) | const [virtual, inherited] |
Reimplemented from QwtPlotItem.
QwtPlotRasterItem::CachePolicy QwtPlotRasterItem::cachePolicy | ( | ) | const [inherited] |
const QwtColorMap * QwtPlotSpectrogram::colorMap | ( | ) | const |
QList< double > QwtPlotSpectrogram::contourLevels | ( | ) | const |
Return the levels of the contour lines.
The levels are sorted in increasing order.
QPen QwtPlotSpectrogram::contourPen | ( | double | level | ) | const [virtual] |
Calculate the pen for a contour line.
The color of the pen is the color for level calculated by the color map
level | Contour level |
QSize QwtPlotSpectrogram::contourRasterSize | ( | const QRectF & | area, |
const QRect & | rect | ||
) | const [protected, virtual] |
Return the raster to be used by the CONREC contour algorithm.
A larger size will improve the precisision of the CONREC algorithm, but will slow down the time that is needed to calculate the lines.
The default implementation returns rect.size() / 2 bounded to the resolution depending on pixelSize().
area | Rect, where to calculate the contour lines |
rect | Rect in pixel coordinates, where to paint the contour lines |
const QwtRasterData * QwtPlotSpectrogram::data | ( | ) | const |
QwtRasterData * QwtPlotSpectrogram::data | ( | ) |
QPen QwtPlotSpectrogram::defaultContourPen | ( | ) | const |
void QwtPlotItem::detach | ( | ) | [inherited] |
This method detaches a QwtPlotItem from any QwtPlot it has been associated with.
detach() is equivalent to calling attach( NULL )
void QwtPlotSpectrogram::draw | ( | QPainter * | painter, |
const QwtScaleMap & | xMap, | ||
const QwtScaleMap & | yMap, | ||
const QRectF & | canvasRect | ||
) | const [virtual] |
Draw the spectrogram.
painter | Painter |
xMap | Maps x-values into pixel coordinates. |
yMap | Maps y-values into pixel coordinates. |
canvasRect | Contents rect of the canvas in painter coordinates |
Reimplemented from QwtPlotRasterItem.
void QwtPlotSpectrogram::drawContourLines | ( | QPainter * | painter, |
const QwtScaleMap & | xMap, | ||
const QwtScaleMap & | yMap, | ||
const QwtRasterData::ContourLines & | contourLines | ||
) | const [protected, virtual] |
Paint the contour lines
painter | Painter |
xMap | Maps x-values into pixel coordinates. |
yMap | Maps y-values into pixel coordinates. |
contourLines | Contour lines |
virtual void QwtLegendItemManager::drawLegendIdentifier | ( | QPainter * | , |
const QRectF & | |||
) | const [inline, virtual, inherited] |
QwtLegendItem can display an icon-identifier followed by a text. The icon helps to identify a plot item on the plot canvas and depends on the type of information, that is displayed.
The default implementation paints nothing.
Reimplemented in QwtPlotCurve, QwtPlotIntervalCurve, QwtPlotMarker, and QwtPlotHistogram.
void QwtPlotItem::hide | ( | ) | [inherited] |
Hide the item.
QwtScaleMap QwtPlotRasterItem::imageMap | ( | Qt::Orientation | orientation, |
const QwtScaleMap & | map, | ||
const QRectF & | area, | ||
const QSize & | imageSize, | ||
double | pixelSize | ||
) | const [protected, virtual, inherited] |
Calculate a scale map for painting to an image.
orientation | Orientation, Qt::Horizontal means a X axis |
map | Scale map for rendering the plot item |
area | Area to be painted on the image |
imageSize | Image size |
pixelSize | Width/Height of a data pixel |
QwtInterval QwtPlotSpectrogram::interval | ( | Qt::Axis | axis | ) | const [virtual] |
The default implementation returns the interval of the associated raster data object.
axis | X, Y, or Z axis |
Reimplemented from QwtPlotRasterItem.
void QwtPlotRasterItem::invalidateCache | ( | ) | [inherited] |
Invalidate the paint cache
bool QwtPlotItem::isVisible | ( | ) | const [inherited] |
void QwtPlotItem::itemChanged | ( | ) | [virtual, inherited] |
Update the legend and call QwtPlot::autoRefresh for the parent plot.
QWidget * QwtPlotItem::legendItem | ( | ) | const [virtual, inherited] |
Allocate the widget that represents the item on the legend.
The default implementation returns a QwtLegendItem(), but an item could be represented by any type of widget, by overloading legendItem() and updateLegend().
Implements QwtLegendItemManager.
QRectF QwtPlotItem::paintRect | ( | const QwtScaleMap & | xMap, |
const QwtScaleMap & | yMap | ||
) | const [inherited] |
Calculate the bounding paint rect of 2 maps.
xMap | X map |
yMap | X map |
QRectF QwtPlotSpectrogram::pixelHint | ( | const QRectF & | area | ) | const [virtual] |
Pixel hint.
The geometry of a pixel is used to calculated the resolution and alignment of the rendered image.
The default implementation returns data()->pixelHint( rect );
area | In most implementations the resolution of the data doesn't depend on the requested area. |
Reimplemented from QwtPlotRasterItem.
QwtPlot * QwtPlotItem::plot | ( | ) | const [inherited] |
Return attached plot.
QwtRasterData::ContourLines QwtPlotSpectrogram::renderContourLines | ( | const QRectF & | rect, |
const QSize & | raster | ||
) | const [protected, virtual] |
Calculate contour lines
rect | Rectangle, where to calculate the contour lines |
raster | Raster, used by the CONREC algorithm |
QImage QwtPlotSpectrogram::renderImage | ( | const QwtScaleMap & | xMap, |
const QwtScaleMap & | yMap, | ||
const QRectF & | area, | ||
const QSize & | imageSize | ||
) | const [protected, virtual] |
Render an image from data and color map.
For each pixel of rect the value is mapped into a color.
xMap | X-Scale Map |
yMap | Y-Scale Map |
area | Requested area for the image in scale coordinates |
imageSize | Size of the requested image |
Implements QwtPlotRasterItem.
uint QwtPlotSpectrogram::renderThreadCount | ( | ) | const |
void QwtPlotSpectrogram::renderTile | ( | const QwtScaleMap & | xMap, |
const QwtScaleMap & | yMap, | ||
const QRect & | tile, | ||
QImage * | image | ||
) | const [protected] |
Render a tile of an image.
Rendering in tiles can be used to composite an image in parallel threads.
xMap | X-Scale Map |
yMap | Y-Scale Map |
tile | Geometry of the tile in image coordinates |
image | Image to be rendered |
int QwtPlotSpectrogram::rtti | ( | ) | const [virtual] |
Reimplemented from QwtPlotItem.
QRectF QwtPlotItem::scaleRect | ( | const QwtScaleMap & | xMap, |
const QwtScaleMap & | yMap | ||
) | const [inherited] |
Calculate the bounding scale rect of 2 maps.
xMap | X map |
yMap | X map |
void QwtPlotRasterItem::setAlpha | ( | int | alpha | ) | [inherited] |
Set an alpha value for the raster data.
Often a plot has several types of raster data organized in layers. ( f.e a geographical map, with weather statistics ). Using setAlpha() raster items can be stacked easily.
The alpha value is a value [0, 255] to control the transparency of the image. 0 represents a fully transparent color, while 255 represents a fully opaque color.
alpha | Alpha value |
The default alpha value is -1.
void QwtPlotItem::setAxes | ( | int | xAxis, |
int | yAxis | ||
) | [inherited] |
Set X and Y axis
The item will painted according to the coordinates its Axes.
xAxis | X Axis |
yAxis | Y Axis |
void QwtPlotRasterItem::setCachePolicy | ( | QwtPlotRasterItem::CachePolicy | policy | ) | [inherited] |
Change the cache policy
The default policy is NoCache
policy | Cache policy |
void QwtPlotSpectrogram::setColorMap | ( | QwtColorMap * | colorMap | ) |
Change the color map
Often it is useful to display the mapping between intensities and colors as an additional plot axis, showing a color bar.
colorMap | Color Map |
void QwtPlotSpectrogram::setConrecFlag | ( | QwtRasterData::ConrecFlag | flag, |
bool | on | ||
) |
Modify an attribute of the CONREC algorithm, used to calculate the contour lines.
flag | CONREC flag |
on | On/Off |
void QwtPlotSpectrogram::setContourLevels | ( | const QList< double > & | levels | ) |
Set the levels of the contour lines
levels | Values of the contour levels |
void QwtPlotSpectrogram::setData | ( | QwtRasterData * | data | ) |
void QwtPlotSpectrogram::setDefaultContourPen | ( | const QPen & | pen | ) |
Set the default pen for the contour lines.
If the spectrogram has a valid default contour pen a contour line is painted using the default contour pen. Otherwise (pen.style() == Qt::NoPen) the pen is calculated for each contour level using contourPen().
void QwtPlotSpectrogram::setDisplayMode | ( | DisplayMode | mode, |
bool | on = true |
||
) |
The display mode controls how the raster data will be represented.
mode | Display mode |
on | On/Off |
The default setting enables ImageMode.
void QwtPlotItem::setItemAttribute | ( | ItemAttribute | attribute, |
bool | on = true |
||
) | [inherited] |
Toggle an item attribute
attribute | Attribute type |
on | true/false |
void QwtPlotRasterItem::setPaintAttribute | ( | PaintAttribute | attribute, |
bool | on = true |
||
) | [inherited] |
Specify an attribute how to draw the raster item
attribute | Paint attribute |
on | On/Off /sa PaintAttribute, testPaintAttribute() |
void QwtPlotItem::setRenderHint | ( | RenderHint | hint, |
bool | on = true |
||
) | [inherited] |
Toggle an render hint
hint | Render hint |
on | true/false |
void QwtPlotSpectrogram::setRenderThreadCount | ( | uint | numThreads | ) |
Rendering an image from the raster data can often be done parallel on a multicore system.
numThreads | Number of threads to be used for rendering. If numThreads is set to 0, the system specific ideal thread count is used. |
The default thread count is 1 ( = no additional threads )
void QwtPlotItem::setTitle | ( | const QString & | title | ) | [inherited] |
void QwtPlotItem::setTitle | ( | const QwtText & | title | ) | [inherited] |
void QwtPlotItem::setVisible | ( | bool | on | ) | [virtual, inherited] |
void QwtPlotItem::setXAxis | ( | int | axis | ) | [inherited] |
Set the X axis
The item will painted according to the coordinates its Axes.
axis | X Axis |
void QwtPlotItem::setYAxis | ( | int | axis | ) | [inherited] |
Set the Y axis
The item will painted according to the coordinates its Axes.
axis | Y Axis |
void QwtPlotItem::setZ | ( | double | z | ) | [inherited] |
Set the z value.
Plot items are painted in increasing z-order.
z | Z-value |
void QwtPlotItem::show | ( | ) | [inherited] |
Show the item.
bool QwtPlotSpectrogram::testConrecFlag | ( | QwtRasterData::ConrecFlag | flag | ) | const |
Test an attribute of the CONREC algorithm, used to calculate the contour lines.
flag | CONREC flag |
bool QwtPlotSpectrogram::testDisplayMode | ( | DisplayMode | mode | ) | const |
The display mode controls how the raster data will be represented.
mode | Display mode |
bool QwtPlotItem::testItemAttribute | ( | ItemAttribute | attribute | ) | const [inherited] |
Test an item attribute
attribute | Attribute type |
bool QwtPlotRasterItem::testPaintAttribute | ( | PaintAttribute | attribute | ) | const [inherited] |
Return the current paint attributes.
bool QwtPlotItem::testRenderHint | ( | RenderHint | hint | ) | const [inherited] |
Test a render hint
hint | Render hint |
const QwtText & QwtPlotItem::title | ( | ) | const [inherited] |
void QwtPlotItem::updateLegend | ( | QwtLegend * | legend | ) | const [virtual, inherited] |
Update the widget that represents the item on the legend.
updateLegend() is called from itemChanged() to adopt the widget representing the item on the legend to its new configuration.
The default implementation updates a QwtLegendItem(), but an item could be represented by any type of widget, by overloading legendItem() and updateLegend().
legend | Legend |
Implements QwtLegendItemManager.
Reimplemented in QwtPlotCurve, and QwtPlotMarker.
void QwtPlotItem::updateScaleDiv | ( | const QwtScaleDiv & | xScaleDiv, |
const QwtScaleDiv & | yScaleDiv | ||
) | [virtual, inherited] |
Update the item to changes of the axes scale division.
Update the item, when the axes of plot have changed. The default implementation does nothing, but items that depend on the scale division (like QwtPlotGrid()) have to reimplement updateScaleDiv()
xScaleDiv | Scale division of the x-axis |
yScaleDiv | Scale division of the y-axis |
Reimplemented in QwtPlotScaleItem, QwtPlotSeriesItem< T >, QwtPlotSeriesItem< QwtIntervalSample >, QwtPlotSeriesItem< QPointF >, QwtPlotSeriesItem< QwtPoint3D >, and QwtPlotGrid.
int QwtPlotItem::xAxis | ( | ) | const [inherited] |
Return xAxis.
int QwtPlotItem::yAxis | ( | ) | const [inherited] |
Return yAxis.
double QwtPlotItem::z | ( | ) | const [inherited] |
Plot items are painted in increasing z-order.