utils.utils

  1"""
  2utils.py
  3
  4Módulo de utilidades para el juego Freddy's Family Diner.
  5
  6Funciones incluidas:
  7- resource_path(): Resuelve rutas absolutas para recursos.
  8- limpiar_pantalla(): Limpia la consola.
  9- reproducir_sonido(): Reproduce sonidos con Pygame.
 10- cargar_plantilla_archivo(): Carga plantillas de las cámaras.
 11"""
 12
 13import os
 14import sys
 15import warnings
 16import core.config as estado
 17
 18# ---------------------- CONFIGURACIÓN INICIAL ---------------------- #
 19os.environ['PYGAME_HIDE_SUPPORT_PROMPT'] = "hide"
 20warnings.filterwarnings("ignore", category=UserWarning)
 21import pygame
 22pygame.init()
 23
 24
 25def resource_path(relative_path):
 26    """
 27    Resuelve la ruta absoluta a un recurso, compatible con PyInstaller.
 28
 29    Args:
 30        relative_path (str): Ruta relativa al archivo.
 31
 32    Returns:
 33        str: Ruta absoluta al recurso.
 34    """
 35    if hasattr(sys, '_MEIPASS'):
 36        return os.path.join(sys._MEIPASS, relative_path)
 37    return os.path.join(os.path.abspath("."), relative_path)
 38
 39
 40def limpiar_pantalla():
 41    """
 42    Limpia la pantalla de la consola, compatible con Windows y Unix.
 43    """
 44    os.system('cls' if os.name == 'nt' else 'clear')
 45
 46
 47def reproducir_sonido(archivo, canal=None):
 48    """
 49    Reproduce un sonido desde el archivo especificado.
 50
 51    Args:
 52        archivo (str): Nombre del archivo de sonido.
 53        canal (pygame.mixer.Channel, opcional): Canal específico para reproducir el sonido.
 54    """
 55    try:
 56        ruta = resource_path(
 57            os.path.join(estado.config.get("carpeta_sonidos", ""), archivo)
 58        )
 59        if not os.path.isfile(ruta):
 60            print(f"[WARNING] Archivo de sonido no encontrado: {ruta}")
 61            return
 62
 63        sonido = pygame.mixer.Sound(ruta)
 64        if canal:
 65            canal.play(sonido)
 66        else:
 67            pygame.mixer.music.load(ruta)
 68            pygame.mixer.music.play()
 69    except Exception as e:
 70        print(f"[ERROR] No se pudo reproducir {archivo}: {e}")
 71
 72
 73def cargar_plantilla_archivo(camara_num, anim_presentes):
 74    """
 75    Carga la plantilla de texto de una cámara según los animatrónicos presentes.
 76
 77    Args:
 78        camara_num (int): Número de la cámara a cargar.
 79        anim_presentes (list of str): Lista de nombres de animatrónicos presentes.
 80
 81    Returns:
 82        list of str: Líneas leídas del archivo de plantilla.
 83    """
 84    carpeta_base = estado.config.get("carpeta_rooms", "")
 85    carpeta = os.path.join(carpeta_base, f"CAM_{str(camara_num).zfill(2)}")
 86
 87    if not anim_presentes:
 88        combinacion = "EMPTY"
 89    else:
 90        combinacion = "_".join(sorted(anim_presentes))
 91
 92    ruta = os.path.join(carpeta, f"{combinacion}.txt")
 93    if not os.path.isfile(ruta):
 94        ruta = os.path.join(carpeta, "EMPTY.txt")
 95        if not os.path.isfile(ruta):
 96            print(f"[WARNING] No se encontró plantilla para CAM_{camara_num}")
 97            return []
 98
 99    with open(ruta, "r", encoding="utf-8") as f:
100        lineas = f.readlines()
101
102    return lineas