love.window.setMode (Français)

Disponible depuis LÖVE 0.9.0
Moved from love.graphics.setMode.


Règle le mode d'affichage et les propriétés de la fenêtre.

Si la largeur et la hauteur sont 0, setMode utilisera la largeur et hauteur du bureau.

Changer le mode d'affichage pourrait avoir des effets de bord : Par exemple, les canvas (toile, om sont dessiner les motifs) sera nettoyée et les valeurs envoyées aux shaders avec Shader:send (Français) seront effacées. Soyez sûr de sauvegarder le contenu du canvas auparavant, ou de le retracer juste après, si vous en avez besoin.

Fonction

Synopsis

success = love.window.setMode( width, height, flags )

Arguments

number (Français) width
Largeur de l'affichage.
number (Français) height
hauteur de l'affichage.
table (Français) flags
La table des drapeaux avec les options:
boolean (Français) fullscreen (false)
Plein écran (true (vrai)), ou fenêtré (false (faux)).
FullscreenType (Français) fullscreentype ("desktop")
Le type de plein écran à utiliser. Cela met à "normal" par défaut depuis 0.9.0 jusqu'à 0.9.2 et à bureau avec 0.10.0 et plus ancien.
number (Français) vsync (1)
Active ou désactive la synchronisation verticale ('vsync'): 1 pour l'activer, 0 pour la désactiver, et -1 pour utiliser la vsync adaptative (où elle est supportée). Avant la version 11.0 c'était un drapeau booléen, plutôt qu'un nombre.
number (Français) msaa (0)
Le nombre d'échantillons pour l'anticrénelage.
boolean (Français) stencil (true)
Si un tampon de stencil doit être alloué. Si true (vrai, le tampon de stencil sera de 8 bits.
number (Français) depth (0)
Le nombre de bits dans le tampon de profondeur.
boolean (Français) resizable (false)
True (vrai) si la fenêtre soit être redimensionnable en mode fenêtré, false (faux) autrement.
boolean (Français) borderless (false)
True (vrai) si la fenêtre ne doit pas avoir de bordure en mode fenêtré ou bien false (faux) sinon.
boolean (Français) centered (true)
True (vrai) si la fenêtre doit être centrée en mode fenêtré ou bien false (faux) sinon.
number (Français) display (1)
L'index de l'écran dans lequel affiché la fenêtre, si plusieurs moniteurs sont disponibles.
number (Français) minwidth (1)
La largeur minimum de la fenêtre, si elle est redimensionnable. Ne peut etre inférieur à 1.
number (Français) minheight (1)
La hauteur minimum de la fenêtre, si elle est redimensionnable. Ne peut etre inférieur à 1.
Disponible depuis LÖVE 0.9.1
boolean (Français) highdpi (false)
True (vrai) si le mode haute dansiteé de ppp doit être utilisé sur des écrans Retina avec macOS et iOS. Ne fait rien sur des écrans non-Retina. C'est toujours activé avec Android.


Disponible depuis LÖVE 0.9.2
number x (nil)
La coordonnée en x de la position de la fenêtre dans l'écran spécifié.
number y (nil)
La coordonnée en y de la position de la fenêtre dans l'écran spécifié.


Disponible depuis LÖVE 11.3
boolean (Français) usedpiscale (true)
Désactive le changement d'échelle ppp automatique de LOVE sur les écrans à haut ppp lorsque false (faux). Cela n'a d'effet que lorsque le drapeau highdpi est réglé à true (vrai), comme le système d'exploitation (plutôt que LOVE) prend tout en charge autrement.


Disponible depuis LÖVE 0.9.1 et supprimé avec LÖVE 0.10.0
boolean (Français) srgb (false)
Supprimé avec 0.10.0 (règle t.gammacorrect dans conf.lua à la place). True (vrai) si la correction gamma sRGB doit être appliquée lorsque l'on trace à l'écran.


Retourne

boolean (Français) success
True (vrai) si effectué avec succès, false (faux) autrement.

Notes

love.conf pourrait comporter une documentation plus importante sur le comportement des drapeaux de fenêtre.

  • Si le plein écran est activé et que la largeur et hauteur ne sont pas supportéss (voir love.window.getFullscreenModes (Français)), la fenêtre pourrait être redimensionnée à la résolution la plus proche disponible et un évenement resize (redimensionnement) sera déclenché.
  • Si le type de plein écran est réglé à '« bureau », alors la fenêtre sera automatiquement redimensionnée à la résolution du bureau.
  • Si la largeur et hauteur sont plus grandes ou égales aux dimensions du bureau (cela inclus le réglage des deux paramètres à 0) et plein écran est réglé à false (faux), elle apparaître en plein écran « visuellement », mais ça n'est pas le vrai plein écran et love.window.getFullscreen (Français) retournera false (faux) dans ce cas. Cela s'applique également à love.window.updateMode (Français).
  • Si vous avez désactivé la fenêtre dans conf.lua (c'est à dire t.window = false) et utilisez cette fonction pour créer manuellement la fenêtre, vous ne devez alors pas appeler une quelconque des fonctions love.graphics.* avant celle-ci. Faire cela résulterait par un comportement imprévisible et/ou un plantage, parce qu'OpenGL ne peut pas fonctionner correctement sans une fenêtre.
  • Avec Android, le rapport d'aspect, déduit de la largeur et de la hauteur est utilisé pour déterminer si le jeu doit fonctionner en mode paysage ou portrait.
  • Les fond transparents ne sont actuellement pas supportés.

Exemples

Rend la fenêtre redimensionnable avec la vsync désactivée et une largeur et hauteur minimales réglées.

function love.load()
    love.window.setMode(800, 600, {resizable=true, vsync=false, minwidth=400, minheight=300})
end

Règle l'orientation à portrait

Par exemple, pour les écrans portrait d'Android :

function love.load()
    love.window.setMode(360, 640, {resizable=false})
end

La résolution sera changée à la résolution par défaut de l'écran, avec l'échelle en ppp.

Voir également


Autres langues