Functions
static cpVect	cpv (const cpFloat x, const cpFloat y)
	Convenience constructor for cpVect structs.
cpFloat	cpvlength (const cpVect v)
	Returns the length of v.
cpVect	cpvslerp (const cpVect v1, const cpVect v2, const cpFloat t)
	Spherical linearly interpolate between v1 and v2.
cpVect	cpvslerpconst (const cpVect v1, const cpVect v2, const cpFloat a)
	Spherical linearly interpolate between v1 towards v2 by no more than angle a radians.
cpVect	cpvforangle (const cpFloat a)
	Returns the unit length vector for the given angle (in radians).
cpFloat	cpvtoangle (const cpVect v)
	Returns the angular direction v is pointing in (in radians).
char *	cpvstr (const cpVect v)
static cpBool	cpveql (const cpVect v1, const cpVect v2)
	Check if two vectors are equal. (Be careful when comparing floating point numbers!)
static cpVect	cpvadd (const cpVect v1, const cpVect v2)
	Add two vectors.
static cpVect	cpvsub (const cpVect v1, const cpVect v2)
	Subtract two vectors.
static cpVect	cpvneg (const cpVect v)
	Negate a vector.
static cpVect	cpvmult (const cpVect v, const cpFloat s)
	Scalar multiplication.
static cpFloat	cpvdot (const cpVect v1, const cpVect v2)
	Vector dot product.
static cpFloat	cpvcross (const cpVect v1, const cpVect v2)
static cpVect	cpvperp (const cpVect v)
	Returns a perpendicular vector. (90 degree rotation)
static cpVect	cpvrperp (const cpVect v)
	Returns a perpendicular vector. (-90 degree rotation)
static cpVect	cpvproject (const cpVect v1, const cpVect v2)
	Returns the vector projection of v1 onto v2.
static cpVect	cpvrotate (const cpVect v1, const cpVect v2)
	Uses complex number multiplication to rotate v1 by v2. Scaling will occur if v1 is not a unit vector.
static cpVect	cpvunrotate (const cpVect v1, const cpVect v2)
	Inverse of cpvrotate().
static cpFloat	cpvlengthsq (const cpVect v)
	Returns the squared length of v. Faster than cpvlength() when you only need to compare lengths.
static cpVect	cpvlerp (const cpVect v1, const cpVect v2, const cpFloat t)
	Linearly interpolate between v1 and v2.
static cpVect	cpvnormalize (const cpVect v)
	Returns a normalized copy of v.
static cpVect	cpvnormalize_safe (const cpVect v)
	Returns a normalized copy of v or cpvzero if v was already cpvzero. Protects against divide by zero errors.
static cpVect	cpvclamp (const cpVect v, const cpFloat len)
	Clamp v to length len.
static cpVect	cpvlerpconst (cpVect v1, cpVect v2, cpFloat d)
	Linearly interpolate between v1 towards v2 by distance d.
static cpFloat	cpvdist (const cpVect v1, const cpVect v2)
	Returns the distance between v1 and v2.
static cpFloat	cpvdistsq (const cpVect v1, const cpVect v2)
	Returns the squared distance between v1 and v2. Faster than cpvdist() when you only need to compare distances.
static cpBool	cpvnear (const cpVect v1, const cpVect v2, const cpFloat dist)
	Returns true if the distance between v1 and v2 is less than dist.
Variables
static const cpVect	cpvzero = {0.0f,0.0f}
	Constant for the zero vector.

Detailed Description

Chipmunk's 2D vector type along with a handy 2D vector math lib.

Chipmunk's 2D vector type.

Function Documentation

static cpVect cpv	(	const cpFloat	x,
		const cpFloat	y
	)		`[inline, static]`

Convenience constructor for cpVect structs.

static cpVect cpvadd	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Add two vectors.

static cpVect cpvclamp	(	const cpVect	v,
		const cpFloat	len
	)		`[inline, static]`

Clamp v to length len.

static cpFloat cpvcross	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

2D vector cross product analog. The cross product of 2D vectors results in a 3D vector with only a z component. This function returns the magnitude of the z value.

static cpFloat cpvdist	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Returns the distance between v1 and v2.

static cpFloat cpvdistsq	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Returns the squared distance between v1 and v2. Faster than cpvdist() when you only need to compare distances.

static cpFloat cpvdot	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Vector dot product.

static cpBool cpveql	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Check if two vectors are equal. (Be careful when comparing floating point numbers!)

cpVect cpvforangle ( const cpFloat a )

Returns the unit length vector for the given angle (in radians).

cpFloat cpvlength ( const cpVect v )

Returns the length of v.

static cpFloat cpvlengthsq ( const cpVect v ) [inline, static]

Returns the squared length of v. Faster than cpvlength() when you only need to compare lengths.

static cpVect cpvlerp	(	const cpVect	v1,
		const cpVect	v2,
		const cpFloat	t
	)		`[inline, static]`

Linearly interpolate between v1 and v2.

static cpVect cpvlerpconst	(	cpVect	v1,
		cpVect	v2,
		cpFloat	d
	)		`[inline, static]`

Linearly interpolate between v1 towards v2 by distance d.

static cpVect cpvmult	(	const cpVect	v,
		const cpFloat	s
	)		`[inline, static]`

Scalar multiplication.

static cpBool cpvnear	(	const cpVect	v1,
		const cpVect	v2,
		const cpFloat	dist
	)		`[inline, static]`

Returns true if the distance between v1 and v2 is less than dist.

static cpVect cpvneg ( const cpVect v ) [inline, static]

Negate a vector.

static cpVect cpvnormalize ( const cpVect v ) [inline, static]

Returns a normalized copy of v.

static cpVect cpvnormalize_safe ( const cpVect v ) [inline, static]

Returns a normalized copy of v or cpvzero if v was already cpvzero. Protects against divide by zero errors.

static cpVect cpvperp ( const cpVect v ) [inline, static]

Returns a perpendicular vector. (90 degree rotation)

static cpVect cpvproject	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Returns the vector projection of v1 onto v2.

static cpVect cpvrotate	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Uses complex number multiplication to rotate v1 by v2. Scaling will occur if v1 is not a unit vector.

static cpVect cpvrperp ( const cpVect v ) [inline, static]

Returns a perpendicular vector. (-90 degree rotation)

cpVect cpvslerp	(	const cpVect	v1,
		const cpVect	v2,
		const cpFloat	t
	)

Spherical linearly interpolate between v1 and v2.

cpVect cpvslerpconst	(	const cpVect	v1,
		const cpVect	v2,
		const cpFloat	a
	)

Spherical linearly interpolate between v1 towards v2 by no more than angle a radians.

char* cpvstr ( const cpVect v )

Returns a string representation of v. Intended mostly for debugging purposes and not production use.

Attention:: The string points to a static local and is reset every time the function is called. If you want to print more than one vector you will have to split up your printing onto separate lines.

static cpVect cpvsub	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Subtract two vectors.

cpFloat cpvtoangle ( const cpVect v )

Returns the angular direction v is pointing in (in radians).

static cpVect cpvunrotate	(	const cpVect	v1,
		const cpVect	v2
	)		`[inline, static]`

Inverse of cpvrotate().

Variable Documentation

const cpVect cpvzero = {0.0f,0.0f} [static]

Constant for the zero vector.

Functions

Variables

Detailed Description

Function Documentation

Variable Documentation