GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
QwtPlot(3) Qwt User's Guide QwtPlot(3)

QwtPlot -

#include <qwt_plot.h>
Inherits QwtPlotDict.


enum Axis { yLeft, yRight, xBottom, xTop, axisCnt }
 
enum LegendPosition { LeftLegend, RightLegend, BottomLegend, TopLegend, ExternalLegend }
 


void autoRefresh ()
 
virtual void clear ()
 
virtual void replot ()
 


void legendChecked (QwtPlotItem *plotItem, bool on)
 
void legendClicked (QwtPlotItem *plotItem)
 


QwtPlot (QWidget *=NULL)
 
QwtPlot (const QwtText &title, QWidget *p=NULL)
 
virtual ~QwtPlot ()
 
void applyProperties (const QString &)
 
bool autoReplot () const
 
bool axisAutoScale (int axisId) const
 
bool axisEnabled (int axisId) const
 
QFont axisFont (int axisId) const
 
int axisMaxMajor (int axisId) const
 
int axisMaxMinor (int axisId) const
 
const QwtScaleDiv * axisScaleDiv (int axisId) const
 
QwtScaleDiv * axisScaleDiv (int axisId)
 
const QwtScaleDraw * axisScaleDraw (int axisId) const
 
QwtScaleDraw * axisScaleDraw (int axisId)
 
QwtScaleEngine * axisScaleEngine (int axisId)
 
const QwtScaleEngine * axisScaleEngine (int axisId) const
 
double axisStepSize (int axisId) const
 
QwtText axisTitle (int axisId) const
 
const QwtScaleWidget * axisWidget (int axisId) const
 
QwtScaleWidget * axisWidget (int axisId)
 
QwtPlotCanvas * canvas ()
 
const QwtPlotCanvas * canvas () const
 
const QColor & canvasBackground () const
 
int canvasLineWidth () const
 
virtual QwtScaleMap canvasMap (int axisId) const
 
virtual void drawCanvas (QPainter *)
 
void enableAxis (int axisId, bool tf=true)
 
virtual bool event (QEvent *)
 
QString grabProperties () const
 
void insertLegend (QwtLegend *, LegendPosition=QwtPlot::RightLegend, double ratio=-1.0)
 
double invTransform (int axisId, int pos) const
 
QwtLegend * legend ()
 
const QwtLegend * legend () const
 
int margin () const
 
virtual QSize minimumSizeHint () const
 
QwtPlotLayout * plotLayout ()
 
const QwtPlotLayout * plotLayout () const
 
virtual void polish ()
 
void print (QPaintDevice &p, const QwtPlotPrintFilter &=QwtPlotPrintFilter()) const
 
virtual void print (QPainter *, const QRect &rect, const QwtPlotPrintFilter &= QwtPlotPrintFilter()) const
 
void setAutoReplot (bool tf=true)
 
void setAxisAutoScale (int axisId)
 
void setAxisFont (int axisId, const QFont &f)
 
void setAxisLabelAlignment (int axisId, Qt::Alignment)
 
void setAxisLabelRotation (int axisId, double rotation)
 
void setAxisMaxMajor (int axisId, int maxMajor)
 
void setAxisMaxMinor (int axisId, int maxMinor)
 
void setAxisScale (int axisId, double min, double max, double step=0)
 
void setAxisScaleDiv (int axisId, const QwtScaleDiv &)
 
void setAxisScaleDraw (int axisId, QwtScaleDraw *)
 
void setAxisScaleEngine (int axisId, QwtScaleEngine *)
 
void setAxisTitle (int axisId, const QString &)
 
void setAxisTitle (int axisId, const QwtText &)
 
void setCanvasBackground (const QColor &c)
 
void setCanvasLineWidth (int w)
 
void setMargin (int margin)
 
void setTitle (const QString &)
 
void setTitle (const QwtText &t)
 
virtual QSize sizeHint () const
 
QwtText title () const
 
QwtTextLabel * titleLabel ()
 
const QwtTextLabel * titleLabel () const
 
int transform (int axisId, double value) const
 
void updateAxes ()
 
virtual void updateLayout ()
 


virtual void legendItemChecked (bool)
 
virtual void legendItemClicked ()
 


virtual void drawItems (QPainter *, const QRect &, const QwtScaleMap maps[axisCnt], const QwtPlotPrintFilter &) const
 
virtual void printCanvas (QPainter *, const QRect &boundingRect, const QRect &canvasRect, const QwtScaleMap maps[axisCnt], const QwtPlotPrintFilter &) const
 
virtual void printLegend (QPainter *, const QRect &) const
 
