gtn/engine/plugins/pygame.py

"""
Définit un plugin qui gère les évenements pygame.
"""

from engine import *
import pygame

from engine.math import Vec2


class PygamePlugin(Plugin):
    """
    Plugin qui gère les évenements pygame.
    """

    @staticmethod
    def _initialize_pygame(world: World) -> None:
        pygame.init()

        # Initialisation des ressources
        world.set(Display(pygame.display.set_mode((640, 480))), Keyboard(), Mouse())

    @staticmethod
    def _check_events(world: World) -> None:
        keyboard = world[Keyboard]
        keyboard._pressed.clear()
        keyboard._released.clear()

        mouse = world[Mouse]
        mouse._pressed.clear()
        mouse._released.clear()

        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                world[Game].stop()
            elif event.type == pygame.KEYDOWN:
                key_name = pygame.key.name(event.key)
                keyboard._keys.add(key_name)
                keyboard._pressed.add(key_name)
            elif event.type == pygame.KEYUP:
                key_name = pygame.key.name(event.key)
                keyboard._keys.remove(key_name)
                keyboard._released.add(key_name)
            elif event.type == pygame.MOUSEBUTTONDOWN:
                mouse._buttons.add(event.button)
                mouse._pressed.add(event.button)
            elif event.type == pygame.MOUSEBUTTONUP:
                mouse._buttons.remove(event.button)
                mouse._released.add(event.button)
            elif event.type == pygame.MOUSEMOTION:
                mouse._position = Vec2(float(event.pos[0]), float(event.pos[1]))

    @staticmethod
    def _terminate_pygame(world: World) -> None:
        pygame.quit()

    def apply(self, game: Game) -> None:
        """
        Applique le plugin a un jeu.

        Paramètres:
            game: Le jeu auquel appliquer le plugin.
        """
        game.add_startup_tasks(self._initialize_pygame)
        game.add_pre_update_tasks(self._check_events)
        game.add_shutdown_tasks(self._terminate_pygame)


class Display:
    """
    Ressource qui represente la fenetre du jeu.
    """

    def __init__(self, surface: pygame.Surface) -> None:
        self.surface = surface

    @property
    def width(self) -> int:
        """
        Renvoie la largeur de la fenetre

        Retourne:
            La largeur de la fenetre
        """
        return self.surface.get_width()

    @property
    def height(self) -> int:
        """
        Renvoie la hauteur de la fenetre

        Retourne:
            La hauteur de la fenetre
        """
        return self.surface.get_height()


class Keyboard:
    """
    Ressource qui représente les entrées utilisateurs sur le clavier à la frame actuelle.
    """

    def __init__(self) -> None:
        self._keys: set[str] = set()
        self._pressed: set[str] = set()
        self._released: set[str] = set()

    def is_key_pressed(self, key_name: str) -> bool:
        """
        Renvoie True si la touche *key_name* a commencé a être appuyée pendant la frame actuelle.

        Paramètres:
            key_name: Le nom de la touche à tester.

        Retourne:
            True si la touche *key_name* a commencé a être appuyée pendant la frame actuelle.
        """
        return key_name in self._pressed

    def is_key(self, key_name: str) -> bool:
        """
        Renvoie True si la touche *key_name* est actuellement appuyée.

        Paramètres:
            key_name: Le nom de la touche à tester.

        Retourne:
            True si la touche *key_name* est actuellement appuyée.
        """
        return key_name in self._keys

    def is_key_released(self, key_name: str) -> bool:
        """
        Renvoie True si la touche *key_name* a été relachée pendant la frame actuelle.

        Paramètres:
            key_name: Le nom de la touche à tester.

        Retourne:
            True si la touche *key_name* a été relachée pendant la frame actuelle.
        """
        return key_name in self._released


class Mouse:
    """
    Ressource qui représente l'état de la souris à la frame actuelle.
    """

    def __init__(self) -> None:
        self._buttons: set[int] = set()
        self._pressed: set[int] = set()
        self._released: set[int] = set()
        self._position: Vec2 = Vec2(0.0, 0.0)

    def is_button_pressed(self, button: int) -> bool:
        """
        Renvoie True si le bouton *button* a commencé a être appuyée pendant la frame actuelle.

        Paramètres:
            button: Le numéro du bouton à tester.

        Retourne:
            True si le bouton *button* a commencé a être appuyée pendant la frame actuelle.
        """
        return button in self._pressed

    def is_button(self, button: int) -> bool:
        """
        Renvoie True si le bouton *button* est actuellement appuyé.

        Paramètres:
            button: Le numéro du bouton à tester.

        Retourne:
            True si le bouton *button* est actuellement appuyé.
        """
        return button in self._buttons

    def is_button_released(self, button: int) -> bool:
        """
        Renvoie True si le bouton *button* a été relaché pendant la frame actuelle.

        Paramètres:
            button: Le numéro du bouton à tester.

        Retourne:
            True si le bouton *button* aLongrightarrow relaché pendant la frame actuelle.
        """
        return button in self._released

    @property
    def position(self) -> Vec2:
        """
        Renvoie la position de la souris.

        Retourne:
            La position de la souris.
        """
        return self._position