Canvas (Français)

Disponible depuis LÖVE 0.8.0
Ceci est un renommage de Framebuffer.

Un Canvas (toile) est utilisé pour le rendu hors écran. Pensez à un écran invisible sur lequel vous pouvez dessiner, mais qui sera invisible jusqu'à ce que vous l'affichiez sur l'écran final qui sera visible. Cette technique est également connue sous le nom « rendu dans une texture ».

En dessinant des choses qui ne changent pas souvent de position (tels que les objets du fond) sur un Canvas, puis en dessinant le Canvas complet au lieu de chaque objets, vous pouvez réduire le nombre d'opération de tracé effectué à chaque image temporelle.

Dans les version précédentes à la 0.10.0, les cartes graphiques que supportaient LÖVE ne pouvaient pas toutes utiliser des Canvas. love.graphics.isSupported("canvas") pouvait être utilisé pour vérifier son support pendant l'exécution.

O.png Lorsque du contenu est dessiné sur un Canvas en utilisant un mixage alpha standard, les valeurs alpha de ce contenu sont multipliées avec leur valeurs RVB.

Les couleurs des pixels du Canvas auront donc un alpha prémultiplié une fois qu'il y aura été dessiné. Lorsque le Canvas est tracé à l'écran ou sur un autre Canvas, vous devez donc utiliser un mélange alpha prémultiplié – love.graphics.setBlendMode("alpha", "premultiplied").

 


Constructeurs

love.graphics.newCanvas (Français) Crée un nouveau Canvas.

Fonctions

O.png Toutes les fonctions n'ont peut être pas encore été traduites, veuillez vous référer à la version en anglais pour la liste complète.  


Canvas:generateMipmaps (Français) Génère des mipmaps pour le Canvas, en se basant sur le contenu du niveau de mipmap de résolution la plus élevée.
Canvas:getFormat (Français) Retourne le format de texture du Canevas.
Canvas:getMSAA (Français) Retourne le nombre d'échantillons de l'anticrénelage multi-échantillon (MSAA) utilisé lors du tracé du Canevas.
Canvas:getMipmapMode (Français) Récupère le MipmapMode (mode de mipmap) dans lequel ce Canvas a été créé.
Canvas:newImageData (Français) Génère un objet ImageData (données d'image) à partir du contenu du Canvas.
Canvas:renderTo (Français) Render to a Canvas using a function.
Object:release (Français) Détruit immédiatement la référence Lua à l'objet.
Object:type (Français) Retourne le type d'un objet comme une chaîne de caractère.
Object:typeOf (Français) Test si un objet est d'un certain type.
Texture:getDPIScale (Français) Retourne le facteur d'échelle en DPI (PPP) de la Texture.
Texture:getDepth (Français) Récupère la profondeur d'une Texture en volume.]].
Texture:getDepthSampleMode (Français) Récupère le mode de comparaison utilisé lors d'un échantillonnage depuis une depth texture (texture de profondeur) dans un shader.
Texture:getDimensions (Français) Retourne la largeur et hauteur de la Texture.
Texture:getFilter (Français) Retourne le mode de filtrage de la Texture.
Texture:getFormat (Français) Définit le format de pixel de la Texture.
Texture:getHeight (Français) Retourne la hauteur de la Texture.
Texture:getLayerCount (Français) Récupère le nombre de calques / tranches dans une Array Texture (texture en tableau).
Texture:getMipmapCount (Français) Retourne le nombre de mipmaps contenus dans la Texture.
Texture:getMipmapFilter (Français) Définit le mode de filtrage mimap pour une Texture.
Texture:getPixelDimensions (Français) Récupère la largeur et hauteur en pixels de la Texture.
Texture:getPixelHeight (Français) Récupère la hauteur, en pixels, de la Texture.
Texture:getPixelWidth (Français) Récupère la largeur, en pixels, de la Texture.
Texture:getTextureType (Français) Retourne le type de texture.
Texture:getWidth (Français) Retourne la largeur de la Texture.
Texture:getWrap (Français) Récupère les propriétés de bouclage d'une Texture.
Texture:isReadable (Français) Retourne si la Texture peut être ou non tracée et envoyée à un ombrage.
Texture:setDepthSampleMode (Français) Définit le mode de comparaison utilisé lors de l'échantillonnage depuis la texture de profondeur dans un ombrage.
Texture:setFilter (Français) Définit le mode de filtre de la Texture.
Texture:setMipmapFilter (Français) Sets the mipmap filter mode for a Texture. Added since 0.9.0
Texture:setWrap (Français) Définit les propriétés de bouclage d'une Texture.

Enums

MipmapMode (Français) Contrôle si un Canvas comporte des mipmaps, et sans comportement dans ce cas. Added since 11.0

Supertypes

Exemples

Dessiner quelque chose sur le Canvas, puis dessiner le Canvas à l'écran.

function love.load()
    canvas = love.graphics.newCanvas(800, 600)

    -- Un rectangle est dessiné sur le canvas avec une mode de mixage alpha standard.
    love.graphics.setCanvas(canvas)
        love.graphics.clear()
        love.graphics.setBlendMode("alpha")
        love.graphics.setColor(1, 0, 0, 0.5)
        love.graphics.rectangle('fill', 0, 0, 100, 100)
    love.graphics.setCanvas()
end

function love.draw()
    -- Trés important ! : remettez à zéro la couleur avant de dessiner sur le canvas, afin d'avoir les couleurs affichées corréctement.
    -- Voir cette discussion : https://love2d.org/forums/viewtopic.php?f=4&p=211418#p211418
    love.graphics.setColor(1, 1, 1, 1)

    -- Le rectangle du Canvas a déjà été mélangé en alpha.
    -- Utilise le mode mélange alpha prémultiplié lorsque dessine le Canvas lui-même, afin de prévenir des mélanges impropres.
    love.graphics.setBlendMode("alpha", "premultiplied")
    love.graphics.draw(canvas)
    -- Observez la différence si le Canvas est dessiné avec le mode mélange alpha standard à la place.
    love.graphics.setBlendMode("alpha")
    love.graphics.draw(canvas, 100, 0)

    -- Le rectangle est dessiné directement à l'écran avec le mode mélange alpha standard.
    love.graphics.setBlendMode("alpha")
    love.graphics.setColor(1, 0, 0, 0.5)
    love.graphics.rectangle('fill', 200, 0, 100, 100)
end

Voir également


Autres langues