cugl::IVec4 Class Reference

#include <CUIVec4.h>

Public Member Functions
	IVec4 ()
	IVec4 (int x, int y, int z, int w)
	IVec4 (const int *array)
	IVec4 (const IVec4 &p1, const IVec4 &p2)
IVec4 &	operator= (const int *array)
IVec4 &	set (int x, int y, int z, int w)
IVec4 &	set (const int *array)
IVec4 &	set (const IVec4 &v)
IVec4 &	set (const IVec4 &p1, const IVec4 &p2)
IVec4 &	setZero ()
IVec4 &	clamp (const IVec4 &min, const IVec4 &max)
IVec4	getClamp (const IVec4 &min, const IVec4 &max) const
IVec4 &	add (const IVec4 &v)
IVec4 &	add (int x, int y, int z, int w)
IVec4 &	subtract (const IVec4 &v)
IVec4 &	subtract (int x, int y, int z, int w)
IVec4 &	scale (int s)
IVec4 &	scale (int sx, int sy, int sz, int sw)
IVec4 &	scale (const IVec4 &v)
IVec4 &	negate ()
IVec4	getNegation () const
IVec4 &	map (std::function< int(int)> func)
IVec4	getMap (std::function< int(int)> func) const
IVec4 &	operator+= (const IVec4 &v)
IVec4 &	operator-= (const IVec4 &v)
IVec4 &	operator*= (int s)
IVec4 &	operator*= (const IVec4 &v)
const IVec4	operator+ (const IVec4 &v) const
const IVec4	operator- (const IVec4 &v) const
const IVec4	operator- () const
const IVec4	operator* (int s) const
const IVec4	operator* (const IVec4 &v) const
bool	operator< (const IVec4 &v) const
bool	operator<= (const IVec4 &v) const
bool	operator> (const IVec4 &v) const
bool	operator>= (const IVec4 &v) const
bool	operator== (const IVec4 &v) const
bool	operator!= (const IVec4 &v) const
bool	under (const IVec4 &v) const
bool	over (const IVec4 &v) const
bool	equals (const IVec4 &v) const
bool	isZero () const
std::string	toString (bool verbose=false) const
	operator std::string () const
	operator Vec4 () const
	IVec4 (const Vec4 &v)
IVec4 &	operator= (const Vec4 &v)
IVec4 &	operator+= (const Vec4 &v)
IVec4 &	operator-= (const Vec4 &v)
IVec4 &	operator*= (const Vec4 &v)
const IVec4	operator+ (const Vec4 &v)
const IVec4	operator- (const Vec4 &v)
const IVec4	operator* (const Vec4 &v)
	operator IVec2 () const
	IVec4 (const IVec2 &v)
	IVec4 (const IVec2 &v, int z, int w)
IVec4 &	operator= (const IVec2 &size)
	operator IVec3 () const
	IVec4 (const IVec3 &v)
	IVec4 (const IVec3 &v, int w)
IVec4 &	operator= (const IVec3 &v)
IVec4 &	set (const IVec3 &v, int w)

Static Public Member Functions
static IVec4 *	clamp (const IVec4 &v, const IVec4 &min, const IVec4 &max, IVec4 *dst)
static IVec4 *	add (const IVec4 &v1, const IVec4 &v2, IVec4 *dst)
static IVec4 *	subtract (const IVec4 &v1, const IVec4 &v2, IVec4 *dst)
static IVec4 *	scale (const IVec4 &v, int s, IVec4 *dst)
static IVec4 *	scale (const IVec4 &v1, const IVec4 &v2, IVec4 *dst)
static IVec4 *	negate (const IVec4 &v, IVec4 *dst)

Public Attributes
int	x
int	y
int	z
int	w

Static Public Attributes
static const IVec4	ZERO
static const IVec4	ONE

Detailed Description

This class defines a 4-element integer vector.

This class is in standard layout with fields of uniform type. This means that it is safe to reinterpret_cast objects to int arrays.

Constructor & Destructor Documentation

IVec4() [1/9]

cugl::IVec4::IVec4 ( )

inline

Constructs a new vector initialized to all zeros.

IVec4() [2/9]

cugl::IVec4::IVec4 ( int  x, int  y, int  z, int  w  )

inline

Constructs a new vector initialized to the specified values.

Parameters

x	The x coordinate.
y	The y coordinate.
z	The z coordinate.
w	The w coordinate.

IVec4() [3/9]

cugl::IVec4::IVec4 ( const int *  array )

inline

Constructs a new vector from the values in the specified array.

The elements of the arra are in the order x, y, z, and w.

Parameters

array

An array containing the elements of the vector.

