Math/vector.hxx

   1 /**************************************************************************
   2  * vector.hxx -- additional vector routines
   3  *
   4  * Written by Curtis Olson, started December 1997.
   5  *
   6  * Copyright (C) 1997  Curtis L. Olson  - curt@infoplane.com
   7  *
   8  * This program is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License as
  10  * published by the Free Software Foundation; either version 2 of the
  11  * License, or (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21  *
  22  * $Id$
  23  * (Log is kept at end of this file)
  24  **************************************************************************/
  25
  26
  27 #ifndef _VECTOR_HXX
  28 #define _VECTOR_HXX
  29
  30
  31 #ifndef __cplusplus
  32 # error This library requires C++
  33 #endif
  34
  35
  36 #include "mat3.h"
  37
  38
  39 /* Map a vector onto the plane specified by normal */
  40 #if defined( USE_XTRA_MAT3_INLINES )
  41 #  define map_vec_onto_cur_surface_plane(normal, v0, vec, result) { \
  42         double scale = ((normal[0]*vec[0]+normal[1]*vec[1]+normal[2]*vec[2]) / \
  43                (normal[0]*normal[0]+normal[1]*normal[1]+normal[2]*normal[2])); \
  44         result[0] = vec[0]-normal[0]*scale; \
  45         result[1] = vec[1]-normal[1]*scale; \
  46         result[2] = vec[2]-normal[2]*scale; \
  47   }
  48 #else
  49   void map_vec_onto_cur_surface_plane(MAT3vec normal, MAT3vec v0, MAT3vec vec,
  50                                     MAT3vec result);
  51 #endif //defined( USE_XTRA_MAT3_INLINES )
  52
  53
  54 // Given a point p, and a line through p0 with direction vector d,
  55 // find the shortest distance from the point to the line
  56 double fgPointLine(MAT3vec p, MAT3vec p0, MAT3vec d);
  57
  58
  59 // Given a point p, and a line through p0 with direction vector d,
  60 // find the shortest distance (squared) from the point to the line
  61 double fgPointLineSquared(MAT3vec p, MAT3vec p0, MAT3vec d);
  62
  63
  64 #endif /* _VECTOR_HXX */
  65
  66
  67 /* $Log$
  68 /* Revision 1.3  1998/08/24 20:04:13  curt
  69 /* Various "inline" code optimizations contributed by Norman Vine.
  70 /*
  71  * Revision 1.2  1998/07/24 21:34:38  curt
  72  * fgPointLine() rewritten into fgPointLineSquared() ... this ultimately saves
  73  * us from doing a sqrt().
  74  *
  75  * Revision 1.1  1998/07/08 14:40:10  curt
  76  * polar3d.[ch] renamed to polar3d.[ch]xx, vector.[ch] renamed to vector.[ch]xx
  77  * Updated fg_geodesy comments to reflect that routines expect and produce
  78  *   meters.
  79  *
  80  * Revision 1.4  1998/04/21 17:03:51  curt
  81  * Prepairing for C++ integration.
  82  *
  83  * Revision 1.3  1998/01/22 02:59:39  curt
  84  * Changed #ifdef FILE_H to #ifdef _FILE_H
  85  *
  86  * Revision 1.2  1998/01/19 19:27:14  curt
  87  * Merged in make system changes from Bob Kuehne <rpk@sgi.com>
  88  * This should simplify things tremendously.
  89  *
  90  * Revision 1.1  1997/12/22 04:13:18  curt
  91  * Initial revision.
  92  *
  93  */