Difference between revisions of "Config Files (Français)"

(Fichier de configuration actuel: fini la traduction)
(Flags: traduit une bonne partie, à finir)
Line 76: Line 76:
 
</source>
 
</source>
  
== Flags ==
+
== Drapeaux ==
 
==== identity ====
 
==== identity ====
This flag determines the name of the save directory for your game. Note that you can only specify the name, not the location where it will be created:
+
Ce drapeau détermine le nom du répertoire de sauvegarde de votre jeu. Notez que vous ne pouvez que spécifier le nom, pas l'emplacement où il sera créé :
 
<source lang="lua">
 
<source lang="lua">
 
t.identity = "gabe_HL3" -- Correct
 
t.identity = "gabe_HL3" -- Correct
 
t.identity = "c:/Users/gabe/HL3" -- Incorrect
 
t.identity = "c:/Users/gabe/HL3" -- Incorrect
 
</source>
 
</source>
Alternatively [[love.filesystem.setIdentity]] can be used to set the save directory outside of the config file.
+
[[love.filesystem.setIdentity]] peut également être utilisé pour régler le répertoire de sauvegarde en dehors du fichier de configuration.
  
 
==== appendidentity ====
 
==== appendidentity ====
 
{{newin|[[11.0]]|110|type=flag}}
 
{{newin|[[11.0]]|110|type=flag}}
This flag determines if game directory should be searched first then save directory (<code>true</code>) or otherwise (<code>false</code>)
+
Ce drapeau détermine, si le répertoire du jeu doit être fouillé en premier, puis, le répertoire de sauvegarde (<code>true</code>) ou autrement (<code>false</code>)
  
 
==== version ====
 
==== version ====
 
{{newin|[[0.8.0]]|080|type=flag}}
 
{{newin|[[0.8.0]]|080|type=flag}}
<code>t.version</code> should be a string, representing the version of LÖVE for which your game was made.
+
<code>t.version</code> doit être une chaîne de caractères, représentant la version de LÖVE pour laquelle votre jeu à été conçu.
  
Before [[11.0]], it should be formatted as <code>"''X.Y.Z''"</code> where <code>''X''</code> is the major release number, <code>''Y''</code> the minor, and <code>''Z''</code> the patch level. Since 11.0, it should be formatted as <code>"''X.Y''"</code> where <code>''X''</code> and <code>''Y''</code> are the major and minor release respectively.
+
Avant la version [[11.0]], elle doit être formatée en <code>"''X.Y.Z''"</code>, où <code>''X''</code> est le numéro de version majeur, <code>''Y''</code> le mineur, et <code>''Z''</code> le niveau de patch. À partir de la 11.0, elle doit être formatée en <code>"''X.Y''"</code>, où <code>''X''</code> et <code>''Y''</code> sont respectivement les numéro de version majeur et mineur.
  
It allows LÖVE to display a warning if it isn't compatible. Its default is the version of LÖVE running.
+
Il permet à LÖVE d'afficher un danger si il n'est pas compatible. Sa version par défaut est la version de LÖVE fonctionnant.
  
 
==== console ====
 
==== console ====
Determines whether a console should be opened alongside the game window (Windows only) or not. Note: On OSX you can get console output by running LÖVE through the terminal, or on Windows with LÖVE [[0.10.2]], by running <code>lovec.exe</code> instead of <code>love.exe</code>.
+
Détermine si une console devrait être ouverte aux côté de la fenêtre de jeu (seulement sous Windows) ou non. Note : Sous OSX, vous pouvez obtenir une sortie en console en lançant LÖVE depuis un terminal, ou, sous Windows, avec LÖVE [[0.10.2]], en lançant <code>lovec.exe</code> à la place de <code>love.exe</code>.
  
 
==== accelerometerjoystick ====
 
==== accelerometerjoystick ====
{{newin|[[0.10.0]]|100|type=flag}}
+
{{newin (Français)|[[0.10.0]]|100|type=flag}}
Sets whether the device accelerometer on iOS and Android should be exposed as a 3-axis [[Joystick]]. Disabling the accelerometer when it's not used may reduce CPU usage.
+
Permet de régler si l'accéléromètre du périphérique, sous iOS ou Android, doit être exposé comme un [[Joystick]] à 3 axes. Sets whether the device accelerometer on iOS and Android should be exposed as a 3-axis [[Joystick]]. Désactiver l'accéléromètre lorsqu'il n'est pas utilisé, peux réduire l'utilisation du CPU.
  
 
==== externalstorage ====
 
==== externalstorage ====
{{newin|[[0.10.1]]|101|type=flag}}
+
{{newin (Français)|[[0.10.1]]|101|type=flag}}
Sets whether files are saved in external storage (true) or internal storage (false) on Android.
+
Permet de régler si les fichiers doivent être sauvegarder sur un stockage externe (true) ou interne (false) sous Android.
  
 
==== gammacorrect ====
 
==== gammacorrect ====
{{newin|[[0.10.0]]|100|type=flag}}
+
{{newin (Français)|[[0.10.0]]|100|type=flag}}
Determines whether [[love.graphics.isGammaCorrect|gamma-correct rendering]] is enabled, when the system supports it.
+
Détermines si le [[love.graphics.isGammaCorrect|rendu au gamma correct]] est activé, lorsque le système le supporte.
  
 
==== audio.mixwithsystem ====
 
