PyGame Drawing Shapes: Guía Completa para Dibujar Formas Básicas

El módulo PyGame es una herramienta poderosa en Python para desarrollar juegos y aplicaciones gráficas. Entre las funciones que ofrece, la capacidad de dibujar formas geométricas básicas es esencial para dar vida a los elementos visuales de nuestros proyectos. En este tutorial, exploraremos paso a paso cómo utilizar PyGame para dibujar rectángulos, círculos, elipses, líneas y polígonos. Aprenderemos a definir colores, crear objetos pygame rect para gestionar las coordenadas y dimensiones de las formas, y a controlar el orden de dibujo para garantizar la visibilidad de nuestras creaciones.

Configurando el Entorno de Trabajo

Antes de empezar a dibujar, necesitamos configurar nuestro entorno de trabajo con PyGame. Si aún no lo has instalado, puedes hacerlo desde la terminal usando el siguiente comando:

bash
pip install pygame


Una vez instalado, podemos crear un nuevo archivo Python y empezar a escribir nuestro código.

Definiendo Colores en PyGame

PyGame utiliza el modelo RGB (Red, Green, Blue) para definir colores. Cada color se representa como una tupla de tres valores, donde cada valor representa la intensidad del componente rojo, verde o azul, respectivamente. Los valores van de 0 a 255, donde 0 representa la ausencia de ese color y 255 su máxima intensidad.

Por ejemplo, para definir el color rojo puro, usaríamos la tupla (255, 0, 0). Para el verde puro, usaríamos (0, 255, 0), y para el azul puro, (0, 0, 255). Podemos combinar estos valores para crear una amplia gama de colores, como el amarillo ((255, 255, 0)) o el magenta ((255, 0, 255)).

PyGame Draw Rect Example: Dibujando Rectángulos

El rectángulo es una de las formas más básicas en geometría, y PyGame ofrece la función pygame.draw.rect() para dibujarlo en la pantalla. Esta función toma como argumentos:

• La superficie donde se dibuja el rectángulo (generalmente la pantalla).
• El color del rectángulo, definido como una tupla RGB.
• Una tupla que define las coordenadas del rectángulo (x, y).
• Dos valores que representan el ancho y la altura del rectángulo.
• Un valor opcional para el grosor del borde del rectángulo. Si se omite, se rellena completamente.

«`python
import pygame

pygame.init()

Define el tamaño de la ventana

screenwidth = 600
screenheight = 400
screen = pygame.display.setmode((screenwidth, screen_height))

Define el color rojo

red = (255, 0, 0)

Dibuja un rectángulo rojo en la pantalla

pygame.draw.rect(screen, red, (100, 100, 200, 100))

Actualiza la pantalla

pygame.display.flip()

Mantiene la ventana abierta hasta que se cierre

running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False

pygame.quit()
«`

En este código, primero importamos el módulo pygame y lo inicializamos. Luego, definimos las dimensiones de la ventana y creamos la superficie de dibujo. A continuación, definimos el color rojo y finalmente usamos pygame.draw.rect() para dibujar el rectángulo. El último paso consiste en actualizar la pantalla para mostrar el resultado y manejar el evento de cierre de la ventana.

PyGame Shapes: Más allá del Rectángulo

PyGame ofrece funciones para dibujar otras formas geométricas básicas además del rectángulo. Estas incluyen:

• pygame.draw.circle(): Para dibujar círculos.
• pygame.draw.ellipse(): Para dibujar elipses (incluyendo círculos como caso especial).
• pygame.draw.line(): Para dibujar líneas.
• pygame.draw.polygon(): Para dibujar polígonos de cualquier forma.

Dibujando Círculos con pygame.draw.circle()

La función pygame.draw.circle() es similar a pygame.draw.rect() en cuanto a sus argumentos:

• La superficie donde se dibuja el círculo.
• El color del círculo.
• Una tupla que define las coordenadas del centro del círculo (x, y).
• El radio del círculo.
• Un valor opcional para el grosor del borde del círculo. Si se omite, se rellena completamente.

«`python
import pygame

pygame.init()

Define el tamaño de la ventana

screenwidth = 600
screenheight = 400
screen = pygame.display.setmode((screenwidth, screen_height))

Define el color azul

blue = (0, 0, 255)

Dibuja un círculo azul en la pantalla

pygame.draw.circle(screen, blue, (300, 200), 50)

Actualiza la pantalla

pygame.display.flip()

Mantiene la ventana abierta hasta que se cierre

running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False

pygame.quit()
«`

En este código, dibujamos un círculo azul con centro en (300, 200) y un radio de 50 píxeles.

Dibujando Elipses con pygame.draw.ellipse()

Para dibujar elipses, se utiliza la función pygame.draw.ellipse(). Esta función toma como argumentos:

• La superficie donde se dibuja la elipse.
• El color de la elipse.
• Un rectángulo que define la zona de la elipse (x, y, ancho, alto).
• Un valor opcional para el grosor del borde de la elipse. Si se omite, se rellena completamente.

«`python
import pygame

pygame.init()

Define el tamaño de la ventana

screenwidth = 600
screenheight = 400
screen = pygame.display.setmode((screenwidth, screen_height))

Define el color verde

green = (0, 255, 0)

Dibuja una elipse verde en la pantalla

pygame.draw.ellipse(screen, green, (100, 100, 200, 100))

Actualiza la pantalla

pygame.display.flip()

Mantiene la ventana abierta hasta que se cierre

running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False

pygame.quit()
«`

