mPoint.cpp

Public Functions

Point3F

mPerp(const Point3F & inVec)

Public Functions

mPerp(const Point3F & inVec)

Returns a perpendicular vector to the unit length input vector.

 1
 2//-----------------------------------------------------------------------------
 3// Copyright (c) 2012 GarageGames, LLC
 4//
 5// Permission is hereby granted, free of charge, to any person obtaining a copy
 6// of this software and associated documentation files (the "Software"), to
 7// deal in the Software without restriction, including without limitation the
 8// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 9// sell copies of the Software, and to permit persons to whom the Software is
10// furnished to do so, subject to the following conditions:
11//
12// The above copyright notice and this permission notice shall be included in
13// all copies or substantial portions of the Software.
14//
15// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21// IN THE SOFTWARE.
22//-----------------------------------------------------------------------------
23
24#include "platform/platform.h"
25#include "math/mPoint2.h"
26#include "math/mPoint3.h"
27#include "math/mPoint4.h"
28
29
30const Point2I Point2I::One(1, 1);
31const Point2I Point2I::Zero(0, 0);
32const Point2I Point2I::Min(S32_MIN, S32_MIN);
33const Point2I Point2I::Max(S32_MAX, S32_MAX);
34
35const Point2F Point2F::One(1.0f, 1.0f);
36const Point2F Point2F::Zero(0.0f, 0.0f);
37const Point2F Point2F::Min(F32_MIN, F32_MIN);
38const Point2F Point2F::Max(F32_MAX, F32_MAX);
39
40const Point2D Point2D::One(1.0, 1.0);
41const Point2D Point2D::Zero(0.0, 0.0);
42
43const Point3I Point3I::One(1, 1, 1);
44const Point3I Point3I::Zero(0, 0, 0);
45
46const Point3F Point3F::One(1.0f, 1.0f, 1.0f);
47const Point3F Point3F::Zero(0.0f, 0.0f, 0.0f);
48const Point3F Point3F::Min(F32_MIN, F32_MIN, F32_MIN);
49const Point3F Point3F::Max(F32_MAX, F32_MAX, F32_MAX);
50const Point3F Point3F::UnitX(1.0f, 0.0f, 0.0f);
51const Point3F Point3F::UnitY(0.0f, 1.0f, 0.0f);
52const Point3F Point3F::UnitZ(0.0f, 0.0f, 1.0f);
53
54const Point3D Point3D::One(1.0, 1.0, 1.0);
55const Point3D Point3D::Zero(0.0, 0.0, 0.0);
56
57const Point4I Point4I::One(1, 1, 1, 1);
58const Point4I Point4I::Zero(0, 0, 0, 0);
59
60const Point4F Point4F::One(1.0f, 1.0f, 1.0f, 1.0f);
61const Point4F Point4F::Zero(0.0f, 0.0f, 0.0f, 0.0f);
62
63
64Point3F mPerp( const Point3F &inVec )
65{   
66   AssertFatal( inVec.len() > 0.0f, "mPerp() - zero length vector has no perp!" );
67   AssertFatal( inVec.isUnitLength(), "mPerp() - passed vector must be normalized!" );
68
69   U32 idx = inVec.getLeastComponentIndex();
70
71   Point3F vec( 0.0f, 0.0f, 0.0f );
72   vec[idx] = 1.0f;
73
74   Point3F outVec = mCross( inVec, vec );
75   outVec.normalize();
76
77   //AssertFatal( mIsZero( mDot( inVec, outVec ) ), "mPerp, failed to generate perpendicular" );
78
79   return outVec;   
80}
81
82