qwtcurve.3

软件无线电的平台

.TH "QwtCurve" 3 "4 Nov 2003" "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:
.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
.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

.SS "enum \fBQwtCurve::CurveStyle\fP"
.PP
Curve styles. 
.PP
\fBSee also:\fP
.RS 4
\fBQwtCurve::setStyle\fP 
.RE
.PP

.SH "Constructor & Destructor Documentation"
.PP 
.SS "QwtCurve::QwtCurve (const QString & title = QString::null)"
.PP
Ctor. \fBParameters:\fP
.RS 4
\fItitle\fP title of the curve 
.RE
.PP

.SS "QwtCurve::QwtCurve (const \fBQwtCurve\fP & c)"
.PP
Copy Constructor. 
.SS "QwtCurve::~\fBQwtCurve\fP ()\fC [virtual]\fP"
.PP
Dtor. 
.SH "Member Function Documentation"
.PP 
.SS "double QwtCurve::baseline () const"
.PP
Return the value of the baseline. \fBSee also:\fP
.RS 4
\fBQwtCurve::setBaseline\fP 
.RE
.PP

.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 
.SS "const  QBrush & QwtCurve::brush () const"
.PP
Return the brush used to fill the area between lines and the baseline. \fBSee also:\fP
.RS 4
\fBQwtCurve::setBrush\fP, \fBQwtCurve::setBaseline\fP, \fBQwtCurve::baseline\fP 
.RE
.PP

.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. \fBParameters:\fP
.RS 4
\fIxMap\fP X map 
.br
\fIyMap\fP Y map 
.br
\fIpa\fP Polygon to be completed 
.RE
.PP

.SS "void QwtCurve::copy (const \fBQwtCurve\fP & c)\fC [protected]\fP"
.PP
Copy the contents of a curve into another curve. 
.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. Reimplemented in \fBQwtPlotCurve\fP.
.SS "int QwtCurve::dataSize () const"
.PP
Return the size of the data arrays 
.SS "void QwtCurve::draw (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from = 0, int to = -1)\fC [virtual]\fP"
.PP
Draw an intervall of the curve. \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

.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. \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

.SS "void QwtCurve::drawDots (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from, int to)\fC [protected]\fP"
.PP
Draw dots. \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

.SS "void QwtCurve::drawLines (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap, int from, int to)\fC [protected]\fP"
.PP
Draw lines. \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

.SS "void QwtCurve::drawSpline (QPainter * painter, const \fBQwtDiMap\fP & xMap, const \fBQwtDiMap\fP & yMap)\fC [protected]\fP"
.PP
Draw a spline. \fBParameters:\fP
.RS 4