// Filename: lvector3_src.h
// Created by:  drose (24Sep99)
//
////////////////////////////////////////////////////////////////////
//
// PANDA 3D SOFTWARE
// Copyright (c) 2001 - 2004, Disney Enterprises, Inc.  All rights reserved
//
// All use of this software is subject to the terms of the Panda 3d
// Software license.  You should have received a copy of this license
// along with this source code; you will also find a current copy of
// the license at http://etc.cmu.edu/panda3d/docs/license/ .
//
// To contact the maintainers of this program write to
// panda3d-general@lists.sourceforge.net .
//
////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////
//       Class : LVector3
// Description : This is a three-component vector distance (as opposed
//               to a three-component point, which represents a
//               particular point in space).  Some of the methods are
//               slightly different between LPoint3 and LVector3; in
//               particular, subtraction of two points yields a
//               vector, while addition of a vector and a point yields
//               a point.
////////////////////////////////////////////////////////////////////
class EXPCL_PANDA_LINMATH FLOATNAME(LVector3) : public FLOATNAME(LVecBase3) {
PUBLISHED:
  INLINE_LINMATH FLOATNAME(LVector3)();
  INLINE_LINMATH FLOATNAME(LVector3)(const FLOATNAME(LVecBase3) &copy);
  INLINE_LINMATH FLOATNAME(LVector3) &operator = (const FLOATNAME(LVecBase3) &copy);
  INLINE_LINMATH FLOATNAME(LVector3) &operator = (FLOATTYPE fill_value);
  INLINE_LINMATH FLOATNAME(LVector3)(FLOATTYPE fill_value);
  INLINE_LINMATH FLOATNAME(LVector3)(FLOATTYPE x, FLOATTYPE y, FLOATTYPE z);

  INLINE_LINMATH static const FLOATNAME(LVector3) &zero();
  INLINE_LINMATH static const FLOATNAME(LVector3) &unit_x();
  INLINE_LINMATH static const FLOATNAME(LVector3) &unit_y();
  INLINE_LINMATH static const FLOATNAME(LVector3) &unit_z();

  INLINE_LINMATH FLOATNAME(LVector3) operator - () const;

  INLINE_LINMATH FLOATNAME(LVecBase3) operator + (const FLOATNAME(LVecBase3) &other) const;
  INLINE_LINMATH FLOATNAME(LVector3) operator + (const FLOATNAME(LVector3) &other) const;

  INLINE_LINMATH FLOATNAME(LVecBase3) operator - (const FLOATNAME(LVecBase3) &other) const;
  INLINE_LINMATH FLOATNAME(LVector3) operator - (const FLOATNAME(LVector3) &other) const;

  INLINE_LINMATH FLOATNAME(LVector3) cross(const FLOATNAME(LVecBase3) &other) const;
  INLINE_LINMATH FLOATTYPE angle_rad(const FLOATNAME(LVector3) &other) const;
  INLINE_LINMATH FLOATTYPE angle_deg(const FLOATNAME(LVector3) &other) const;

  INLINE_LINMATH FLOATTYPE relative_angle_rad(const FLOATNAME(LVector3) &other) const;
  INLINE_LINMATH FLOATTYPE relative_angle_deg(const FLOATNAME(LVector3) &other) const;


  INLINE_LINMATH FLOATNAME(LVector3) operator * (FLOATTYPE scalar) const;
  INLINE_LINMATH FLOATNAME(LVector3) operator / (FLOATTYPE scalar) const;

  // Some special named constructors for LVector3.

  INLINE_LINMATH static FLOATNAME(LVector3) up(CoordinateSystem cs = CS_default);
  INLINE_LINMATH static FLOATNAME(LVector3) right(CoordinateSystem cs = CS_default);
  INLINE_LINMATH static FLOATNAME(LVector3) forward(CoordinateSystem cs = CS_default);

  INLINE_LINMATH static FLOATNAME(LVector3) down(CoordinateSystem cs = CS_default);
  INLINE_LINMATH static FLOATNAME(LVector3) left(CoordinateSystem cs = CS_default);
  INLINE_LINMATH static FLOATNAME(LVector3) back(CoordinateSystem cs = CS_default);

//  INLINE_LINMATH static FLOATNAME(LVector3) & rfu(FLOATTYPE right,
  INLINE_LINMATH static FLOATNAME(LVector3) rfu(FLOATTYPE right,
                                        FLOATTYPE fwd,FLOATTYPE up,     CoordinateSystem cs = CS_default);

#ifdef HAVE_PYTHON
  INLINE_LINMATH void python_repr(ostream &out, const string &class_name) const;
#endif

public:
  static TypeHandle get_class_type() {
    return _type_handle;
  }
  static void init_type();

private:
  static TypeHandle _type_handle;
};

#include "lvector3_src.I"
