De la Idea al Píxel: Cómo Implementar el Acotamiento de Cámara Usando Min y Max en Python

python dev.to

En la primera parte de nuestro tutorial aprendimos a alinear los elementos de nuestro mundo usando operaciones aritméticas básicas. Hoy daremos el siguiente paso lógico y práctico.

Cuando creamos videojuegos en 2D con mapas basados en cuadrículas (tiles), queremos que la cámara siga al jugador. Pero, ¿qué pasa cuando el jugador se acerca a los bordes del nivel? Sin el control adecuado, la cámara se movería de más, mostrando un fondo vacío o el "vacío" del espacio de la ventana.

Para solucionar esto de forma elegante, utilizamos una técnica matemática llamada acotamiento o clamping.

El Reto Espacial
Imaginemos que tenemos una pantalla con una resolución fija y un mapa que es mucho más grande que dicha pantalla.

Para centrar a nuestro personaje, calculamos un desplazamiento (offset) ideal. Sin embargo, este offset puede salirse de los límites permitidos. Para evitarlo, encerramos nuestro cálculo entre los valores mínimos y máximos que puede tomar la cámara en el mundo.

El Modelo Matemático
Para acotar el valor de la cámara, combinamos las funciones min() y max(). La ecuación general que aplicamos es:

Offset_final = max(Límite_Inferior, min(Límite_Superior, Offset_ideal))

Implementación en el Código
En nuestro script, primero calculamos el tamaño total del mapa en píxeles multiplicando el número de celdas (tiles) por su dimensión:

# El ancho y alto total del mapa en píxeles
map_width_pixels = len(store.nivel_mapa[0]) * store.TILE_SIZE
map_height_pixels = len(store.nivel_mapa) * store.TILE_SIZE
Enter fullscreen mode Exit fullscreen mode

Una vez que tenemos el tamaño del mapa, determinamos los límites del desplazamiento. Por ejemplo, en el eje X, el límite superior no puede ser mayor a cero (de lo contrario, veríamos el fondo a la izquierda de nuestro mapa) y el límite inferior se obtiene restando el ancho de la ventana menos el ancho del mapa.

# Límites del desplazamiento de la cámara para X
max_offset_x = 0
min_offset_x = store.SCREEN_WIDTH - map_width_pixels
Enter fullscreen mode Exit fullscreen mode

Finalmente, calculamos la posición ideal para centrar a nuestro personaje y aplicamos la función matemática de acotamiento:

# Posición ideal de la cámara para centrar a Mario
ideal_camera_x_offset = int(store.SCREEN_WIDTH / 2 - mario_world_center_x)


# Aplicación del límite
store.camera_x_offset = max(min_offset_x, min(max_offset_x, ideal_camera_x_offset))
Enter fullscreen mode Exit fullscreen mode

Nota: Este mismo bloque se aplica para el eje Y, intercambiando las variables correspondientes a la altura.

Conclusión
Con estas sencillas líneas de código, hemos logrado un movimiento de cámara fluido, evitando que se muestren áreas fuera de los límites del nivel. ¡Un paso más para lograr que nuestro juego se vea profesional y pulido!

Si no leíste la primera parte del tutorial:


Ejemplo de nuestro video explicando este proceso:
(Próximamente en Youtube).
Por mientras, puedes visitar mi canal para aprender Ren'Py:

Coding Cuddles - YouTube

Turn your stories into video games! 🎮✨ Have you ever dreamed of creating your own visual novel or an amazing game, but the code intimidates you a little? You're in the right place! Here, we demystify programming. With Ren'Py and Python, we'll learn from scratch (yes, from "Hello World") to creating amazing mechanics, vibrant characters, and unique systems. No boring language, just lots of patience and, above all, tons of fun! Subscribe and let's start writing the code for your next big hit. Your developer adventure starts today! 🚀 ❤️███████▓▒ IMPORTANT NOTICE ░▒▓████████❤️ "This tutorial has been a labor of love. I've used AI tools (Google AI/Gemini) to bring my protagonist's voice to life and generate visual and audio resources that allow me to focus on what I love most: teaching you programming. AI is my assistant, but the heart and structure of this course are my own. Thank you for being part of this dream!"

favicon youtube.com

Si te ha resultado útil este artículo, recuerda dejar tu reacción y compartirlo. ¡Nos vemos en el próximo tutorial!

Source: dev.to

arrow_back Back to Tutorials