Utilities

Gère l’abstraction de pygame.

rollnjump.utilities.add_to_group(sprite, group)

Ajoute un sprite à un groupe de sprites.

Paramètres

  • sprite (Sprite) – Le sprite à ajouter

  • group (Group) – Le groupe de sprites

rollnjump.utilities.collide(obj, pos_next, rect)

Gestion des collisions.

Paramètres

  • obj (Player / Item) – objet (joueur ou objet) dont on examine la collision

  • pos_next (Vector2) – position suivante de l’objet

  • rect (Rect) – ce qui est potentiellement en collision avec l’objet

Renvoie

un triplet (collision verticale, collision horizontale, modification de position necessaire)

Type renvoyé

bool * bool * Vector2

rollnjump.utilities.collide_group(sprite, group)

Indique s’il y a une collision entre un sprite et un groupe de sprites.

Paramètres

  • sprite (Sprite) – Le sprite examiné

  • group (Sprite group) – Le groupe de sprites examiné

Renvoie

True s’il y a une collision

Type renvoyé

bool

rollnjump.utilities.contact(sprite1, sprite2)

Indique si deux sprites sont en contact.

Paramètres

  • sprite1 (Sprite) – Le premier sprite

  • sprite2 (Sprite) – Le second sprite

Renvoie

True si les deux sprites sont en contact

Type renvoyé

bool

rollnjump.utilities.create_rect(array)

Crée un objet rectangle.

Paramètres

array (int list) – liste contenant l’abscisse de la gauche du rectangle, l’ordonnée du haut du rectangle, sa largeur et sa hauteur

Renvoie

Le rectangle correspondant

Type renvoyé

Rect

rollnjump.utilities.draw_rect(surface, color, rect)

Dessine l’objet rectangle sur une surface.

Paramètres

  • surface (Surface) – La surface sur laquelle afficher le rectangle

  • color (int * int * int) – La couleur (en RGB)

  • rect (Rect) – Le rectangle à afficher

rollnjump.utilities.font(font_name, size)

Renvoie une fonte de la taille demandée.

Paramètres

  • font_name (str) – La police de caractères

  • size (int) – La taille de la fonte

Renvoie

La fonte

Type renvoyé

Font

rollnjump.utilities.get_events()

Renvoie la liste des évènements.

Renvoie

Liste des évènements

Type renvoyé

Event list

rollnjump.utilities.get_screen_size()

Renvoie la taille de la fenêtre.

Renvoie

Dimensions de la fenêtre

Type renvoyé

int * int

rollnjump.utilities.group_sprite_define()

Création d’un nouveau groupe de sprites.

Renvoie

le groupe de sprites

Type renvoyé

Group

rollnjump.utilities.initialize_clock()

Initialise le temps.

Renvoie

Une horloge

Type renvoyé

Clock

rollnjump.utilities.initialize_window(icon, title, width, height, graphical)

Initialise l’environnement graphique et la fenêtre.

Paramètres

  • icon (Surface) – Icone de la fenêtre

  • title (str) – Nom de la fenêtre

  • width (int) – Largeur de la fenêtre

  • height (int) – Hauteur de la fenêtre

  • graphical (bool) – Indique si la fenêtre doit être affichée

Renvoie

Un couple (surface de jeu, surface à afficher)

Type renvoyé

Surface * Surface

rollnjump.utilities.keyname(key)

Renvoie le nom de la touche pressée.

Paramètres

key (Key) – Touche pressée

Renvoie

Nom de la touche

Type renvoyé

str

rollnjump.utilities.load_image(path)

Charge une image à partir d’un chemin.

Paramètres

path (str) – Chemin du fichier

Renvoie

Image du fichier

Type renvoyé

Surface

rollnjump.utilities.load_music(path)

Charge une musique à partir d’un chemin.

Paramètres

path (str) – Chemin du fichier

rollnjump.utilities.make_event(event_type, attr=None)