==== audio.mixwithsystem ====
{{newin|[[11.0]]|110|type=flag}}
+
{{newin (Français)|[[11.0]]|110|type=flag}}
Sets whether background audio / music from other apps should play while LÖVE is open. See [[love.system.hasBackgroundMusic]] for more details.
+
Détermine si l'audio / musique des autres applications en tâche de fond doivent être joués lrosque LÖVE est ouvert. Voir [[love.system.hasBackgroundMusic]] pour d'avantage de déails.
  
 
==== window ====
 
==== window ====
{{newin|[[0.9.0]]|090|type=flags|plural='y'}}
+
{{newin (Français)|[[0.9.0]]|090|type=flags|plural='y'}}
It is possible to defer window creation until [[love.window.setMode]] is first called in your code. To do so, set <code>t.window = nil</code> in love.conf (or <code>t.screen = nil</code> in older versions.) If this is done, LÖVE may crash if any function from [[love.graphics]] is called before the first [[love.window.setMode]] in your code.
+
Il est possible de différer la création de la fenêtre jusqu'à ce que [[love.window.setMode]] soit appelé en premier dans votre code. Pour cela, réglez <code>t.window = nil</code> dans love.conf (ou <code>t.screen = nil</code> dans les versions plus anciennes.) Si c'est le cas, LÖVE pourrait planter si une quelconque fonction de [[love.graphics]] est appelée avant le premier appel à [[love.window.setMode]] dans votre code.
  
The <code>t.window</code> table was named <code>t.screen</code> in versions prior to [[0.9.0]]. The <code>t.screen</code> table doesn't exist in love.conf in 0.9.0, and the <code>t.window</code> table doesn't exist in love.conf in 0.8.0. This means '''love.conf''' will fail to execute (therefore it will fall back to default values) if care is not taken to use the correct table for the LÖVE version being used.
+
La table <code>t.window</code> était nommée <code>t.screen</code> dans les versions antérieures à la [[0.9.0]]. La table <code>t.screen</code> n'existe pas dans love.conf avec la version 0.9.0, et la table <code>t.window</code> n'existe pas dans love.conf avec la version 0.8.0. Cela signifie que '''love.conf''' échouera lors de son execution (Il reviendra alors aux valeurs par défaut) si une attention particulière n'est pas prise pour prendre la bonne la table en fonction de la version de  LÖVE qui est utilisée.
  
 
==== window.title ====
 
==== window.title ====
{{newin|[[0.9.0]]|090|type=flag}}
+
{{newin (Français)|[[0.9.0]]|090|type=flag}}
Sets the title of the window the game is in. Alternatively [[love.window.setTitle]] can be used to change the window title outside of the config file.
+
Règle le titre de la fenêtre dans laquelle est le jeu. [[love.window.setTitle]] peut également être utilisé pour changer le titre de la fenêtre en dehors du fichier de configuration.
  
 
==== window.icon ====
 
==== window.icon ====
{{newin|[[0.9.0]]|090|type=flag}}
+
{{newin (Français)|[[0.9.0]]|090|type=flag}}
 
A filepath to an image to use as the window's icon. Not all operating systems support very large icon images. The icon can also be changed with [[love.window.setIcon]].
 
A filepath to an image to use as the window's icon. Not all operating systems support very large icon images. The icon can also be changed with [[love.window.setIcon]].
  
 
==== window.width & window.height ====
 
==== window.width & window.height ====
{{newin|[[0.9.0]]|090|type=flags|plural='y'}}
+
{{newin (Français)|[[0.9.0]]|090|type=flags|plural='y'}}
 
Sets the window's dimensions. If these flags are set to 0 LÖVE automatically uses the user's desktop dimensions.
 
Sets the window's dimensions. If these flags are set to 0 LÖVE automatically uses the user's desktop dimensions.
  
 
==== window.borderless ====
 
==== window.borderless ====
{{newin|[[0.9.0]]|090|type=flag}}
+
{{newin (Français)|[[0.9.0]]|090|type=flag}}
 
Removes all border visuals from the window. Note that the effects may wary between operating systems.
 
Removes all border visuals from the window. Note that the effects may wary between operating systems.
  
Line 143: Line 143:
  
 
==== window.minwidth & window.minheight ====
 
==== window.minwidth & window.minheight ====
{{newin|[[0.9.0]]|090|type=flags|plural='y'}}
+
{{newin (Français)|[[0.9.0]]|090|type=flags|plural='y'}}
 
Sets the minimum width and height for the game's window if it can be resized by the user. If you set lower values to <code>window.width</code> and <code>window.height</code> LÖVE will always favor the minimum dimensions set via <code>window.minwidth</code> and <code>window.minheight</code>.
 
Sets the minimum width and height for the game's window if it can be resized by the user. If you set lower values to <code>window.width</code> and <code>window.height</code> LÖVE will always favor the minimum dimensions set via <code>window.minwidth</code> and <code>window.minheight</code>.
  
 
==== window.fullscreen ====
 
==== window.fullscreen ====
{{newin|[[0.9.0]]|090|type=flag}}
+
{{newin (Français)|[[0.9.0]]|090|type=flag}}
 
Wether to run the game in fullscreen (<code>true</code>) or windowed (<code>false</code>) mode. The fullscreen can also be toggled via [[love.window.setFullscreen]] or [[love.window.setMode]].
 
