Unigine::Math::vec4 Struct

Header:

#include <UnigineMathLib.h>

This class represents a vector of 4 float components.

Methods:

Name	Description View: Sort by:
vec4	Constructor.
set	Sets the vector by components.
get	Gets the vector: val[0]=x, val[1]=y, val[2]=z, val[3]=w.
length	Returns the length of the vector.
length2	Returns the squared length of the vector.
maxXY	Compares the X and Y components of the vector and returns the greater one.
maxXYZ	Compares the X, Y, and Z components of the vector and returns the greatest one.
max	Compares all components of the vector and returns the greatest value.
normalize	Returns normalized vector.
normalize3	Returns the vector with normalized XYZ components.
normalizeFast	Returns normalized vector, calculated using the fast inverse square root algorithm.
normalizeFast3	Returns the vector with XYZ components normalized using the fast inverse square root algorithm.
operator __m128	Performs type conversion to __m128.
operator const float *	Performs type conversion to const float *.
operator const void *	Performs type conversion to const void *.
operator float *	Performs type conversion to float *.
operator void *	Performs type conversion to void *.
*operator =**	Performs scalar multiplication.
operator +=	Performs vector addition.
operator -	Performs vector negation.
operator -=	Performs vector subtraction.
operator /=	Performs componentwise division of the vector by the scalar.
operator =	Sets the vector using a given 128-bit variable as a source.
operator []	Performs array access to the vector item reference by using given item index.
sse	Returns vector components as a 128-bit variable.

Variables:

Name	Description
BLUE	Blue color vector (0, 0, 1 1).
BLACK	Black color vector (0, 0, 0 0).
EPS	Vector, filled with epsilon constant (1e-6f).
GREEN	Green color vector (0, 1, 0 1).
INF	Vector, filled with infinity constant (1e+9f).
ONE	Vector, filled with ones (1).
RED	Red color vector (1, 0, 0 1).
WHITE	White color vector (1, 1, 1 1).
ZERO	Vector, filled with zeros (0).

vec4 Class

Members

vec4 ( const __m128 & v ) #

Constructor. Initializes the vector using a given 128-bit variable as a source.

NoticeWe do not recommend to use this method unless you have a clear understanding of SSE2.

Arguments

const __m128 & v - 128-bit variable

vec4 ( const quat & q ) #

Arguments

const quat & q

vec4 ( const hvec4 & v ) #

Constructor. Initializes the vector using a given hvec4 source vector.

Arguments

const hvec4 & v - Source vector.

vec4 ( ) #

Default constructor. Produces a zero vector.

vec4 ( const vec4 & v ) #

Constructor. Initializes the vector by copying a given source vector.

Arguments

const vec4 & v - Source vector.

vec4 ( const vec2 & v, float z, float w ) #

Constructor. Initializes the vector using a given two-component vec2 source vector and two scalars.

Arguments

const vec2 & v - Two-component source vector.
float z - Z component of the vector.
float w - W component of the vector.

vec4 ( const vec3 & v, float w ) #

Constructor. Initializes the vector using a given three-component vec3 source vector and a scalar.

Arguments

const vec3 & v - Three-component source vector.
float w - W component of the vector.

vec4 ( float x, float y, float z, float w ) #

Constructor. Initializes the vector using given float values.

Arguments

float x - X component of the vector.
float y - Y component of the vector.
float z - Z component of the vector.
float w - W component of the vector.

explicit vec4 ( float v ) #

Constructor. Initializes the vector using a given scalar value: x=v, y=v, z=v, w=v.

Arguments

float v - Scalar value.

explicit vec4 ( const vec2 & v ) #

Constructor. Initializes the vector using a given two-component vec2 source vector: x=v.x, y=v.y, z=0.0f, w=1.0f.

Arguments

const vec2 & v - Two-component source vector.

explicit vec4 ( const vec3 & v ) #

Constructor. Initializes the vector using a given three-component vec3 source vector: x=v.x, y=v.y, z=v.z, w=1.0f.

Arguments

const vec3 & v - Three-component source vector.

explicit vec4 ( const dvec4 & v ) #

Constructor. Initializes the vector using a given dvec4 source vector.

Arguments

const dvec4 & v - Source vector.

explicit vec4 ( const ivec4 & v ) #

Constructor. Initializes the vector using a given ivec4 source vector.

Arguments

const ivec4 & v - Source vector.

explicit vec4 ( const bvec4 & v ) #

