llline.cpp
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:6k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llline.cpp
  3.  * @author Andrew Meadows
  4.  * @brief Simple line class that can compute nearest approach between two lines
  5.  *
  6.  * $LicenseInfo:firstyear=2006&license=viewergpl$
  7.  * 
  8.  * Copyright (c) 2006-2010, Linden Research, Inc.
  9.  * 
  10.  * Second Life Viewer Source Code
  11.  * The source code in this file ("Source Code") is provided by Linden Lab
  12.  * to you under the terms of the GNU General Public License, version 2.0
  13.  * ("GPL"), unless you have obtained a separate licensing agreement
  14.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  15.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  16.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  17.  * 
  18.  * There are special exceptions to the terms and conditions of the GPL as
  19.  * it is applied to this Source Code. View the full text of the exception
  20.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  21.  * online at
  22.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  23.  * 
  24.  * By copying, modifying or distributing this software, you acknowledge
  25.  * that you have read and understood your obligations described above,
  26.  * and agree to abide by those obligations.
  27.  * 
  28.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  29.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  30.  * COMPLETENESS OR PERFORMANCE.
  31.  * $/LicenseInfo$
  32.  */
  33. #include "linden_common.h"
  34. #include "llline.h"
  35. #include "llrand.h"
  36. const F32 SOME_SMALL_NUMBER = 1.0e-5f;
  37. const F32 SOME_VERY_SMALL_NUMBER = 1.0e-8f;
  38. LLLine::LLLine()
  39. : mPoint(0.f, 0.f, 0.f),
  40. mDirection(1.f, 0.f, 0.f)
  41. { }
  42. LLLine::LLLine( const LLVector3& first_point, const LLVector3& second_point )
  43. {
  44. setPoints(first_point, second_point);
  45. }
  46. void LLLine::setPoints( const LLVector3& first_point, const LLVector3& second_point )
  47. {
  48. mPoint = first_point;
  49. mDirection = second_point - first_point;
  50. mDirection.normalize();
  51. }
  52. void LLLine::setPointDirection( const LLVector3& first_point, const LLVector3& second_point )
  53. {
  54. setPoints(first_point, first_point + second_point);
  55. }
  56. bool LLLine::intersects( const LLVector3& point, F32 radius ) const
  57. {
  58. LLVector3 other_direction = point - mPoint;
  59. LLVector3 nearest_point = mPoint + mDirection * (other_direction * mDirection);
  60. F32 nearest_approach = (nearest_point - point).length();
  61. return (nearest_approach <= radius);
  62. }
  63. // returns the point on this line that is closest to some_point
  64. LLVector3 LLLine::nearestApproach( const LLVector3& some_point ) const
  65. {
  66. return (mPoint + mDirection * ((some_point - mPoint) * mDirection));
  67. }
  68. // the accuracy of this method sucks when you give it two nearly
  69. // parallel lines, so you should probably check for parallelism
  70. // before you call this
  71. // 
  72. // returns the point on this line that is closest to other_line
  73. LLVector3 LLLine::nearestApproach( const LLLine& other_line ) const
  74. {
  75. LLVector3 between_points = other_line.mPoint - mPoint;
  76. F32 dir_dot_dir = mDirection * other_line.mDirection;
  77. F32 one_minus_dir_dot_dir = 1.0f - fabs(dir_dot_dir);
  78. if ( one_minus_dir_dot_dir < SOME_VERY_SMALL_NUMBER )
  79. {
  80. #ifdef LL_DEBUG
  81. llwarns << "LLLine::nearestApproach() was given two very "
  82. << "nearly parallel lines dir1 = " << mDirection 
  83. << " dir2 = " << other_line.mDirection << " with 1-dot_product = " 
  84. << one_minus_dir_dot_dir << llendl;
  85. #endif
  86. // the lines are approximately parallel
  87. // We shouldn't fall in here because this check should have been made
  88. // BEFORE this function was called.  We dare not continue with the 
  89. // computations for fear of division by zero, but we have to return 
  90. // something so we return a bogus point -- caller beware.
  91. return 0.5f * (mPoint + other_line.mPoint);
  92. }
  93. F32 odir_dot_bp = other_line.mDirection * between_points;
  94. F32 numerator = 0;
  95. F32 denominator = 0;
  96. for (S32 i=0; i<3; i++)
  97. {
  98. F32 factor = dir_dot_dir * other_line.mDirection.mV[i] - mDirection.mV[i];
  99. numerator += ( between_points.mV[i] - odir_dot_bp * other_line.mDirection.mV[i] ) * factor;
  100. denominator -= factor * factor;
  101. }
  102. F32 length_to_nearest_approach = numerator / denominator;
  103. return mPoint + length_to_nearest_approach * mDirection;
  104. }
  105. std::ostream& operator<<( std::ostream& output_stream, const LLLine& line )
  106. {
  107. output_stream << "{point=" << line.mPoint << "," << "dir=" << line.mDirection << "}";
  108. return output_stream;
  109. }
  110. F32 ALMOST_PARALLEL = 0.99f;
  111. F32 TOO_SMALL_FOR_DIVISION = 0.0001f;
  112. // returns 'true' if this line intersects the plane
  113. // on success stores the intersection point in 'result'
  114. bool LLLine::intersectsPlane( LLVector3& result, const LLLine& plane ) const
  115. {
  116. // p = P + l * d     equation for a line
  117. // 
  118. // N * p = D         equation for a point
  119. //
  120. // N * (P + l * d) = D
  121. // N*P + l * (N*d) = D
  122. // l * (N*d) = D - N*P
  123. // l =  ( D - N*P ) / ( N*d )
  124. //
  125. F32 dot = plane.mDirection * mDirection;
  126. if (fabs(dot) < TOO_SMALL_FOR_DIVISION)
  127. {
  128. return false;
  129. }
  130. F32 plane_dot = plane.mDirection * plane.mPoint;
  131. F32 length = ( plane_dot - (plane.mDirection * mPoint) ) / dot;
  132. result = mPoint + length * mDirection;
  133. return true;
  134. }
  135. //static 
  136. // returns 'true' if planes intersect, and stores the result 
  137. // the second and third arguments are treated as planes
  138. // where mPoint is on the plane and mDirection is the normal
  139. // result.mPoint will be the intersection line's closest approach 
  140. // to first_plane.mPoint
  141. bool LLLine::getIntersectionBetweenTwoPlanes( LLLine& result, const LLLine& first_plane, const LLLine& second_plane )
  142. {
  143. // TODO -- if we ever get some generic matrix solving code in our libs
  144. // then we should just use that, since this problem is really just
  145. // linear algebra.
  146. F32 dot = fabs(first_plane.mDirection * second_plane.mDirection);
  147. if (dot > ALMOST_PARALLEL)
  148. {
  149. // the planes are nearly parallel
  150. return false;
  151. }
  152. LLVector3 direction = first_plane.mDirection % second_plane.mDirection;
  153. direction.normalize();
  154. LLVector3 first_intersection;
  155. {
  156. LLLine intersection_line(first_plane);
  157. intersection_line.mDirection = direction % first_plane.mDirection;
  158. intersection_line.mDirection.normalize();
  159. intersection_line.intersectsPlane(first_intersection, second_plane);
  160. }
  161. /*
  162. LLVector3 second_intersection;
  163. {
  164. LLLine intersection_line(second_plane);
  165. intersection_line.mDirection = direction % second_plane.mDirection;
  166. intersection_line.mDirection.normalize();
  167. intersection_line.intersectsPlane(second_intersection, first_plane);
  168. }
  169. */
  170. result.mPoint = first_intersection;
  171. result.mDirection = direction;
  172. return true;
  173. }