Wether to run the game in fullscreen (<code>true</code>) or windowed (<code>false</code>) mode. The fullscreen can also be toggled via [[love.window.setFullscreen]] or [[love.window.setMode]].
  
 
==== window.fullscreentype ====
 
==== window.fullscreentype ====
{{newin|[[0.9.0]]|090|type=flag}}
+
{{newin (Français)|[[0.9.0]]|090|type=flag}}
 
Specifies the [[FullscreenType|type of fullscreen]] mode to use (<code>exclusive</code> or <code>desktop</code>). Generally the <code>desktop</code> is recommended, as it is less restrictive than <code>exclusive</code> mode on some operating systems. (Note: In [[0.9.2]] and earlier, use <code>normal</code> instead of <code>exclusive</code>.)
 
Specifies the [[FullscreenType|type of fullscreen]] mode to use (<code>exclusive</code> or <code>desktop</code>). Generally the <code>desktop</code> is recommended, as it is less restrictive than <code>exclusive</code> mode on some operating systems. (Note: In [[0.9.2]] and earlier, use <code>normal</code> instead of <code>exclusive</code>.)
  
 
==== window.vsync ====
 
==== window.vsync ====
{{newin|[[0.9.0]]|090|type=flag}}
+
{{newin (Français)|[[0.9.0]]|090|type=flag}}
 
Enables or deactivates vertical synchronization. Vsync tries to keep the game at a steady framerate and can prevent issues like screen tearing. It is recommended to keep vsync activated if you don't know about the possible implications of turning it off. Before LÖVE 11.0, this value was boolean (<code>true</code> or <code>false</code>). Since LÖVE 11.0, this value is number (1 to enable vsync, 0 to disable vsync).
 
Enables or deactivates vertical synchronization. Vsync tries to keep the game at a steady framerate and can prevent issues like screen tearing. It is recommended to keep vsync activated if you don't know about the possible implications of turning it off. Before LÖVE 11.0, this value was boolean (<code>true</code> or <code>false</code>). Since LÖVE 11.0, this value is number (1 to enable vsync, 0 to disable vsync).
  
Line 161: Line 161:
  
 
==== window.msaa ====
 
==== window.msaa ====
{{newin|[[0.9.2]]|092|type=flag}}
+
{{newin (Français)|[[0.9.2]]|092|type=flag}}
 
The number of samples to use with multi-sampled antialiasing.
 
The number of samples to use with multi-sampled antialiasing.
  
 
==== window.display ====
 
==== window.display ====
{{newin|[[0.9.0]]|090|type=flag}}
+
{{newin (Français)|[[0.9.0]]|090|type=flag}}
 
The index of the display to show the window in, if multiple monitors are available.
 
The index of the display to show the window in, if multiple monitors are available.
  
 
==== window.highdpi ====
 
==== window.highdpi ====
{{newin|[[0.9.1]]|091|type=flag}}
+
{{newin (Français)|[[0.9.1]]|091|type=flag}}
 
See [[love.window.getPixelScale]], [[love.window.toPixels]], and [[love.window.fromPixels]]. It is recommended to keep this option disabled if you can't test your game on a Mac or iOS system with a Retina display, because code will need tweaking to make sure things look correct.
 
See [[love.window.getPixelScale]], [[love.window.toPixels]], and [[love.window.fromPixels]]. It is recommended to keep this option disabled if you can't test your game on a Mac or iOS system with a Retina display, because code will need tweaking to make sure things look correct.
  
Line 175: Line 175:
  
 
==== window.x & window.y ====
 
==== window.x & window.y ====
{{newin|[[0.9.2]]|092|type=flags|plural='y'}}
+
{{newin (Français)|[[0.9.2]]|092|type=flags|plural='y'}}
 
Determines the position of the window on the user's screen. Alternatively [[love.window.setPosition]] can be used to change the position on the fly.
 
Determines the position of the window on the user's screen. Alternatively [[love.window.setPosition]] can be used to change the position on the fly.
  

Revision as of 22:53, 29 October 2019

Introduction

Si un fichier appelé conf.lua est présent dans votre dossier de jeu (ou fichier .love), il est exécuté avant que les modules LÖVE ne soient chargés. Vous pouvez utiliser ce fichier pour y mettre la fonction love.conf. À l'aide de cette fonction, vous pouvez définir certaines options de configuration et modifier des éléments tels que la taille par défaut de la fenêtre, les modules chargés et d'autres éléments.

love.conf

La fonction love.conf prend un argument: une table contenant toutes les valeurs par défaut que vous pouvez écraser à votre guise. Si vous voulez changer la taille de la fenêtre par défaut, par exemple:

function love.conf(t)
    t.window.width = 1024
    t.window.height = 768
end

Si vous n'avez pas besoin du module physique ou du module joystick, procédez comme suit.

function love.conf(t)
    t.modules.joystick = false
    t.modules.physics = false
end

Définir les modules inutilisés à false est encouragé lorsque vous lancez votre jeu. Il réduit légèrement le temps de démarrage (surtout si le module du joystick est désactivé) et réduit l'utilisation de la mémoire (légèrement).

Notez que vous ne pouvez pas désactiver love.filesystem; il est obligatoire. La même chose vaut pour le module love lui-même. love.graphics à besoin de love.window pour être activé.

Fichier de configuration actuel

Voici une liste complète des options et de leurs valeurs par défaut pour LÖVE 11.0:

function love.conf(t)
    t.identity = nil                    -- Le nom du répertoire de sauvegarde (string)
    t.appendidentity = false            -- Rechercher des fichiers dans le répertoire source avant le répertoire de sauvegarde (booléen)
    t.version = "11.0"                  -- La version de LÖVE pour laquelle ce jeu a été fait (string)
    t.console = false                   -- Ouvrir une console (boolean, Windows seulement)
    t.accelerometerjoystick = true      -- Activer l'accéléromètre sur iOS et Android en l'exposant comme un joystick (boolean)
    t.externalstorage = false           -- True pour enregistrer les fichiers (et lire depuis le répertoire de sauvegarde) dans un stockage externe sur Android (booléen)
    t.gammacorrect = false              -- Activer le rendu de correction gamma, lorsqu'il est pris en charge par le système (booléen)

    t.audio.mixwithsystem = true        -- Continue à jouer la musique de fond lors de l'ouverture de LOVE (booléen, iOS et Android seulement)

    t.window.title = "Untitled"         -- Titre de la fenêtre (string)
    t.window.icon = nil                 -- Chemin du fichier vers une image à utiliser comme icône de la fenêtre (string)
    t.window.width = 800                -- Largeur de la fenêtre (number)
    t.window.height = 600               -- Hauteur de la fenêtre (number)
    t.window.borderless = false         -- Supprime toutes les bordures de la fenêtre (booléen)
    t.window.resizable = false          -- Laissez la fenêtre être redimensionnable par l'utilisateur (booléen)
    t.window.minwidth = 1               -- Largeur minimale de la fenêtre si elle est redimensionnée (number)
    t.window.minheight = 1              -- Hauteur minimale de la fenêtre si elle est redimensionnée (number)
    t.window.fullscreen = false         -- Active le plein écran (booléen)
    t.window.fullscreentype = "desktop" -- Choisissez entre le mode plein écran "bureau" ou le mode plein écran "exclusif" (string)
    t.window.vsync = 1                  -- Mode de synchronisation verticale (number)
    t.window.msaa = 0                   -- Le nombre d'échantillons à utiliser avec l'anti-crénelage multi-échantillonné (number)
    t.window.display = 1                -- Index du moniteur où afficher la fenêtre (number)
    t.window.highdpi = false            -- Activer le mode haute résolution pour la fenêtre sur un écran Retina (booléen)
    t.window.x = nil                    -- La position x de la fenêtre dans l'écran spécifié (number)
    t.window.y = nil                    -- La position y de la fenêtre dans l'écran spécifié (number)

    t.modules.audio = true              -- Active le module audio (boolean)
    t.modules.data = true               -- Active le module data (boolean)
    t.modules.event = true              -- Active le module event (boolean)
    t.modules.font = true               -- Active le module font (boolean)
    t.modules.graphics = true           -- Active le module graphics (boolean)
    t.modules.image = true              -- Active le module image (boolean)
    t.modules.joystick = true           -- Active le module joystick (boolean)
    t.modules.keyboard = true           -- Active le module keyboard (boolean)
    t.modules.math = true               -- Active le module math (boolean)
    t.modules.mouse = true              -- Active le module mouse (boolean)
    t.modules.physics = true            -- Active le module physics (boolean)
    t.modules.sound = true              -- Active le module sound (boolean)
    t.modules.system = true             -- Active le module system (boolean)
    t.modules.thread = true             -- Active le module thread (boolean)
    t.modules.timer = true              -- Active le module timer (boolean), le désactiver résultera en un temps delta de 0 dans love.update
    t.modules.touch = true              -- Active le module touch (boolean)
    t.modules.video = true              -- Active le module video (boolean)
    t.modules.window = true             -- Active le module window (boolean)
end

Drapeaux

identity

Ce drapeau détermine le nom du répertoire de sauvegarde de votre jeu. Notez que vous ne pouvez que spécifier le nom, pas l'emplacement où il sera créé :

t.identity = "gabe_HL3" -- Correct
t.identity = "c:/Users/gabe/HL3" -- Incorrect

love.filesystem.setIdentity peut également être utilisé pour régler le répertoire de sauvegarde en dehors du fichier de configuration.

appendidentity

Available since LÖVE 11.0
This flag is not supported in earlier versions.

Ce drapeau détermine, si le répertoire du jeu doit être fouillé en premier, puis, le répertoire de sauvegarde (true) ou autrement (false)

version

Available since LÖVE 0.8.0
This flag is not supported in earlier versions.

t.version doit être une chaîne de caractères, représentant la version de LÖVE pour laquelle votre jeu à été conçu.

Avant la version 11.0, elle doit être formatée en "X.Y.Z", où X est le numéro de version majeur, Y le mineur, et Z le niveau de patch. À partir de la 11.0, elle doit être formatée en "X.Y", où X et Y sont respectivement les numéro de version majeur et mineur.

Il permet à LÖVE d'afficher un danger si il n'est pas compatible. Sa version par défaut est la version de LÖVE fonctionnant.

console

Détermine si une console devrait être ouverte aux côté de la fenêtre de jeu (seulement sous Windows) ou non. Note : Sous OSX, vous pouvez obtenir une sortie en console en lançant LÖVE depuis un terminal, ou, sous Windows, avec LÖVE 0.10.2, en lançant lovec.exe à la place de love.exe.

accelerometerjoystick

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

