Difference between revisions of "love (Français)"

(Correct wrong link)
(Modules)
 
(14 intermediate revisions by 6 users not shown)
Line 1: Line 1:
C'est le module racine qui contient tous les autres modules.
+
Quand on commence à programmer avec LÖVE, la partie la plus importante de l'API sont les fonctions de rappel ([[Callback (Français)|callback]]) : [[love.load (Français)|love.load]] pour ne faire qu'une fois le réglage de votre jeu, [[love.update (Français)|love.update]] qui est utilsié pour gérer l'état de votre jeu, image par image, et [[love.draw (Français)|love.draw]]  qui est utilisé pour rendre l'état du jeu à l'écran.
Le plus löve des modules...
+
 
 +
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 :
 +
 
 +
<source lang="lua">
 +
-- 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
 +
</source>
 +
 
 
== Modules ==
 
== Modules ==
{{#ask: [[Category:Modules]] [[parent::love (Français)]]
+
{{#ask: [[Category:Modules (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 
}}
 
}}
 +
 +
== Modules tiers ==
 +
{{#ask: [[Category:Libraries (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 +
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 +
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 +
}}
 +
 +
== Fonctions ==
 +
{{#ask: [[Category:Functions (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 +
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 +
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 +
}}
 +
 
== Types ==
 
== Types ==
{{#ask: [[Category:Types]] [[parent::love (Français)]]
+
{{#ask: [[Category:Types (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 +
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 +
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 +
}}
 +
 
 +
== Fonctions de rappel ==
 +
Toutes les fonctions de rappel ne sont appelées que dans la thread principale.
 +
 
 +
=== Général ===
 +
{{#ask: [[Category:Callbacks (Français)]] [[Subcategory::General (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 +
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 +
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 +
}}
 +
 
 +
=== Fenêtre ===
 +
{{#ask: [[Category:Callbacks (Français)]] [[Subcategory::Window (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 +
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 +
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 +
}}
 +
 
 +
=== Clavier ===
 +
{{#ask: [[Category:Callbacks (Français)]] [[Subcategory::Keyboard (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 
}}
 
}}
== Fonctions de Rappel ==
+
 
{{#ask: [[Category:Callbacks]] [[parent::love (Français)]] OR [[Category:Callbacks]] [[parent::love]]
+
=== Souris ===
 +
{{#ask: [[Category:Callbacks (Français)]] [[Subcategory::Mouse (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 
}}
 
}}
[[Category:Modules]]
+
 
{{#set:Description=Module racine qui contient tous les autres modules.
+
=== Manette de jeu ===
 +
{{#ask: [[Category:Callbacks (Français)]] [[Subcategory::Joystick (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 +
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 +
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 +
}}
 +
 
 +
=== Tactile ===
 +
{{#ask: [[Category:Callbacks (Français)]] [[Subcategory::Touch (Français)]] [[parent::love (Français)]] [[Concept:Current]]
 +
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 +
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 
}}
 
}}
 +
 +
[[Category:Modules (Français)]]
 +
{{#set:Description=Le module racine qui contient tous les autres modules.}}
 +
{{#set:Since=000}}
 +
 
== Autres langues ==
 
== Autres langues ==
 
{{i18n|love}}
 
{{i18n|love}}

Latest revision as of 21:43, 6 March 2022

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

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). Added since 11.0
love.event (Français) Gère les événements comme les frappes de touches. Added since 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. Added since 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. Added since 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. Added since 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. Added since 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. Added since 0.9.0
love.thread (Français) Vous permet d'utiliser des threads (fils exécution). Added since 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. Added since 0.10.0
love.video (Français) Ce module est responsable du décodage, du contrôle et du flux de fichiers vidéos. Added since 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. Added since 0.9.0

Modules tiers

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