line()

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

Examples

example picture for line()
1
2
def setup():
    py5.line(30, 20, 85, 75)
example picture for line()
1
2
3
4
5
6
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()
1
2
3
4
5
6
7
8
9
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 Java method: line

Syntax

line(x1: float, y1: float, x2: float, y2: float, /) -> None
line(x1: float, y1: float, z1: float, x2: float, y2: float, z2: float, /) -> None

Parameters

  • x1: float - x-coordinate of the first point

  • x2: float - x-coordinate of the second point

  • y1: float - y-coordinate of the first point

  • y2: float - y-coordinate of the second point

  • z1: float - z-coordinate of the first point

  • z2: float - z-coordinate of the second point

Updated on September 11, 2021 16:51:34pm UTC