qwtcurve.3

linux下qt的第三方的一个类

.TH "QwtCurve" 3 "16 Nov 2004" "Version 4.2.0" "Qwt User's Guide" \" -*- nroff -*-
.ad l
.nh
.SH NAME
QwtCurve \- 
.SH SYNOPSIS
.br
.PP
Inherited by \fBQwtPlotCurve\fP.
.PP
.SH "Detailed Description"
.PP 
A class which draws curves. 

This class can be used to display data as a curve in the x-y plane. It supports different display styles, spline interpolation and symbols.
.PP
\fBUsage\fP.RS 4

.IP "\fBA. Assign curve properties \fP" 1c
When a curve is created, it is configured to draw black solid lines with QwtCurve::Lines and no symbols. You can change this by calling \fBQwtCurve::setPen()\fP, \fBQwtCurve::setStyle()\fP and \fBQwtCurve::setSymbol()\fP. 
.IP "\fBB. Assign or change data. \fP" 1c
Data can be set in two ways:.PD 0

.IP "\(bu" 2
\fBQwtCurve::setData()\fP is overloaded to initialize the x and y data by copying from different data structures with different kind of copy semantics. 
.IP "\(bu" 2
\fBQwtCurve::setRawData()\fP only stores the pointers and size information and is provided for backwards compatibility. This function is less safe (you must not delete the data while they are attached), but has been more efficient, and has been more convenient for dynamically changing data. Use of \fBQwtCurve::setData()\fP in combination with a problem-specific subclass of \fBQwtData\fP is always preferrable.
.PP
.IP "\fBC. Draw \fP" 1c
\fBQwtCurve::draw()\fP maps the data into pixel coordinates and paints them. 
.PP
.RE
.PP
\fBExample:\fP.RS 4
see examples/curvdemo
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtData\fP, \fBQwtSymbol\fP, \fBQwtDiMap\fP 
.RE
.PP

