Interface PMatrix

core/src/processing/core/PMatrix.java:37–208

A matrix is used to define graphical transformations. PMatrix is the common interface for both the 2D and 3D matrix classes in Processing. A matrix is a grid of numbers, which can be multiplied by a vector to give another vector. Multiplying a point by a particular matrix might translate it, rotate

 * {@code apply} and {@code preApply} methods for this.
 */
public interface PMatrix {
  
  /**
   * Make this an identity matrix. Multiplying by it will have no effect.
   */
  public void reset();
  
  /**
   * Returns a copy of this PMatrix.
   */
  public PMatrix get();  

  /**
   * Copies the matrix contents into a float array.
   * If target is null (or not the correct size), a new array will be created.
   */
  public float[] get(float[] target);
  
  
  /**
   * Make this matrix become a copy of src.
   */
  public void set(PMatrix src);

  /**
   * Set the contents of this matrix to the contents of source. Fills the
   * matrix left-to-right, starting in the top row.
   */
  public void set(float[] source);

  /**
   * Set the matrix content to this 2D matrix or its 3D equivalent.
   */
  public void set(float m00, float m01, float m02, 
                  float m10, float m11, float m12);

  /**
   * Set the matrix content to the 3D matrix supplied, if this matrix is 3D.
   */
  public void set(float m00, float m01, float m02, float m03,
                  float m10, float m11, float m12, float m13,
                  float m20, float m21, float m22, float m23,
                  float m30, float m31, float m32, float m33);

  
  public void translate(float tx, float ty);
  
  public void translate(float tx, float ty, float tz);

  public void rotate(float angle);

  public void rotateX(float angle);

  public void rotateY(float angle);

  public void rotateZ(float angle);

  public void rotate(float angle, float v0, float v1, float v2);