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.
Contents
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.
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.
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.
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
- love.window (Français)
- love.window.getMode (Français)
- love.window.getFullscreenModes (Français)
- love.resize (Français)
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