Class MatrixStack

java.lang.Object
net.minecraft.client.util.math.MatrixStack

@Environment(CLIENT) public class MatrixStack extends Object
A stack of transformation matrices used to specify how 3D objects are translated, scaled or rotated in 3D space. Each entry consists of a position matrix and its corresponding normal matrix.

By putting matrices in a stack, a transformation can be expressed relative to another. You can push, transform, render and pop, which allows you to restore the original matrix after rendering.

An entry of identity matrix is pushed when a stack is created. This means that a stack is empty if and only if the stack contains exactly one entry.

Mappings:
Namespace Name
official eaq
intermediary net/minecraft/class_4587
named net/minecraft/client/util/math/MatrixStack
  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static final class 
     
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private final Deque<MatrixStack.Entry>
     
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    Returns whether this stack contains exactly one entry.
    void
    Sets the top entry to be the identity matrix.
    void
    multiply(Quaternion quaternion)
    Applies the rotation transformation to the top entry.
    void
    Multiplies the top position matrix with the given matrix.
    Returns the entry at the top of this stack.
    void
    pop()
    Removes the entry at the top of this stack.
    void
    Pushes a copy of the top entry onto this stack.
    void
    scale(float x, float y, float z)
    Applies the scale transformation to the top entry.
    void
    translate(double x, double y, double z)
    Applies the translation transformation to the top entry.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • stack

      private final Deque<MatrixStack.Entry> stack
      Mappings:
      Namespace Name Mixin selector
      official a Leaq;a:Ljava/util/Deque;
      intermediary field_20898 Lnet/minecraft/class_4587;field_20898:Ljava/util/Deque;
      named stack Lnet/minecraft/client/util/math/MatrixStack;stack:Ljava/util/Deque;
  • Constructor Details

    • MatrixStack

      public MatrixStack()
  • Method Details

    • translate

      public void translate(double x, double y, double z)
      Applies the translation transformation to the top entry.
      Mappings:
      Namespace Name Mixin selector
      official a Leaq;a(DDD)V
      intermediary method_22904 Lnet/minecraft/class_4587;method_22904(DDD)V
      named translate Lnet/minecraft/client/util/math/MatrixStack;translate(DDD)V
    • scale

      public void scale(float x, float y, float z)
      Applies the scale transformation to the top entry.
      Implementation Note:
      This does not scale the normal matrix correctly when the scaling is uniform and the scaling factor is negative.
      Mappings:
      Namespace Name Mixin selector
      official a Leaq;a(FFF)V
      intermediary method_22905 Lnet/minecraft/class_4587;method_22905(FFF)V
      named scale Lnet/minecraft/client/util/math/MatrixStack;scale(FFF)V
    • multiply

      public void multiply(Quaternion quaternion)
      Applies the rotation transformation to the top entry.
      Mappings:
      Namespace Name Mixin selector
      official a Leaq;a(Lg;)V
      intermediary method_22907 Lnet/minecraft/class_4587;method_22907(Lnet/minecraft/class_1158;)V
      named multiply Lnet/minecraft/client/util/math/MatrixStack;multiply(Lnet/minecraft/util/math/Quaternion;)V
    • push

      public void push()
      Pushes a copy of the top entry onto this stack.
      Mappings:
      Namespace Name Mixin selector
      official a Leaq;a()V
      intermediary method_22903 Lnet/minecraft/class_4587;method_22903()V
      named push Lnet/minecraft/client/util/math/MatrixStack;push()V
    • pop

      public void pop()
      Removes the entry at the top of this stack.
      Mappings:
      Namespace Name Mixin selector
      official b Leaq;b()V
      intermediary method_22909 Lnet/minecraft/class_4587;method_22909()V
      named pop Lnet/minecraft/client/util/math/MatrixStack;pop()V
    • peek

      public MatrixStack.Entry peek()
      Returns the entry at the top of this stack.
      Returns:
      the entry at the top of this stack
      Mappings:
      Namespace Name Mixin selector
      official c Leaq;c()Leaq$a;
      intermediary method_23760 Lnet/minecraft/class_4587;method_23760()Lnet/minecraft/class_4587$class_4665;
      named peek Lnet/minecraft/client/util/math/MatrixStack;peek()Lnet/minecraft/client/util/math/MatrixStack$Entry;
    • isEmpty

      public boolean isEmpty()
      Returns whether this stack contains exactly one entry.
      Returns:
      whether this stack contains exactly one entry
      Mappings:
      Namespace Name Mixin selector
      official d Leaq;d()Z
      intermediary method_22911 Lnet/minecraft/class_4587;method_22911()Z
      named isEmpty Lnet/minecraft/client/util/math/MatrixStack;isEmpty()Z
    • loadIdentity

      public void loadIdentity()
      Sets the top entry to be the identity matrix.
      Mappings:
      Namespace Name Mixin selector
      official e Leaq;e()V
      intermediary method_34426 Lnet/minecraft/class_4587;method_34426()V
      named loadIdentity Lnet/minecraft/client/util/math/MatrixStack;loadIdentity()V
    • multiplyPositionMatrix

      public void multiplyPositionMatrix(Matrix4f matrix)
      Multiplies the top position matrix with the given matrix.

      This does not update the normal matrix unlike other transformation methods.

      Mappings:
      Namespace Name Mixin selector
      official a Leaq;a(Ld;)V
      intermediary method_34425 Lnet/minecraft/class_4587;method_34425(Lnet/minecraft/class_1159;)V
      named multiplyPositionMatrix Lnet/minecraft/client/util/math/MatrixStack;multiplyPositionMatrix(Lnet/minecraft/util/math/Matrix4f;)V