IVec4() [4/9]

cugl::IVec4::IVec4 ( const IVec4 &  p1, const IVec4 &  p2  )

inline

Constructs a vector that describes the direction between the specified points.

Parameters

p1	The first point.
p2	The second point.

IVec4() [5/9]

cugl::IVec4::IVec4 ( const Vec4 &  v )

explicit

Creates a vector from the given floating point vector.

The float values are truncated.

Parameters

v	The vector to convert

IVec4() [6/9]

cugl::IVec4::IVec4 ( const IVec2 &  v )

explicit

Creates a 4d vector from the given 2d one.

The z and w coordinates are set to 0.

Parameters

v	The vector to convert

IVec4() [7/9]

cugl::IVec4::IVec4	(	const IVec2 &	v,
		int	z,
		int	w
	)

Creates a 4d vector from the given 2d one

The z and w coordinates are set to the given values.

Parameters

v	The vector to convert
z	The z-coordinate
w	The w-coordinate

IVec4() [8/9]

cugl::IVec4::IVec4 ( const IVec3 &  v )

explicit

Creates a homogenous vector from the given 3d one.

The w-coordinate is set to 0

Parameters

v	The vector to convert

IVec4() [9/9]

cugl::IVec4::IVec4	(	const IVec3 &	v,
		int	w
	)

Creates a 4d vector from the given 3d one

The w-coordinate is set to the given value.

Parameters

v	The vector to convert
w	The w-coordinate

Member Function Documentation

add() [1/3]

IVec4 & cugl::IVec4::add ( const IVec4 &  v )

inline

Adds the given vector to this one in place.

Parameters

v	The vector to add

Returns

A reference to this (modified) Vec4 for chaining.

add() [2/3]

static IVec4 * cugl::IVec4::add ( const IVec4 &  v1, const IVec4 &  v2, IVec4 *  dst  )

static

Adds the specified vectors and stores the result in dst.

Parameters

v1	The first vector.
v2	The second vector.
dst	A vector to store the result in

Returns

A reference to dst for chaining

add() [3/3]

IVec4 & cugl::IVec4::add ( int  x, int  y, int  z, int  w  )

inline

Adds the given values to this vector.

Parameters

x	The x coordinate to add.
y	The y coordinate to add.
z	The z coordinate to add.
w	The w coordinate to add.

Returns

A reference to this (modified) Vec4 for chaining.

clamp() [1/2]

IVec4 & cugl::IVec4::clamp	(	const IVec4 &	min,
		const IVec4 &	max
	)

Clamps this vector within the given range.

Parameters

min	The minimum value.
max	The maximum value.

Returns

A reference to this (modified) Vec4 for chaining.

clamp() [2/2]

static IVec4 * cugl::IVec4::clamp ( const IVec4 &  v, const IVec4 &  min, const IVec4 &  max, IVec4 *  dst  )

static

Clamps the specified vector within the given range and returns it in dst.

Parameters

v	The vector to clamp.
min	The minimum value.
max	The maximum value.
dst	A vector to store the result in.

Returns

A reference to dst for chaining

equals()

bool cugl::IVec4::equals

(

const IVec4 &

v

)

const

Returns true if this vector is equal to the given vector.

Parameters

v	The vector to compare against.

Returns

True if this vector is equal to the given vector.

getClamp()

IVec4 cugl::IVec4::getClamp ( const IVec4 &  min, const IVec4 &  max  ) const

inline

Returns a copy of this vector clamped within the given range.

Note: this does not modify this vector.

Parameters

min	The minimum value.
max	The maximum value.

Returns

A copy of this vector clamped within the given range.

getMap()

IVec4 cugl::IVec4::getMap ( std::function< int(int)>  func ) const

inline

Returns a copy of this vector with func applied to each component.

This method supports any function that has the signature float func(float); This includes many of the functions in math.h.

Parameters

func	The function to map on the coordinates.

Returns

A copy of this vector with func applied to each component.

getNegation()

IVec4 cugl::IVec4::getNegation ( ) const

inline

Returns a negated copy of this vector.

Note: This method does not modify the vector

Returns

a negated copy of this vector.

isZero()

bool cugl::IVec4::isZero

(

)

const

Returns true this vector contains all zeros.

Returns

true if this vector contains all zeros, false otherwise.

map()

IVec4 & cugl::IVec4::map ( std::function< int(int)>  func )

inline

Maps the given function to the vector coordinates in place.

This method supports any function that has the signature float func(float); This includes many of the functions in math.h.

Parameters

func	The function to map on the coordinates.

Returns

A reference to this (modified) Vec4 for chaining.