virtual void printLegendItem (QPainter *, const QWidget *, const QRect &) const
 
virtual void printScale (QPainter *, int axisId, int startDist, int endDist, int baseDist, const QRect &) const
 
virtual void printTitle (QPainter *, const QRect &) const
 
virtual void resizeEvent (QResizeEvent *e)
 
virtual void updateTabOrder ()
 


static bool axisValid (int axisId)
 

A 2-D plotting widget.
QwtPlot is a widget for plotting two-dimensional graphs. An unlimited number of plot items can be displayed on its canvas. Plot items might be curves ( QwtPlotCurve), markers (QwtPlotMarker), the grid (QwtPlotGrid), or anything else derived from QwtPlotItem. A plot can have up to four axes, with each plot item attached to an x- and a y axis. The scales at the axes can be explicitely set ( QwtScaleDiv), or are calculated from the plot items, using algorithms ( QwtScaleEngine) which can be configured separately for each axis.
Example
The following example shows (schematically) the most simple way to use QwtPlot. By default, only the left and bottom axes are visible and their scales are computed automatically.
#include <qwt_plot.h>
#include <qwt_plot_curve.h>
QwtPlot *myPlot = new QwtPlot("Two Curves", parent);
// add curves QwtPlotCurve *curve1 = new QwtPlotCurve("Curve 1"); QwtPlotCurve *curve2 = new QwtPlotCurve("Curve 2");
// copy the data into the curves curve1->setData(...); curve2->setData(...);
curve1->attach(myPlot); curve2->attach(myPlot);
// finally, refresh the plot myPlot->replot();

Axis index
yLeft
 
yRight
 
xBottom
 
xTop
 

Position of the legend, relative to the canvas.
LeftLegend
 

The legend will be left from the yLeft axis.
RightLegend
 

The legend will be right from the yLeft axis.
BottomLegend
 

The legend will be right below the xBottom axis.
TopLegend
 

The legend will be between xTop axis and the title.
ExternalLegend
 

External means that only the content of the legend will be handled by QwtPlot, but not its geometry. This might be interesting if an application wants to have a legend in an external window ( or on the canvas ).
Note:
In case of ExternalLegend, the legend is not printed by print().
See also:
insertLegend()

Constructor. Parameters:
parent Parent widget

Constructor. Parameters:
title Title text
 
parent Parent widget

This method is intended for manipulating the plot widget from a specific editor in the Qwt designer plugin.
Warning:
The plot editor has never been implemented.

Returns:
true if the autoReplot option is set.

Returns:
true if autoscaling is enabled
Parameters:
axisId axis index

Returns:
true if a specified axis is enabled
Parameters:
axisId axis index

Returns:
the font of the scale labels for a specified axis
Parameters:
axisId axis index

Returns:
the maximum number of major ticks for a specified axis
Parameters:
axisId axis index sa setAxisMaxMajor()

Returns:
the maximum number of minor ticks for a specified axis
Parameters:
axisId axis index sa setAxisMaxMinor()

Return the scale division of a specified axis. axisScaleDiv(axisId)->lowerBound(), axisScaleDiv(axisId)->upperBound() are the current limits of the axis scale.
Parameters:
axisId axis index
Returns:
Scale division
See also:
QwtScaleDiv, setAxisScaleDiv()

Return the scale division of a specified axis. axisScaleDiv(axisId)->lowerBound(), axisScaleDiv(axisId)->upperBound() are the current limits of the axis scale.
Parameters:
axisId axis index
Returns:
Scale division
See also:
QwtScaleDiv, setAxisScaleDiv()

Returns:
the scale draw of a specified axis
Parameters:
axisId axis index
Returns:
specified scaleDraw for axis, or NULL if axis is invalid.
See also:
QwtScaleDraw

Returns:
the scale draw of a specified axis
Parameters:
axisId axis index
Returns:
specified scaleDraw for axis, or NULL if axis is invalid.
See also:
QwtScaleDraw

Parameters:
axisId axis index
Returns:
Scale engine for a specific axis

Parameters:
axisId axis index
Returns:
Scale engine for a specific axis

Return the step size parameter, that has been set in setAxisScale. This doesn't need to be the step size of the current scale.
Parameters:
axisId axis index
Returns:
step size parameter value
See also:
setAxisScale()

Returns:
the title of a specified axis
Parameters:
axisId axis index

Returns:
true if the specified axis exists, otherwise false
Parameters:
axisId axis index

Returns:
specified axis, or NULL if axisId is invalid.
Parameters:
axisId axis index

Returns:
specified axis, or NULL if axisId is invalid.
Parameters:
axisId axis index

