```
public class MatrixHandler
extends Object
```
The matrix handler specifies (and implements) various matrix operations needed by the Graph to properly perform its geometry transformations.
To emit the transform() matrix to a shader override the _setUniforms() signal, which is fired automatically by the handler every time one of its matrices change state. See also projection(), view() and model().
To bind a Graph object to a third party renderer (i.e., that renderer provides its own matrix handling: matrix transformations, shader uniforms transfers, etc), refer to the bind(Matrix, Matrix) documentation.

Field Summary

Fields
Modifier and Type Field Description

static String ERROR_PUSHMATRIX_OVERFLOW

static String ERROR_PUSHMATRIX_UNDERFLOW

static int STACK_DEPTH

Constructor Summary

Constructors
Constructor Description

MatrixHandler()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`applyMatrix(Matrix source)`	Multiplies the current `model()` matrix by the one specified through the parameters.
`void`	`applyProjection(Matrix source)`	Multiplies the current `projection()` matrix by the one specified through the parameters.
`void`	`applyTransformation(Node node)`	Apply the local transformation defined by `node`, i.e., respect to its `Node.reference()`.
`void`	`applyWorldTransformation(Node node)`	Similar to `applyTransformation(Node)`, but applies the global transformation defined by the `node`.
`void`	`beginHUD(int width, int height)`	Begins Heads Up Display (HUD).
`void`	`bind(Matrix projection, Matrix view)`	Updates the `projection()`, `view()` and `model()` matrices and call `_setUniforms()`.
`void`	`endHUD()`	Ends Heads Up Display (HUD).
`Matrix`	`model()`	Returns the model matrix.
`Matrix`	`modelview()`	Same as `return Matrix.multiply(view(), model())`.
`void`	`popMatrix()`	Replace the current `model()` matrix with the top of the stack.
`void`	`popProjection()`	Replace the current `projection()` matrix with the top of the stack.
`Matrix`	`projection()`	Returns the projection matrix.
`void`	`pushMatrix()`	Push a copy of the `model()` matrix onto the stack.
`void`	`pushProjection()`	Push a copy of the `projection()` matrix onto the stack.
`void`	`rotate(float angle)`	Rotate around the Z axis.
`void`	`rotate(float angle, float v0, float v1, float v2)`	Rotate about a vector in space.
`void`	`scale(float sx, float sy)`	Scale in X and Y.
`void`	`scale(float sx, float sy, float sz)`	Scale in X, Y, and Z.
`Matrix`	`transform()`	Returns `projection()` times `modelview()`.
`void`	`translate(float x, float y)`	Translate in X and Y.
`void`	`translate(float x, float y, float z)`	Translate in X, Y, and Z.
`Matrix`	`view()`	Returns the view matrix.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - STACK_DEPTH
```
public static int STACK_DEPTH
```
  - ERROR_PUSHMATRIX_OVERFLOW
```
public static String ERROR_PUSHMATRIX_OVERFLOW
```
  - ERROR_PUSHMATRIX_UNDERFLOW
```
public static String ERROR_PUSHMATRIX_UNDERFLOW
```
- Constructor Detail
  - MatrixHandler
```
public MatrixHandler()
```
- Method Detail
  - bind
```
public void bind(Matrix projection,
                 Matrix view)
```
    Updates the projection(), view() and model() matrices and call _setUniforms(). This method is automatically called by Graph.render() right at the beginning of the main event loop.
    If this matrix handler is bound to a third party renderer (i.e., that renderer provides its own matrix matrix handling: matrix transformations, shader uniforms transfers, etc.) override this method together with: _bindProjection(Matrix), _bindMatrix(Matrix), model(), modelview(), applyMatrix(Matrix), pushMatrix(), popMatrix(), translate(float, float, float), rotate(float), rotate(float, float, float, float), scale(float, float, float), projection(), _bindProjection(Matrix), applyProjection(Matrix), pushProjection() and popProjection() by implementing them in terms of that renderer.
    
    See Also:
    
    Graph.render(), Node.view()
  - projection
