---

sglSphericalTransform.hpp

/*****************************************************************************
 * SGL: A Scene Graph Library
 *
 * Copyright (C) 1997-2001  Scott McMillan   All Rights Reserved.
 *
 * 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 Mass Ave, Cambridge, MA 02139, USA.
 *****************************************************************************
 *     File: sglSphericalTransform.hpp
 *  Created: 15 January 2001 (was sgluSphericalTransform)
 *  Summary: spherical transform subclass of sglTransform
 *****************************************************************************/

#ifndef __SGL_SPHERICAL_TRANSFORM_HPP
#define __SGL_SPHERICAL_TRANSFORM_HPP

#include <sgl.h>
#include <sglTransform.hpp>

template <class T>
class SGL_DLL_API sglSphericalTransform : public sglTransform<T>
{
public:
   enum ModeEnum { eX_UP, eY_UP, eZ_UP };

public:
   sglSphericalTransform();
   virtual ~sglSphericalTransform() {}

   void setMode(ModeEnum mode) { m_mode = mode; }

   ModeEnum getMode() const { return m_mode; }

   virtual void reset();

   void updateAzimuth(T delta_azimuth)
      {
         setAzimuth(m_azimuth + delta_azimuth);
      }

   void updateElevation(T delta_elevation)
      {
         setElevation(m_elevation + delta_elevation);
      }

   void updateRadius(T delta_radius)
      {
         setRadius(m_radius + delta_radius);
      }

   void updateCOI(const sglVec3<T> &delta_coi)
      {
         m_pos_coi += delta_coi;
      }

   void updateCOI(T delta_x, T delta_y, T delta_z)
      {
         m_pos_coi += sglVec3<T>(delta_x, delta_y, delta_z);
      }

   T getAzimuth() const { return m_azimuth; }

   void setAzimuth(T new_azimuth);

   T getElevation() const { return m_elevation; }

   void setElevation(T new_elevation);

   T getRadius() const { return m_radius; }

   void setRadius(T new_radius);

   const sglVec3<T> &getCOI() const { return m_pos_coi; }

   void setCOI(const sglVec3<T> &pos_coi) { m_pos_coi = pos_coi; }

   void setCOI(T x, T y, T z) { m_pos_coi.set(x, y, z); }

   void computeMatrix();

   // See sglNode::clone() for details.
   virtual sglNode *clone(unsigned int mode) const;

   // See sglObject::printInfo() for details.
   virtual void printInfo(ostream &ostrm, const char *indent_spaces) const;

private:  // not implemented
   sglSphericalTransform(const sglSphericalTransform&);
   sglSphericalTransform &operator=(const sglSphericalTransform&);

   void copyTo(sglSphericalTransform *dst, unsigned int mode) const;

protected:
   ModeEnum   m_mode;     // defines which is the polar axis (z by default)

   sglVec3<T> m_pos_coi;  // lookat position for center of interest

   T m_radius;      // distance from center of interest
   T m_elevation, m_sin_el, m_cos_el;  // elevation angle in degrees
   T m_azimuth,   m_sin_az, m_cos_az;  // azimuth angle in degrees

   sglVec2<T>   m_delta_pos;  // HACK - set by subclass
};

//----------------------------------------------------------------------------
// convenience types:
//    template class 'should' only be float or double

typedef sglSphericalTransform<float>  sglSphericalTransformf;
typedef sglSphericalTransform<double> sglSphericalTransformd;

#endif

---