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) 
```

University of Michigan - Ann Arbor

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

Drawing Shapes in Pygame

Pygame Documentation

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

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) 
```

Learn Before

Related