The draw.rect() function allows you to draw a rectangle. The function takes in the surface, color, rectangle object, and optional width. The width is used to determine line thickness or if the rectangle should be filled. When the width is 0, the rectangle will be filled. If it's greater than 0, it will determine the thickness of the line. If it's less than 0, nothing will be drawn.
```Python
displaySurface = pygame.display.set_mode((1920, 1080))
displayColor = (0, 0, 0)
rectangle = (400, 400, 50, 25) #this rectangle is 400 by 400 pixels and drawn on coordinates (50, 25)
width = 0
pygame.draw.rect(displaySurface, displayColor, rect, width)
```

Drawing Rectangles in Pygame

The draw.polygon() function allows you to draw a polygon. The function takes in the surface, color, tuple or list of 3 or more xy coordinates for the vertices, and optional width. The width is used to determine line thickness or if the polygon should be filled. When the width is 0, the polygon will be filled. If it's greater than 0, it will determine the thickness of the line. If it's less than 0, nothing will be drawn.
```Python
displaySurface = pygame.display.set_mode((1920, 1080))
displayColor = (0, 0, 0)
vertices = [(x1, y1), (x2, y2), (x3, y3)]
width = 0
pygame.draw.polygon(displaySurface, displayColor, vertices, width)
```

Drawing Polygons in Pygame

The draw.circle() function allows you to draw a circle. The function takes in the surface, color, tuple for the xy coordinates of the center, int or float value for the radius measured from the center coordinates, and optional width. The width is used to determine line thickness or if the circle should be filled. When the width is 0, the circle will be filled. If it's greater than 0, it will determine the thickness of the line. If it's less than 0, nothing will be drawn.
```Python
displaySurface = pygame.display.set_mode((1920, 1080))
displayColor = (0, 0, 0)
center = (x, y)
radius = 3
width = 0
pygame.draw.circle(displaySurface, displayColor, center, radius, width)
```

Drawing Circles in Pygame

The draw.ellipse() function allows you to draw an ellipse. The function takes in the surface, color, rectangle that will bound the ellipse, 
and optional width. The width is used to determine line thickness or if the ellipse should be filled.
When the width is 0, the ellipse will be filled. If it's greater than 0, it will determine the thickness of the line. If it's less than 0, nothing will be drawn.
```Python
displaySurface = pygame.display.set_mode((1920, 1080))
displayColor = (0, 0, 0)
rect = pygame.Rect(30, 30, 60, 60)
width = 0
#the ellipse will be contained inside the rectangle stored in rect variable
pygame.draw.circle(displaySurface, displayColor, rect, width) 
```

Drawing Ellipses in PyGame

The draw.arc() function allows you to draw an arc based on an ellipse. The function takes in the surface, color, rectangle that will bound the ellipse the arc is based on, two floats for the start and stop angles in radians,
and optional width. The width is used to determine line thickness or if the arc should be filled.
When the width is 0, the arc will be filled. If it's greater than 0, it will determine the thickness of the line. If it's less than 0, nothing will be drawn.
```Python
displaySurface = pygame.display.set_mode((1920, 1080))
displayColor = (0, 0, 0)
rect = pygame.Rect(30, 30, 60, 60)
start_angle = 25 
stop_angle = 45
width = 0
pygame.draw.arc(displaySurface, displayColor, rect, start_angle, stop_angle, width) 
```

Drawing Arcs in Pygame

The draw.line() function allows you to draw a line from a start point to an endpoint. The function takes in the surface, color, tuple storing the xy coordinates for the start position, another tuple for the end position, 
and optional width. The width is used to determine line thickness, starting at 1. If the width is less than 1, the line will not be drawn.
```Python
displaySurface = pygame.display.set_mode((1920, 1080))
displayColor = (0, 0, 0)
start_pos = (10, 10)
end_pos = (20, 20)
width = 1
pygame.draw.arc(displaySurface, displayColor, start_pos, end_pos, width) 
```

Drawing Lines in Pygame

You can draw the following shapes with the pygame.draw module:
- Rectangles
- Polygons
- Circles
- Ellipses
- Arcs
- Lines

University of Michigan - Ann Arbor

There a multitude of shapes you can draw with pygame. You specify attributes of the shape like color, size, coordinates for the position, and which surface to draw the shape on. All the drawing functions will take in a color parameter that can be a pygame.Color object, an RGB tuple/list, RGBA tuple/list, or an integer value that has been mapped to the surface's pixel format.

Learn Before

Related

Learn After