This reference is for Processing 2.0+. If you have a previous version, use the reference included with your software. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Javadoc.

Name | ### scale()
Examples |
    rect(30, 20, 50, 50);
    scale(0.5);
    rect(30, 20, 50, 50);
    rect(30, 20, 50, 50);
    scale(0.5, 1.3);
    rect(30, 20, 50, 50);
    // Scaling in 3D requires P3D
    // as a parameter to size()
    size(100, 100, P3D);
    noFill();
    translate(width/2+12, height/2);
    box(20, 20, 20);
    scale(2.5, 2.5, 2.5);
    box(20, 20, 20);
Description | Increases or decreases the size of a shape by expanding and contracting vertices. Objects always scale from their relative origin to the coordinate system. Scale values are specified as decimal percentages. For example, the function call scale(2.0) increases the dimension of a shape by 200%. Transformations apply to everything that happens after and subsequent calls to the function multiply the effect. For example, calling scale(2.0) and then scale(1.5) is the same as scale(3.0). If scale() is called within draw(), the transformation is reset when the loop begins again. Using this fuction with the z parameter requires using P3D as a parameter for size(), as shown in the third example above. This function can be further controlled with pushMatrix() and popMatrix().
Syntax |
    scale(s)
    scale(x, y)
    scale(x, y, z)
Parameters |
s | float: percentage to scale the object
x | float: percentage to scale the object in the x-axis
y | float: percentage to scale the object in the y-axis
z | float: percentage to scale the object in the z-axis
Returns | void
Related | pushMatrix() popMatrix() translate() rotate() rotateX() rotateY() rotateZ()

Updated on May 19, 2014 05:30:01pm PDT