popMatrix() / Reference / Processing.org

Name

popMatrix()

Description

Pops the current transformation matrix off the matrix stack. Understanding pushing and popping requires understanding the concept of a matrix stack. The pushMatrix() function saves the current coordinate system to the stack and popMatrix() restores the prior coordinate system. pushMatrix() and popMatrix() are used in conjunction with the other transformation functions and may be embedded to control the scope of the transformations.

Examples

```
size(400, 400);

fill(255);
rect(0, 0, 200, 200);  // White rectangle

pushMatrix();
translate(120, 80);
fill(0);  
rect(0, 0, 200, 200);  // Black rectangle
popMatrix();

fill(100);  
rect(60, 40, 200, 200);  // Gray rectangle
```