negate() [1/2]

IVec4 & cugl::IVec4::negate ( )

inline

Negates this vector in place.

Returns

A reference to this (modified) Vec4 for chaining.

negate() [2/2]

static IVec4 * cugl::IVec4::negate ( const IVec4 &  v, IVec4 *  dst  )

static

Negates the specified vector and stores the result in dst.

Parameters

v	The vector to negate.
dst	The destination vector.

Returns

A reference to dst for chaining

operator IVec2()

cugl::IVec4::operator IVec2

(

)

const

Casts from a IVec2 to IVec4.

The z and w coordinates are dropped.

operator IVec3()

cugl::IVec4::operator IVec3

(

)

const

Casts from Vec4 to Vec3.

The w coordinate is dropped

operator std::string()

cugl::IVec4::operator std::string ( ) const

inline

Cast from IVec4 to a string.

operator Vec4()

cugl::IVec4::operator Vec4

(

)

const

Cast from IVec4 to a Vec4.

operator!=()

bool cugl::IVec4::operator!=

(

const IVec4 &

v

)

const

Returns true if this vector is not equal to the given vector.

Parameters

v	The vector to compare against.

Returns

True if this vector is not equal to the given vector.

operator*() [1/3]

const IVec4 cugl::IVec4::operator* ( const IVec4 &  v ) const

inline

Returns the scalar product of this vector with the given vector.

This method is provided to support non-uniform scaling. Note: this does not modify this vector.

Parameters

v	The vector to scale by.

Returns

The scalar product of this vector with the given vector.

operator*() [2/3]

const IVec4 cugl::IVec4::operator*

(

const Vec4 &

v

)

Returns the scalar product of this vector with the given vector.

The float values of v are truncated.

Note: this does not modify this vector.

Parameters

v	The vector to scale by.

Returns

The scalar product of this vector with the given vector.

operator*() [3/3]

const IVec4 cugl::IVec4::operator* ( int  s ) const

inline

Returns the scalar product of this vector with the given value.

Note: this does not modify this vector.

Parameters

s	The value to scale by.

Returns

The scalar product of this vector with the given value.

operator*=() [1/3]

IVec4 & cugl::IVec4::operator*= ( const IVec4 &  v )

inline

Scales this vector nonuniformly by the given vector.

Parameters

v	The vector to scale by

Returns

A reference to this (modified) IVec4 for chaining.

operator*=() [2/3]

IVec4 & cugl::IVec4::operator*=

(

const Vec4 &

v

)

Scales this vector nonuniformly by the given vector.

The float values of v are truncated.

Parameters

v	The vector to scale by

Returns

A reference to this (modified) Vec2 for chaining.

operator*=() [3/3]

IVec4 & cugl::IVec4::operator*= ( int  s )

inline

Scales this vector in place by the given factor.

Parameters

s	The value to scale by

Returns

A reference to this (modified) IVec4 for chaining.

operator+() [1/2]

const IVec4 cugl::IVec4::operator+ ( const IVec4 &  v ) const

inline

Returns the sum of this vector with the given vector.

Note: this does not modify this vector.

Parameters

v	The vector to add.

Returns

The sum of this vector with the given vector.

operator+() [2/2]

const IVec4 cugl::IVec4::operator+

(

const Vec4 &

v

)

Returns the sum of this vector with the given vector.

The float values of v are truncated.

Note: this does not modify this vector.

Parameters

v	The vector to add.

Returns

The sum of this vector with the given vector.

operator+=() [1/2]

IVec4 & cugl::IVec4::operator+= ( const IVec4 &  v )

inline

Adds the given vector to this one in place.

Parameters

v	The vector to add

Returns

A reference to this (modified) IVec4 for chaining.

operator+=() [2/2]

IVec4 & cugl::IVec4::operator+=

(

const Vec4 &

v

)

Adds the given vector to this one in place.

The float values of v are truncated.

Parameters

v	The vector to add

Returns

A reference to this (modified) IVec2 for chaining.

operator-() [1/3]

const IVec4 cugl::IVec4::operator- ( ) const

inline

Returns the negation of this vector.

Note: this does not modify this vector.

Returns

The negation of this vector.

operator-() [2/3]

const IVec4 cugl::IVec4::operator- ( const IVec4 &  v ) const

inline

Returns the difference of this vector with the given vector.

Note: this does not modify this vector.

Parameters

v	The vector to subtract.

Returns

The difference of this vector with the given vector.

operator-() [3/3]

const IVec4 cugl::IVec4::operator-

(

const Vec4 &

v

)

Returns the difference of this vector with the given vector.

The float values of v are truncated.