Constructor. Initializes the vector using a given bvec4 source vector.

Arguments

const bvec4 & v - Source vector.

explicit vec4 ( const float * v ) #

Constructor. Initializes the vector using a given pointer to the array of float elements: x=v[0], y=v[1], z=v[2], w=v[3].

Arguments

const float * v - Pointer to the array of float elements.

void set ( float x_, float y_, float z_, float w_ ) #

Sets the vector by components.

Arguments

float x_ - X component of the vector.
float y_ - Y component of the vector.
float z_ - Z component of the vector.
float w_ - W component of the vector.

void set ( const float * val ) #

Sets the vector using the array of float elements: x=val[0], y=val[1], z=val[2], w=val[3].

Arguments

const float * val - Pointer to the array of float elements.

void set ( const vec4 & val ) #

Sets the vector equal to the specified source vector.

Arguments

const vec4 & val - Source vector.

void set ( const vec2 & val, float z_, float w_ ) #

Sets the vector using a two-component vec2 source vector and two scalars.

Arguments

const vec2 & val - Two-component source vector.
float z_ - Z component of the vector.
float w_ - W component of the vector.

void set ( const vec3 & val, float w_ ) #

Sets the vector using a three-component vec3 source vector and a scalar.

Arguments

const vec3 & val - Three-component source vector.
float w_ - W component of the vector.

void set ( const quat & q ) #

Sets the vector using a quaternion.

Arguments

const quat & q - Quaternion.

void set ( float val ) #

Sets the vector components equal to specified scalar value: x=val, y=val, z=val, w=val.

Arguments

float val - Scalar value.

void get ( float * val ) const#

Gets the vector: val[0]=x, val[1]=y, val[2]=z, val[3]=w.

Arguments

float * val - Pointer to the array of float elements.

float * get ( ) #

Returns the pointer to the vector.

Return value

Pointer to the vector.

const float * get ( ) const#

Returns the constant pointer to the vector.

Return value

Pointer to the vector.

float length ( ) #

Returns the length of the vector.

Return value

Vector length.

float length2 ( ) #

Returns the squared length of the vector.

Return value

Squared length of the vector.

float maxXY ( ) #

Compares the X and Y components of the vector and returns the greater one.

Return value

The greater out of the X and Y components of the vector.

float maxXYZ ( ) #

Compares the X, Y, and Z components of the vector and returns the greatest one.

Return value

The greatest out of the X, Y, and Z vector components.

float max ( ) #

Compares all components of the vector and returns the greatest value.

Return value

The greatest out of the vector components.

vec4 & normalize ( ) #

Returns normalized vector.

Return value

Normalized vector.

vec4 & normalize3 ( ) #

Returns the vector with normalized XYZ components.

Return value

Vector with normalized XYZ components.

vec4 & normalizeFast ( ) #

Returns normalized vector, calculated using the fast inverse square root algorithm.

Return value

Normalized vector.

vec4 & normalizeFast3 ( ) #

Returns the vector with XYZ components normalized using the fast inverse square root algorithm..

Return value

Vector with normalized XYZ components.

m128 operator m128 ( ) #

Performs type conversion to __m128.

NoticeWe do not recommend to use this method unless you have a clear understanding of SSE2.

const float * operator const float * ( ) #

Performs type conversion to const float *.

const void * operator const void * ( ) #

Performs type conversion to const void *.

float * operator float * ( ) #

Performs type conversion to float *.

void * operator void * ( ) #

Performs type conversion to void *.

vec4 & operator*= ( float val ) #

Performs scalar multiplication.

Arguments

float val - Scalar value.

Return value

Resulting vector.

vec4 & operator*= ( const vec4 & val ) #

Performs vector multiplication.

Arguments

const vec4 & val - Vector.

Return value

Resulting vector.

vec4 & operator+= ( const vec4 & val ) #

Performs vector addition.

Arguments

const vec4 & val - Vector.

Return value

Resulting vector.

vec4 operator- ( ) const#

Performs vector negation.

Return value

Resulting vector.

vec4 & operator-= ( const vec4 & val ) #

Performs vector subtraction.

Arguments

const vec4 & val - Vector.

Return value

Resulting vector.

vec4 & operator/= ( float val ) #

Performs componentwise division of the vector by the scalar. Implemented using the calculation of inverse scalar value with subsequent by-component multiplication.

Arguments

float val - Scalar value.

Return value

