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

(initial copy from english version)
 
m (Notice fixed)
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{newin|[[0.7.0]]|type=module}}
+
{{newin (Français)|[[0.7.0]]|type=module}}
Allows you to work with threads.
+
Vous permet d'utiliser des threads (fils exécution).
{{notice|[[love.graphics]] and [[love.thread]] don't play nice together. Don't call love.graphics functions from a [[Thread]].}}
+
 
 +
Les threads (fils exécution) sont des environnements Lua séparés, s'exécutant en parallèle au code principal. Comme leur code s'exécute séparément, ils peuvent être utiliser pour calculer des opérations complexes sans affecter de façon nefaste le taux de rafraîchissement du thread principal. Toutefois, comme il s'agit d'environnements séparés, ils ne peuvent accéder aux variables et fonctions du thread principal, et les communications entre les threads sont limités.
 +
 
 +
Tous les objets LÖVE (userdata) sont partagé parmi les threads, vous n'avez donc qu'à fournir leurs références entre les threads. Vous pourriez avoir des problèmes de concurrence si vous manipulez un objet dans différentes threads au même moment.
 +
 
 +
Lorsqu'un [[Thread (Français)|Thread]] est démarré, il ne charge que le module love.thread. Chacun des autres modules doivent être charges par un  [[require (Français)|require]].
 +
 
 +
{{notice (Français)|Les modules [[love.graphics (Français)|love.graphics]], [[love.window (Français)|love.window]], [[love.joystick (Français)|love.joystick]], [[love.keyboard (Français)|love.keyboard]], [[love.mouse (Français)|love.mouse]], et [[love.touch (Français)|love.touch]] ont différentes restrictions et ne peuvent donc être utilisée que dans la thread principale.}}
 +
{{notice (Français)|Vous ne verrez aucune des erreurs générée par votre thread, à moins que vous ne définissiez la fonction de rappel [[love.threaderror (Français)|love.threaderror]]  ou que vous n’appeliez [[Thread:getError (Français)|Thread:getError]].}}
 +
{{notice|Sous Android, vous devez vous assurer que toute les threads sont terminées avant de [[love.event.quit (Français)|quitter/redémarrer]], autrement LOVE ne pourra pas à redémarrer !}}
 +
 
 
== Types ==
 
== Types ==
{{#ask: [[Category:Types]] [[parent::love.thread]]
+
{{#ask: [[Category:Types (Français)]] [[parent::love.thread (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 
}}
 
}}
 +
 
== Functions ==
 