Note: this does not modify this vector.

Parameters

v	The vector to subtract.

Returns

The difference of this vector with the given vector.

operator-=() [1/2]

IVec4 & cugl::IVec4::operator-= ( const IVec4 &  v )

inline

Subtracts the given vector from this one in place.

Parameters

v	The vector to subtract

Returns

A reference to this (modified) IVec4 for chaining.

operator-=() [2/2]

IVec4 & cugl::IVec4::operator-=

(

const Vec4 &

v

)

Subtracts the given vector from this one in place.

The float values of v are truncated.

Parameters

v	The vector to subtract

Returns

A reference to this (modified) IVec2 for chaining.

operator<()

bool cugl::IVec4::operator<

(

const IVec4 &

v

)

const

Returns true if this vector is less than the given vector.

This comparison uses the lexicographical order. To test if all components in this vector are less than those of v, use the method under().

Parameters

v	The vector to compare against.

Returns

True if this vector is less than the given vector.

operator<=()

bool cugl::IVec4::operator<=

(

const IVec4 &

v

)

const

Returns true if this vector is less than or equal the given vector.

This comparison uses the lexicographical order. To test if all components in this vector are less than those of v, use the method under().

Parameters

v	The vector to compare against.

Returns

True if this vector is less than or equal the given vector.

operator=() [1/4]

IVec4 & cugl::IVec4::operator= ( const int *  array )

inline

Sets the elements of this vector from the values in the specified array.

The elements of the array are in the order x, y, z, and w.

Parameters

array

An array containing the elements of the vector.

Returns

A reference to this (modified) IVec4 for chaining.

operator=() [2/4]

IVec4 & cugl::IVec4::operator=

(

const IVec2 &

size

)

Sets the coordinates of this vector to those of the given 2d vector.

The z and w coordinates are set to 0.

Parameters

size	The vector to convert

Returns

A reference to this (modified) Vec4 for chaining.

operator=() [3/4]

IVec4 & cugl::IVec4::operator=

(

const IVec3 &

v

)

Sets the coordinates of this vector to those of the given 3d vector.

The w-coordinate is set to 0

Parameters

v	The vector to convert

Returns

A reference to this (modified) Vec4 for chaining.

operator=() [4/4]

IVec4 & cugl::IVec4::operator=

(

const Vec4 &

v

)

Sets this vector to be the given floating point vector.

The float values are truncated.

Parameters

v	The vector to convert

Returns

A reference to this (modified) IVec4 for chaining.

operator==()

bool cugl::IVec4::operator==

(

const IVec4 &

v

)

const

Returns true if this vector is equal to the given vector.

Parameters

v	The vector to compare against.

Returns

True if this vector is equal to the given vector.

operator>()

bool cugl::IVec4::operator>

(

const IVec4 &

v

)

const

Determines if this vector is greater than the given vector.

This comparison uses the lexicographical order. To test if all components in this vector are greater than those of v, use the method over().

Parameters

v	The vector to compare against.

Returns

True if this vector is greater than the given vector.

operator>=()

bool cugl::IVec4::operator>=

(

const IVec4 &

v

)

const

Determines if this vector is greater than or equal the given vector.

This comparison uses the lexicographical order. To test if all components in this vector are greater than those of v, use the method over().

Parameters

v	The vector to compare against.

Returns

True if this vector is greater than or equal the given vector.

over()

bool cugl::IVec4::over

(

const IVec4 &

v

)

const

Returns true if this vector dominates the given vector.

Domination means that all components of this vector are greater than or equal to the components of the given vector.

Parameters

v	The vector to compare against.

Returns

True if this vector is dominated by the given vector.

scale() [1/5]

IVec4 & cugl::IVec4::scale ( const IVec4 &  v )

inline

Scales this vector nonuniformly by the given vector.

Parameters

v	The vector to scale by

Returns

A reference to this (modified) Vec4 for chaining.

scale() [2/5]

static IVec4 * cugl::IVec4::scale ( const IVec4 &  v, int  s, IVec4 *  dst  )

static

Scales the specified vector and stores the result in dst.

The scale is uniform by the constant s.

Parameters

v	The vector to scale.
s	The uniform scaling factor.
dst	The destination vector.

Returns

A reference to dst for chaining

scale() [3/5]

static IVec4 * cugl::IVec4::scale ( const IVec4 &  v1, const IVec4 &  v2, IVec4 *  dst  )

static

Scales the specified vector and stores the result in dst.

The scale is nonuniform by the attributes in v2.

Parameters

v1	The vector to scale.
v2	The nonuniform scaling factor.
dst	The destination vector.

Returns

A reference to dst for chaining