Resulting vector.

Examples

Source code (UnigineScript)

vec4 a = vec4(6.0, 10.0, 12.0, 25.0);
a /= 2.0;
/*
Initial value of vector a:
	a (6.0, 10.0, 12.0, 25.0)

	a /= 2.0;
Vector a after operation:	
	a (3.0, 5.0, 6.0, 12.5)	
*/

vec4 & operator/= ( const vec4 & val ) #

Performs componentwise division of vectors.

Arguments

const vec4 & val - Vector.

Return value

Resulting vector.

Examples

Source code (UnigineScript)

vec4 a, b;
a = vec4(6.0, 10.0, 12.0, 25.0);
b = vec4(2.0, 5.0, 6.0, 5.0);
a /= b;
/*
Initial values of vectors a and b:
	a (6.0, 10.0, 12.0, 25.0)
	b (2.0, 5.0, 6.0, 5.0)

	a /= b;
Vector a after operation:	
	a (3.0, 2.0, 2.0, 5.0)	
*/

vec4 & operator= ( const __m128 & val ) #

Sets the vector using a given 128-bit variable as a source.

NoticeWe do not recommend to use this method unless you have a clear understanding of SSE2.

Arguments

const __m128 & val - 128-bit variable.

Return value

Vector.

vec4 & operator= ( const vec4 & val ) #

Performs vector assignment. Destination vector = Source vector.

Arguments

const vec4 & val - Source vector.

Return value

Result.

float & operator[] ( int i ) #

Performs array access to the vector item reference by using given item index.

Arguments

int i - Vector item index.

Return value

Vector item reference.

float operator[] ( int i ) const#

Performs array access to the vector item by using given item index.

Arguments

int i - Vector item index.

Return value

Vector item.

__m128 sse ( ) #

Returns vector components as a 128-bit variable.

NoticeWe do not recommend to use this method unless you have a clear understanding of SSE2.

Return value

128-bit variable.

void sse ( const __m128 & val ) #

Sets the vector using a given 128-bit variable as a source.

NoticeWe do not recommend to use this method unless you have a clear understanding of SSE2.

Arguments

const __m128 & val - 128-bit variable.

Last update: 2020-11-24

Help improve this article

Was this article helpful?

Report a problem related to this article

(or select a word/phrase and press Ctrl+Enter)

Unigine::Math::vec4 Struct

Methods:

Variables:

vec4 Class

Members

vec4 ( const __m128 & v ) #

Arguments

vec4 ( const quat & q ) #

Arguments

vec4 ( const hvec4 & v ) #

Arguments

vec4 ( ) #

vec4 ( const vec4 & v ) #

Arguments

vec4 ( const vec2 & v, float z, float w ) #

Arguments

vec4 ( const vec3 & v, float w ) #

Arguments

vec4 ( float x, float y, float z, float w ) #

Arguments

explicit vec4 ( float v ) #

Arguments

explicit vec4 ( const vec2 & v ) #

Arguments

explicit vec4 ( const vec3 & v ) #

Arguments

explicit vec4 ( const dvec4 & v ) #

Arguments

explicit vec4 ( const ivec4 & v ) #

Arguments

explicit vec4 ( const bvec4 & v ) #

Arguments

explicit vec4 ( const float * v ) #

Arguments

void set ( float x_, float y_, float z_, float w_ ) #

Arguments

void set ( const float * val ) #

Arguments

void set ( const vec4 & val ) #

Arguments

void set ( const vec2 & val, float z_, float w_ ) #

Arguments

void set ( const vec3 & val, float w_ ) #

Arguments

void set ( const quat & q ) #

Arguments

void set ( float val ) #

Arguments

void get ( float * val ) const#

Arguments

float * get ( ) #

Return value

const float * get ( ) const#

Return value

float length ( ) #

Return value

float length2 ( ) #

Return value

float maxXY ( ) #

Return value

float maxXYZ ( ) #

Return value

float max ( ) #

Return value

vec4 & normalize ( ) #

Return value

vec4 & normalize3 ( ) #

Return value

vec4 & normalizeFast ( ) #

Return value

vec4 & normalizeFast3 ( ) #

Return value

__m128 operator __m128 ( ) #

const float * operator const float * ( ) #

const void * operator const void * ( ) #

float * operator float * ( ) #

void * operator void * ( ) #

vec4 & operator*= ( float val ) #

Arguments

Return value

m128 operator m128 ( ) #