Unigine::Math::ivec4 Struct

Header:

#include <UnigineMathLibIVec4.h>

This class represents a vector of 4 integer components.

Methods:

Name	Description View: Sort by:
ivec4	Constructor.
abs	Returns the absolute values of the vector components.
set	Sets the vector by components.
get	Returns the pointer to the vector.
length2	Returns the squared length of the vector.
operator const int *	Performs type conversion to const int *.
operator const void *	Performs type conversion to const void *.
operator int *	Performs type conversion to int *.
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 integer division of the vector by the scalar.
operator <<=	Performs componentwise left bit shift.
operator =	Performs vector assignment.
operator >>=	Performs componentwise right bit shift.
operator []	Performs array access to the vector item reference by using given item index.
operator =	Sets the vector components equal to specified scalar value: x=val, y=val, z=val, w=val.
mul	Multiplies the vector by the value of the specified argument.
div	Returns the result of division of the vector by the value of the specified arguments.
sub	Subtracts each element of the specified argument from the corresponding element.
operator -=	Performs vector subtraction.
sum	Returns the sum of vector components.
add	Performs addition of the specified value.
operator +=	Performs addition of the specified value.
shiftLeft	Bitwise left shift by a specific value.
operator <<=	Bitwise left shift by a specific value.
shiftRight	Bitwise right shift by a specific value.
operator >>=	Bitwise right shift by a specific value.
max	Returns the maximum of all components.
min	Returns the minimum of all components.

Variables:

Name	Description
ivec4_one	Vector filled with ones (1).
ivec4_zero	Vector filled with zeros (0).

ivec4 Class

Members

ivec4 ( const __m128i& v ) #

Constructor. Initializes the vector using a __m128i variable.

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

Arguments

const __m128i& v - All components of the vector in __m128d format

ivec4 ( ) #

Default constructor. Produces a zero vector.

ivec4 ( const ivec4& v ) #

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

Arguments

const ivec4& v - Source vector.

ivec4 ( int x, int y, int z, int w ) #

Constructor. Initializes the vector using given integer values.

Arguments

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

explicit ivec4 ( int v ) #

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

Arguments

int v - Scalar value.

explicit ivec4 ( const vec4& v ) #

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

Arguments

const vec4& v - Source vector.

explicit ivec4 ( const dvec4& v ) #

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

Arguments

const dvec4& v - Source vector.

explicit ivec4 ( const bvec4& v ) #

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

Arguments

const bvec4& v - Source vector.

explicit ivec4 ( const svec4& v ) #

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

Arguments

const svec4& v - Source vector.

explicit ivec4 ( const int* v ) #

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

Arguments

const int* v - Pointer to the array of integer elements.

ivec4 ( const ivec3& v ) #

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

Arguments

const ivec3& v - Source vector.

ivec4 ( const ivec2& v0, const ivec2& v1 ) #

Constructor. Initializes the vector using given ivec2 source vectors.

Arguments

const ivec2& v0 - Source vector for X and Y components.
const ivec2& v1 - Source vector for Z and W components.

ivec4 ( const ivec2& v, int z, int w ) #

Constructor. Initializes the vector using a given ivec2 source vector and two int values for Z and W components.

Arguments

const ivec2& v - Source vector for X and Y components.
int z - Z component of the vector.
int w - W component of the vector.

ivec4 ( const ivec3& v, int w ) #

Constructor. Initializes the vector using a given ivec3 source vector and an int value for the W component.

Arguments

const ivec3& v - Source vector for X, Y and Z components.
int w - W component of the vector.

ivec4 ( int v, ConstexprTag ) #

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

Arguments

int v - Constant scalar value.
ConstexprTag - Auxiliary tag.

ivec4 & abs ( ) #

Returns the absolute values of the vector components.

Return value

Vector with absolute values.

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

Sets the vector by components.

Arguments

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

void set ( const int* val ) #

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

Arguments

const int* val - Pointer to the array of integer elements.

void set ( int val ) #

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

Arguments

int val - Scalar value.

void set ( const ivec4& val ) #

Sets the vector equal to the specified source vector.

Arguments

const ivec4& val - Source vector.

int * get ( ) #

Returns the pointer to the vector.

Return value

Pointer to the vector.

const int * get ( ) const#

Returns the constant pointer to the vector.

Return value

Pointer to the vector.

void get ( int* val ) const#

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

Arguments

int* val - Pointer to the array of integer elements.

