Difference between revisions of "WrapMode"

(update for love 0.6.2)
 
m
(22 intermediate revisions by 8 users not shown)
Line 1: Line 1:
How the image wraps inside a large [[Quad|Quad.]]
+
How the image wraps inside a [[Quad]] with a larger quad size than image size. This also affects how [[Mesh]]es with texture coordinates which are outside the range of [0, 1] are drawn, and the color returned by the <code>Texel</code> [[Shader]] function when using it to sample from texture coordinates outside of the range of [0, 1].
 +
 
 +
[[File:ComparisonWraps.png]]
 
== Constants ==
 
== Constants ==
;clamp: Clamp the image. Appears only once.
+
;clamp: Clamp the texture. Appears only once. The area outside the texture's normal range is colored based on the edge pixels of the texture.
;repeat: Repeat the image. Fills the whole available extent.
+
;repeat: Repeat the texture. Fills the whole available extent.
 +
{{New feature|0.9.2|
 +
;mirroredrepeat: Repeat the texture, flipping it each time it repeats. May produce better visual results than the <code>repeat</code> mode when the texture doesn't seamlessly tile.}}
 +
{{New feature|0.10.0|
 +
;clampzero: Clamp the texture. Fills the area outside the texture's normal range with transparent black (or opaque black for textures with no alpha channel.)}}
 +
 
 +
== Notes ==
 +
The <code>clampzero</code> mode is not available on most mobile devices, and will fall back to the <code>clamp</code> mode when it's unsupported. Check the <code>clampzero</code> [[GraphicsFeature]] constant by calling [[love.graphics.getSupported]].
 +
 
 
== See Also ==
 
== See Also ==
 
* [[parent::love.graphics]]
 
* [[parent::love.graphics]]
* [[(Image):getWrap]]
+
* [[Texture:setWrap]]
* [[(Image):setWrap]]
+
* [[Texture:getWrap]]
 
[[Category:Enums]]
 
[[Category:Enums]]
 
{{#set:Description=How the image wraps inside a large Quad.}}
 
{{#set:Description=How the image wraps inside a large Quad.}}
 +
{{#set:Since=000}}
 +
== Other Languages ==
 +
{{i18n|WrapMode}}

Revision as of 00:07, 20 July 2017

How the image wraps inside a Quad with a larger quad size than image size. This also affects how Meshes with texture coordinates which are outside the range of [0, 1] are drawn, and the color returned by the Texel Shader function when using it to sample from texture coordinates outside of the range of [0, 1].

ComparisonWraps.png

Constants

clamp
Clamp the texture. Appears only once. The area outside the texture's normal range is colored based on the edge pixels of the texture.
repeat
Repeat the texture. Fills the whole available extent.
Available since LÖVE 0.9.2
mirroredrepeat
Repeat the texture, flipping it each time it repeats. May produce better visual results than the repeat mode when the texture doesn't seamlessly tile.


Available since LÖVE 0.10.0
clampzero
Clamp the texture. Fills the area outside the texture's normal range with transparent black (or opaque black for textures with no alpha channel.)


Notes

The clampzero mode is not available on most mobile devices, and will fall back to the clamp mode when it's unsupported. Check the clampzero GraphicsFeature constant by calling love.graphics.getSupported.

See Also


Other Languages