line()#

Draws a line (a direct path between two points) to the screen.

Examples#

example picture for line()

def setup():
    py5.line(30, 20, 85, 75)

example picture for line()

def setup():
    py5.line(30, 20, 85, 20)
    py5.stroke(126)
    py5.line(85, 20, 85, 75)
    py5.stroke(255)
    py5.line(85, 75, 30, 75)

example picture for line()

def setup():
    py5.size(100, 100, py5.P3D)
    # drawing lines in 3D requires P3D
    # as a parameter to size()
    py5.line(30, 20, 0, 85, 20, 15)
    py5.stroke(126)
    py5.line(85, 20, 15, 85, 75, 0)
    py5.stroke(255)
    py5.line(85, 75, 0, 30, 75, -50)

Description#

Draws a line (a direct path between two points) to the screen. The version of line() with four parameters draws the line in 2D. To color a line, use the stroke() function. A line cannot be filled, therefore the fill() function will not affect the color of a line. 2D lines are drawn with a width of one pixel by default, but this can be changed with the stroke_weight() function. The version with six parameters allows the line to be placed anywhere within XYZ space. Drawing this shape in 3D with the z parameter requires the P3D parameter in combination with size() as shown in the third example.

Underlying Processing method: line

Signatures#

line(
    x1: float,  # x-coordinate of the first point
    y1: float,  # y-coordinate of the first point
    x2: float,  # x-coordinate of the second point
    y2: float,  # y-coordinate of the second point
    /,
) -> None

line(
    x1: float,  # x-coordinate of the first point
    y1: float,  # y-coordinate of the first point
    z1: float,  # z-coordinate of the first point
    x2: float,  # x-coordinate of the second point
    y2: float,  # y-coordinate of the second point
    z2: float,  # z-coordinate of the second point
    /,
) -> None

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