# line()¶

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

## Examples¶ ```1 2``` ```def setup(): py5.line(30, 20, 85, 75) ``` ```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) ``` ```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