scale() [4/5]

IVec4 & cugl::IVec4::scale ( int  s )

inline

Scales this vector in place by the given factor.

Parameters

s	The scalar to multiply by

Returns

A reference to this (modified) Vec4 for chaining.

scale() [5/5]

IVec4 & cugl::IVec4::scale ( int  sx, int  sy, int  sz, int  sw  )

inline

Scales this vector nonuniformly by the given factors.

Parameters

sx	The scalar to multiply the x-axis
sy	The scalar to multiply the y-axis
sz	The scalar to multiply the z-axis
sw	The scalar to divide the w-axis

Returns

A reference to this (modified) Vec4 for chaining.

set() [1/5]

IVec4 & cugl::IVec4::set ( const int *  array )

inline

Sets the elements of this vector from the values in the specified array.

The elements of the arra are in the order x, y, z, and w.

Parameters

array

An array containing the elements of the vector.

Returns

A reference to this (modified) IVec4 for chaining.

set() [2/5]

IVec4 & cugl::IVec4::set	(	const IVec3 &	v,
		int	w
	)

Sets the coordinates of this vector to those of the given 3d vector.

The w-coordinate is set to the given value.

Parameters

v	The vector to convert
w	The w-coordinate

Returns

A reference to this (modified) Vec4 for chaining.

set() [3/5]

IVec4 & cugl::IVec4::set ( const IVec4 &  p1, const IVec4 &  p2  )

inline

Sets this vector to the directional vector between the specified points.

Parameters

p1	The initial point of the vector.
p2	The terminal point of the vector.

Returns

A reference to this (modified) Vec2 for chaining.

set() [4/5]

IVec4 & cugl::IVec4::set ( const IVec4 &  v )

inline

Sets the elements of this vector to those in the specified vector.

Parameters

v	The vector to copy.

Returns

A reference to this (modified) Vec2 for chaining.

set() [5/5]

IVec4 & cugl::IVec4::set ( int  x, int  y, int  z, int  w  )

inline

Sets the elements of this vector to the specified values.

Parameters

x	The new x coordinate.
y	The new y coordinate.
z	The new z coordinate.
w	The new w coordinate.

Returns

A reference to this (modified) IVec4 for chaining.

setZero()

IVec4 & cugl::IVec4::setZero ( )

inline

Sets the elements of this vector to zero.

Returns

A reference to this (modified) Vec2 for chaining.

subtract() [1/3]

IVec4 & cugl::IVec4::subtract ( const IVec4 &  v )

inline

Subtracts the given vector from this one in place.

Parameters

v	The vector to subtract

Returns

A reference to this (modified) Vec4 for chaining.

subtract() [2/3]

static IVec4 * cugl::IVec4::subtract ( const IVec4 &  v1, const IVec4 &  v2, IVec4 *  dst  )

static

Subtracts the specified vectors and stores the result in dst.

The resulting vector is computed as (v1 - v2).

Parameters

v1	The first vector.
v2	The second vector.
dst	The destination vector.

Returns

A reference to dst for chaining

subtract() [3/3]

IVec4 & cugl::IVec4::subtract ( int  x, int  y, int  z, int  w  )

inline

Subtracts the given values from this vector.

Parameters

x	The x coordinate to subtract.
y	The y coordinate to subtract.
z	The z coordinate to subtract.
w	The w coordinate to subtract.

Returns

A reference to this (modified) Vec4 for chaining.

toString()

std::string cugl::IVec4::toString

(

bool

verbose = false

)

const

Returns a string representation of this vector for debugging purposes.

If verbose is true, the string will include class information. This allows us to unambiguously identify the class.

Parameters

verbose

Whether to include class information

Returns

a string representation of this vector for debugging purposes.

under()

bool cugl::IVec4::under

(

const IVec4 &

v

)

const

Returns true if this vector is dominated by the given vector.

Domination means that all components of the given vector are greater than or equal to the components of this one.

Parameters

v	The vector to compare against.

Returns

True if this vector is dominated by the given vector.

Member Data Documentation

ONE

const IVec4 cugl::IVec4::ONE

static

The ones vector Vec4(1,1,1,1)

w

int cugl::IVec4::w

The w-coordinate.

x

int cugl::IVec4::x

The x-coordinate.

y

int cugl::IVec4::y

The y-coordinate.

z

int cugl::IVec4::z

The z-coordinate.

ZERO

const IVec4 cugl::IVec4::ZERO

static

The zero vector Vec4(0,0,0,0)

---

The documentation for this class was generated from the following file:

• /Users/wmwhite/Developer/CUGL/include/cugl/core/math/CUIVec4.h