== Functions ==
{{#ask: [[Category:Functions]] [[parent::love.thread]]
+
{{#ask: [[Category:Functions (Français)]] [[parent::love.thread (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 
}}
 
}}
[[Category:Modules]]
+
[[Category:Modules (Français)]]
{{#set:Description=Allows you to work with threads.}}
+
{{#set:Description=Vous permet d'utiliser des threads (fils exécution).}}
== See Also ==
+
{{#set:Since=070}}
* [[parent::love]]
+
 
 +
== Exemples ==
 +
Un exemple simple montrant l'utilisation générale d'un thread et utilisant les channels (canaux) pour la communication.
 +
<source lang="lua">
 +
-- Ceci est le code qui s'exécutera sur notre thread. il devrait être déplacé
 +
-- sur son propre fichier Lua dédié, mais nous le créons ici par simplification
 +
local threadCode = [[
 +
-- Reçoit les valeurs envoyées via thread:start
 +
local min, max = ...
 +
 
 +
for i = min, max do
 +
    -- Le Channel (canal) est utilisé pour gérer les communications entre notre
 +
    -- thread principal et celui-ci. À chaque itération de la boucle, il poussera
 +
    -- un message vers celui-ci, qui peut émettre / recevoir du thread principal.
 +
    love.thread.getChannel( 'info' ):push( i )
 +
end
 +
]]
 +
 
 +
local thread -- Notre objet thread.
 +
local timer  -- Un chronomètre utilisé pour animer notre cercle.
 +
 
 +
function love.load()
 +
    thread = love.thread.newThread( threadCode )
 +
    thread:start( 99, 1000 )
 +
end
 +
 
 +
function love.update( dt )
 +
    timer = timer and timer + dt or 0
 +
 
 +
    -- S'assure qu'aucune erreur ne se produit.
 +
    local error = thread:getError()
 +
    assert( not error, error )
 +
end
 +
 
 +
function love.draw()
 +
    -- Récupère l'info de channel et lui émet (pop) le message suivant.
 +
    local info = love.thread.getChannel( 'info' ):pop()
 +
    if info then
 +
        love.graphics.print( info, 10, 10 )
 +
    end
 +
 
 +
    -- Nous animons, un cercle, avec fluidité, afin de montrer que le thread n'est pas bloquant pour
 +
    -- notre thread principal.
 +
    love.graphics.circle( 'line', 100 + math.sin( timer ) * 20, 100 + math.cos( timer ) * 20, 20 )
 +
end
 +
</source>
  
== Other Languages ==
+
== Voir également ==
 +
* [[parent::love (Français)]]
 +
{{#set:Since=070}}
 +
== Autres langues ==
 
{{i18n|love.thread}}
 
{{i18n|love.thread}}

Latest revision as of 06:45, 17 August 2021

Disponible depuis LÖVE 0.7.0
Ce-tte module n'est pas supporté-e par des versions plus anciennes.

Vous permet d'utiliser des threads (fils exécution).

Les threads (fils exécution) sont des environnements Lua séparés, s'exécutant en parallèle au code principal. Comme leur code s'exécute séparément, ils peuvent être utiliser pour calculer des opérations complexes sans affecter de façon nefaste le taux de rafraîchissement du thread principal. Toutefois, comme il s'agit d'environnements séparés, ils ne peuvent accéder aux variables et fonctions du thread principal, et les communications entre les threads sont limités.

Tous les objets LÖVE (userdata) sont partagé parmi les threads, vous n'avez donc qu'à fournir leurs références entre les threads. Vous pourriez avoir des problèmes de concurrence si vous manipulez un objet dans différentes threads au même moment.

Lorsqu'un Thread est démarré, il ne charge que le module love.thread. Chacun des autres modules doivent être charges par un require.

O.png Les modules love.graphics, love.window, love.joystick, love.keyboard, love.mouse, et love.touch ont différentes restrictions et ne peuvent donc être utilisée que dans la thread principale.  


O.png Vous ne verrez aucune des erreurs générée par votre thread, à moins que vous ne définissiez la fonction de rappel love.threaderror ou que vous n’appeliez Thread:getError.  


O.png Sous Android, vous devez vous assurer que toute les threads sont terminées avant de quitter/redémarrer, autrement LOVE ne pourra pas à redémarrer !  


Types

Channel (Français) Un objet pouvant être utilisé pour envoyer et recevoir de données entre les threads (fils d'exécution). Added since 0.9.0
Thread (Français) Un Thread représente un fil d'exécution (thread). Added since 0.7.0

Functions

love.thread.getChannel (Français) Crée ou récupère un channel de thread nomée.
love.thread.newChannel (Français) Crée un Channel (canal) de Thread (fil d’exécution) sans nom.
love.thread.newThread (Français) Crée une nouvelle Thread depuis un nom de fichier, une chaîne de caractères ou un objet FileData contenant du code Lua.


Exemples

Un exemple simple montrant l'utilisation générale d'un thread et utilisant les channels (canaux) pour la communication.

-- Ceci est le code qui s'exécutera sur notre thread. il devrait être déplacé
-- sur son propre fichier Lua dédié, mais nous le créons ici par simplification
local threadCode = [[
-- Reçoit les valeurs envoyées via thread:start
local min, max = ...

for i = min, max do
    -- Le Channel (canal) est utilisé pour gérer les communications entre notre
    -- thread principal et celui-ci. À chaque itération de la boucle, il poussera
    -- un message vers celui-ci, qui peut émettre / recevoir du thread principal.
    love.thread.getChannel( 'info' ):push( i )
end
]]

local thread -- Notre objet thread.
local timer  -- Un chronomètre utilisé pour animer notre cercle.

function love.load()
    thread = love.thread.newThread( threadCode )
    thread:start( 99, 1000 )
end

function love.update( dt )
    timer = timer and timer + dt or 0

    -- S'assure qu'aucune erreur ne se produit.
    local error = thread:getError()
    assert( not error, error )
end

function love.draw()
    -- Récupère l'info de channel et lui émet (pop) le message suivant.
    local info = love.thread.getChannel( 'info' ):pop()
    if info then
        love.graphics.print( info, 10, 10 )
    end

    -- Nous animons, un cercle, avec fluidité, afin de montrer que le thread n'est pas bloquant pour
    -- notre thread principal.
    love.graphics.circle( 'line', 100 + math.sin( timer ) * 20, 100 + math.cos( timer ) * 20, 20 )
end

Voir également

Autres langues