.PP
Definition at line 60 of file qwt_curve.h.
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBCurveStyle\fP { \fBNoCurve\fP, \fBLines\fP, \fBSticks\fP, \fBSteps\fP, \fBDots\fP, \fBSpline\fP, \fBUserCurve\fP =  100 }"
.br
.ti -1c
.RI "enum \fBCurveOption\fP { \fBAuto\fP =  0, \fBYfx\fP =  1, \fBXfy\fP =  2, \fBParametric\fP =  4, \fBPeriodic\fP =  8, \fBInverted\fP =  16 }"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBQwtCurve\fP (const QString &title=QString::null)"
.br
.ti -1c
.RI "\fBQwtCurve\fP (const \fBQwtCurve\fP &c)"
.br
.ti -1c
.RI "virtual \fB~QwtCurve\fP ()"
.br
.ti -1c
.RI "const \fBQwtCurve\fP & \fBoperator=\fP (const \fBQwtCurve\fP &c)"
.br
.ti -1c
.RI "void \fBsetRawData\fP (const double *x, const double *y, int size)"
.br
.ti -1c
.RI "void \fBsetData\fP (const double *xData, const double *yData, int size)"
.br
.ti -1c
.RI "void \fBsetData\fP (const QwtArray< double > &xData, const QwtArray< double > &yData)"
.br
.ti -1c
.RI "void \fBsetData\fP (const QwtArray< \fBQwtDoublePoint\fP > &data)"
.br
.ti -1c
.RI "void \fBsetData\fP (const \fBQwtData\fP &data)"
.br
.ti -1c
.RI "int \fBdataSize\fP () const"
.br
.ti -1c
.RI "double \fBx\fP (int i) const"
.br
.ti -1c
.RI "double \fBy\fP (int i) const"
.br
.ti -1c
.RI "virtual \fBQwtDoubleRect\fP \fBboundingRect\fP () const"
.br
.ti -1c
.RI "double \fBminXValue\fP () const"
.br
.ti -1c
.RI "double \fBmaxXValue\fP () const"
.br
.ti -1c
.RI "double \fBminYValue\fP () const"
.br
.ti -1c
.RI "double \fBmaxYValue\fP () const"
.br
.ti -1c
.RI "void \fBsetOptions\fP (int t)"
.br
.ti -1c
.RI "int \fBoptions\fP () const"
.br
.ti -1c
.RI "void \fBsetTitle\fP (const QString &title)"
.br
.ti -1c
.RI "const QString & \fBtitle\fP () const"
.br
.ti -1c
.RI "void \fBsetPen\fP (const QPen &)"
.br
.ti -1c
.RI "const QPen & \fBpen\fP () const"
.br
.ti -1c
.RI "void \fBsetBrush\fP (const QBrush &)"
.br
.ti -1c
.RI "const QBrush & \fBbrush\fP () const"
.br
.ti -1c
.RI "void \fBsetBaseline\fP (double ref)"
.br
.ti -1c
.RI "double \fBbaseline\fP () const"
.br
.ti -1c
.RI "void \fBsetStyle\fP (int style, int options=0)"
.br
.ti -1c
.RI "int \fBstyle\fP () const"
.br
.ti -1c
.RI "void \fBsetSymbol\fP (const \fBQwtSymbol\fP &s)"
.br
.ti -1c
.RI "const \fBQwtSymbol\fP & \fBsymbol\fP () const"
.br
.ti -1c
.RI "void \fBsetSplineSize\fP (int s)"
.br
.ti -1c
.RI "int \fBsplineSize\fP () const"
.br
.ti -1c
.RI "virtual void \fBdraw\fP (QPainter *p, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap, int from=0, int to=-1)"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "void \fBinit\fP (const QString &title)"
.br
.ti -1c
.RI "void \fBcopy\fP (const \fBQwtCurve\fP &c)"
.br
.ti -1c
.RI "virtual void \fBdrawCurve\fP (QPainter *p, int style, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap, int from, int to)"
.br
.ti -1c
.RI "virtual void \fBdrawSymbols\fP (QPainter *p, \fBQwtSymbol\fP &, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap, int from, int to)"
.br
.ti -1c
.RI "void \fBdrawLines\fP (QPainter *p, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap, int from, int to)"
.br
.ti -1c
.RI "void \fBdrawSticks\fP (QPainter *p, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap, int from, int to)"
.br
.ti -1c
.RI "void \fBdrawDots\fP (QPainter *p, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap, int from, int to)"
.br
.ti -1c
.RI "void \fBdrawSteps\fP (QPainter *p, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap, int from, int to)"
.br
.ti -1c
.RI "void \fBdrawSpline\fP (QPainter *p, const \fBQwtDiMap\fP &xMap, const \fBQwtDiMap\fP &yMap)"
.br
.ti -1c
.RI "void \fBclosePolyline\fP (const \fBQwtDiMap\fP &, const \fBQwtDiMap\fP &, QPointArray &) const"
.br
.ti -1c
.RI "virtual void \fBcurveChanged\fP ()"
.br
.ti -1c
.RI "int \fBverifyRange\fP (int &i1, int &i2)"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "\fBQwtSpline\fP \fBd_spx\fP"
.br
.ti -1c
.RI "\fBQwtSpline\fP \fBd_spy\fP"
.br
.in -1c
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBQwtCurve::CurveOption\fP"
.PP
Curve options. 
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::setOptions\fP 
.RE
.PP
Definition at line 82 of file qwt_curve.h.
.SS "enum \fBQwtCurve::CurveStyle\fP"
.PP
Curve styles. 
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::setStyle\fP 
.RE
.PP
Definition at line 67 of file qwt_curve.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "QwtCurve::QwtCurve (const QString & title = \fCQString::null\fP)"
.PP
Ctor. 
.PP
\fBParameters:\fP
.RS 4
\fItitle\fP title of the curve 
.RE
.PP
Definition at line 321 of file qwt_curve.cpp.
.PP
References init().
.SS "QwtCurve::QwtCurve (const \fBQwtCurve\fP & c)"
.PP
Copy Constructor. 
.PP
Definition at line 60 of file qwt_curve.cpp.
.PP
References copy(), d_title, and init().
.SS "QwtCurve::~\fBQwtCurve\fP ()\fC [virtual]\fP"
.PP
Dtor. 
.PP
Definition at line 52 of file qwt_curve.cpp.
.SH "Member Function Documentation"
.PP 
.SS "double QwtCurve::baseline () const"
.PP
Return the value of the baseline. 
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::setBaseline\fP 
.RE
.PP
Definition at line 907 of file qwt_curve.cpp.
.PP
Referenced by QwtPlot::curveBaseline().
.SS "\fBQwtDoubleRect\fP QwtCurve::boundingRect () const\fC [virtual]\fP"
.PP
Returns the bounding rectangle of the curve data. If there is no bounding rect, like for empty data the rectangle is invalid: \fBQwtDoubleRect.isValid()\fP == FALSE Definition at line 309 of file qwt_curve.cpp.
.PP
References QwtData::boundingRect().
.PP
Referenced by QwtPlot::updateAxes().
.SS "const QBrush & QwtCurve::brush () const"
.PP
Return the brush used to fill the area between lines and the baseline. 
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::setBrush\fP, \fBQwtCurve::setBaseline\fP, \fBQwtCurve::baseline\fP 
.RE
.PP
Definition at line 196 of file qwt_curve.cpp.
.PP
Referenced by QwtPlot::curveBrush().
.SS "void QwtCurve::closePolyline (const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, QPointArray & pa) const\fC [protected]\fP"
.PP
Complete a polygon to be a closed polygon including the area between the original polygon and the baseline. 
.PP
\fBParameters:\fP
.RS 4
\fIxMap\fP X map 
.br
\fIyMap\fP Y map 
.br
\fIpa\fP Polygon to be completed 
.RE
.PP
Definition at line 831 of file qwt_curve.cpp.
.PP
References QwtDiMap::transform().
.PP
Referenced by drawDots(), drawLines(), drawSpline(), and drawSteps().
.SS "void QwtCurve::copy (const \fBQwtCurve\fP & c)\fC [protected]\fP"
.PP
Copy the contents of a curve into another curve. 
.PP
Definition at line 36 of file qwt_curve.cpp.
.PP
References QwtData::copy(), d_data, d_options, d_pen, d_ref, d_splineSize, d_style, d_sym, and d_title.
.PP
Referenced by operator=(), and QwtCurve().
.SS "void QwtCurve::curveChanged ()\fC [protected, virtual]\fP"
.PP
Notify a change of attributes. This virtual function is called when an attribute of the curve has changed. It can be redefined by derived classes. The default implementation does nothing. 
.PP
Reimplemented in \fBQwtPlotCurve\fP.
.PP
Definition at line 927 of file qwt_curve.cpp.
.PP
Referenced by operator=(), setBaseline(), setBrush(), setData(), setOptions(), setPen(), setRawData(), setSplineSize(), setStyle(), setSymbol(), and setTitle().
.SS "int QwtCurve::dataSize () const"
.PP
Return the size of the data arrays Definition at line 915 of file qwt_curve.cpp.
.PP
References QwtData::size().
.PP
Referenced by QwtPlot::closestCurve(), draw(), drawCurve(), drawSpline(), and verifyRange().
.SS "void QwtCurve::draw (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from = \fC0\fP, int to = \fC-1\fP)\fC [virtual]\fP"
.PP
Draw an intervall of the curve. 
.PP
\fBParameters:\fP
.RS 4
\fIpainter\fP Painter 
.br
\fIxMap\fP maps x-values into pixel coordinates. 
.br
\fIyMap\fP maps y-values into pixel coordinates. 
.br
\fIfrom\fP index of the first point to be painted 
.br
\fIto\fP index of the last point to be painted. If to < 0 the curve will be painted to its last point.
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::drawCurve\fP, \fBQwtCurve::drawDots\fP, \fBQwtCurve::drawLines\fP, \fBQwtCurve::drawSpline\fP, \fBQwtCurve::drawSteps\fP, \fBQwtCurve::drawSticks\fP 
.RE
.PP
Definition at line 357 of file qwt_curve.cpp.
.PP
References dataSize(), drawCurve(), drawSymbols(), QwtSymbol::style(), and verifyRange().
.PP
Referenced by QwtPlot::drawCanvasItems(), and QwtPlot::drawCurve().
.SS "void QwtCurve::drawCurve (QPainter * painter, int style, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from, int to)\fC [protected, virtual]\fP"
.PP
Draw the line part (without symbols) of a curve interval. 
.PP
\fBParameters:\fP
.RS 4
\fIpainter\fP Painter 
.br
\fIstyle\fP curve style, see \fBQwtCurve::CurveStyle\fP 
.br
\fIxMap\fP x map 
.br
\fIyMap\fP y map 
.br
\fIfrom\fP index of the first point to be painted 
.br
\fIto\fP index of the last point to be painted 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::draw\fP, \fBQwtCurve::drawDots\fP, \fBQwtCurve::drawLines\fP, \fBQwtCurve::drawSpline\fP, \fBQwtCurve::drawSteps\fP, \fBQwtCurve::drawSticks\fP 
.RE
.PP
Definition at line 401 of file qwt_curve.cpp.
.PP
References dataSize(), drawDots(), drawLines(), drawSpline(), drawSteps(), and drawSticks().
.PP
Referenced by draw().
.SS "void QwtCurve::drawDots (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from, int to)\fC [protected]\fP"
.PP
Draw dots. 
.PP
\fBParameters:\fP
.RS 4
\fIpainter\fP Painter 
.br
\fIxMap\fP x map 
.br
\fIyMap\fP y map 
.br
\fIfrom\fP index of the first point to be painted 
.br
\fIto\fP index of the last point to be painted 
.RE
.PP
\fBSee also:\fP
.RS 4
QwtCurve::drawPolyline, QwtCurve::drawLine, \fBQwtCurve::drawLines\fP, \fBQwtCurve::drawSpline\fP, \fBQwtCurve::drawSteps\fP QwtCurve::drawPolyline, QwtCurve::drawPolygon 
.RE
.PP
Definition at line 502 of file qwt_curve.cpp.
.PP
References closePolyline(), QwtPainter::drawPoint(), QwtPainter::drawPolygon(), QwtDiMap::transform(), x(), and y().
.PP
Referenced by drawCurve().
.SS "void QwtCurve::drawLines (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from, int to)\fC [protected]\fP"
.PP
Draw lines. 
.PP
\fBParameters:\fP
.RS 4
\fIpainter\fP Painter 
.br
\fIxMap\fP x map 
.br
\fIyMap\fP y map 
.br
\fIfrom\fP index of the first point to be painted 
.br
\fIto\fP index of the last point to be painted 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::draw\fP, \fBQwtCurve::drawLines\fP, \fBQwtCurve::drawDots\fP, \fBQwtCurve::drawSpline\fP, \fBQwtCurve::drawSteps\fP, \fBQwtCurve::drawSticks\fP 
.RE
.PP
Definition at line 441 of file qwt_curve.cpp.
.PP
References closePolyline(), QwtPainter::drawPolygon(), QwtPainter::drawPolyline(), QwtDiMap::transform(), x(), and y().
.PP
Referenced by drawCurve(), and drawSpline().
.SS "void QwtCurve::drawSpline (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap)\fC [protected]\fP"
.PP
Draw a spline. 
.PP
\fBParameters:\fP
.RS 4
\fIpainter\fP Painter 
.br
\fIxMap\fP x map 
.br
\fIyMap\fP y map 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::draw\fP, \fBQwtCurve::drawCurve\fP, \fBQwtCurve::drawDots\fP, \fBQwtCurve::drawLines\fP, \fBQwtCurve::drawSteps\fP, \fBQwtCurve::drawSticks\fP 
.RE
.PP
Definition at line 583 of file qwt_curve.cpp.
.PP
References closePolyline(), dataSize(), drawLines(), QwtPainter::drawPolygon(), QwtPainter::drawPolyline(), qwtSqr(), QwtSpline::recalc(), QwtSpline::value(), x(), QwtDiMap::xTransform(), and y().
.PP
Referenced by drawCurve().
.SS "void QwtCurve::drawSteps (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from, int to)\fC [protected]\fP"
.PP
Draw step function. 
.PP
\fBParameters:\fP
.RS 4
\fIpainter\fP Painter 
.br
\fIxMap\fP x map 
.br
\fIyMap\fP y map 
.br
\fIfrom\fP index of the first point to be painted 
.br
\fIto\fP index of the last point to be painted 
.RE
.PP
\fBSee also:\fP
.RS 4