Permet de régler si l'accéléromètre du périphérique, sous iOS ou Android, doit être exposé comme un Joystick à 3 axes. Sets whether the device accelerometer on iOS and Android should be exposed as a 3-axis Joystick. Désactiver l'accéléromètre lorsqu'il n'est pas utilisé, peux réduire l'utilisation du CPU.

externalstorage

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

Permet de régler si les fichiers doivent être sauvegarder sur un stockage externe (true) ou interne (false) sous Android.

gammacorrect

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

Détermines si le rendu au gamma correct est activé, lorsque le système le supporte.

audio.mixwithsystem

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

Détermine si l'audio / musique des autres applications en tâche de fond doivent être joués lrosque LÖVE est ouvert. Voir love.system.hasBackgroundMusic pour d'avantage de déails.

window

Disponible depuis LÖVE 0.9.0
Ces flags ne sont pas supporté-e par des versions plus anciennes.

Il est possible de différer la création de la fenêtre jusqu'à ce que love.window.setMode soit appelé en premier dans votre code. Pour cela, réglez t.window = nil dans love.conf (ou t.screen = nil dans les versions plus anciennes.) Si c'est le cas, LÖVE pourrait planter si une quelconque fonction de love.graphics est appelée avant le premier appel à love.window.setMode dans votre code.

La table t.window était nommée t.screen dans les versions antérieures à la 0.9.0. La table t.screen n'existe pas dans love.conf avec la version 0.9.0, et la table t.window n'existe pas dans love.conf avec la version 0.8.0. Cela signifie que love.conf échouera lors de son execution (Il reviendra alors aux valeurs par défaut) si une attention particulière n'est pas prise pour prendre la bonne la table en fonction de la version de LÖVE qui est utilisée.

window.title

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

Règle le titre de la fenêtre dans laquelle est le jeu. love.window.setTitle peut également être utilisé pour changer le titre de la fenêtre en dehors du fichier de configuration.

window.icon

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

A filepath to an image to use as the window's icon. Not all operating systems support very large icon images. The icon can also be changed with love.window.setIcon.

window.width & window.height

Disponible depuis LÖVE 0.9.0
Ces flags ne sont pas supporté-e par des versions plus anciennes.

Sets the window's dimensions. If these flags are set to 0 LÖVE automatically uses the user's desktop dimensions.

window.borderless

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

Removes all border visuals from the window. Note that the effects may wary between operating systems.

window.resizable

Available since LÖVE 0.9.0
This flag is not supported in earlier versions.

If set to true this allows the user to resize the game's window.

window.minwidth & window.minheight

Disponible depuis LÖVE 0.9.0
Ces flags ne sont pas supporté-e par des versions plus anciennes.

Sets the minimum width and height for the game's window if it can be resized by the user. If you set lower values to window.width and window.height LÖVE will always favor the minimum dimensions set via window.minwidth and window.minheight.

window.fullscreen

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

Wether to run the game in fullscreen (true) or windowed (false) mode. The fullscreen can also be toggled via love.window.setFullscreen or love.window.setMode.

window.fullscreentype

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

Specifies the type of fullscreen mode to use (exclusive or desktop). Generally the desktop is recommended, as it is less restrictive than exclusive mode on some operating systems. (Note: In 0.9.2 and earlier, use normal instead of exclusive.)

window.vsync

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

Enables or deactivates vertical synchronization. Vsync tries to keep the game at a steady framerate and can prevent issues like screen tearing. It is recommended to keep vsync activated if you don't know about the possible implications of turning it off. Before LÖVE 11.0, this value was boolean (true or false). Since LÖVE 11.0, this value is number (1 to enable vsync, 0 to disable vsync).

Note that in iOS, vertical synchronization is always enabled and cannot be changed.

window.msaa

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

The number of samples to use with multi-sampled antialiasing.

window.display

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

The index of the display to show the window in, if multiple monitors are available.

window.highdpi

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

See love.window.getPixelScale, love.window.toPixels, and love.window.fromPixels. It is recommended to keep this option disabled if you can't test your game on a Mac or iOS system with a Retina display, because code will need tweaking to make sure things look correct.

Please note that since 11.0, high DPI is always enabled in Android regardless of this flag!

window.x & window.y

Disponible depuis LÖVE 0.9.2
Ces flags ne sont pas supporté-e par des versions plus anciennes.

Determines the position of the window on the user's screen. Alternatively love.window.setPosition can be used to change the position on the fly.

window.fsaa

Available since LÖVE 0.9.0 and removed in LÖVE 0.10.0
This flag has been replaced by the window.msaa flag.

The number of samples to use with multi-sampled antialiasing.

window.srgb

Available since LÖVE 0.9.1 and removed in LÖVE 0.10.0
This flag has been replaced by the gammacorrect flag.

Enabling this window flag will automatically convert the colors of everything drawn to the main screen from the linear RGB colorspace to the sRGB colorspace - the window's surface is treated as gamma-space sRGB. This is only one component of gamma-correct rendering, an advanced topic which is easy to mess up, so it's recommended to keep this option disabled if you're not sure about its implications.

Release Mode

Available since LÖVE 0.8.0 and removed in LÖVE 0.9.0
This flag is not supported in earlier or later versions.


If t.release is enabled, LÖVE uses the release error handler, which is sparse on information by default, and can, of course, be overridden.

The default release mode error handler also outputs a message to the player informing them to contact the author using the values title, author and url as specified in conf.lua.