```
public Matrix projection()
```
    Returns the projection matrix.
    
    See Also:
    
    view(), model(), modelview(), transform()
  - view
```
public Matrix view()
```
    Returns the view matrix.
    
    See Also:
    
    projection(), model(), modelview(), transform()
  - model
```
public Matrix model()
```
    Returns the model matrix.
    
    See Also:
    
    projection(), view(), modelview(), transform()
  - modelview
```
public Matrix modelview()
```
    Same as return Matrix.multiply(view(), model()).
    
    See Also:
    
    projection(), view(), model(), transform()
  - transform
```
public Matrix transform()
```
    Returns projection() times modelview().
    
    See Also:
    
    projection(), view(), model(), modelview()
  - applyMatrix
```
public void applyMatrix(Matrix source)
```
    Multiplies the current model() matrix by the one specified through the parameters. Calls _setUniforms().
  - applyProjection
```
public void applyProjection(Matrix source)
```
    Multiplies the current projection() matrix by the one specified through the parameters. Calls _setUniforms().
  - pushMatrix
```
public void pushMatrix()
```
    Push a copy of the model() matrix onto the stack.
  - popMatrix
```
public void popMatrix()
```
    Replace the current model() matrix with the top of the stack. Calls _setUniforms().
  - translate
```
public void translate(float x,
                      float y,
                      float z)
```
    Translate in X, Y, and Z. Calls _setUniforms().
  - rotate
```
public void rotate(float angle)
```
    Rotate around the Z axis. Calls _setUniforms().
  - rotate
```
public void rotate(float angle,
                   float v0,
                   float v1,
                   float v2)
```
    Rotate about a vector in space. Calls _setUniforms().
  - scale
```
public void scale(float sx,
                  float sy,
                  float sz)
```
    Scale in X, Y, and Z. Calls _setUniforms().
  - pushProjection
```
public void pushProjection()
```
    Push a copy of the projection() matrix onto the stack.
  - popProjection
```
public void popProjection()
```
    Replace the current projection() matrix with the top of the stack. Calls _setUniforms().
  - beginHUD
```
public void beginHUD(int width,
                     int height)
```
    Begins Heads Up Display (HUD).
    Binds Matrix.hudProjection(width, height) and Matrix.hudView(width, height) so that so that drawing can be done using 2D screen coordinates. Calls _setUniforms().
    
    See Also:
    
    endHUD(), Matrix.hudProjection(int, int), Matrix.hudView(int, int)
  - endHUD
```
public void endHUD()
```
    Ends Heads Up Display (HUD).
    Restores the projection() and model() matrices. See beginHUD(int, int) for details.
    
    See Also:
    
    beginHUD(int, int)
  - applyTransformation
```
public void applyTransformation(Node node)
```
    Apply the local transformation defined by node, i.e., respect to its Node.reference(). The node is first translated, then rotated around the new translated origin and then scaled.
  - applyWorldTransformation
```
public void applyWorldTransformation(Node node)
```
    Similar to applyTransformation(Node), but applies the global transformation defined by the node.
  - translate
```
public void translate(float x,
                      float y)
```
    Translate in X and Y.
  - scale
```
public void scale(float sx,
                  float sy)
```
    Scale in X and Y. Equivalent to scale(sx, sy, 1).
    Not recommended for use in 3D, because the z-dimension is just scaled by 1, since there's no way to know what else to scale it by.

Modifier and Type	Field	Description
`static String`	`ERROR_PUSHMATRIX_OVERFLOW`
`static String`	`ERROR_PUSHMATRIX_UNDERFLOW`
`static int`	`STACK_DEPTH`

Class MatrixHandler

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

STACK_DEPTH

ERROR_PUSHMATRIX_OVERFLOW

ERROR_PUSHMATRIX_UNDERFLOW

Constructor Detail

MatrixHandler

Method Detail

bind

projection

view

model

modelview

transform

applyMatrix

applyProjection

pushMatrix

popMatrix

translate

rotate

rotate

scale

pushProjection

popProjection

beginHUD

endHUD

applyTransformation

applyWorldTransformation

translate

scale