// ======================================================================
//
// Copyright (c) 2000 The CGAL Consortium
//
// This software and related documentation is part of an INTERNAL release
// of the Computational Geometry Algorithms Library (CGAL). It is not
// intended for general use.
//
// ----------------------------------------------------------------------
//
// release       :
// release_date  :
//
// file          : include/CGAL/Cartesian/Plane_3.h
// revision      : $Revision$
// revision_date : $Date$
// author(s)     : Andreas Fabri
// coordinator   : INRIA Sophia-Antipolis (Mariette.Yvinec@sophia.inria.fr)
//
// ======================================================================

#ifndef CGAL_CARTESIAN_PLANE_3_H
#define CGAL_CARTESIAN_PLANE_3_H

#include <CGAL/Cartesian/redefine_names_3.h>
#include <CGAL/Fourtuple.h>

CGAL_BEGIN_NAMESPACE

template <class R_>
class PlaneC3 CGAL_ADVANCED_KERNEL_PARTIAL_SPEC
  : public Handle_for< Fourtuple<typename R_::FT> >
{
public:
  typedef R_                                    R;
  typedef typename R::FT                        FT;
  typedef typename R::RT                        RT;
#ifndef CGAL_CFG_NO_ADVANCED_KERNEL
  typedef PlaneC3<R,Cartesian_tag>              Self;
  typedef typename R::Point_2                   Point_2;
  typedef typename R::Point_3                   Point_3;
  typedef typename R::Vector_3                  Vector_3;
  typedef typename R::Direction_3               Direction_3;
  typedef typename R::Line_3                    Line_3;
  typedef typename R::Ray_3                     Ray_3;
  typedef typename R::Segment_3                 Segment_3;
  typedef typename R::Aff_transformation_3      Aff_transformation_3;
#else
  typedef PlaneC3<R>                            Self;
  typedef typename R::Point_2_base              Point_2;
  typedef typename R::Point_3_base              Point_3;
  typedef typename R::Vector_3_base             Vector_3;
  typedef typename R::Direction_3_base          Direction_3;
  typedef typename R::Line_3_base               Line_3;
  typedef typename R::Ray_3_base                Ray_3;
  typedef typename R::Segment_3_base            Segment_3;
  typedef typename R::Aff_transformation_3_base Aff_transformation_3;
#endif

  PlaneC3();
  PlaneC3(const Self &p);
  PlaneC3(const Point_3 &p, const Point_3 &q, const Point_3 &r);
  PlaneC3(const Point_3 &p, const Direction_3 &d);
  PlaneC3(const Point_3 &p, const Vector_3 &v);
  PlaneC3(const FT &a, const FT &b, const FT &c, const FT &d);
  PlaneC3(const Line_3 &l, const Point_3 &p);
  PlaneC3(const Segment_3 &s, const Point_3 &p);
  PlaneC3(const Ray_3 &r, const Point_3 &p);
  ~PlaneC3();

  bool         operator==(const Self &p) const;
  bool         operator!=(const Self &p) const;

  FT           a() const;
  FT           b() const;
  FT           c() const;
  FT           d() const;

  Line_3       perpendicular_line(const Point_3 &p) const;
  Self             opposite() const;

  Point_3      point() const;
  Point_3      projection(const Point_3 &p) const;
  Vector_3     orthogonal_vector() const;
  Direction_3  orthogonal_direction() const;
  Vector_3     base1() const;
  Vector_3     base2() const;

  Point_3      to_plane_basis(const Point_3 &p) const;

  Point_2      to_2d(const Point_3 &p) const;
  Point_3      to_3d(const Point_2 &p) const;

  Self        transform(const Aff_transformation_3 &t) const;


  Oriented_side oriented_side(const Point_3 &p) const;
  bool         has_on_boundary(const Point_3 &p) const;
  bool         has_on_boundary(const Line_3 &p) const;
  bool         has_on_positive_side(const Point_3 &l) const;
  bool         has_on_negative_side(const Point_3 &l) const;
  bool         has_on(const Point_3 &p) const;

  bool         is_degenerate() const;

private:
  void              new_rep(const Point_3 &p,
                            const Point_3 &q,
                            const Point_3 &r);
  void              new_rep(const FT &a, const FT &b,
                            const FT &c, const FT &d);
};

CGAL_END_NAMESPACE

#ifndef CGAL_CARTESIAN_CLASS_DEFINED
#include <CGAL/Cartesian/Plane_3.C>
#endif 

#endif // CGAL_CARTESIAN_PLANE_3_H