Difference between revisions of "Canvas"
(being bold - this page only covers the 0.8.0 framebuffer/canvas, and images are auto-padded in 0.8.0 so PO2 syndrome should never be an issue) |
(Canvases do not auto-pad, this is intentional. It's likely that all implementations supporting framebuffers have the non-po2 textures extension, though. Added a less-in-your-face notice.) |
||
| Line 3: | Line 3: | ||
By drawing things that do not change position often (such as background items) to the Canvas, and then drawing the entire Canvas instead of each item, 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 Canvas, and then drawing the entire Canvas instead of each item, you can reduce the number of draw operations performed each frame. | ||
| + | |||
| + | Canvases can be susceptible to [[PO2_Syndrome| power of 2 syndrome]]. Most graphics cards that support Canvas should have PO2 texture support. However, there are some old cards that do not. Check with [[love.graphics.isSupported|love.graphics.isSupported("npot")]] if it is supported. | ||
== Constructors == | == Constructors == | ||
Revision as of 18:04, 3 September 2012
| Available since LÖVE 0.8.0 |
| It has been renamed from Framebuffer. |
A Canvas 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 Canvas, and then drawing the entire Canvas instead of each item, you can reduce the number of draw operations performed each frame.
Canvases can be susceptible to power of 2 syndrome. Most graphics cards that support Canvas should have PO2 texture support. However, there are some old cards that do not. Check with love.graphics.isSupported("npot") if it is supported.
Contents
Constructors
| love.graphics.newCanvas | Creates a new Canvas. |
Functions
| Canvas:clear | Clears the contents of a Canvas to a specific color. |
| Canvas:generateMipmaps | Generates mipmaps for the Canvas, based on the contents of the highest-resolution mipmap level. |
| Canvas:getFSAA | Gets the number of FSAA samples used when drawing to the Canvas. |
| Canvas:getFormat | Gets the texture format of the Canvas. |
| Canvas:getImageData | Generates ImageData from the contents of the Canvas. |
| Canvas:getMSAA | Gets the number of MSAA samples used when drawing to the Canvas. |
| Canvas:getMipmapMode | Gets the MipmapMode this Canvas was created with. |
| Canvas:getPixel | Gets the pixel at the specified position in a Canvas. |
| Canvas:newImageData | Generates ImageData from the contents of the Canvas. |
| Canvas:renderTo | Render to a Canvas using a function. |
| Object:release | Immediately destroys the object's Lua reference. |
| 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&start=20
See Also
Other Languages
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
