love.graphics.newCanvas (Français)

Disponible depuis LÖVE 0.8.0
It has been renamed from love.graphics.newFramebuffer.

Créé un nouvel objet Canvas (toile) pour le rendu hors écran.

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 !  



Fonction

Synopsis

canvas = love.graphics.newCanvas( )

Arguments

Aucun.

Retourne

Canvas (Français) canvas
Un nouveau Canvas dont les dimensions sont égal à la taille de la fenêtre en pixels.

Fonction

Synopsis

canvas = love.graphics.newCanvas( width, height )

Arguments

number (Français) width
La largeur désirée du Canvas.
number (Français) height
La hauteur désirée du Canvas.

Returns

Canvas (Français) canvas
Un nouveau Canvas avec les largeur et hauteur spécifiées.

Fonction

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

Crée un Canvas 2D ou cubemap en utilisant les réglages fournis.

Synopsis

canvas = love.graphics.newCanvas( width, height, settings )

Arguments

number (Français) width
La largeur désirée du Canvas.
number (Français) height
La hauteur désirée du Canvas.
table (Français) settings
Une table contenant les champs fournis :
TextureType (Français) type ("2d")
Le type de Canvas à créer.
PixelFormat (Français) format ("normal")
Le format du Canvas.
boolean (Français) readable
Est-ce que le Canvas est lisible (traçable et accessible dans un Shader). True (Vrai) par défaut pour les formats réguliers, false (faux) par défaut pour les formats de profondeur/stencil.
number (Français) msaa (0)
Le nombre désiré d'échantillons d'anticrénelage multi-échantillon (MSAA) utilisé pour tracer sur le canvas.
number (Français) dpiscale (love.graphics.getDPIScale())
Le facteur d'échelle en DPI (point par pouce) du Canvas, utilisé lors du traçage sur le Canvas, ainsi que lorsque le Canvas Canvas est tracé à l'écran.
MipmapMode (Français) mipmaps ("none")
Est-ce que le Canvas possède des mipmaps, et, dans ce cas, est-ce qu'il faut les régénérer automatiquement.

Retourne

Canvas (Français) canvas
Un nouveau Canvas avec la largeur et hauteur spécifiée.

Notes

Certains formats de Canvas ont des prérequis système plus élevés que le format par défaut. Utilisez love.graphics.getCanvasFormats pour vérifier qu'il soit supporté.

Fonction

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

Crée un Canvas de type-texture volume ou table.

Synopsis

canvas = love.graphics.newCanvas( width, height, layers, settings )

Arguments

number (Français) width
La largeur désirée du Canvas.
number (Français) height
La hauteur désirée du Canvas.
number (Français) layers
Le nombre de calques de tables (si le Canvas est une Texture de table), ou le volume de la profondeur (Si le Canvas est une Texture de Volume).
table (Français) settings
Une tableau contenant les différents champs :
TextureType (Français) type ("array")
Le type de Canvas à créer.
PixelFormat (Français) format ("normal")
Le format du Canvas.
boolean (Français) readable
Est-ce que le Canvas est lisible (traçable et accessible dans un Shader). True (Vrai) par défaut pour les formats standards, false (Faux) par défaut pour les formats profondeur/stencil.
number (Français) msaa (0)
Le nombre désiré d'échantillons d'anticrénelage multi-échantillon (MSAA) utilisé pour tracer sur le canvas.
number (Français) Le facteur d'échelle en DPI (point par pouce) du Canvas, utilisé lors du traçage sur le Canvas, ainsi que lorsque le Canvas Canvas est tracé à l'écran.
Some description goes here.
MipmapMode (Français) mipmaps ("none")
Est-ce que le Canvas possède des mipmaps, et, dans ce cas, est-ce qu'il faut les régénérer automatiquement.

Retourne

Canvas (Français) canvas
Un nouveau Canvas avec la largeur et hauteur spécifiée.

Notes

Tous les types de textures ne sont pas supportés par tous les systèmes. love.graphics.getTextureTypes peut vérifier qu'il soit supporté.

Fonction

Disponible depuis LÖVE 0.9.0 et supprimé avec LÖVE 11.0
ce-tte variant n'est pas supporté dans des versions antérieures ou postérieures.

Synopsis

canvas = love.graphics.newCanvas( width, height, format )

Arguments

number (Français) width (window_width)
La largeur désirée du Canvas.
number (Français) height (window_height)
La hateur désirée du Canvas.
CanvasFormat (Français) format ("normal")
La format de texture désiré du Canvas.

Retourne

Canvas (Français) canvas
Un nouveau Canvas avec les largeurs et hauteurs spécifiées.

Notes

Certains formats de Canvas ont des prérequis système plus élevés que le format par défaut. Utilisez love.graphics.getCanvasFormats pour vérifier qu'il soit supporté.

Fonction

Disponible depuis LÖVE 0.9.1 et supprimé avec LÖVE 11.0
ce-tte variant n'est pas supporté dans des versions antérieures ou postérieures.

Synopsis

canvas = love.graphics.newCanvas( width, height, format, msaa )

Arguments

number (Français) width (window_width)
La largeur désirée du Canvas.
number (Français) height (window_height)
La hauteur désirée du Canvas.
CanvasFormat (Français) format ("normal")
La format de texture désiré du Canvas.
number (Français) msaa (0)
Le nombre désiré d'échantillons d'anticrénelage multi-échantillon (MSAA) utilisé pour tracer sur le canvas.

Retourne

Canvas (Français) canvas
Un nouveau Canvas avec les largeurs et hauteurs spécifiées.

Notes

  • Les différents types de textures ne sont pas tous supportés par tous les systèmes. love.graphics.getTextureTypes (Français) permet de vérifier qu'il soit supporté.
  • Quelques formats de Canvas ont des prérquis système plus élevés que le format par défaut. Utilisez love.graphics.getCanvasFormats (Français) pouv vérifier qu'il soit supporter.
  • Le nombre maximum d'échantillon MSAA supporté varie en fonction du système. Utilisez love.graphics.getSystemLimits (Français) pour vérifier.
  • Si le nombre d'échantillons MSSA spécifié est plus élevé que le maximum supporté par le système, le Canvas sera toujours créé, mais uniquement en utilisant seulement la quantité supportée (cela inclus 0.)

Voir également


Autres langues