DefaultWCCoordinateHandler.h

Go to the documentation of this file.

//# DefaultWCCoordinateHandler.h: default coordinate handling for WorldCanvas
//# Copyright (C) 1993,1994,1995,1996,1997,1998,1999,2000,2001
//# 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_DEFAULTWCCOORDINATEHANDLER_H
#define TRIALDISPLAY_DEFAULTWCCOORDINATEHANDLER_H

#include <casa/aips.h>
#include <display/DisplayCanvas/WCCoordinateHandler.h>

namespace casa { //# NAMESPACE CASA - BEGIN

// <summary>
// Class to provide default coordinate handling for WorldCanvases.
// </summary>
//
// <prerequisite>
// <li> <linkto class="WCCoordinateHandler">WCCoordinateHandler</linkto>
// <li> <linkto class="CoordinateSystem">CoordinateSystem</linkto>
// </prerequisite>
//
// <etymology>
// DefaultWCCoordinateHandler stands for Default WorldCanvas Coordinate Handler
// </etymology>
//
// <synopsis>
// Implements identity transformation function pairs between World Coordinates
// and linear coordinates. It assumes 2 axes only.
// </synopsis>
//
// <motivation>
// Recognized that 95% of the time the WorldCanvas will be used in
// conjunction with a world coordinate system of some kind.  So it makes
// more sense to assume that there is always a coordinate handler available
// and use it rather than to have to check to see if there is a handler
// registered with the WorldCanvas or not each time you have to do a
// transformation.
//
// The WorldCanvas creates this default handler for its own purpose.
// </motivation>
//

        class DefaultWCCoordinateHandler : public WCCoordinateHandler {

        public:

                // Default Constructor Required
                DefaultWCCoordinateHandler();

                // just copy lin to world and vice versa.  The input vectors must be of
                // length 2. The output vectors are resized as needed.  The output matrices
                // must be the correct shape on input.
                // <group>
                virtual Bool linToWorld(Vector<Double> & world, const Vector<Double> & lin);
                virtual Bool linToWorld(Matrix<Double> & world,
                                        Vector<Bool> & failures,
                                        const Matrix<Double> & lin);
                virtual Bool worldToLin(Vector<Double> & lin, const Vector<Double> & world);
                virtual Bool worldToLin(Matrix<Double> & lin,
                                        Vector<Bool> & failures,
                                        const Matrix<Double> & world);
                // </group>

                // return the number of world axes. Always 2.
                virtual uInt nWorldAxes() const {
                        return 2;
                }

                // Routines that give the axes names and the units. Both return "Pixel".
                // <group>
                virtual Vector<String> worldAxisNames() const;
                virtual Vector<String> worldAxisUnits() const;
                // </group>

                std::string errorMessage( ) const { return ""; }

                // Destructor
                virtual ~DefaultWCCoordinateHandler();

        };


} //# NAMESPACE CASA - END

#endif