Package org.joml

Class Vector4i

java.lang.Object
org.joml.Vector4i
All Implemented Interfaces:
Externalizable, Serializable, Cloneable, Vector4ic

public class Vector4i extends Object implements Externalizable, Cloneable, Vector4ic
Contains the definition of a Vector comprising 4 ints and associated transformations.
Author:
Richard Greenlees, Kai Burjack, Hans Uhlig
See Also:
Serialized Form
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    int
    The w component of the vector.
    int
    The x component of the vector.
    int
    The y component of the vector.
    int
    The z component of the vector.
  • Constructor Summary

    Constructors
    Constructor
    Description
    Create a new Vector4i of (0, 0, 0, 1).
    Vector4i​(int s)
    Create a new Vector4i and initialize all four components with the given value.
    Vector4i​(int[] xyzw)
    Create a new Vector4i and initialize its four components from the first four elements of the given array.
    Vector4i​(int x, int y, int z, int w)
    Create a new Vector4i with the given component values.
    Vector4i​(int index, ByteBuffer buffer)
    Create a new Vector4i and read this vector from the supplied ByteBuffer starting at the specified absolute buffer position/index.
    Vector4i​(int index, IntBuffer buffer)
    Create a new Vector4i and read this vector from the supplied IntBuffer starting at the specified absolute buffer position/index.
    Vector4i​(ByteBuffer buffer)
    Create a new Vector4i and read this vector from the supplied ByteBuffer at the current buffer position.
    Vector4i​(IntBuffer buffer)
    Create a new Vector4i and read this vector from the supplied IntBuffer at the current buffer position.
    Vector4i​(Vector2ic v, int z, int w)
    Create a new Vector4i with the first two components from the given v and the given z, and w.
    Vector4i​(Vector3fc v, float w, int mode)
    Create a new Vector4i with the first three components from the given v and the given w and round using the given RoundingMode.
    Vector4i​(Vector3ic v, int w)
    Create a new Vector4i with the first three components from the given v and the given w.
    Vector4i​(Vector4dc v, int mode)
    Create a new Vector4i and initialize its components to the rounded value of the given vector.
    Vector4i​(Vector4fc v, int mode)
    Create a new Vector4i and initialize its components to the rounded value of the given vector.
    Create a new Vector4i with the same values as v.
  • Method Summary

    Modifier and Type
    Method
    Description
    Compute the absolute of each of this vector's components.
    absolute​(Vector4i dest)
    Compute the absolute of each of this vector's components and store the result into dest.
    add​(int x, int y, int z, int w)
    Increment the components of this vector by the given values.
    add​(int x, int y, int z, int w, Vector4i dest)
    Increment the components of this vector by the given values and store the result in dest.
    add​(Vector4ic v)
    Add the supplied vector to this one.
    add​(Vector4ic v, Vector4i dest)
    Add the supplied vector to this one and store the result in dest.
     
    double
    distance​(int x, int y, int z, int w)
    Return the distance between this vector and (x, y, z, w).
    static double
    distance​(int x1, int y1, int z1, int w1, int x2, int y2, int z2, int w2)
    Return the distance between (x1, y1, z1, w1) and (x2, y2, z2, w2).
    double
    Return the distance between this Vector and v.
    int
    distanceSquared​(int x, int y, int z, int w)
    Return the square of the distance between this vector and (x, y, z, w).
    static long
    distanceSquared​(int x1, int y1, int z1, int w1, int x2, int y2, int z2, int w2)
    Return the squared distance between (x1, y1, z1, w1) and (x2, y2, z2, w2).
    int
    Return the square of the distance between this vector and v.
    div​(float scalar)
    Divide all components of this Vector3i by the given scalar value.
    div​(float scalar, Vector4i dest)
    Divide all components of this Vector4i by the given scalar value and store the result in dest.
    div​(int scalar)
    Divide all components of this Vector4i by the given scalar value.
    div​(int scalar, Vector4i dest)
    Divide all components of this Vector4i by the given scalar value and store the result in dest.
    div​(Vector4ic v)
    Divide this Vector4i component-wise by another Vector4i.
    div​(Vector4ic v, Vector4i dest)
    Divide this Vector4i component-wise by another Vector4ic and store the result in dest.
    int
    dot​(Vector4ic v)
    Compute the dot product (inner product) of this vector and v.
    boolean
    equals​(int x, int y, int z, int w)
    Compare the vector components of this vector with the given (x, y, z, w) and return whether all of them are equal.
    boolean
    equals​(Object obj)
     
    int
    get​(int component)
    Get the value of the specified component of this vector.
    get​(int index, ByteBuffer buffer)
    Store this vector into the supplied ByteBuffer starting at the specified absolute buffer position/index.
    get​(int index, IntBuffer buffer)
    Store this vector into the supplied IntBuffer starting at the specified absolute buffer position/index.
    get​(ByteBuffer buffer)
    Store this vector into the supplied ByteBuffer at the current buffer position.
    get​(IntBuffer buffer)
    Store this vector into the supplied IntBuffer at the current buffer position.
    getToAddress​(long address)
    Store this vector at the given off-heap memory address.
    long
    gridDistance​(int x, int y, int z, int w)
    Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance) (x, y).
    long
    Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance) (x, y).
    int
     
    double
    Return the length of this vector.
    static double
    length​(int x, int y, int z, int w)
    Get the length of a 4-dimensional single-precision vector.
    long
    Return the length squared of this vector.
    static long
    lengthSquared​(int x, int y, int z, int w)
    Get the length squared of a 4-dimensional single-precision vector.
    max​(Vector4ic v)
    Set the components of this vector to be the component-wise maximum of this and the other vector.
    max​(Vector4ic v, Vector4i dest)
    Set the components of dest to be the component-wise maximum of this and the other vector.
    int
    Determine the component with the biggest absolute value.
    min​(Vector4ic v)
    Set the components of this vector to be the component-wise minimum of this and the other vector.
    min​(Vector4ic v, Vector4i dest)
    Set the components of dest to be the component-wise minimum of this and the other vector.
    int
    Determine the component with the smallest (towards zero) absolute value.
    mul​(int scalar)
    Multiply all components of this Vector4i by the given scalar value.
    mul​(int scalar, Vector4i dest)
    Multiply all components of this Vector4i by the given scalar value and store the result in dest.
    mul​(Vector4ic v)
    Multiply this Vector4i component-wise by another Vector4i.
    mul​(Vector4ic v, Vector4i dest)
    Multiply this Vector4i component-wise by another Vector4ic and store the result in dest.
    Negate this vector.
    negate​(Vector4i dest)
    Negate this vector and store the result in dest.
    void
     
    set​(int s)
    Set the x, y, z, and w components to the supplied value.
    set​(int[] xyzw)
    Set the four components of this vector to the first four elements of the given array.
    set​(int x, int y, int z, int w)
    Set the x, y, z, and w components to the supplied values.
    set​(int index, ByteBuffer buffer)
    Read this vector from the supplied ByteBuffer starting at the specified absolute buffer position/index.
    set​(int index, IntBuffer buffer)
    Read this vector from the supplied IntBuffer starting at the specified absolute buffer position/index.
    set​(ByteBuffer buffer)
    Read this vector from the supplied ByteBuffer at the current buffer position.
    set​(IntBuffer buffer)
    Read this vector from the supplied IntBuffer at the current buffer position.
    set​(Vector2ic v, int z, int w)
    Sets the first two components of this to the components of given v and last two components to the given z, and w.
    set​(Vector3ic v, int w)
    Set the first three components of this to the components of v and the last component to w.
    set​(Vector4dc v)
    Set this Vector4i to the values of v using RoundingMode.TRUNCATE rounding.
    set​(Vector4dc v, int mode)
    Set this Vector4i to the values of v using the given RoundingMode.
    set​(Vector4fc v, int mode)
    Set this Vector4i to the values of v using the given RoundingMode.
    set​(Vector4ic v)
    Set this Vector4i to the values of the given v.
    setComponent​(int component, int value)
    Set the value of the specified component of this vector.
    setFromAddress​(long address)
    Set the values of this vector by reading 4 integer values from off-heap memory, starting at the given address.
    sub​(int x, int y, int z, int w)
    Subtract (x, y, z, w) from this.
    sub​(int x, int y, int z, int w, Vector4i dest)
    Subtract (x, y, z, w) from this and store the result in dest.
    sub​(Vector4ic v)
    Subtract the supplied vector from this one.
    sub​(Vector4ic v, Vector4i dest)
    Subtract the supplied vector from this one and store the result in dest.
    Return a string representation of this vector.
    toString​(NumberFormat formatter)
    Return a string representation of this vector by formatting the vector components with the given NumberFormat.
    int
    w()
     
    void
     
    int
    x()
     
    int
    y()
     
    int
    z()
     
    Set all components to zero.

    Methods inherited from class java.lang.Object

    finalize, getClass, notify, notifyAll, wait, wait, wait
  • Field Details

    • x

      public int x
      The x component of the vector.
    • y

      public int y
      The y component of the vector.
    • z

      public int z
      The z component of the vector.
    • w

      public int w
      The w component of the vector.
  • Constructor Details

    • Vector4i

      public Vector4i()
      Create a new Vector4i of (0, 0, 0, 1).
    • Vector4i

      public Vector4i(Vector4ic v)
      Create a new Vector4i with the same values as v.
      Parameters:
      v - the Vector4ic to copy the values from
    • Vector4i

      public Vector4i(Vector3ic v, int w)
      Create a new Vector4i with the first three components from the given v and the given w.
      Parameters:
      v - the Vector3ic
      w - the w component
    • Vector4i

      public Vector4i(Vector2ic v, int z, int w)
      Create a new Vector4i with the first two components from the given v and the given z, and w.
      Parameters:
      v - the Vector2ic
      z - the z component
      w - the w component
    • Vector4i

      public Vector4i(Vector3fc v, float w, int mode)
      Create a new Vector4i with the first three components from the given v and the given w and round using the given RoundingMode.
      Parameters:
      v - the Vector3fc to copy the values from
      w - the w component
      mode - the RoundingMode to use
    • Vector4i

      public Vector4i(Vector4fc v, int mode)
      Create a new Vector4i and initialize its components to the rounded value of the given vector.
      Parameters:
      v - the Vector4fc to round and copy the values from
      mode - the RoundingMode to use
    • Vector4i

      public Vector4i(Vector4dc v, int mode)
      Create a new Vector4i and initialize its components to the rounded value of the given vector.
      Parameters:
      v - the Vector4dc to round and copy the values from
      mode - the RoundingMode to use
    • Vector4i

      public Vector4i(int s)
      Create a new Vector4i and initialize all four components with the given value.
      Parameters:
      s - scalar value of all four components
    • Vector4i

      public Vector4i(int x, int y, int z, int w)
      Create a new Vector4i with the given component values.
      Parameters:
      x - the x component
      y - the y component
      z - the z component
      w - the w component
    • Vector4i

      public Vector4i(int[] xyzw)
      Create a new Vector4i and initialize its four components from the first four elements of the given array.
      Parameters:
      xyzw - the array containing at least four elements
    • Vector4i

      public Vector4i(ByteBuffer buffer)
      Create a new Vector4i and read this vector from the supplied ByteBuffer at the current buffer position.

      This method will not increment the position of the given ByteBuffer.

      In order to specify the offset into the ByteBuffer at which the vector is read, use Vector4i(int, ByteBuffer), taking the absolute position as parameter.

      Parameters:
      buffer - values will be read in x, y, z, w order
      See Also:
      Vector4i(int, ByteBuffer)
    • Vector4i

      public Vector4i(int index, ByteBuffer buffer)
      Create a new Vector4i and read this vector from the supplied ByteBuffer starting at the specified absolute buffer position/index.

      This method will not increment the position of the given ByteBuffer.

      Parameters:
      index - the absolute position into the ByteBuffer
      buffer - values will be read in x, y, z, w order
    • Vector4i

      public Vector4i(IntBuffer buffer)
      Create a new Vector4i and read this vector from the supplied IntBuffer at the current buffer position.

      This method will not increment the position of the given IntBuffer.

      In order to specify the offset into the IntBuffer at which the vector is read, use Vector4i(int, IntBuffer), taking the absolute position as parameter.

      Parameters:
      buffer - values will be read in x, y, z, w order
      See Also:
      Vector4i(int, IntBuffer)
    • Vector4i

      public Vector4i(int index, IntBuffer buffer)
      Create a new Vector4i and read this vector from the supplied IntBuffer starting at the specified absolute buffer position/index.

      This method will not increment the position of the given IntBuffer.

      Parameters:
      index - the absolute position into the IntBuffer
      buffer - values will be read in x, y, z, w order
  • Method Details

    • x

      public int x()
      Specified by:
      x in interface Vector4ic
      Returns:
      the value of the x component
    • y

      public int y()
      Specified by:
      y in interface Vector4ic
      Returns:
      the value of the y component
    • z

      public int z()
      Specified by:
      z in interface Vector4ic
      Returns:
      the value of the z component
    • w

      public int w()
      Specified by:
      w in interface Vector4ic
      Returns:
      the value of the w component
    • set

      public Vector4i set(Vector4ic v)
      Set this Vector4i to the values of the given v.
      Parameters:
      v - the vector whose values will be copied into this
      Returns:
      this
    • set

      public Vector4i set(Vector4dc v)
      Set this Vector4i to the values of v using RoundingMode.TRUNCATE rounding.

      Note that due to the given vector v storing the components in double-precision, there is the possibility to lose precision.

      Parameters:
      v - the vector to copy from
      Returns:
      this
    • set

      public Vector4i set(Vector4dc v, int mode)
      Set this Vector4i to the values of v using the given RoundingMode.

      Note that due to the given vector v storing the components in double-precision, there is the possibility to lose precision.

      Parameters:
      v - the vector to copy from
      mode - the RoundingMode to use
      Returns:
      this
    • set

      public Vector4i set(Vector4fc v, int mode)
      Set this Vector4i to the values of v using the given RoundingMode.

      Note that due to the given vector v storing the components in double-precision, there is the possibility to lose precision.

      Parameters:
      v - the vector to copy from
      mode - the RoundingMode to use
      Returns:
      this
    • set

      public Vector4i set(Vector3ic v, int w)
      Set the first three components of this to the components of v and the last component to w.
      Parameters:
      v - the Vector3ic to copy
      w - the w component
      Returns:
      this
    • set

      public Vector4i set(Vector2ic v, int z, int w)
      Sets the first two components of this to the components of given v and last two components to the given z, and w.
      Parameters:
      v - the Vector2ic
      z - the z component
      w - the w component
      Returns:
      this
    • set

      public Vector4i set(int s)
      Set the x, y, z, and w components to the supplied value.
      Parameters:
      s - the value of all four components
      Returns:
      this
    • set

      public Vector4i set(int x, int y, int z, int w)
      Set the x, y, z, and w components to the supplied values.
      Parameters:
      x - the x component
      y - the y component
      z - the z component
      w - the w component
      Returns:
      this
    • set

      public Vector4i set(int[] xyzw)
      Set the four components of this vector to the first four elements of the given array.
      Parameters:
      xyzw - the array containing at least four elements
      Returns:
      this
    • set

      public Vector4i set(ByteBuffer buffer)
      Read this vector from the supplied ByteBuffer at the current buffer position.

      This method will not increment the position of the given ByteBuffer.

      In order to specify the offset into the ByteBuffer at which the vector is read, use set(int, ByteBuffer), taking the absolute position as parameter.

      Parameters:
      buffer - values will be read in x, y, z, w order
      Returns:
      this
      See Also:
      set(int, ByteBuffer)
    • set

      public Vector4i set(int index, ByteBuffer buffer)
      Read this vector from the supplied ByteBuffer starting at the specified absolute buffer position/index.

      This method will not increment the position of the given ByteBuffer.

      Parameters:
      index - the absolute position into the ByteBuffer
      buffer - values will be read in x, y, z, w order
      Returns:
      this
    • set

      public Vector4i set(IntBuffer buffer)
      Read this vector from the supplied IntBuffer at the current buffer position.

      This method will not increment the position of the given IntBuffer.

      In order to specify the offset into the IntBuffer at which the vector is read, use set(int, IntBuffer), taking the absolute position as parameter.

      Parameters:
      buffer - values will be read in x, y, z, w order
      Returns:
      this
      See Also:
      set(int, IntBuffer)
    • set

      public Vector4i set(int index, IntBuffer buffer)
      Read this vector from the supplied IntBuffer starting at the specified absolute buffer position/index.

      This method will not increment the position of the given IntBuffer.

      Parameters:
      index - the absolute position into the IntBuffer
      buffer - values will be read in x, y, z, w order
      Returns:
      this
    • setFromAddress

      public Vector4i setFromAddress(long address)
      Set the values of this vector by reading 4 integer values from off-heap memory, starting at the given address.

      This method will throw an UnsupportedOperationException when JOML is used with `-Djoml.nounsafe`.

      This method is unsafe as it can result in a crash of the JVM process when the specified address range does not belong to this process.

      Parameters:
      address - the off-heap memory address to read the vector values from
      Returns:
      this
    • get

      public int get(int component) throws IllegalArgumentException
      Description copied from interface: Vector4ic
      Get the value of the specified component of this vector.
      Specified by:
      get in interface Vector4ic
      Parameters:
      component - the component, within [0..3]
      Returns:
      the value
      Throws:
      IllegalArgumentException - if component is not within [0..3]
    • maxComponent

      public int maxComponent()
      Description copied from interface: Vector4ic
      Determine the component with the biggest absolute value.
      Specified by:
      maxComponent in interface Vector4ic
      Returns:
      the component index, within [0..3]
    • minComponent

      public int minComponent()
      Description copied from interface: Vector4ic
      Determine the component with the smallest (towards zero) absolute value.
      Specified by:
      minComponent in interface Vector4ic
      Returns:
      the component index, within [0..3]
    • setComponent

      public Vector4i setComponent(int component, int value) throws IllegalArgumentException
      Set the value of the specified component of this vector.
      Parameters:
      component - the component whose value to set, within [0..3]
      value - the value to set
      Returns:
      this
      Throws:
      IllegalArgumentException - if component is not within [0..3]
    • get

      public IntBuffer get(IntBuffer buffer)
      Description copied from interface: Vector4ic
      Store this vector into the supplied IntBuffer at the current buffer position.

      This method will not increment the position of the given IntBuffer.

      In order to specify the offset into the IntBuffer at which the vector is stored, use Vector4ic.get(int, IntBuffer), taking the absolute position as parameter.

      Specified by:
      get in interface Vector4ic
      Parameters:
      buffer - will receive the values of this vector in x, y, z, w order
      Returns:
      the passed in buffer
      See Also:
      Vector4ic.get(int, IntBuffer)
    • get

      public IntBuffer get(int index, IntBuffer buffer)
      Description copied from interface: Vector4ic
      Store this vector into the supplied IntBuffer starting at the specified absolute buffer position/index.

      This method will not increment the position of the given IntBuffer.

      Specified by:
      get in interface Vector4ic
      Parameters:
      index - the absolute position into the IntBuffer
      buffer - will receive the values of this vector in x, y, z, w order
      Returns:
      the passed in buffer
    • get

      public ByteBuffer get(ByteBuffer buffer)
      Description copied from interface: Vector4ic
      Store this vector into the supplied ByteBuffer at the current buffer position.

      This method will not increment the position of the given ByteBuffer.

      In order to specify the offset into the ByteBuffer at which the vector is stored, use Vector4ic.get(int, ByteBuffer), taking the absolute position as parameter.

      Specified by:
      get in interface Vector4ic
      Parameters:
      buffer - will receive the values of this vector in x, y, z, w order
      Returns:
      the passed in buffer
      See Also:
      Vector4ic.get(int, ByteBuffer)
    • get

      public ByteBuffer get(int index, ByteBuffer buffer)
      Description copied from interface: Vector4ic
      Store this vector into the supplied ByteBuffer starting at the specified absolute buffer position/index.

      This method will not increment the position of the given ByteBuffer.

      Specified by:
      get in interface Vector4ic
      Parameters:
      index - the absolute position into the ByteBuffer
      buffer - will receive the values of this vector in x, y, z, w order
      Returns:
      the passed in buffer
    • getToAddress

      public Vector4ic getToAddress(long address)
      Description copied from interface: Vector4ic
      Store this vector at the given off-heap memory address.

      This method will throw an UnsupportedOperationException when JOML is used with `-Djoml.nounsafe`.

      This method is unsafe as it can result in a crash of the JVM process when the specified address range does not belong to this process.

      Specified by:
      getToAddress in interface Vector4ic
      Parameters:
      address - the off-heap address where to store this vector
      Returns:
      this
    • sub

      public Vector4i sub(Vector4ic v)
      Subtract the supplied vector from this one.
      Parameters:
      v - the vector to subtract
      Returns:
      this
    • sub

      public Vector4i sub(int x, int y, int z, int w)
      Subtract (x, y, z, w) from this.
      Parameters:
      x - the x component to subtract
      y - the y component to subtract
      z - the z component to subtract
      w - the w component to subtract
      Returns:
      this
    • sub

      public Vector4i sub(Vector4ic v, Vector4i dest)
      Description copied from interface: Vector4ic
      Subtract the supplied vector from this one and store the result in dest.
      Specified by:
      sub in interface Vector4ic
      Parameters:
      v - the vector to subtract from this
      dest - will hold the result
      Returns:
      dest
    • sub

      public Vector4i sub(int x, int y, int z, int w, Vector4i dest)
      Description copied from interface: Vector4ic
      Subtract (x, y, z, w) from this and store the result in dest.
      Specified by:
      sub in interface Vector4ic
      Parameters:
      x - the x component to subtract
      y - the y component to subtract
      z - the z component to subtract
      w - the w component to subtract
      dest - will hold the result
      Returns:
      dest
    • add

      public Vector4i add(Vector4ic v)
      Add the supplied vector to this one.
      Parameters:
      v - the vector to add
      Returns:
      this
    • add

      public Vector4i add(Vector4ic v, Vector4i dest)
      Description copied from interface: Vector4ic
      Add the supplied vector to this one and store the result in dest.
      Specified by:
      add in interface Vector4ic
      Parameters:
      v - the vector to add
      dest - will hold the result
      Returns:
      dest
    • add

      public Vector4i add(int x, int y, int z, int w)
      Increment the components of this vector by the given values.
      Parameters:
      x - the x component to add
      y - the y component to add
      z - the z component to add
      w - the w component to add
      Returns:
      this
    • add

      public Vector4i add(int x, int y, int z, int w, Vector4i dest)
      Description copied from interface: Vector4ic
      Increment the components of this vector by the given values and store the result in dest.
      Specified by:
      add in interface Vector4ic
      Parameters:
      x - the x component to add
      y - the y component to add
      z - the z component to add
      w - the w component to add
      dest - will hold the result
      Returns:
      dest
    • mul

      public Vector4i mul(Vector4ic v)
      Multiply this Vector4i component-wise by another Vector4i.
      Parameters:
      v - the other vector
      Returns:
      this
    • mul

      public Vector4i mul(Vector4ic v, Vector4i dest)
      Description copied from interface: Vector4ic
      Multiply this Vector4i component-wise by another Vector4ic and store the result in dest.
      Specified by:
      mul in interface Vector4ic
      Parameters:
      v - the other vector
      dest - will hold the result
      Returns:
      dest
    • div

      public Vector4i div(Vector4ic v)
      Divide this Vector4i component-wise by another Vector4i.
      Parameters:
      v - the vector to divide by
      Returns:
      this
    • div

      public Vector4i div(Vector4ic v, Vector4i dest)
      Description copied from interface: Vector4ic
      Divide this Vector4i component-wise by another Vector4ic and store the result in dest.
      Specified by:
      div in interface Vector4ic
      Parameters:
      v - the vector to divide by
      dest - will hold the result
      Returns:
      dest
    • mul

      public Vector4i mul(int scalar)
      Multiply all components of this Vector4i by the given scalar value.
      Parameters:
      scalar - the scalar to multiply by
      Returns:
      this
    • mul

      public Vector4i mul(int scalar, Vector4i dest)
      Description copied from interface: Vector4ic
      Multiply all components of this Vector4i by the given scalar value and store the result in dest.
      Specified by:
      mul in interface Vector4ic
      Parameters:
      scalar - the scalar to multiply by
      dest - will hold the result
      Returns:
      dest
    • div

      public Vector4i div(float scalar)
      Divide all components of this Vector3i by the given scalar value.
      Parameters:
      scalar - the scalar to divide by
      Returns:
      this
    • div

      public Vector4i div(float scalar, Vector4i dest)
      Description copied from interface: Vector4ic
      Divide all components of this Vector4i by the given scalar value and store the result in dest.
      Specified by:
      div in interface Vector4ic
      Parameters:
      scalar - the scalar to divide by
      dest - will hold the result
      Returns:
      dest
    • div

      public Vector4i div(int scalar)
      Divide all components of this Vector4i by the given scalar value.
      Parameters:
      scalar - the scalar to divide by
      Returns:
      this
    • div

      public Vector4i div(int scalar, Vector4i dest)
      Description copied from interface: Vector4ic
      Divide all components of this Vector4i by the given scalar value and store the result in dest.
      Specified by:
      div in interface Vector4ic
      Parameters:
      scalar - the scalar to divide by
      dest - will hold the result
      Returns:
      dest
    • lengthSquared

      public long lengthSquared()
      Description copied from interface: Vector4ic
      Return the length squared of this vector.
      Specified by:
      lengthSquared in interface Vector4ic
      Returns:
      the length squared
    • lengthSquared

      public static long lengthSquared(int x, int y, int z, int w)
      Get the length squared of a 4-dimensional single-precision vector.
      Parameters:
      x - The vector's x component
      y - The vector's y component
      z - The vector's z component
      w - The vector's w component
      Returns:
      the length squared of the given vector
    • length

      public double length()
      Description copied from interface: Vector4ic
      Return the length of this vector.
      Specified by:
      length in interface Vector4ic
      Returns:
      the length
    • length

      public static double length(int x, int y, int z, int w)
      Get the length of a 4-dimensional single-precision vector.
      Parameters:
      x - The vector's x component
      y - The vector's y component
      z - The vector's z component
      w - The vector's w component
      Returns:
      the length squared of the given vector
    • distance

      public double distance(Vector4ic v)
      Description copied from interface: Vector4ic
      Return the distance between this Vector and v.
      Specified by:
      distance in interface Vector4ic
      Parameters:
      v - the other vector
      Returns:
      the distance
    • distance

      public double distance(int x, int y, int z, int w)
      Description copied from interface: Vector4ic
      Return the distance between this vector and (x, y, z, w).
      Specified by:
      distance in interface Vector4ic
      Parameters:
      x - the x component of the other vector
      y - the y component of the other vector
      z - the z component of the other vector
      w - the w component of the other vector
      Returns:
      the euclidean distance
    • gridDistance

      public long gridDistance(Vector4ic v)
      Description copied from interface: Vector4ic
      Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance) (x, y).
      Specified by:
      gridDistance in interface Vector4ic
      Parameters:
      v - the other vector
      Returns:
      the grid distance
    • gridDistance

      public long gridDistance(int x, int y, int z, int w)
      Description copied from interface: Vector4ic
      Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance) (x, y).
      Specified by:
      gridDistance in interface Vector4ic
      Parameters:
      x - the x component of the other vector
      y - the y component of the other vector
      z - the z component of the other vector
      w - the w component of the other vector
      Returns:
      the grid distance
    • distanceSquared

      public int distanceSquared(Vector4ic v)
      Description copied from interface: Vector4ic
      Return the square of the distance between this vector and v.
      Specified by:
      distanceSquared in interface Vector4ic
      Parameters:
      v - the other vector
      Returns:
      the squared of the distance
    • distanceSquared

      public int distanceSquared(int x, int y, int z, int w)
      Description copied from interface: Vector4ic
      Return the square of the distance between this vector and (x, y, z, w).
      Specified by:
      distanceSquared in interface Vector4ic
      Parameters:
      x - the x component of the other vector
      y - the y component of the other vector
      z - the z component of the other vector
      w - the w component of the other vector
      Returns:
      the square of the distance
    • distance

      public static double distance(int x1, int y1, int z1, int w1, int x2, int y2, int z2, int w2)
      Return the distance between (x1, y1, z1, w1) and (x2, y2, z2, w2).
      Parameters:
      x1 - the x component of the first vector
      y1 - the y component of the first vector
      z1 - the z component of the first vector
      w1 - the w component of the first vector
      x2 - the x component of the second vector
      y2 - the y component of the second vector
      z2 - the z component of the second vector
      w2 - the 2 component of the second vector
      Returns:
      the euclidean distance
    • distanceSquared

      public static long distanceSquared(int x1, int y1, int z1, int w1, int x2, int y2, int z2, int w2)
      Return the squared distance between (x1, y1, z1, w1) and (x2, y2, z2, w2).
      Parameters:
      x1 - the x component of the first vector
      y1 - the y component of the first vector
      z1 - the z component of the first vector
      w1 - the w component of the first vector
      x2 - the x component of the second vector
      y2 - the y component of the second vector
      z2 - the z component of the second vector
      w2 - the w component of the second vector
      Returns:
      the euclidean distance squared
    • dot

      public int dot(Vector4ic v)
      Description copied from interface: Vector4ic
      Compute the dot product (inner product) of this vector and v.
      Specified by:
      dot in interface Vector4ic
      Parameters:
      v - the other vector
      Returns:
      the dot product
    • zero

      public Vector4i zero()
      Set all components to zero.
      Returns:
      this
    • negate

      public Vector4i negate()
      Negate this vector.
      Returns:
      this
    • negate

      public Vector4i negate(Vector4i dest)
      Description copied from interface: Vector4ic
      Negate this vector and store the result in dest.
      Specified by:
      negate in interface Vector4ic
      Parameters:
      dest - will hold the result
      Returns:
      dest
    • toString

      public String toString()
      Return a string representation of this vector.

      This method creates a new DecimalFormat on every invocation with the format string "0.000E0;-".

      Overrides:
      toString in class Object
      Returns:
      the string representation
    • toString

      public String toString(NumberFormat formatter)
      Return a string representation of this vector by formatting the vector components with the given NumberFormat.
      Parameters:
      formatter - the NumberFormat used to format the vector components with
      Returns:
      the string representation
    • writeExternal

      public void writeExternal(ObjectOutput out) throws IOException
      Specified by:
      writeExternal in interface Externalizable
      Throws:
      IOException
    • readExternal

      public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException
      Specified by:
      readExternal in interface Externalizable
      Throws:
      IOException
      ClassNotFoundException
    • min

      public Vector4i min(Vector4ic v)
      Set the components of this vector to be the component-wise minimum of this and the other vector.
      Parameters:
      v - the other vector
      Returns:
      this
    • min

      public Vector4i min(Vector4ic v, Vector4i dest)
      Description copied from interface: Vector4ic
      Set the components of dest to be the component-wise minimum of this and the other vector.
      Specified by:
      min in interface Vector4ic
      Parameters:
      v - the other vector
      dest - will hold the result
      Returns:
      dest
    • max

      public Vector4i max(Vector4ic v)
      Set the components of this vector to be the component-wise maximum of this and the other vector.
      Parameters:
      v - the other vector
      Returns:
      this
    • max

      public Vector4i max(Vector4ic v, Vector4i dest)
      Description copied from interface: Vector4ic
      Set the components of dest to be the component-wise maximum of this and the other vector.
      Specified by:
      max in interface Vector4ic
      Parameters:
      v - the other vector
      dest - will hold the result
      Returns:
      dest
    • absolute

      public Vector4i absolute()
      Compute the absolute of each of this vector's components.
      Returns:
      this
    • absolute

      public Vector4i absolute(Vector4i dest)
      Description copied from interface: Vector4ic
      Compute the absolute of each of this vector's components and store the result into dest.
      Specified by:
      absolute in interface Vector4ic
      Parameters:
      dest - will hold the result
      Returns:
      dest
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object
    • equals

      public boolean equals(int x, int y, int z, int w)
      Description copied from interface: Vector4ic
      Compare the vector components of this vector with the given (x, y, z, w) and return whether all of them are equal.
      Specified by:
      equals in interface Vector4ic
      Parameters:
      x - the x component to compare to
      y - the y component to compare to
      z - the z component to compare to
      w - the w component to compare to
      Returns:
      true if all the vector components are equal
    • clone

      public Object clone() throws CloneNotSupportedException
      Overrides:
      clone in class Object
      Throws:
      CloneNotSupportedException