ivec4 a = ivec4(6, 10, 11, 4);
a /= 2;
/*
Initial value of vector a:
	a (6, 10, 11, 4)

	a /= 2;
Vector a after operation:	
	a (3, 5, 5, 2)	
*/

ivec4 & operator/= ( const ivec4& v ) #

Performs componentwise integer division of vectors.

Arguments

const ivec4& v - Vector.

Return value

Resulting vector.

Examples

Source code (UnigineScript)

ivec4 a, b;
a = ivec4(6, 10, 12, 3);
b = ivec4(2, 6, 5, 2);
a /= b;
/*
Initial values of vectors a and b:
	a (6, 10, 12, 3)
	b (2, 6, 5, 2)

	a /= b;
Vector a after operation:	
	a (3, 1, 2, 1)

ivec4 & operator<<= ( int v ) #

Performs componentwise left bit shift.

Arguments

int v - Shift amount.

Return value

Resulting vector.

ivec4 & operator= ( const __m128i& val ) #

Performs vector assignment. Destination vector = Source vector.

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

Arguments

const __m128i& val - Source vector in the __m128i format.

ivec4 & operator= ( const ivec4& val ) #

Performs vector assignment. Destination vector = Source vector.

Arguments

const ivec4& val - Source vector.

Return value

Result.

ivec4 & operator>>= ( int v ) #

Performs componentwise right bit shift.

Arguments

int v - Shift amount.

Return value

Resulting vector.

int & 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.

int 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.

ivec4 & operator= ( int val ) #

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

Arguments

int val - Scalar value.

Return value

This vector.

int mul ( ) const#

Multiplies the vector by the value of the specified argument.

Return value

Vector multiplier.

void mul ( int v ) #

Multiplies the vector by the value of the specified argument.

Arguments

int v - An int multiplier.

void mul ( const ivec4& v ) #

Multiplies the vector by the value of the specified argument.

Arguments

const ivec4& v - Vector multiplier.

void div ( int v ) #

Returns the result of division of the vector by the value of the specified arguments.

Arguments

int v - An int divisor value.

void div ( const ivec4& v ) #

Returns the result of division of the vector by the value of the specified arguments.

Arguments

const ivec4& v - A ivec4 divisor value.

void sub ( int v ) #

Subtracts each element of the specified argument from the corresponding element.

Arguments

int v - Value.

void sub ( const ivec4& v ) #

Subtracts each element of the specified argument from the corresponding element.

Arguments

const ivec4& v - Value.

ivec4 & operator-= ( int v ) #

Performs vector subtraction.

Arguments

int v - Value.

int sum ( ) const#

Returns the sum of vector components.

void add ( int v ) #

Performs addition of the specified value.

Arguments

int v - Value.

void add ( const ivec4& v ) #

Performs addition of the specified value.

Arguments

const ivec4& v - Value.

ivec4 & operator+= ( int v ) #

Performs addition of the specified value.

Arguments

int v - Value.

void shiftLeft ( int v ) #

Bitwise left shift by a specific value. All components are shifted by this value.

Arguments

int v - Value.

void shiftLeft ( const ivec4& v ) #

Bitwise left shift by a specific value. All components are shifted by the value's corresponding component.

Arguments

const ivec4& v - Value.

ivec4 & operator<<= ( const ivec4& v ) #

Bitwise left shift by a specific value. All components are shifted by the value's corresponding component.

Arguments

const ivec4& v - Value.

Return value

This vector.

ivec4 & operator<<= ( int v ) #

Bitwise left shift by a specific value. All components are shifted by this value.

Arguments

int v - Value.

Return value

This vector.

void shiftRight ( int v ) #

Bitwise right shift by a specific value. All components are shifted by this value.

Arguments

int v - Value.

void shiftRight ( const ivec4& v ) #

Bitwise right shift by a specific value. All components are shifted by the value's corresponding component.

Arguments

const ivec4& v - Value.

ivec4 & operator>>= ( const ivec4& v ) #

Bitwise right shift by a specific value. All components are shifted by the value's corresponding component.

Arguments

const ivec4& v - Value.

Return value

This vector.

ivec4 & operator>>= ( int v ) #

Bitwise right shift by a specific value. All components are shifted by this value.

Arguments

int v - Value.

Return value

This vector.

int max ( ) const#

Returns the maximum of all components.

int min ( ) const#

Returns the minimum of all components.

Last update: 2022-02-04

Help improve this article

Was this article helpful?

Report a problem related to this article

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