En este código, dibujamos una elipse verde dentro de un rectángulo con coordenadas (100, 100), ancho 200 y alto 100.

pygame.draw.line(): Dibujando Líneas

La función pygame.draw.line() permite dibujar líneas rectas en la pantalla. Toma como argumentos:

• La superficie donde se dibuja la línea.
• El color de la línea.
• Las coordenadas del punto de inicio de la línea (x1, y1).
• Las coordenadas del punto final de la línea (x2, y2).
• Un valor opcional para el grosor de la línea. Si se omite, el grosor es 1 píxel.

«`python
import pygame

pygame.init()

Define el tamaño de la ventana

screenwidth = 600
screenheight = 400
screen = pygame.display.setmode((screenwidth, screen_height))

Define el color amarillo

yellow = (255, 255, 0)

Dibuja una línea amarilla en la pantalla

pygame.draw.line(screen, yellow, (0, 0), (screenwidth, screenheight), 5)

Actualiza la pantalla

pygame.display.flip()

Mantiene la ventana abierta hasta que se cierre

running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False

pygame.quit()
«`

En este código, dibujamos una línea amarilla que va del punto (0, 0) al punto (screenwidth, screenheight), con un grosor de 5 píxeles.

pygame.draw.polygon(): Dibujando Polígonos

Para dibujar polígonos de cualquier forma, utilizamos la función pygame.draw.polygon(). Esta función toma como argumentos:

• La superficie donde se dibuja el polígono.
• El color del polígono.
• Una lista de tuplas que definen las coordenadas de los vértices del polígono.
• Un valor opcional para el grosor del borde del polígono. Si se omite, se rellena completamente.

«`python
import pygame

pygame.init()

Define el tamaño de la ventana

screenwidth = 600
screenheight = 400
screen = pygame.display.setmode((screenwidth, screen_height))

Define el color magenta

magenta = (255, 0, 255)

Define las coordenadas de los vértices del triángulo

vertices = [(100, 100), (200, 100), (150, 200)]

Dibuja un triángulo magenta en la pantalla

pygame.draw.polygon(screen, magenta, vertices)

Actualiza la pantalla

pygame.display.flip()

Mantiene la ventana abierta hasta que se cierre

running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False

pygame.quit()
«`

En este código, dibujamos un triángulo magenta con los vértices en las coordenadas especificadas.

How to Draw a Rectangle in Pygame: Usando Objetos pygame.Rect

Para gestionar las coordenadas y dimensiones de las formas, PyGame ofrece la clase pygame.Rect. Un objeto pygame.Rect representa un rectángulo con atributos como su posición (x, y), ancho, alto, y su área total.

Para crear un objeto pygame.Rect, podemos pasarle una tupla que define las coordenadas (x, y), el ancho y la altura:

«`python

Crea un objeto Rect con las coordenadas (100, 100), ancho 200, alto 100

rect = pygame.Rect(100, 100, 200, 100)
«`

Una vez creado el objeto pygame.Rect, podemos utilizarlo como argumento para las funciones de dibujo:

«`python
import pygame

pygame.init()

Define el tamaño de la ventana

screenwidth = 600
screenheight = 400
screen = pygame.display.setmode((screenwidth, screen_height))

Define el color rojo

red = (255, 0, 0)

Crea un objeto Rect para el rectángulo

rect = pygame.Rect(100, 100, 200, 100)

Dibuja el rectángulo usando el objeto Rect

pygame.draw.rect(screen, red, rect)

Actualiza la pantalla

pygame.display.flip()

Mantiene la ventana abierta hasta que se cierre

running = True
while running:
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False

pygame.quit()
«`

En este código, creamos un objeto pygame.Rect para representar el rectángulo y lo usamos como argumento para pygame.draw.rect().

Controlando el Orden de Dibujo

Es importante tener en cuenta que el orden en que se dibujan las formas afecta a su visibilidad. La última forma dibujada será la que se vea en primer plano. Por ejemplo, si dibujamos un rectángulo y luego un círculo que lo interseca, el círculo ocultará la parte del rectángulo que está debajo.

Pygame Polygon: Atributos y Métodos de pygame.Rect

Los objetos pygame.Rect tienen varios atributos y métodos útiles para manipulación y detección de colisiones en juegos.

• rect.x y rect.y: Representan las coordenadas del punto superior izquierdo del rectángulo.
• rect.width y rect.height: Representan el ancho y la altura del rectángulo.
• rect.center: Representa las coordenadas del centro del rectángulo como una tupla.
• rect.move(x, y): Mueve el rectángulo a una nueva posición.
• rect.move_ip(x, y): Mueve el rectángulo en su lugar.
• rect.collidepoint(x, y): Devuelve True si el punto (x, y) está dentro del rectángulo.
• rect.colliderect(other_rect): Devuelve True si el rectángulo colisiona con otro rectángulo.

Actividades para Practicar

1. Crea un cuadrado con un círculo en su interior. Puedes usar los objetos pygame.Rect y pygame.draw.circle().
2. Dibuja un triángulo isósceles con una línea horizontal que lo divide en dos.
3. Crea un fondo con un patrón de líneas horizontales.

Conclusión

Este tutorial te ha introducido al mundo del dibujo con PyGame. Has aprendido cómo definir colores, dibujar rectángulos, círculos, elipses, líneas y polígonos. También has aprendido a usar objetos pygame.Rect para gestionar las coordenadas y dimensiones de las formas. Ahora tienes las herramientas para crear tus propios diseños y figuras geométricas en tus juegos y aplicaciones.