love.graphics.newCubeImage (Français)

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

Crée une nouvelle Image cubemap (carte de cube).

O.png Cette fonction peut être lente si elle est appelée de façon répétée, comme depuis love.update ou love.draw. Si vous devez utiliser souvent une ressource spécifique, créez la une seule fois, et conservez la quelque part, elle peut être réutilisée !  



Les images cubemap possèdent 6 faces (côtés) représentant un cube. Elles ne peuvent être directement rendues, elle ne peuvent être utilisées qu'avec un code d'ombrage (Shader), et envoyé à l'ombrage via Shader:send).

Pour utiliser une image cubemap dans un ombrage, elle doit être déclarée en tant que type CubeImage ou samplerCube (cube d'échantillonnage), plutôt que Image ou sampler2D. La fonction d'ombrage Texel(CubeImage image, vec3 direction) doit être utilisée pour récupérer les couleurs des pixels du cubemap. L'argument vec3 est une direction normalisée (de longueur 1) depuis le centre du cube, plutôt que des coordonnées de texture explicites.

Chaque face dans une image cubemap doit être de dimensions carrée.

Pour les variantes de cette fonction qui acceptent une seule image contenant plusieurs faces de cubemap, elles doivent être arrangées dans l'une des formes de cette image :

   +y
-x +z +x -z
   -y

cubemap-sidecross-earth.png

ou :

+x
-x
+y
-y
+z
-z

cubemap-verticalstrip-earth.png

ou :

+x -x +y -y +z -z

cubemap-horizontalstrip-earth.png

ou :

   +y
+z +x -z
   -y
   -x

cubemap-upcross-earth.png

Il faut noter que cette forme, bien que semblant pouvoir être pliée en un cube, ne le peut pas : L'orientation des différentes faces est la même que dans trois autres mises en page.

Fonction

Crée une Image cubemap d'après un fichier d'image donné, contenant plusieurs faces du cube.

Synopsis

image = love.graphics.newCubeImage( filename, settings )

Arguments

{{param|string (Français)|filename|Chemin du fichier image cubemap (ou bien un File, FileData, ou ImageData).}

table (Français) settings (nil)
Table de réglages optionnelle pour congirguer l'image cubemap, contenant les champs suivants :
boolean (Français) mipmaps (false)
True (vrai) pour que l'image utilise des mipmaps, false (faux) pour les désactiver. Les mipmaps seront générés automatiquement si l'image n'est pas dans un format de texture compressée.
boolean (Français) linear (false)
True (vrai) pour traiter les pixels de l'image comme linéaires plutôt que sRGB, lorsque le rendu avec correction gamma est activé. La majorité des images sont crées en sRGB.

Retourne

Image (Français) image
Un objet Image cubemap.

Fonction

Crée une image cubemap depuis des fichiers d'image différents pour chaque face du cube.

Synopsis

image = love.graphics.newCubeImage( faces, settings )

Arguments

table (Français) faces
Table contenant 6 chemins de fichiers vers des images (ou des objets fichier, données de fichier, Données d'image, ou données d'images compressées), dans une table, dans l'ordre +x -x +y -y +z -z. Chaque image de face doit être des mêmes dimensions. Une table de tables peut également être passée, où chaque sous-table contient tous les niveaux de mipmap pour l'index de face de cube de cette sous-table.
table (Français) settings (nil)
Table optionnelle des réglages pour configurer l'image cubemap, contenant les champs suivants :
boolean (Français) mipmaps (false)
True (vrai) pour que l'image utilise des mipmaps, false (faux) pour les désactiver. Les mipmaps seront générés automatiquement si l'image n'est pas dans un format de texture compressée.
boolean (Français) linear (false)
True (vrai) pour traiter les pixels de l'image comme linéaires plutôt que sRGB, lorsque le rendu avec correction gamma est activé. La majorité des images sont crées en sRGB.

Retourne

Image (Français) image
Un objet Image cubemap.

Voir également


Autres langues