Welcome to Python-flavored Magnum! Please note that, while already being rather stable, this functionality is still considered experimental and some APIs might get changed without preserving full backwards compatibility.

# magnum.Vector4 class

Four-component float vector

## Static methods

def zero_init() -> Vector4
Construct a zero vector

## Methods

def dot(self, /) -> float
Dot product of the vector
def flipped(self, /) -> Vector4
Flipped vector
def is_normalized(self, /) -> bool
Whether the vector is normalized
def is_zero(self, /) -> bool
Whether the vector is zero
def length(self, /) -> float
Vector length
def length_inverted(self, /) -> float
Inverse vector length
def max(self, /) -> float
Maximal value in the vector
def min(self, /) -> float
Minimal value in the vector
def minmax(self, /) -> typing.Tuple[float, float]
Minimal and maximal value in the vector
def normalized(self, /) -> Vector4
Normalized vector (of unit length)
def product(self, /) -> float
Product of values in the vector
def projected(self, line: Vector4) -> Vector4
Vector projected onto a line
self, line: Vector4) -> Vector4
Vector projected onto a normalized line
def resized(self, length: float) -> Vector4
Resized vector
def sum(self, /) -> float
Sum of values in the vector

## Special methods

def __add__(self, arg0: Vector4, /) -> Vector4
def __eq__(self, arg0: Vector4, /) -> bool
Equality comparison
def __ge__(self, arg0: Vector4, /) -> BitVector4
Component-wise greater than or equal comparison
def __getattr__(self, arg0: str, /) -> object
Vector swizzle
def __getitem__(self, arg0: int, /) -> float
Value at given position
def __getstate__(self, /) -> bytes
Dumps the in-memory representation of vector components
def __gt__(self, arg0: Vector4, /) -> BitVector4
Component-wise greater than comparison
def __iadd__(self, arg0: Vector4, /) -> Vector4
def __imul__(self, arg0: float, /) -> Vector4
Multiply with a scalar and assign
def __imul__(self, arg0: Vector4, /) -> Vector4
Multiply a vector component-wise and assign
def __init__(self, arg0: Vector4ui, /) -> None
Construct from different underlying type
def __init__(self, arg0: Vector4i, /) -> None
Construct from different underlying type
def __init__(self, arg0: Vector4d, /) -> None
Construct from different underlying type
def __init__(self, arg0: buffer, /) -> None
Construct from a buffer
def __init__(self, /) -> None
Default constructor
def __init__(self, arg0: float, /) -> None
Construct a vector with one value for all components
def __init__(self, arg0: float, arg1: float, arg2: float, arg3: float, /) -> None
Constructor
def __init__(self, arg0: Vector3, arg1: float, /) -> None
Constructor
def __init__(self, arg0: typing.Tuple[float, float, float, float], /) -> None
Construct from a tuple
def __isub__(self, arg0: Vector4, /) -> Vector4
Subtract and assign a vector
def __itruediv__(self, arg0: float, /) -> Vector4
Divide with a scalar and assign
def __itruediv__(self, arg0: Vector4, /) -> Vector4
Divide a vector component-wise and assign
def __le__(self, arg0: Vector4, /) -> BitVector4
Component-wise less than or equal comparison
def __len__() -> int
Vector size. Returns 4.
def __lt__(self, arg0: Vector4, /) -> BitVector4
Component-wise less than comparison
def __mul__(self, arg0: float, /) -> Vector4
Multiply with a scalar
def __mul__(self, arg0: Vector4, /) -> Vector4
Multiply a vector component-wise
def __ne__(self, arg0: Vector4, /) -> bool
Non-equality comparison
def __neg__(self, /) -> Vector4
Negated vector
def __repr__(self, /) -> str
Object representation
def __rmul__(self, arg0: float, /) -> Vector4
Multiply a scalar with a vector
def __rtruediv__(self, arg0: float, /) -> Vector4
Divide a vector with a scalar and invert
def __setattr__(self, arg0: str, arg1: object, /) -> None
Vector swizzle
def __setitem__(self, arg0: int, arg1: float, /) -> None
Set a value at given position
def __setstate__(self, arg0: bytes, /) -> None
Treats the data as the in-memory representation of vector components
def __sub__(self, arg0: Vector4, /) -> Vector4
Subtract a vector
def __truediv__(self, arg0: float, /) -> Vector4
Divide with a scalar
def __truediv__(self, arg0: Vector4, /) -> Vector4
Divide a vector component-wise

## Properties

a: float get set
A component
b: float get set
B component
g: float get set
G component
r: float get set
R component
rgb: Vector3 get set
RGB part of the vector
w: float get set
W component
x: float get set
X component
xy: Vector2 get set
XY part of the vector
xyz: Vector3 get set
XYZ part of the vector
y: float get set
Y component
z: float get set
Z component

## Method documentation

### def magnum.Vector4.projected_onto_normalized(self, line: Vector4) -> Vector4

Vector projected onto a normalized line

Exceptions
ValueError If `line` is not normalized

### def magnum.Vector4.__setstate__(self, arg0: bytes, /) -> None

Treats the data as the in-memory representation of vector components

Exceptions
ValueError If the data size doesn’t match type size