scale() / Reference / Processing.org

Name

scale()

Class

PShape

Description

Increases or decreases the size of a shape by expanding and contracting vertices. Shapes always scale from the relative origin of their bounding box. Scale values are specified as decimal percentages. For example, the method call scale(2.0) increases the dimension of a shape by 200%. Subsequent calls to the method multiply the effect. For example, calling scale(2.0) and then scale(1.5) is the same as scale(3.0). This transformation is applied directly to the shape, it's not refreshed each time draw() is run.

Using this method with the z parameter requires using the P3D parameter in combination with size.

Examples

PShape s;

void setup() {
  s = loadShape("bot.svg");
}

void draw() {
  background(204);
  shape(s);
}

void mousePressed() {
  // Shrink the shape 90% each time the mouse is pressed
  s.scale(0.9);  
}

Syntax

sh.scale(s)
sh.scale(x, y)
sh.scale(x, y, z)

Parameters

sh(PShape) any variable of type PShape
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

Return

void

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.