LatticePADMRaster.h

Go to the documentation of this file.

//# LatticePADMRaster.h: drawing axis bound lattice elements as rasters
//# Copyright (C) 1996,1997,1998,1999,2000,2002
//# Associated Universities, Inc. Washington DC, USA.
//#
//# This library is free software; you can redistribute it and/or modify it
//# under the terms of the GNU Library General Public License as published by
//# the Free Software Foundation; either version 2 of the License, or (at your
//# option) any later version.
//#
//# This library is distributed in the hope that it will be useful, but WITHOUT
//# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
//# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public
//# License for more details.
//#
//# You should have received a copy of the GNU Library General Public License
//# along with this library; if not, write to the Free Software Foundation,
//# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
//#
//# Correspondence concerning AIPS++ should be addressed as follows:
//#        Internet email: aips2-request@nrao.edu.
//#        Postal address: AIPS++ Project Office
//#                        National Radio Astronomy Observatory
//#                        520 Edgemont Road
//#                        Charlottesville, VA 22903-2475 USA
//#
//# $Id$

#ifndef TRIALDISPLAY_LATTICEPADMRASTER_H
#define TRIALDISPLAY_LATTICEPADMRASTER_H

//# aips includes:
#include <casa/aips.h>

//# display library includes:
#include <display/DisplayDatas/LatticePADM.h>

namespace casa { //# NAMESPACE CASA - BEGIN

//# forwards:
        class IPosition;
        template <class T> class LatticePADisplayData;
        class WorldCanvas;
        template <class T> class Vector;
        template <class T> class Matrix;

// <summary>
// Class to draw a raster image of a slice of an AIPS++ Lattice.
// </summary>
//
// <use visibility=local>
//
// <reviewed reviewer="" date="yyyy/mm/dd" tests="" demos="">
// </reviewed>
//
// <prerequisite>
// <li> <linkto class="LatticeAsRaster">LatticeAsRaster</linkto>
// </prerequisite>
//
// <etymology>
// The purpose of this class is to draw "raster" images of data that
// is "lattice"-based.  The "PADM" refers to PrincipalAxesDisplayMethod,
// meaning that one or more instances of this class are used to actually
// draw slices of a Lattice along its main axes.
// </etymology>
//
// <synopsis>
// This is a helper class for the LatticeAsRaster class.  One or more
// instances of this class are created by a single LatticeAsRaster
// object, each being responsible for drawing a different slice of the
// data.
// </synopsis>
//
// <example>
// This class should only be used by the LatticeAsRaster class to
// setup a number of views of an AIPS++ Image or Array.  As such, this
// example simply outlines how this class is used by LatticeAsRaster,
// in, for example, a support function for a constructor:
// <srcblock>
// template <class T>
// void LatticeAsRaster<T>::setupElements(IPosition fixedPos) {
//   if (nPixelAxes > 2) {
//     nImages = dataLattice()->shape()(zAxisNum);
//     DDelement.resize(nImages);
//     for (uInt index = 0; index < nImages; index++) {
//       fixedPos(zAxisNum) = index;
//       DDelement[index] = (LatticePADisplayMethod<T> *)new
//       LatticePADMRaster<T>(dataLattice(), xAxisNum, yAxisNum,
//                            zAxisNum, fixedPos, this);
//     }
//   } else {
//     nImages = 1;
//     DDelement.resize(nImages);
//     DDelement[0] = (LatticePADisplayMethod<T> *)new
//       LatticePADMRaster<T>(dataLattice(), xAxisNum, yAxisNum, this);
//   }
// }
// </srcblock>
// </example>
//
// <motivation>
// Displaying 2-dimensional slices of a lattice-based data volume is
// a standard display requirement for astronomical data visualization
// and presentation.
// </motivation>
//
// <templating arg=T>
// </templating>
//
// <thrown>
// </thrown>
//
// <todo asof="yyyy/mm/dd">
// </todo>

        template <class T> class LatticePADMRaster : public LatticePADisplayMethod<T> {

        public:

                // Constructors: >2d and 2d.  xAxis and yAxis specify which axis in
                // the Lattice (0-based) should be mapped to X and Y on the display
                // device: ie. 2-d slices of the data to be displayed have these as
                // axes.  mAxis specifies the "movie" axis, which is the axis along
                // which different slices are taken.  fixedPos is an IPosition
                // having the same length as the number of dimensions in the array,
                // and indicates the fixed axis values for axes in the data that are
                // not specified as xAxis or yAxis: indeed, <src>fixedPos(mAxis)</src>
                // indicates which pixel value along the movie axis that this
                // particular object looks after.
                // <group>
                LatticePADMRaster(const uInt xAxis,
                                  const uInt yAxis, const uInt mAxis,
                                  const IPosition fixedPos,
                                  LatticePADisplayData<T> *arDat);
                LatticePADMRaster(const uInt xAxis,
                                  const uInt yAxis, LatticePADisplayData<T> *arDat);
                // </group>

                // Destructor
                virtual ~LatticePADMRaster();

                // Invoke (much more rapid) redraw of previous color-index rendering if
                // applicable (i.e., only during colormap 'fiddling' -- ColorTableChange
                // refresh).  Return value indicates success.
                virtual Bool dataRedrawSelf(WorldCanvas*,  Display::RefreshReason);

                // Actually draw on the display device.  The WorldCanvasHolder will
                // tell the LatticeAsRaster that it should now draw, which will in
                // turn determine which of its one or more LatticePADMRaster objects
                // should draw by matching the movie value on the WorldCanvas.  The
                // raster is drawn from world coordinate blc to trc.
                virtual uInt dataDrawSelf(WorldCanvas *wCanvas,
                                          const Vector<Double> &blc,
                                          const Vector<Double> &trc,
                                          const IPosition &start,
                                          const IPosition &shape,
                                          const IPosition &stride,
                                          const Bool usePixelEdges = False);

                //# Make parent members known.
        protected:
                using LatticePADisplayMethod<T>::parentDisplayData;
        private:
                bool initializeColorMatrix( LatticeAsRaster<T>* lar,
                                                        const IPosition &start,
                                            const IPosition &shape,
                                            const IPosition &stride,
                                            Matrix<T>& datMatrix,
                                                        Matrix<Bool>& maskMatrix) const;
        };


} //# NAMESPACE CASA - END

#ifndef AIPS_NO_TEMPLATE_SRC
#include <display/DisplayDatas/LatticePADMRaster.tcc>
#endif //# AIPS_NO_TEMPLATE_SRC
#endif