Difference between revisions of "GraphicsLimit"

m
m (Updated link (function was renamed))
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{newin|[[0.9.1]]|091|type=enum}}
 
{{newin|[[0.9.1]]|091|type=enum}}
Types of system-dependent graphics limits checked for using [[love.graphics.getSystemLimit]].
+
Types of system-dependent graphics limits checked for using [[love.graphics.getSystemLimits]].
 
== Constants ==
 
== Constants ==
;pointsize: The maximum size of [[love.graphics.point|points]].
+
;pointsize: The maximum size of [[love.graphics.points|points]].
 
;texturesize: The maximum width or height of [[Image]]s and [[Canvas]]es.
 
;texturesize: The maximum width or height of [[Image]]s and [[Canvas]]es.
 
;multicanvas: The maximum number of simultaneously active canvases (via [[love.graphics.setCanvas]].)
 
;multicanvas: The maximum number of simultaneously active canvases (via [[love.graphics.setCanvas]].)
{{newin|[[0.9.2]]|092|type=constant|text=This constant has been renamed from '''canvasfsaa'''}}
+
 
 +
{{New feature|0.10.0|
 
;canvasmsaa: The maximum number of antialiasing samples for a [[love.graphics.newCanvas|Canvas]].
 
;canvasmsaa: The maximum number of antialiasing samples for a [[love.graphics.newCanvas|Canvas]].
{{oldin|[[0.10.0]]|100|type=constant|text=This constant has been renamed to '''canvasmsaa'''}}
+
}}
 +
 
 +
{{New feature|11.0|
 +
;texturelayers: The maximum number of layers in an [[TextureType|Array texture]].
 +
;volumetexturesize: The maximum width, height, or depth of a [[TextureType|Volume texture]].
 +
;cubetexturesize: The maximum width or height of a [[TextureType|Cubemap texture]].
 +
;anisotropy: The maximum amount of anisotropic filtering. [[Texture:setMipmapFilter]] internally clamps the given anisotropy value to the system's limit.
 +
}}
 +
 
 +
{{Removed feature|0.10.0|
 
;canvasfsaa: The maximum number of antialiasing samples for a [[love.graphics.newCanvas|Canvas]].
 
;canvasfsaa: The maximum number of antialiasing samples for a [[love.graphics.newCanvas|Canvas]].
 
+
}}
 
== Notes ==
 
== Notes ==
 
Attempting to create an [[Image]] with a width '''or''' height greater than the maximum supported will create a checkerboard-patterned image instead. Doing the same for a [[Canvas]] will result in an error.
 
Attempting to create an [[Image]] with a width '''or''' height greater than the maximum supported will create a checkerboard-patterned image instead. Doing the same for a [[Canvas]] will result in an error.
  
It's safe to assume the maximum texture size will never be less than 1024 and will almost always be 2048 or greater.There is an [http://feedback.wildfiregames.com/report/opengl/feature/GL_MAX_TEXTURE_SIZE online database] which has collected info about the max texture size for various systems.
+
It's safe to assume the maximum texture size will always be 2048 or greater. There is an [http://feedback.wildfiregames.com/report/opengl/feature/GL_MAX_TEXTURE_SIZE online database] which has collected info about the max texture size for various systems.
  
The value for the '''multicanvas''' system limit will be at least 4, as long as multi-canvas rendering is [[GraphicsFeature|supported]].
+
The value for the '''multicanvas''' system limit will generally be either 1, 4, or 8.
  
 
== See Also ==
 
== See Also ==
 
* [[parent::love.graphics]]
 
* [[parent::love.graphics]]
* [[love.graphics.getSystemLimit]]
+
* [[love.graphics.getSystemLimits]]
* [[Canvas:getFSAA]]
+
* [[Canvas:getMSAA]]
 
[[Category:Enums]]
 
[[Category:Enums]]
 
{{#set:Description=Types of system-dependent graphics limits.}}
 
{{#set:Description=Types of system-dependent graphics limits.}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|GraphicsLimit}}
 
{{i18n|GraphicsLimit}}

Latest revision as of 10:51, 1 January 2019

Available since LÖVE 0.9.1
This enum is not supported in earlier versions.

Types of system-dependent graphics limits checked for using love.graphics.getSystemLimits.

Constants

pointsize
The maximum size of points.
texturesize
The maximum width or height of Images and Canvases.
multicanvas
The maximum number of simultaneously active canvases (via love.graphics.setCanvas.)


Available since LÖVE 0.10.0
canvasmsaa
The maximum number of antialiasing samples for a Canvas.


Available since LÖVE 11.0
texturelayers
The maximum number of layers in an Array texture.
volumetexturesize
The maximum width, height, or depth of a Volume texture.
cubetexturesize
The maximum width or height of a Cubemap texture.
anisotropy
The maximum amount of anisotropic filtering. Texture:setMipmapFilter internally clamps the given anisotropy value to the system's limit.


Removed in LÖVE 0.10.0
canvasfsaa
The maximum number of antialiasing samples for a Canvas.

Notes

Attempting to create an Image with a width or height greater than the maximum supported will create a checkerboard-patterned image instead. Doing the same for a Canvas will result in an error.

It's safe to assume the maximum texture size will always be 2048 or greater. There is an online database which has collected info about the max texture size for various systems.

The value for the multicanvas system limit will generally be either 1, 4, or 8.

See Also

Other Languages