love (Français)

Quand on commence à programmer avec LÖVE, la partie la plus importante de l'API sont les fonctions de rappel (callback) : love.load pour ne faire qu'une fois le réglage de votre jeu, love.update qui est utilsié pour gérer l'état de votre jeu, image par image, et love.draw qui est utilisé pour rendre l'état du jeu à l'écran.

Des jeux plus interactifs surchargerons des fonctions de rappel additionnelles dans le but de gérer les entrées de l'utilisateur, et les autres aspects d'un jeu plein de fonctionnalités.

LÖVE fournit les emplacement par défaut de ces fonctions de rappel, que vous pouvez surcharger dans votre code, en créant vos propres fonctions avec le même nom que la fonction de rappel correspondante :

-- Charge quelques valeurs par défaut pour notre rectangle.
function love.load()
    x, y, w, h = 20, 20, 60, 20
end

-- Augmente la taille du rectangle à chaque image.
function love.update(dt)
    w = w + 1
    h = h + 1
end

-- Trace un rectangle coloré.
function love.draw()
    -- Dans les versions antérieures à 11.0, les valeurs des composantes de couleur sont (0, 102, 102)
    love.graphics.setColor(0, 0.4, 0.4)
    love.graphics.rectangle("fill", x, y, w, h)
end

Attention cette page ne reflète pas forcément la totalité des modules, types, fonctions etc, voir la version en anglais pour vérifier.

Modules

love.audio (Français)	Fournit une interface pour créer des bruitages avec les haut-parleurs de l'utilisateur.
love.data (Français)	Fournit les fonctionnalités pour créer et transformer les données (data).	11.0
love.event (Français)	Gère les événements comme les frappes de touches.	0.6.0
love.filesystem (Français)	Fournit une interface de gestion du système de fichiers de l'utilisateur.
love.font (Français)	Permet de manipuler les polices de caractères.	0.7.0
love.graphics (Français)	Dessins de formes et d'images, contrôle de l'agencement de l'écran.
love.image (Français)	Fournit une interface pour décoder les données d'images encodées.
love.joystick (Français)	Fournit une interface de manette de jeu (joystick) pour l'utilisateur.	0.5.0
love.keyboard (Français)	Fournit une interface au clavier de l'utilisateur.
love.math (Français)	Fournit des fonctions mathématiques indépendantes du système.	0.9.0
love.mouse (Français)	Fournit une interface vers la souris de l'utilisateur.
love.physics (Français)	Peut simuler la physique 2D des corps rigides de manière réaliste.	0.4.0
love.sound (Français)	Ce module est responsable du décodage des fichiers audios.
love.system (Français)	Provides access to information about the user's system.	0.9.0
love.thread (Français)	Vous permet d'utiliser des threads (fils exécution).	0.7.0
love.timer (Français)	Fournit une interface vers l'horloge de l'utilisateur.
love.touch (Français)	Fournit une interface pour les pressions sur des écrans tactiles.	0.10.0
love.video (Français)	Ce module est responsable du décodage, du contrôle et du flux de fichiers vidéos.	0.10.0
love.window (Français)	Fournit une interface pour modifier et récupérer les informations à propos de la fenêtre du programme.	0.9.0

Modules tiers

lua-enet (Français)	Module de réseau multijoueur pour les jeux.	0.9.0
socket (Français)	Module pour opérations réseau en HTTP, TCP et UDP.	0.5.0
utf8 (Français)	Fournit un support basique pour la manipulation des chaînes de caractères en UTF-8.	0.9.2

Fonctions

love.getVersion (Français)	Récupère la version en cours de fonctionnement de LÖVE.
love.hasDeprecationOutput (Français)	Récupère si LÖVE affiche les alertes lorsqu'une fonctionnalité dépréciée.
love.isVersionCompatible (Français)	Test si la version est compatible avec la version actuelle de LÖVE.
love.setDeprecationOutput (Français)	Règle si LÖVE doit ou non afficher les alertes lorsque une fonctionnalité dépréciée est utilisée.

Types

Data (Français)	Super classe de tous les objets de données.
Object (Français)	Super classe de tous les objets.
Variant (Français)	Les types supportés par love.thread et love.event.