When a fused game in release mode is run it will not save in the love save dir, but rather one for itself, whereas previously it would be %APPDATA%\\LOVE\\game on Windows, it now is %APPDATA%\\game. This concept applies to other platforms as well.

Older Versions

Here is a full list of options and their default values for LÖVE 0.10.1 and 0.10.2:

function love.conf(t)
    t.identity = nil                    -- The name of the save directory (string)
    t.version = "0.10.2"                -- The LÖVE version this game was made for (string)
    t.console = false                   -- Attach a console (boolean, Windows only)
    t.accelerometerjoystick = true      -- Enable the accelerometer on iOS and Android by exposing it as a Joystick (boolean)
    t.externalstorage = false           -- True to save files (and read from the save directory) in external storage on Android (boolean)
    t.gammacorrect = false              -- Enable gamma-correct rendering, when supported by the system (boolean)

    t.window.title = "Untitled"         -- The window title (string)
    t.window.icon = nil                 -- Filepath to an image to use as the window's icon (string)
    t.window.width = 800                -- The window width (number)
    t.window.height = 600               -- The window height (number)
    t.window.borderless = false         -- Remove all border visuals from the window (boolean)
    t.window.resizable = false          -- Let the window be user-resizable (boolean)
    t.window.minwidth = 1               -- Minimum window width if the window is resizable (number)
    t.window.minheight = 1              -- Minimum window height if the window is resizable (number)
    t.window.fullscreen = false         -- Enable fullscreen (boolean)
    t.window.fullscreentype = "desktop" -- Choose between "desktop" fullscreen or "exclusive" fullscreen mode (string)
    t.window.vsync = true               -- Enable vertical sync (boolean)
    t.window.msaa = 0                   -- The number of samples to use with multi-sampled antialiasing (number)
    t.window.display = 1                -- Index of the monitor to show the window in (number)
    t.window.highdpi = false            -- Enable high-dpi mode for the window on a Retina display (boolean)
    t.window.x = nil                    -- The x-coordinate of the window's position in the specified display (number)
    t.window.y = nil                    -- The y-coordinate of the window's position in the specified display (number)

    t.modules.audio = true              -- Enable the audio module (boolean)
    t.modules.event = true              -- Enable the event module (boolean)
    t.modules.graphics = true           -- Enable the graphics module (boolean)
    t.modules.image = true              -- Enable the image module (boolean)
    t.modules.joystick = true           -- Enable the joystick module (boolean)
    t.modules.keyboard = true           -- Enable the keyboard module (boolean)
    t.modules.math = true               -- Enable the math module (boolean)
    t.modules.mouse = true              -- Enable the mouse module (boolean)
    t.modules.physics = true            -- Enable the physics module (boolean)
    t.modules.sound = true              -- Enable the sound module (boolean)
    t.modules.system = true             -- Enable the system module (boolean)
    t.modules.timer = true              -- Enable the timer module (boolean), Disabling it will result 0 delta time in love.update
    t.modules.touch = true              -- Enable the touch module (boolean)
    t.modules.video = true              -- Enable the video module (boolean)
    t.modules.window = true             -- Enable the window module (boolean)
    t.modules.thread = true             -- Enable the thread module (boolean)
end

Here is a full list of options and their default values for LÖVE 0.10.0:

function love.conf(t)
    t.identity = nil                    -- The name of the save directory (string)
    t.version = "0.10.0"                -- The LÖVE version this game was made for (string)
    t.console = false                   -- Attach a console (boolean, Windows only)
    t.accelerometerjoystick = true      -- Enable the accelerometer on iOS and Android by exposing it as a Joystick (boolean)
    t.gammacorrect = false              -- Enable gamma-correct rendering, when supported by the system (boolean)

    t.window.title = "Untitled"         -- The window title (string)
    t.window.icon = nil                 -- Filepath to an image to use as the window's icon (string)
    t.window.width = 800                -- The window width (number)
    t.window.height = 600               -- The window height (number)
    t.window.borderless = false         -- Remove all border visuals from the window (boolean)
    t.window.resizable = false          -- Let the window be user-resizable (boolean)
    t.window.minwidth = 1               -- Minimum window width if the window is resizable (number)
    t.window.minheight = 1              -- Minimum window height if the window is resizable (number)
    t.window.fullscreen = false         -- Enable fullscreen (boolean)
    t.window.fullscreentype = "desktop" -- Choose between "desktop" fullscreen or "exclusive" fullscreen mode (string)
    t.window.vsync = true               -- Enable vertical sync (boolean)
    t.window.msaa = 0                   -- The number of samples to use with multi-sampled antialiasing (number)
    t.window.display = 1                -- Index of the monitor to show the window in (number)
    t.window.highdpi = false            -- Enable high-dpi mode for the window on a Retina display (boolean)
    t.window.x = nil                    -- The x-coordinate of the window's position in the specified display (number)
    t.window.y = nil                    -- The y-coordinate of the window's position in the specified display (number)

    t.modules.audio = true              -- Enable the audio module (boolean)
    t.modules.event = true              -- Enable the event module (boolean)
    t.modules.graphics = true           -- Enable the graphics module (boolean)
    t.modules.image = true              -- Enable the image module (boolean)
    t.modules.joystick = true           -- Enable the joystick module (boolean)
    t.modules.keyboard = true           -- Enable the keyboard module (boolean)
    t.modules.math = true               -- Enable the math module (boolean)
    t.modules.mouse = true              -- Enable the mouse module (boolean)
    t.modules.physics = true            -- Enable the physics module (boolean)
    t.modules.sound = true              -- Enable the sound module (boolean)
    t.modules.system = true             -- Enable the system module (boolean)
    t.modules.timer = true              -- Enable the timer module (boolean), Disabling it will result 0 delta time in love.update
    t.modules.touch = true              -- Enable the touch module (boolean)
    t.modules.video = true              -- Enable the video module (boolean)
    t.modules.window = true             -- Enable the window module (boolean)
    t.modules.thread = true             -- Enable the thread module (boolean)