Returns:
the plot's canvas

Returns:
the plot's canvas

Nothing else than: canvas()->palette().color( QPalette::Normal, QColorGroup::Background);
Returns:
the background color of the plotting area.

Nothing else than: canvas()->lineWidth(), left for compatibility only.
Returns:
the border width of the plotting area

Parameters:
axisId Axis
Returns:
Map for the axis on the canvas. With this map pixel coordinates can translated to plot coordinates and vice versa.
See also:
QwtScaleMap, transform(), invTransform()

Remove all curves and markers
Deprecated
Use QwtPlotDeict::detachItems instead

Redraw the canvas.
Parameters:
painter Painter used for drawing
Warning:
drawCanvas calls drawItems what is also used for printing. Applications that like to add individual plot items better overload drawItems()
See also:
drawItems()

Redraw the canvas items.
Parameters:
painter Painter used for drawing
 
rect Bounding rectangle where to paint
 
map QwtPlot::axisCnt maps, mapping between plot and paint device coordinates
 
pfilter Plot print filter

Enable or disable a specified axis. When an axis is disabled, this only means that it is not visible on the screen. Curves, markers and can be attached to disabled axes, and transformation of screen coordinates into values works as normal.
Only xBottom and yLeft are enabled by default.
Parameters:
axisId axis index
 
tf true (enabled) or false (disabled)

This method is intended for manipulating the plot widget from a specific editor in the Qwt designer plugin.
Warning:
The plot editor has never been implemented.

Insert a legend. If the position legend is QwtPlot::LeftLegend or QwtPlot::RightLegend the legend will be organized in one column from top to down. Otherwise the legend items will be placed in a table with a best fit number of columns from left to right.
If pos != QwtPlot::ExternalLegend the plot widget will become parent of the legend. It will be deleted when the plot is deleted, or another legend is set with insertLegend().
Parameters:
legend Legend
 
pos The legend's position. For top/left position the number of colums will be limited to 1, otherwise it will be set to unlimited.
 
ratio Ratio between legend and the bounding rect of title, canvas and axes. The legend will be shrinked if it would need more space than the given ratio. The ratio is limited to ]0.0 .. 1.0]. In case of <= 0.0 it will be reset to the default ratio. The default vertical/horizontal ratio is 0.33/0.5.
See also:
legend(), QwtPlotLayout::legendPosition(), QwtPlotLayout::setLegendPosition()

Transform the x or y coordinate of a position in the drawing region into a value.
Parameters:
axisId axis index
 
pos position
Warning:
The position can be an x or a y coordinate, depending on the specified axis.

Returns:
the plot's legend
See also:
insertLegend()

Returns:
the plot's legend
See also:
insertLegend()

A signal which is emitted when the user has clicked on a legend item, which is in QwtLegend::CheckableItem mode
Parameters:
plotItem Corresponding plot item of the selected legend item
 
on True when the legen item is checked
Note:
clicks are disabled as default
See also:
QwtLegend::setItemMode(), QwtLegend::itemMode()

A signal which is emitted when the user has clicked on a legend item, which is in QwtLegend::ClickableItem mode.
Parameters:
plotItem Corresponding plot item of the selected legend item
Note:
clicks are disabled as default
See also:
QwtLegend::setItemMode(), QwtLegend::itemMode()

Called internally when the legend has been checked Emits a legendClicked() signal.

Called internally when the legend has been clicked on. Emits a legendClicked() signal.

Returns:
margin
See also:
setMargin(), QwtPlotLayout::margin(), plotLayout()

Returns:
the plot's title

Returns:
the plot's titel label.

Print the plot to a QPaintDevice (QPrinter) This function prints the contents of a QwtPlot instance to QPaintDevice object. The size is derived from its device metrics. Parameters:
paintDev device to paint on, often a printer
 
pfilter print filter
See also:
QwtPlotPrintFilter

Paint the plot into a given rectangle. Paint the contents of a QwtPlot instance into a given rectangle. Parameters:
painter Painter
 
plotRect Bounding rectangle
 
pfilter Print filter
See also:
QwtPlotPrintFilter

Print the canvas into a given rectangle.
Parameters:
painter Painter
 
map Maps mapping between plot and paint device coordinates
 
boundingRect Bounding rectangle
 
canvasRect Canvas rectangle
 
pfilter Print filter
See also:
QwtPlotPrintFilter

Print the legend into a given rectangle.
Parameters:
painter Painter
 
rect Bounding rectangle

Print the legend item into a given rectangle.
Parameters:
painter Painter
 
w Widget representing a legend item
 
rect Bounding rectangle

