Difference between revisions of "Framebuffer"

m
 
(8 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{newin|[[0.7.0]]|070|type=type}}
+
{{newinoldin|[[0.7.0]]|070|[[0.8.0]]|080|type=type|text=It has been renamed to [[Canvas]]}}
A Framebuffer is used for off-screen rendering. Think of it as an invisible screen that you can draw to, but that will not be visible until you draw it to the actual visible screen.It is also known as "render to texture".
+
A Framebuffer is used for off-screen rendering. Think of it as an invisible screen that you can draw to, but that will not be visible until you draw it to the actual visible screen. It is also known as "render to texture".
By drawing things that do not change position often, such as background items, to the FrameBuffer, you can reduce the number of draw operations performed each frame.
+
 
 +
By drawing things that do not change position often (such as background items) to the Framebuffer, and then drawing the entire Framebuffer instead of each item, you can reduce the number of draw operations performed each frame.
  
 
== Constructors ==
 
== Constructors ==
Line 7: Line 8:
 
| headers=hide
 
| headers=hide
 
| default=None.
 
| default=None.
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 
}}
 
}}
 
== Functions ==
 
== Functions ==
{{#ask: [[Category:Functions]] [[parent::Framebuffer||Drawable||Object]] [[Since::<072]]
+
{{#ask: [[Category:Functions]] [[parent::Framebuffer||Drawable||Object]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 
}}
 
}}
 
== Supertypes ==
 
== Supertypes ==
 
* [[parent::Drawable]]
 
* [[parent::Drawable]]
 
* [[parent::Object]]
 
* [[parent::Object]]
 +
== Examples ==
 +
=== sample from the forum ===
 +
http://love2d.org/forums/viewtopic.php?f=4&t=2136&hilit=Framebuffer&start=20
 +
 
== See Also ==
 
== See Also ==
 
* [[parent::love.graphics]]
 
* [[parent::love.graphics]]

Latest revision as of 16:06, 27 December 2015

Available since LÖVE 0.7.0 and removed in LÖVE 0.8.0
It has been renamed to Canvas.

A Framebuffer is used for off-screen rendering. Think of it as an invisible screen that you can draw to, but that will not be visible until you draw it to the actual visible screen. It is also known as "render to texture".

By drawing things that do not change position often (such as background items) to the Framebuffer, and then drawing the entire Framebuffer instead of each item, you can reduce the number of draw operations performed each frame.

Constructors

love.graphics.newFramebuffer Creates a new Framebuffer. Added since 0.7.0 Removed in 0.8.0

Functions

Framebuffer:getImageData Get stored ImageData. Added since 0.7.0 Removed in 0.8.0
Framebuffer:getWrap Gets the wrapping properties of a Framebuffer. Added since 0.7.2 Removed in 0.8.0
Framebuffer:renderTo Render to a framebuffer using a function. Added since 0.7.0 Removed in 0.8.0
Framebuffer:setWrap Sets the wrapping properties of a Framebuffer. Added since 0.7.2 Removed in 0.8.0
Object:release Immediately destroys the object's Lua reference. Added since 11.0
Object:type Gets the type of the object as a string.
Object:typeOf Checks whether an object is of a certain type.

Supertypes

Examples

sample from the forum

http://love2d.org/forums/viewtopic.php?f=4&t=2136&hilit=Framebuffer&start=20

See Also

Other Languages