end

Here is a full list of options and their default values for LÖVE 0.9.2:

function love.conf(t)
    t.identity = nil                   -- The name of the save directory (string)
    t.version = "0.9.2"                -- The LÖVE version this game was made for (string)
    t.console = false                  -- Attach a console (boolean, Windows only)

    t.window.title = "Untitled"        -- The window title (string)
    t.window.icon = nil                -- Filepath to an image to use as the window's icon (string)
    t.window.width = 800               -- The window width (number)
    t.window.height = 600              -- The window height (number)
    t.window.borderless = false        -- Remove all border visuals from the window (boolean)
    t.window.resizable = false         -- Let the window be user-resizable (boolean)
    t.window.minwidth = 1              -- Minimum window width if the window is resizable (number)
    t.window.minheight = 1             -- Minimum window height if the window is resizable (number)
    t.window.fullscreen = false        -- Enable fullscreen (boolean)
    t.window.fullscreentype = "normal" -- Choose between "normal" fullscreen or "desktop" fullscreen mode (string)
    t.window.vsync = true              -- Enable vertical sync (boolean)
    t.window.fsaa = 0                  -- The number of samples to use with multi-sampled antialiasing (number)
    t.window.display = 1               -- Index of the monitor to show the window in (number)
    t.window.highdpi = false           -- Enable high-dpi mode for the window on a Retina display (boolean)
    t.window.srgb = false              -- Enable sRGB gamma correction when drawing to the screen (boolean)
    t.window.x = nil                   -- The x-coordinate of the window's position in the specified display (number)
    t.window.y = nil                   -- The y-coordinate of the window's position in the specified display (number)

    t.modules.audio = true             -- Enable the audio module (boolean)
    t.modules.event = true             -- Enable the event module (boolean)
    t.modules.graphics = true          -- Enable the graphics module (boolean)
    t.modules.image = true             -- Enable the image module (boolean)
    t.modules.joystick = true          -- Enable the joystick module (boolean)
    t.modules.keyboard = true          -- Enable the keyboard module (boolean)
    t.modules.math = true              -- Enable the math module (boolean)
    t.modules.mouse = true             -- Enable the mouse module (boolean)
    t.modules.physics = true           -- Enable the physics module (boolean)
    t.modules.sound = true             -- Enable the sound module (boolean)
    t.modules.system = true            -- Enable the system module (boolean)
    t.modules.timer = true             -- Enable the timer module (boolean), Disabling it will result 0 delta time in love.update
    t.modules.window = true            -- Enable the window module (boolean)
    t.modules.thread = true            -- Enable the thread module (boolean)
end

Here is a full list of options and their default values for LÖVE 0.9.1:

function love.conf(t)
    t.identity = nil                   -- The name of the save directory (string)
    t.version = "0.9.1"                -- The LÖVE version this game was made for (string)
    t.console = false                  -- Attach a console (boolean, Windows only)

    t.window.title = "Untitled"        -- The window title (string)
    t.window.icon = nil                -- Filepath to an image to use as the window's icon (string)
    t.window.width = 800               -- The window width (number)
    t.window.height = 600              -- The window height (number)
    t.window.borderless = false        -- Remove all border visuals from the window (boolean)
    t.window.resizable = false         -- Let the window be user-resizable (boolean)
    t.window.minwidth = 1              -- Minimum window width if the window is resizable (number)
    t.window.minheight = 1             -- Minimum window height if the window is resizable (number)
    t.window.fullscreen = false        -- Enable fullscreen (boolean)
    t.window.fullscreentype = "normal" -- Standard fullscreen or desktop fullscreen mode (string)
    t.window.vsync = true              -- Enable vertical sync (boolean)
    t.window.fsaa = 0                  -- The number of samples to use with multi-sampled antialiasing (number)
    t.window.display = 1               -- Index of the monitor to show the window in (number)
    t.window.highdpi = false           -- Enable high-dpi mode for the window on a Retina display (boolean)
    t.window.srgb = false              -- Enable sRGB gamma correction when drawing to the screen (boolean)

    t.modules.audio = true             -- Enable the audio module (boolean)
    t.modules.event = true             -- Enable the event module (boolean)
    t.modules.graphics = true          -- Enable the graphics module (boolean)
    t.modules.image = true             -- Enable the image module (boolean)
    t.modules.joystick = true          -- Enable the joystick module (boolean)
    t.modules.keyboard = true          -- Enable the keyboard module (boolean)
    t.modules.math = true              -- Enable the math module (boolean)
    t.modules.mouse = true             -- Enable the mouse module (boolean)
    t.modules.physics = true           -- Enable the physics module (boolean)
    t.modules.sound = true             -- Enable the sound module (boolean)
    t.modules.system = true            -- Enable the system module (boolean)
    t.modules.timer = true             -- Enable the timer module (boolean)
    t.modules.window = true            -- Enable the window module (boolean)
    t.modules.thread = true            -- Enable the thread module (boolean)
