Lib/Math/vector.hxx

   1 // vector.hxx -- additional vector routines
   2 //
   3 // Written by Curtis Olson, started December 1997.
   4 //
   5 // Copyright (C) 1997  Curtis L. Olson  - curt@infoplane.com
   6 //
   7 // This program is free software; you can redistribute it and/or
   8 // modify it under the terms of the GNU General Public License as
   9 // published by the Free Software Foundation; either version 2 of the
  10 // License, or (at your option) any later version.
  11 //
  12 // This program is distributed in the hope that it will be useful, but
  13 // WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 // General Public License for more details.
  16 //
  17 // You should have received a copy of the GNU General Public License
  18 // along with this program; if not, write to the Free Software
  19 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20 //
  21 // $Id$
  22
  23
  24 #ifndef _VECTOR_HXX
  25 #define _VECTOR_HXX
  26
  27
  28 #ifndef __cplusplus
  29 # error This library requires C++
  30 #endif
  31
  32
  33 #include "mat3.h"
  34
  35
  36 // Map a vector onto the plane specified by normal
  37 #if defined( USE_XTRA_MAT3_INLINES )
  38 #  define map_vec_onto_cur_surface_plane(normal, v0, vec, result) { \
  39         double scale = ((normal[0]*vec[0]+normal[1]*vec[1]+normal[2]*vec[2]) / \
  40                (normal[0]*normal[0]+normal[1]*normal[1]+normal[2]*normal[2])); \
  41         result[0] = vec[0]-normal[0]*scale; \
  42         result[1] = vec[1]-normal[1]*scale; \
  43         result[2] = vec[2]-normal[2]*scale; \
  44   }
  45 #else
  46   void map_vec_onto_cur_surface_plane(MAT3vec normal, MAT3vec v0, MAT3vec vec,
  47                                     MAT3vec result);
  48 #endif //defined( USE_XTRA_MAT3_INLINES )
  49
  50
  51 // Given a point p, and a line through p0 with direction vector d,
  52 // find the shortest distance from the point to the line
  53 double fgPointLine(MAT3vec p, MAT3vec p0, MAT3vec d);
  54
  55
  56 // Given a point p, and a line through p0 with direction vector d,
  57 // find the shortest distance (squared) from the point to the line
  58 double fgPointLineSquared(MAT3vec p, MAT3vec p0, MAT3vec d);
  59
  60
  61 #endif // _VECTOR_HXX
  62
  63