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, /) -> 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
def projected_onto_normalized(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: Add a vector
def __buffer__(self, flags, /): Return a buffer object that exposes the underlying memory of the object.
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: Add and assign a vector
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: 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 __release_buffer__(self, buffer, /): Release the buffer object that exposes the underlying memory of the object.
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