love.graphics.newCanvas (简体中文)

自 LÖVE 0.8.0 可以使用
love.graphics.newFramebuffer 重命名而来.

创建一个新的 Canvas(画布) 对象用来进行离屏渲染。

O.png 这个函数在被重复多次调用的时候,比如 love.update (简体中文) 或者 love.draw (简体中文)中, 可能会很慢。如果你需要频繁地使用一个特定的资源,创建一次并且存储起来,以此来重复使用!  



函数

基础使用

canvas = love.graphics.newCanvas( )

参数

无。

返回值

Canvas canvas
一个像素大小等于窗口的Canvas。

函数

基础使用

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

参数

number width
期望的 Canvas(画布)的宽。
number height
期望的 Canvas(画布)的高。

返回值

Canvas canvas
一个指定大小的 Canvas(画布)对象。

函数

自 LÖVE 0.9.0 可以使用
此 variant 在早期版本中不受支持.

基础使用

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

参数

number width (window_width)
期望的 Canvas(画布)的宽。
number height (window_height)
期望的 Canvas(画布)的高。
CanvasFormat format ("normal")
期望的纹理格式

返回值

Canvas canvas
一个指定大小的 Canvas(画布)对象。

注意事项

一些 Canvas 格式有较高的系统要求,使用 love.graphics.getCanvasFormats (简体中文) 来检查是否支持。

函数

自 LÖVE 0.9.1 可以使用
此 variant 在早期版本中不受支持.

基础使用

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

参数

number width (window_width)
期望的 Canvas(画布)的宽。
number height (window_height)
期望的 Canvas(画布)的高。
CanvasFormat format ("normal")
期望的纹理格式。
number msaa (0)
在绘制时期望的[[1]]采样数。

返回值

Canvas canvas
一个指定大小的 Canvas(画布)对象。

注意事项

可支持的MSAA最大采样数取决与系统。使用 love.graphics.getSystemLimits (简体中文) 获取最大限制。

如果指定的数字大于系统允许的最大限制,Canvas 对象依旧会被创建,同时使用最大的采样数(包括 0)。

参见


其他语言