NAME

       QwtMatrixRasterData -

       A class representing a matrix of values as raster data.

SYNOPSIS

       #include <qwt_matrix_raster_data.h>

       Inherits QwtRasterData.

   Public Types
       enum ResampleMode { NearestNeighbour, BilinearInterpolation }
           Resampling algorithm The default setting is NearestNeighbour;.

   Public Member Functions
       QwtMatrixRasterData ()
           Constructor.
       virtual ~QwtMatrixRasterData ()
           Destructor.
       void setResampleMode (ResampleMode mode)
           Set the resampling algorithm.
       ResampleMode resampleMode () const
       virtual void setInterval (Qt::Axis, const QwtInterval &)
           Assign the bounding interval for an axis.
       void setValueMatrix (const QVector< double > &values, int numColumns)
           Assign a value matrix.
       const QVector< double > valueMatrix () const
       void setValue (int row, int col, double value)
           Change a single value in the matrix.
       int numColumns () const
       int numRows () const
       virtual QRectF pixelHint (const QRectF &) const
           Calculate the pixel hint.
       virtual double value (double x, double y) const

Detailed Description

       A class representing a matrix of values as raster data.

       QwtMatrixRasterData implements an interface for a matrix of equidistant values, that can
       be used by a QwtPlotRasterItem. It implements a couple of resampling algorithms, to
       provide values for positions, that or not on the value matrix.

Member Enumeration Documentation

   enum QwtMatrixRasterData::ResampleMode
       Resampling algorithm The default setting is NearestNeighbour;.

       Enumerator

       NearestNeighbour
              Return the value from the matrix, that is nearest to the the requested position.

       BilinearInterpolation
              Interpolate the value from the distances and values of the 4 surrounding values in
              the matrix,

Member Function Documentation

   int QwtMatrixRasterData::numColumns () const
       Returns:
           Number of columns of the value matrix

       See Also:
           valueMatrix(), numRows(), setValueMatrix()

   int QwtMatrixRasterData::numRows () const
       Returns:
           Number of rows of the value matrix

       See Also:
           valueMatrix(), numColumns(), setValueMatrix()

   QRectF QwtMatrixRasterData::pixelHint (const QRectF &area) const [virtual]
       Calculate the pixel hint. pixelHint() 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.

       • NearestNeighbour
          pixelHint() returns the surrounding pixel of the top left value in the matrix.

       • BilinearInterpolation
          Returns an empty rectangle recommending to render in target device ( f.e. screen )
         resolution.

       Parameters:
           area Requested area, ignored

       Returns:
           Calculated hint

       See Also:
           ResampleMode, setMatrix(), setInterval()

       Reimplemented from QwtRasterData.

   QwtMatrixRasterData::ResampleMode QwtMatrixRasterData::resampleMode () const
       Returns:
           resampling algorithm

       See Also:
           setResampleMode(), value()

   void QwtMatrixRasterData::setInterval (Qt::Axisaxis, const QwtInterval &interval) [virtual]
       Assign the bounding interval for an axis. Setting the bounding intervals for the X/Y axis
       is mandatory to define the positions for the values of the value matrix. The interval in Z
       direction defines the possible range for the values in the matrix, what is f.e used by
       QwtPlotSpectrogram to map values to colors. The Z-interval might be the bounding interval
       of the values in the matrix, but usually it isn't. ( f.e a interval of 0.0-100.0 for
       values in percentage )

       Parameters:
           axis X, Y or Z axis
           interval Interval

       See Also:
           QwtRasterData::interval(), setValueMatrix()

       Reimplemented from QwtRasterData.

   void QwtMatrixRasterData::setResampleMode (ResampleModemode)
       Set the resampling algorithm.

       Parameters:
           mode Resampling mode

       See Also:
           resampleMode(), value()

   void QwtMatrixRasterData::setValue (introw, intcol, doublevalue)
       Change a single value in the matrix.

       Parameters:
           row Row index
           col Column index
           value New value

       See Also:
           value(), setValueMatrix()

   void QwtMatrixRasterData::setValueMatrix (const QVector< double > &values, intnumColumns)
       Assign a value matrix. The positions of the values are calculated by dividing the bounding
       rectangle of the X/Y intervals into equidistant rectangles ( pixels ). Each value
       corresponds to the center of a pixel.

       Parameters:
           values Vector of values
           numColumns Number of columns

       See Also:
           valueMatrix(), numColumns(), numRows(), setInterval()()

   double QwtMatrixRasterData::value (doublex, doubley) const [virtual]
       Returns:
           the value at a raster position

       Parameters:
           x X value in plot coordinates
           y Y value in plot coordinates

       See Also:
           ResampleMode

       Implements QwtRasterData.

   const QVector< double > QwtMatrixRasterData::valueMatrix () const
       Returns:
           Value matrix

       See Also:
           setValueMatrix(), numColumns(), numRows(), setInterval()

Author

       Generated automatically by Doxygen for Qwt User's Guide from the source code.