Fonctions de rappel

Toutes les fonctions de rappel ne sont appelées que dans la thread principale.

Général

Config Files (Français)	Réglages de la configuration du jeu.
love.displayrotated (Français)	Appelée lorsque l'orientation du périphérique d'affichage change.
love.draw (Français)	Fonction de rappel utilisée pour dessiner chaque image à l'écran.
love.errorhandler (Français)	Le gestionnaire d'erreurs, utilisé pour afficher les messages d'erreur.
love.load (Français)	Cette fonction est appelée une seule fois, au lancement du jeu.
love.lowmemory (Français)	Fonction de rappel déclenchée lorsque le système arrive en saturation de mémoire sur les périphériques mobiles.
love.quit (Français)	Fonction de retour déclenché lorsque le jeu est fermé.
love.run (Français)	Fonction principale, contenant la boucle principale. Une fonction adapté avec précision est utilisé par défaut lorsqu'elle n'est pas redéfinie.
love.threaderror (Français)	Callback function triggered when a Thread encounters an error.
love.update (Français)	Fonction de rappel (Callback) utilisée pour mettre à jour l'état du jeu à chaque nouvelle image.

Fenêtre

love.directorydropped (Français)	Fonction de callback déclenchée lorsque un dossier est glissé et déposé dans la fenêtre.
love.filedropped (Français)	Fonction de callback déclenchée lorsqu'un fichier est glissé et déposé dans la fenêtre de l'application.
love.focus (Français)	Fonction de rappel appelée quand la fenêtre principale reçoit ou perds le focus.
love.mousefocus (Français)	Fonction de rappel déclenchée lorsque la fenêtre reçoit ou perd le focus de la souris.
love.resize (Français)	Appelé lorsque la fenêtre est redimensionnée.
love.visible (Français)	Fonction de rappel déclenchée lorsque une fenêtre est minimisée/cachée ou dé-minimisée par l'utilisateur.

Clavier

love.keypressed (Français)	Fonction de rappel déclenchée lorsque une touche du clavier est pressée.
love.keyreleased (Français)	Fonction de rappel déclenchée lorsque une touche du clavier est relâchée.
love.textedited (Français)	Appelé lorsqu'un texte candidat à une IME (Input Method Editor, méthode de saisie) à été modifié.
love.textinput (Français)	Appelée lorsque un texte à été saisi par l'utilisateur.

Souris

love.mousemoved (Français)	Fonction de rappel déclenchée lorsque la souris est déplacée.
love.mousepressed (Français)	Fonction de rappel appelée quand un bouton de la souris est appuyé.
love.mousereleased (Français)	Fonction de rappel appelée quand un bouton de la souris est relâché.
love.wheelmoved (Français)	Fonctions de rappel déclenchées lorsque la molette de la souris est actionnée.

Manette de jeu

love.gamepadaxis (Français)	Appelé lorsque l'axe d'un gamepad virtuel de Joystick est déplacé.
love.gamepadpressed (Français)	Appelé lorsque le bouton d'un gamepad virtuel d'une manette de jeu est pressé.
love.gamepadreleased (Français)	Appelé lorsque le bouton d'un gamepad virtuel d'une manette de jeu est relâché.
love.joystickadded (Français)	Appelé lorsqu'un Joystick (manette de jeu) est connecté.
love.joystickaxis (Français)	Appelé lorsque l'axe d'un joystick (manette de jeu) est bougé.
love.joystickhat (Français)	Appelé lorsqu'un la direction d'un bouton point de vue (PDV) de joystick change.
love.joystickpressed (Français)	Appelé lorsque le bouton d'un joystick est pressé.
love.joystickreleased (Français)	Appelée lorsqu'un bouton de joystick est relâché.
love.joystickremoved (Français)	Appelé lorsqu'un Joystick est déconnecté.

Tactile

love.touchmoved (Français)	Fonction de rappel déclenchée lorsque la pression sur une surface tactile se déplace à l’intérieur de cette surface.
love.touchpressed (Français)	Fonction de rappel déclenche lorsque l'écran tactile est touché.
love.touchreleased (Français)	Fonction de rappel déclenchée lorsque l'écran tactile cesse d'être touché.

Autres langues

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info