Renvoie un événement du type passé en entrée.

Paramètres

  • event_type (int) – Le type de l’événement

  • attr (dict, optionnel) – Le dictionnaire des attributs

Renvoie

L’événement correspondant

Type renvoyé

Event

rollnjump.utilities.mouse_pos()

Renvoie la position de la souris.

Renvoie

La position du pointeur

Type renvoyé

int * int

rollnjump.utilities.onlyalphanum(value)

Filtre value pour ne garder que les caractères alphanumériques.

Paramètres

value (str) – La chaîne à filtrer

Renvoie

La chaîne obtenue après filtrage

Type renvoyé

str

rollnjump.utilities.onlydigits(value)

Filtre value pour ne garder que les chiffres.

On peut ainsi retirer toutes les sauts de lignes présents dans le fichier score.txt.

Paramètres

value (str) – La chaîne à filtrer

Renvoie

La chaîne obtenue après filtrage

Type renvoyé

str

rollnjump.utilities.pause_music()

Met sur pause la musique chargée avec load_music.

rollnjump.utilities.play_music()

Lance la musique chargée avec load_music.

Boucle automatiquement à la fin du fichier.

rollnjump.utilities.quit_game()

Quitte le jeu.

rollnjump.utilities.resize(surface, dimensions, destination=None)

Change l’échelle de la surface en entrée.

Paramètres

  • surface (Surface) – La surface à modifier

  • dimensions (int * int) – Les nouvelles dimensions

  • destination (Surface, optionnel) – Nouvel objet à créer pour le redimensionnement

Renvoie

Surface redimensionnée

Type renvoyé

Surface

rollnjump.utilities.resize_list(L, size)

Redimensionne les images d’une liste.

Paramètres

  • L (Surface list) – Liste d’images

  • size (int * int) – La résolution attendue

Renvoie

La liste des images redimensionnées

Type renvoyé

Surface list

rollnjump.utilities.resize_window(screen_size)

Rétablit le ratio après un redimensionnement de fenêtre.

Paramètres

screen_size (int * int) – Taille de la fenêtre, au ratio quelconque

rollnjump.utilities.unpause_music()

Relance la musique chargée avec load_music.

rollnjump.utilities.update_pos_vel(obj, ground)

Met à jour la position et la vitesse de l’objet.

Paramètres

  • obj (Player / Item) – L’objet à mettre à jour

  • ground (Sprite group) – Le groupe des plateformes

rollnjump.utilities.update_screen()

Met à jour l’écran.

Événements

rollnjump.utilities.KEYDOWN

Événement « touche enfoncée ».

rollnjump.utilities.MOUSEBUTTONDOWN

Événement « clic de la souris ».

rollnjump.utilities.VIDEORESIZE

Événement « redimensionnement de la fenêtre ».

rollnjump.utilities.QUIT

Événement « quitter le jeu ».

Touches

rollnjump.utilities.K_SPACE

Touche espace.

rollnjump.utilities.K_RETURN

Touche entrée.

rollnjump.utilities.K_s

Touche S.

rollnjump.utilities.K_u

Touche U.

rollnjump.utilities.K_BACKSPACE

Touche retour.

Classes

rollnjump.utilities.Vec

Classe des vecteurs de dimension 2.

rollnjump.utilities.Sprite

Classe des sprites.

class rollnjump.utilities.GameObject(position, scroll, image)

Bases : pygame.sprite.Sprite

Classe des objets du monde (hors joueur).

pos

Position de l’objet

Type

int * int

scroll

Vitesse de déplacement

Type

float

image

Image de l’objet

Type

Sprite

rect

Rectangle encadrant l’objet

Type

Rect

FLAG_creation

Drapeau pour gérer la création des objets

Type

bool

Initialisation.

Paramètres

  • position (int * int) – Position de l’objet

  • scroll (float) – Vitesse de déplacement

  • image (Sprite) – image de l’objet

update()

Met à jour le vecteur position.