Py5Shape.set_vertex()

Py5Shape.set_vertex()#

The set_vertex() method defines the coordinates of the vertex point located at the position defined by the index parameter.

Examples#

def setup():
    global s
    s = py5.create_shape()
    with s.begin_closed_shape():
        s.vertex(0, 0)
        s.vertex(60, 0)
        s.vertex(60, 60)
        s.vertex(0, 60)


def draw():
    py5.translate(20, 20)
    for i in range(0, s.get_vertex_count()):
        v = s.get_vertex(i)
        v.x += py5.random(-1, 1)
        v.y += py5.random(-1, 1)
        s.set_vertex(i, v)

    py5.shape(s)

Description#

The set_vertex() method defines the coordinates of the vertex point located at the position defined by the index parameter. This method works when shapes are created as shown in the example, but won’t work properly when a shape is defined explicitly (e.g. create_shape(RECT, 20, 20, 80, 80).

This method can only be used outside the Py5Shape.begin_shape() and Py5Shape.end_shape() methods.

Underlying Processing method: PShape.setVertex

Signatures#

set_vertex(
    index: int,  # the location of the vertex
    vec: Py5Vector,  # the vector to define the x, y, z coordinates
    /,
) -> None

set_vertex(
    index: int,  # the location of the vertex
    x: float,  # the x value for the vertex
    y: float,  # the y value for the vertex
    /,
) -> None

set_vertex(
    index: int,  # the location of the vertex
    x: float,  # the x value for the vertex
    y: float,  # the y value for the vertex
    z: float,  # the z value for the vertex
    /,
) -> None

Updated on October 12, 2026 17:24:20pm UTC