class csMath3

Various assorted 3D mathematical functions

Public Methods

inline static float	Area3 (const csVector3 &a, const csVector3 &b, const csVector3 &c) Compute twice the signed area of triangle composed by three points
static void	Between (const csVector3& v1, const csVector3& v2, csVector3& v, float pct, float wid) Calculates a vector lying a specified distance between two other vectors
static void	CalcNormal (csVector3& norm, const csVector3& v, const csVector3& u) Compute the normal given two (u,v) vectors
inline static void	CalcNormal (csVector3& norm, const csVector3& v1, const csVector3& v2, const csVector3& v3) Calculate a plane normal given three vectors
static void	CalcPlane (const csVector3& v1, const csVector3& v2, const csVector3& v3, csVector3& normal, float& D) Calculate the plane equation given three vectors
static bool	PlanesClose (const csPlane& p1, const csPlane& p2) Check if two planes are close together
static bool	PlanesEqual (const csPlane& p1, const csPlane& p2) Check if two planes are almost equal
static void	SetMinMax (const csVector3& v, csVector3& min, csVector3& max) Set the min and max vector if this vector exceeds their current limits
static bool	Visible (const csVector3& p, const csPlane& pl) Check if the plane is visible from the given point
static bool	Visible (const csVector3& p, const csVector3& t1, const csVector3& t2, const csVector3& t3) Tests if the front face of a triangle is visible from the given point
static int	WhichSide3D (const csVector3& p, const csVector3& v1, const csVector3& v2) Tests which side of a plane the given 3D point is on

static int WhichSide3D(const csVector3& p, const csVector3& v1, const csVector3& v2)

Tests which side of a plane the given 3D point is on. Return -1 if point p is left of plane '0-v1-v2', 1 if point p is right of plane '0-v1-v2', or 0 if point p lies on plane '0-v1-v2'. Plane '0-v1-v2' is the plane passing through points <0,0,0>, v1, and v2.

static bool Visible(const csVector3& p, const csVector3& t1, const csVector3& t2, const csVector3& t3)

Tests if the front face of a triangle is visible from the given point. Visibility test (backface culling) to see if the triangle formed by t1, t2, and t3 is visible from point p.

static bool Visible(const csVector3& p, const csPlane& pl)

Check if the plane is visible from the given point. This function does a back-face culling test to see whether the front face of plane pl is visible from point p.

static void Between(const csVector3& v1, const csVector3& v2, csVector3& v, float pct, float wid)

Calculates a vector lying a specified distance between two other vectors. Given vectors v1 and v2, this function will calculate and return vector v lying between them. If pct != -1, vector v will be the point which is pct % of the way from v1 to v2. Otherwise, if pct equals -1, v will be the point along 'v1-v2' which is distance wid from v1.

static void SetMinMax(const csVector3& v, csVector3& min, csVector3& max)

Set the min and max vector if this vector exceeds their current limits. This function will check each component of vector v against the maximum and minimum values specified by min and max. If the limits are exceeded, new min or max values will be set.

inline static float Area3(const csVector3 &a, const csVector3 &b, const csVector3 &c)

Compute twice the signed area of triangle composed by three points. This function returns 2 x the area of the triangle formed by the points a, b, and c.

inline static void CalcNormal(csVector3& norm, const csVector3& v1, const csVector3& v2, const csVector3& v3)

Calculate a plane normal given three vectors. This function will calculate the normal to the plane formed by vectors v1, v2, and v3, and store the result in norm.

static void CalcNormal(csVector3& norm, const csVector3& v, const csVector3& u)

Compute the normal given two (u,v) vectors. This function will calculat the normal to a polygon with two edges represented by v and u. The result is stored in norm.

static void CalcPlane(const csVector3& v1, const csVector3& v2, const csVector3& v3, csVector3& normal, float& D)

Calculate the plane equation given three vectors. Given three vectors v1, v2, and v3, forming a plane, this function will calculate the plane equation and return the result in 'normal' and 'D'.

static bool PlanesEqual(const csPlane& p1, const csPlane& p2)

Check if two planes are almost equal. The function returns true iff each component of the plane equation for one plane is within .001 of the corresponding component of the other plane.

static bool PlanesClose(const csPlane& p1, const csPlane& p2)

Check if two planes are close together. Two planes are close if there are almost equal OR if the normalized versions are almost equal.

This class has no child classes.

alphabetic index hierarchy of classes

this page has been generated automatically by doc++

(c)opyright by Malte Zöckler, Roland Wunderling
contact: doc++@zib.de