scale()

scale()#

Increases or decreases the size of a shape by expanding and contracting vertices.

Examples#

example picture for scale()

def setup():
    py5.rect(30, 20, 50, 50)
    py5.scale(0.5)
    py5.rect(30, 20, 50, 50)

example picture for scale()

def setup():
    py5.rect(30, 20, 50, 50)
    py5.scale(0.5, 1.3)
    py5.rect(30, 20, 50, 50)

example picture for scale()

def setup():
    py5.size(100, 100, py5.P3D)
    # scaling in 3D requires P3D
    # as a parameter to size()
    py5.no_fill()
    py5.translate(py5.width//2+12, py5.height//2)
    py5.box(20, 20, 20)
    py5.scale(2.5, 2.5, 2.5)
    py5.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 function with the z parameter requires using P3D as a parameter for size(), as shown in the third example. This function can be further controlled with push_matrix() and pop_matrix().

Underlying Processing method: scale

Signatures#

scale(
    s: float,  # percentage to scale the object
    /,
) -> None

scale(
    x: float,  # percentage to scale the object in the x-axis
    y: float,  # percentage to scale the object in the y-axis
    /,
) -> None

scale(
    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
    /,
) -> None

Updated on March 06, 2023 02:49:26am UTC

Contents