end

Here is a full list of options and their default values for LÖVE 0.9.0:

function love.conf(t)
    t.identity = nil                   -- The name of the save directory (string)
    t.version = "0.9.0"                -- The LÖVE version this game was made for (string)
    t.console = false                  -- Attach a console (boolean, Windows only)

    t.window.title = "Untitled"        -- The window title (string)
    t.window.icon = nil                -- Filepath to an image to use as the window's icon (string)
    t.window.width = 800               -- The window width (number)
    t.window.height = 600              -- The window height (number)
    t.window.borderless = false        -- Remove all border visuals from the window (boolean)
    t.window.resizable = false         -- Let the window be user-resizable (boolean)
    t.window.minwidth = 1              -- Minimum window width if the window is resizable (number)
    t.window.minheight = 1             -- Minimum window height if the window is resizable (number)
    t.window.fullscreen = false        -- Enable fullscreen (boolean)
    t.window.fullscreentype = "normal" -- Standard fullscreen or desktop fullscreen mode (string)
    t.window.vsync = true              -- Enable vertical sync (boolean)
    t.window.fsaa = 0                  -- The number of samples to use with multi-sampled antialiasing (number)
    t.window.display = 1               -- Index of the monitor to show the window in (number)

    t.modules.audio = true             -- Enable the audio module (boolean)
    t.modules.event = true             -- Enable the event module (boolean)
    t.modules.graphics = true          -- Enable the graphics module (boolean)
    t.modules.image = true             -- Enable the image module (boolean)
    t.modules.joystick = true          -- Enable the joystick module (boolean)
    t.modules.keyboard = true          -- Enable the keyboard module (boolean)
    t.modules.math = true              -- Enable the math module (boolean)
    t.modules.mouse = true             -- Enable the mouse module (boolean)
    t.modules.physics = true           -- Enable the physics module (boolean)
    t.modules.sound = true             -- Enable the sound module (boolean)
    t.modules.system = true            -- Enable the system module (boolean)
    t.modules.timer = true             -- Enable the timer module (boolean)
    t.modules.window = true            -- Enable the window module (boolean)
    t.modules.thread = true            -- Enable the thread module (boolean)
end

Here is a full list of options and their default values for LÖVE 0.8.0:

function love.conf(t)
    t.title = "Untitled"        -- The title of the window the game is in (string)
    t.author = "Unnamed"        -- The author of the game (string)
    t.url = nil                 -- The website of the game (string)
    t.identity = nil            -- The name of the save directory (string)
    t.version = "0.8.0"         -- The LÖVE version this game was made for (string)
    t.console = false           -- Attach a console (boolean, Windows only)
    t.release = false           -- Enable release mode (boolean)
    t.screen.width = 800        -- The window width (number)
    t.screen.height = 600       -- The window height (number)
    t.screen.fullscreen = false -- Enable fullscreen (boolean)
    t.screen.vsync = true       -- Enable vertical sync (boolean)
    t.screen.fsaa = 0           -- The number of MSAA samples (number)
    t.modules.joystick = true   -- Enable the joystick module (boolean)
    t.modules.audio = true      -- Enable the audio module (boolean)
    t.modules.keyboard = true   -- Enable the keyboard module (boolean)
    t.modules.event = true      -- Enable the event module (boolean)
    t.modules.image = true      -- Enable the image module (boolean)
    t.modules.graphics = true   -- Enable the graphics module (boolean)
    t.modules.timer = true      -- Enable the timer module (boolean)
    t.modules.mouse = true      -- Enable the mouse module (boolean)
    t.modules.sound = true      -- Enable the sound module (boolean)
    t.modules.physics = true    -- Enable the physics module (boolean)
    t.modules.thread = true     -- Enable the thread module (boolean)
end

Here is a full list of options and their default values for LÖVE 0.7.2 and earlier:

function love.conf(t)
    t.title = "Untitled"        -- The title of the window the game is in (string)
    t.author = "Unnamed"        -- The author of the game (string)
    t.identity = nil            -- The name of the save directory (string)
    t.version = 0               -- The LÖVE version this game was made for (number)
    t.console = false           -- Attach a console (boolean, Windows only)
    t.screen.width = 800        -- The window width (number)
    t.screen.height = 600       -- The window height (number)
    t.screen.fullscreen = false -- Enable fullscreen (boolean)
    t.screen.vsync = true       -- Enable vertical sync (boolean)
    t.screen.fsaa = 0           -- The number of MSAA samples (number)
    t.modules.joystick = true   -- Enable the joystick module (boolean)
    t.modules.audio = true      -- Enable the audio module (boolean)
    t.modules.keyboard = true   -- Enable the keyboard module (boolean)
    t.modules.event = true      -- Enable the event module (boolean)
    t.modules.image = true      -- Enable the image module (boolean)
    t.modules.graphics = true   -- Enable the graphics module (boolean)
    t.modules.timer = true      -- Enable the timer module (boolean)
    t.modules.mouse = true      -- Enable the mouse module (boolean)
    t.modules.sound = true      -- Enable the sound module (boolean)
    t.modules.physics = true    -- Enable the physics module (boolean)
end

See Also


Other Languages