<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Qwt User's Guide: QwtRasterData Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Qwt User's Guide <span id="projectnumber">6.0.1</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> </div>
<div class="headertitle">
<h1>QwtRasterData Class Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="QwtRasterData" -->
<p><a class="el" href="class_qwt_raster_data.html" title="QwtRasterData defines an interface to any type of raster data.">QwtRasterData</a> defines an interface to any type of raster data.
<a href="#_details">More...</a></p>
<p><code>#include <<a class="el" href="qwt__raster__data_8h_source.html">qwt_raster_data.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for QwtRasterData:</div>
<div class="dyncontent">
<div class="center"><img src="class_qwt_raster_data__inherit__graph.png" border="0" usemap="#_qwt_raster_data_inherit__map" alt="Inheritance graph"/></div>
<map name="_qwt_raster_data_inherit__map" id="_qwt_raster_data_inherit__map">
<area shape="rect" id="node3" href="class_qwt_matrix_raster_data.html" title="A class representing a matrix of values as raster data." alt="" coords="5,83,152,112"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="class_qwt_raster_data-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#ac0053b66315fde6f0a9a69c40d7c5dcc">ConrecFlag</a> { <br/>
  <a class="el" href="class_qwt_raster_data.html#ac0053b66315fde6f0a9a69c40d7c5dccafd2f6337e825201a247408f033713c92">IgnoreAllVerticesOnLevel</a> = 0x01,
<br/>
  <a class="el" href="class_qwt_raster_data.html#ac0053b66315fde6f0a9a69c40d7c5dcca18e8d1de171dd43cc957c279eb03d32c">IgnoreOutOfRange</a> = 0x02
<br/>
}</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef QFlags< <a class="el" href="class_qwt_raster_data.html#ac0053b66315fde6f0a9a69c40d7c5dcc">ConrecFlag</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a8101f4a0c71813d49fcdc73a457c4874">ConrecFlags</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef QMap< double, QPolygonF > </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#adc6679160a229992f0870a2b784985f3">ContourLines</a></td></tr>
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_qwt_raster_data.html#adc6679160a229992f0870a2b784985f3">ContourLines</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a1fa90434ddeeeeaacb80657e49af8fe1">contourLines</a> (const QRectF &rect, const QSize &raster, const QList< double > &levels, <a class="el" href="class_qwt_raster_data.html#a8101f4a0c71813d49fcdc73a457c4874">ConrecFlags</a>) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a369a5f525814bf569e01f88fbd8ddb5b">discardRaster</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a64f5bf40b6138cc66719a56555c03589">initRaster</a> (const QRectF &, const QSize &raster)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="class_qwt_interval.html">QwtInterval</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a8423d051697f975150b3b555bfcac8b9">interval</a> (Qt::Axis) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual QRectF </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#ad1ce58351804760d1ba1e7efe97d39d6">pixelHint</a> (const QRectF &) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a0fc20e05a794c0dc85f6ae5719566588">QwtRasterData</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a14abf60573989e2a2c97e21a98aee558">setInterval</a> (Qt::Axis, const <a class="el" href="class_qwt_interval.html">QwtInterval</a> &)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual double </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a6396fc013fcec893b1e8cea4cf03691e">value</a> (double x, double y) const =0</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="class_qwt_raster_data.html#a95b24c7cad42c5f7947e64e990def3e8">~QwtRasterData</a> ()</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<div class="textblock"><p><a class="el" href="class_qwt_raster_data.html" title="QwtRasterData defines an interface to any type of raster data.">QwtRasterData</a> defines an interface to any type of raster data. </p>
<p><a class="el" href="class_qwt_raster_data.html" title="QwtRasterData defines an interface to any type of raster data.">QwtRasterData</a> is an abstract interface, that is used by <a class="el" href="class_qwt_plot_raster_item.html" title="A class, which displays raster data.">QwtPlotRasterItem</a> to find the values at the pixels of its raster.</p>
<p>Often a raster item is used to display values from a matrix. Then the derived raster data class needs to implement some sort of resampling, that maps the raster of the matrix into the requested raster of the raster item ( depending on resolution and scales of the canvas ). </p>
</div><hr/><h2>Member Typedef Documentation</h2>
<a class="anchor" id="a8101f4a0c71813d49fcdc73a457c4874"></a><!-- doxytag: member="QwtRasterData::ConrecFlags" ref="a8101f4a0c71813d49fcdc73a457c4874" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef QFlags<<a class="el" href="class_qwt_raster_data.html#ac0053b66315fde6f0a9a69c40d7c5dcc">ConrecFlag</a>> <a class="el" href="class_qwt_raster_data.html#a8101f4a0c71813d49fcdc73a457c4874">QwtRasterData::ConrecFlags</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Flags to modify the contour algorithm. </p>
</div>
</div>
<a class="anchor" id="adc6679160a229992f0870a2b784985f3"></a><!-- doxytag: member="QwtRasterData::ContourLines" ref="adc6679160a229992f0870a2b784985f3" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef QMap<double, QPolygonF> <a class="el" href="class_qwt_raster_data.html#adc6679160a229992f0870a2b784985f3">QwtRasterData::ContourLines</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Contour lines. </p>
</div>
</div>
<hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="ac0053b66315fde6f0a9a69c40d7c5dcc"></a><!-- doxytag: member="QwtRasterData::ConrecFlag" ref="ac0053b66315fde6f0a9a69c40d7c5dcc" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="class_qwt_raster_data.html#ac0053b66315fde6f0a9a69c40d7c5dcc">QwtRasterData::ConrecFlag</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Flags to modify the contour algorithm. </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ac0053b66315fde6f0a9a69c40d7c5dccafd2f6337e825201a247408f033713c92"></a><!-- doxytag: member="IgnoreAllVerticesOnLevel" ref="ac0053b66315fde6f0a9a69c40d7c5dccafd2f6337e825201a247408f033713c92" args="" -->IgnoreAllVerticesOnLevel</em> </td><td>
<p>Ignore all verices on the same level. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ac0053b66315fde6f0a9a69c40d7c5dcca18e8d1de171dd43cc957c279eb03d32c"></a><!-- doxytag: member="IgnoreOutOfRange" ref="ac0053b66315fde6f0a9a69c40d7c5dcca18e8d1de171dd43cc957c279eb03d32c" args="" -->IgnoreOutOfRange</em> </td><td>
<p>Ignore all values, that are out of range. </p>
</td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a0fc20e05a794c0dc85f6ae5719566588"></a><!-- doxytag: member="QwtRasterData::QwtRasterData" ref="a0fc20e05a794c0dc85f6ae5719566588" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QwtRasterData::QwtRasterData </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Constructor. </p>
</div>
</div>
<a class="anchor" id="a95b24c7cad42c5f7947e64e990def3e8"></a><!-- doxytag: member="QwtRasterData::~QwtRasterData" ref="a95b24c7cad42c5f7947e64e990def3e8" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QwtRasterData::~QwtRasterData </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Destructor. </p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a1fa90434ddeeeeaacb80657e49af8fe1"></a><!-- doxytag: member="QwtRasterData::contourLines" ref="a1fa90434ddeeeeaacb80657e49af8fe1" args="(const QRectF &rect, const QSize &raster, const QList< double > &levels, ConrecFlags) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="class_qwt_raster_data.html#adc6679160a229992f0870a2b784985f3">QwtRasterData::ContourLines</a> QwtRasterData::contourLines </td>
<td>(</td>
<td class="paramtype">const QRectF & </td>
<td class="paramname"><em>rect</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QSize & </td>
<td class="paramname"><em>raster</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QList< double > & </td>
<td class="paramname"><em>levels</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="class_qwt_raster_data.html#a8101f4a0c71813d49fcdc73a457c4874">ConrecFlags</a> </td>
<td class="paramname"><em>flags</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Calculate contour lines</p>
<p>An adaption of CONREC, a simple contouring algorithm. <a href="http://local.wasp.uwa.edu.au/~pbourke/papers/conrec/">http://local.wasp.uwa.edu.au/~pbourke/papers/conrec/</a> </p>
</div>
</div>
<a class="anchor" id="a369a5f525814bf569e01f88fbd8ddb5b"></a><!-- doxytag: member="QwtRasterData::discardRaster" ref="a369a5f525814bf569e01f88fbd8ddb5b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void QwtRasterData::discardRaster </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Discard a raster. </p>
<p>After the composition of an image <a class="el" href="class_qwt_plot_spectrogram.html" title="A plot item, which displays a spectrogram.">QwtPlotSpectrogram</a> calls <a class="el" href="class_qwt_raster_data.html#a369a5f525814bf569e01f88fbd8ddb5b" title="Discard a raster.">discardRaster()</a>.</p>
<p>The default implementation does nothing, but if data has been loaded in <a class="el" href="class_qwt_raster_data.html#a64f5bf40b6138cc66719a56555c03589" title="Initialize a raster.">initRaster()</a>, it could deleted now.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_raster_data.html#a64f5bf40b6138cc66719a56555c03589" title="Initialize a raster.">initRaster()</a>, <a class="el" href="class_qwt_raster_data.html#a6396fc013fcec893b1e8cea4cf03691e">value()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a64f5bf40b6138cc66719a56555c03589"></a><!-- doxytag: member="QwtRasterData::initRaster" ref="a64f5bf40b6138cc66719a56555c03589" args="(const QRectF &, const QSize &raster)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void QwtRasterData::initRaster </td>
<td>(</td>
<td class="paramtype">const QRectF & </td>
<td class="paramname"><em>area</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const QSize & </td>
<td class="paramname"><em>raster</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Initialize a raster. </p>
<p>Before the composition of an image <a class="el" href="class_qwt_plot_spectrogram.html" title="A plot item, which displays a spectrogram.">QwtPlotSpectrogram</a> calls initRaster, announcing the area and its resolution that will be requested.</p>
<p>The default implementation does nothing, but for data sets that are stored in files, it might be good idea to reimplement initRaster, where the data is resampled and loaded into memory.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">area</td><td>Area of the raster </td></tr>
<tr><td class="paramname">raster</td><td>Number of horizontal and vertical pixels</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_raster_data.html#a64f5bf40b6138cc66719a56555c03589" title="Initialize a raster.">initRaster()</a>, <a class="el" href="class_qwt_raster_data.html#a6396fc013fcec893b1e8cea4cf03691e">value()</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a8423d051697f975150b3b555bfcac8b9"></a><!-- doxytag: member="QwtRasterData::interval" ref="a8423d051697f975150b3b555bfcac8b9" args="(Qt::Axis) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="class_qwt_interval.html">QwtInterval</a> & QwtRasterData::interval </td>
<td>(</td>
<td class="paramtype">Qt::Axis </td>
<td class="paramname"><em>axis</em></td><td>)</td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="return"><dt><b>Returns:</b></dt><dd>Bounding interval for a axis </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_raster_data.html#a14abf60573989e2a2c97e21a98aee558">setInterval</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ad1ce58351804760d1ba1e7efe97d39d6"></a><!-- doxytag: member="QwtRasterData::pixelHint" ref="ad1ce58351804760d1ba1e7efe97d39d6" args="(const QRectF &) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QRectF QwtRasterData::pixelHint </td>
<td>(</td>
<td class="paramtype">const QRectF & </td>
<td class="paramname"><em>area</em></td><td>)</td>
<td> const<code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Pixel hint. </p>
<p><a class="el" href="class_qwt_raster_data.html#ad1ce58351804760d1ba1e7efe97d39d6" title="Pixel hint.">pixelHint()</a> returns the geometry of a pixel, that can be used to calculate the resolution and alignment of the plot item, that is representing the data.</p>
<p>Width and height of the hint need to be the horizontal and vertical distances between 2 neighboured points. The center of the hint has to be the position of any point ( it doesn't matter which one ).</p>
<p>An empty hint indicates, that there are values for any detail level.</p>
<p>Limiting the resolution of the image might significantly improve the performance and heavily reduce the amount of memory when rendering a QImage from the raster data.</p>
<p>The default implementation returns an empty rectangle recommending to render in target device ( f.e. screen ) resolution.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">area</td><td>In most implementations the resolution of the data doesn't depend on the requested area.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Bounding rectangle of a pixel </dd></dl>
<p>Reimplemented in <a class="el" href="class_qwt_matrix_raster_data.html#a7a9034de8037af500e4f737f54591358">QwtMatrixRasterData</a>.</p>
</div>
</div>
<a class="anchor" id="a14abf60573989e2a2c97e21a98aee558"></a><!-- doxytag: member="QwtRasterData::setInterval" ref="a14abf60573989e2a2c97e21a98aee558" args="(Qt::Axis, const QwtInterval &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void QwtRasterData::setInterval </td>
<td>(</td>
<td class="paramtype">Qt::Axis </td>
<td class="paramname"><em>axis</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="class_qwt_interval.html">QwtInterval</a> & </td>
<td class="paramname"><em>interval</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the bounding interval for the x, y or z coordinates.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">axis</td><td>Axis </td></tr>
<tr><td class="paramname">interval</td><td>Bounding interval</td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="class_qwt_raster_data.html#a8423d051697f975150b3b555bfcac8b9">interval()</a> </dd></dl>
<p>Reimplemented in <a class="el" href="class_qwt_matrix_raster_data.html#a69db38d8f920edb9dc3f0953ca16db8f">QwtMatrixRasterData</a>.</p>
</div>
</div>
<a class="anchor" id="a6396fc013fcec893b1e8cea4cf03691e"></a><!-- doxytag: member="QwtRasterData::value" ref="a6396fc013fcec893b1e8cea4cf03691e" args="(double x, double y) const =0" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual double QwtRasterData::value </td>
<td>(</td>
<td class="paramtype">double </td>
<td class="paramname"><em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"><em>y</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const<code> [pure virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="return"><dt><b>Returns:</b></dt><dd>the value at a raster position </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">x</td><td>X value in plot coordinates </td></tr>
<tr><td class="paramname">y</td><td>Y value in plot coordinates </td></tr>
</table>
</dd>
</dl>
<p>Implemented in <a class="el" href="class_qwt_matrix_raster_data.html#a49952670063166bccdbfb9cdbd7b56e8">QwtMatrixRasterData</a>.</p>
</div>
</div>
</div>
<hr class="footer"/><address class="footer"><small>Generated by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>
