DDDEllipse.h

Go to the documentation of this file.

//# DDDEllipse.h: declaration of ellipse DDDObject
//# Copyright (C) 1999,2000,2001,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_DDDELLIPSE_H
#define TRIALDISPLAY_DDDELLIPSE_H

#include <casa/aips.h>
#include <casa/Arrays/Vector.h>
#include <casa/Arrays/Matrix.h>
#include <casa/Containers/Record.h>
#include <casa/Containers/Block.h> 
#include <casa/Logging/LogIO.h>
#include <casa/Quanta/Quantum.h>
#include <casa/Quanta/Unit.h>
#include <coordinates/Coordinates/CoordinateSystem.h>
#include <display/DisplayDatas/DDDObject.h>
#include <display/DisplayDatas/DDDHandle.h>

namespace casa { //# NAMESPACE CASA - BEGIN

class LogIO;
class DisplayEvent;

// <summary>
// Implementation of an ellipse/rectangle object for DrawingDisplayData class.
// </summary>

// <synopsis>
// This class implements the interface defined by DDDObject, to provide
// an ellipse or rectangle object for registration with DrawingDisplayData objects.
// The widths are all full widths.  
// </synopsis>
//
// <todo>
// Create a drawEllipse function on the world canvas and move
// intelligence from here to there.
// </todo>
//

class DDDEllipse : public DDDObject {

 public:

  // Constructor taking a Record description.  Fields in the record,
  // on top of what is consumed by the DDDObject constructor, are:
  // Required : <src>center</src> (vector of quanta length 2),
  // <src>major, minor, positionangle</src> (all quanta).  
  //
  // Units 'frac' ([0->1]) are available for the center only.
  // Units 'pix' (absolute 0-rel image pixels) are available for the 
  // major and minor only.
  //
  // Other, not required fields are <src>outline & editable</src>
  // which default to <src>True</src>.  When <src>editable=False</src>
  // the object can be moved but not reshaped, when <src>True</src>   
  // it can be moved and reshaped.   When   <src>outline=False</src> 
  // the ellipse is filled.   If the field <src>rectangle=True</src>
  // a rectangle is drawn. If it does not exist or is False, an ellipse
  // is drawn.
  //
  // Finally, field <src>doreference</src> which defaults to <src>False</src>
  // is used to control the location at which conversions to and from
  // pixel coordinates are done.  If <src>True</src> then all conversions
  // are done at the reference value. Otherwise, the conversions are 
  // done at the actual location of the shape.  For example, with
  // a DirectionCoordinate plane, setting <src>doreference=True</src>
  // will cause the shape to rotate as you move it about the display
  // as the position angle tracks the local North.  
  DDDEllipse(const Record &description, DrawingDisplayData *owner);

  // Destructor.
  virtual ~DDDEllipse();
  
  // Draw this object for the given reason on the provided
  // WorldCanvas.
  virtual void draw(const Display::RefreshReason &reason, 
                    WorldCanvas *worldcanvas);
  
  // Return a record describing this object.  Presently returns
  // only construction description.
  virtual Record description();

  // Update this object based on the information in the provided
  // Record.
  virtual void setDescription(const Record &rec);
  
  // Event handlers.  The parent DrawingDisplayData will distribute
  // events as necessary to the various DDDObjects which comprise it.
  // <group>
  virtual void operator()(const WCRefreshEvent &ev);
  virtual void operator()(const WCPositionEvent &ev);
  virtual void operator()(const WCMotionEvent &ev);
  // </group>

 protected:

  // (Required) default constructor.
  DDDEllipse();

  // (Required) copy constructor.
  DDDEllipse(const DDDEllipse &other);

  // (Required) copy assignment.
  void operator=(const DDDEllipse &other);

 private:

// Fill style
  Bool itsOutline;

// Define center x, center y, major, minor, pa in world
  Vector<Quantum<Double> > itsWorldParameters;

// Define center x, center y, major, minor, pa (radians) in screen pixel
  Vector<Double> itsPixelCenter, itsPixelShape;

// Rotated Rectangle Corners to draw in screen pixel
  Matrix<Double> itsCorners;
  Matrix<Double> itsPixelOffsets;

// List of handles

  Block<DDDHandle> itsHandles;

// Mode.

  DDDObject::Mode itsMode;

// Store for movement bases.

  Double itsBaseMoveX, itsBaseMoveY;

// Logger

  LogIO itsLogger;

// CoordinateSystem in screen pixel coordinates
  CoordinateSystem itsCoordinateSystem;
  
// pointer to world canvas (shallow copy)
  WorldCanvas* itsWorldCanvasPtr;

// are we drawing a rectangle or an ellipse ?
  Bool itsRectangle;

// Fractional indicators
  Bool itsFracX, itsFracY;

// Do world/pixel conversions at reference location ?
   Bool itsDoRef;

// COnvert parameters from world to pixel
   void convertToPixel ();

// Update private world parameters from current pixel values
   void updateWorldValues ();

// Decode record into private data

   void decode(const RecordInterface& description, Bool required);

// Encode private data into record
   void encode(RecordInterface& description) const;

// compute corners of rectangle
  void createCorners();

  Matrix<Int> toIntPixel(const Matrix<Double>& points);

// Debugging routines

   void listWorld();
   void listPixel();

};


} //# NAMESPACE CASA - END

#endif