Paint a scale into a given rectangle. Paint the scale into a given rectangle. Parameters:
painter Painter
 
axisId Axis
 
startDist Start border distance
 
endDist End border distance
 
baseDist Base distance
 
rect Bounding rectangle

Print the title into a given rectangle.
Parameters:
painter Painter
 
rect Bounding rectangle

Redraw the plot. If the autoReplot option is not set (which is the default) or if any curves are attached to raw data, the plot has to be refreshed explicitly in order to make changes visible.
See also:
setAutoReplot()
Warning:
Calls canvas()->repaint, take care of infinite recursions

Resize and update internal layout
Parameters:
e Resize event

Set or reset the autoReplot option. If the autoReplot option is set, the plot will be updated implicitly by manipulating member functions. Since this may be time-consuming, it is recommended to leave this option switched off and call replot() explicitly if necessary.
The autoReplot option is set to false by default, which means that the user has to call replot() in order to make changes visible.
Parameters:
tf true or false. Defaults to true.
See also:
replot()

Enable autoscaling for a specified axis. This member function is used to switch back to autoscaling mode after a fixed scale has been set. Autoscaling is enabled by default.
Parameters:
axisId axis index
See also:
setAxisScale(), setAxisScaleDiv()

Change the font of an axis. Parameters:
axisId axis index
 
f font
Warning:
This function changes the font of the tick labels, not of the axis title.

Change the alignment of the tick labels
Parameters:
axisId axis index
 
alignment Or'd Qt::AlignmentFlags <see qnamespace.h>
See also:
QwtScaleDraw::setLabelAlignment()

Rotate all tick labels
Parameters:
axisId axis index
 
rotation Angle in degrees. When changing the label rotation, the label alignment might be adjusted too.
See also:
QwtScaleDraw::setLabelRotation(), setAxisLabelAlignment()

Set the maximum number of major scale intervals for a specified axis
Parameters:
axisId axis index
 
maxMajor maximum number of major steps
See also:
axisMaxMajor()

Set the maximum number of minor scale intervals for a specified axis
Parameters:
axisId axis index
 
maxMinor maximum number of minor steps
See also:
axisMaxMinor()

Disable autoscaling and specify a fixed scale for a selected axis. Parameters:
axisId axis index
 
min
 
max minimum and maximum of the scale
 
stepSize Major step size. If step == 0, the step size is calculated automatically using the maxMajor setting.
See also:
setAxisMaxMajor(), setAxisAutoScale()

Disable autoscaling and specify a fixed scale for a selected axis. Parameters:
axisId axis index
 
scaleDiv Scale division
See also:
setAxisScale(), setAxisAutoScale()

Set a scale draw. Parameters:
axisId axis index
 
scaleDraw object responsible for drawing scales.
By passing scaleDraw it is possible to extend QwtScaleDraw functionality and let it take place in QwtPlot. Please note that scaleDraw has to be created with new and will be deleted by the corresponding QwtScale member ( like a child object ).
See also:
QwtScaleDraw, QwtScaleWidget
Warning:
The attributes of scaleDraw will be overwritten by those of the previous QwtScaleDraw.

Change the scale engine for an axis
Parameters:
axisId axis index
 
scaleEngine Scale engine
See also:
axisScaleEngine()

Change the title of a specified axis. Parameters:
axisId axis index
 
title axis title

Change the title of a specified axis. Parameters:
axisId axis index
 
title axis title

Change the background of the plotting area. Sets c to QColorGroup::Background of all colorgroups of the palette of the canvas. Using canvas()->setPalette() is a more powerful way to set these colors.
Parameters:
c new background color

Change the border width of the plotting area Nothing else than canvas()->setLineWidth(w), left for compatibility only. Parameters:
w new border width

Change the margin of the plot. The margin is the space around all components.
Parameters:
margin new margin
See also:
QwtPlotLayout::setMargin(), margin(), plotLayout()

Change the plot's title
Parameters:
title New title

Change the plot's title
Parameters:
title New title

Return sizeHint
See also:
minimumSizeHint()

Returns:
the plot's title

Returns:
the plot's titel label.

Returns:
the plot's titel label.

Transform a value into a coordinate in the plotting region. Parameters:
axisId axis index
 
value value
Returns:
X or y coordinate in the plotting region corresponding to the value.

Adjust plot content to its current size. See also:
resizeEvent()

Update the focus tab order
The order is changed so that the canvas will be in front of the first legend item, or behind the last legend item - depending on the position of the legend.

Generated automatically by Doxygen for Qwt User's Guide from the source code.
Tue Nov 20 2012 Version 5.2.3

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.