Difference between revisions of "Texture:setFilter"

(Created page)
 
(Merge two variants.)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{newin|[[0.8.0]]|080|type=function}}
 
 
Sets the [[FilterMode|filter mode]] of the Texture.
 
Sets the [[FilterMode|filter mode]] of the Texture.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Texture:setFilter( min, mag )
+
Texture:setFilter( min, mag, anisotropy )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
 
{{param|FilterMode|min|Filter mode to use when minifying the texture (rendering it at a smaller size on-screen than its size in pixels).}}
 
{{param|FilterMode|min|Filter mode to use when minifying the texture (rendering it at a smaller size on-screen than its size in pixels).}}
{{param|FilterMode|mag|Filter mode to use when magnifying the texture (rendering it at a larger size on-screen than its size in pixels).}}
+
{{param|FilterMode|mag (min)|Filter mode to use when magnifying the texture (rendering it at a larger size on-screen than its size in pixels).}}
 +
{{New feature|0.9.0|
 +
{{param|number|anisotropy (1)|Maximum amount of anisotropic filtering to use.}}
 +
|090}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
== Function ==
+
=== Notes ===
{{newin|[[0.9.0]]|090|type=variant}}
+
When mipmapping is used, higher anisotropic filtering values increase the quality of the texture when rendering it with a non-uniform scale, at the expense of a bit of performance.
=== Synopsis ===
+
 
 +
Most systems support up to 8x or 16x anisotropic filtering.
 +
 
 +
=== Example ===
 
<source lang="lua">
 
<source lang="lua">
Texture:setFilter( min, mag, anisotropy )
+
Texture = love.graphics.newImage("char.png")
 +
Texture:setFilter("linear", "nearest")
 
</source>
 
</source>
=== Arguments ===
+
 
{{param|FilterMode|min|Filter mode to use when minifying the texture (rendering it at a smaller size on-screen than its size in pixels).}}
 
{{param|FilterMode|mag|Filter mode to use when magnifying the texture (rendering it at a larger size on-screen than its size in pixels).}}
 
{{param|number|anisotropy (1)|Maximum amount of anisotropic filtering to use.}}
 
=== Returns ===
 
Nothing.
 
 
== See Also ==
 
== See Also ==
 
* [[parent::Texture]]
 
* [[parent::Texture]]
 
* [[Texture:getFilter]]
 
* [[Texture:getFilter]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Sets the [[FilterMode|filter mode]] of the [[Texture]].}}
+
{{#set:Since=000}}
 +
{{#set:Description=Sets the [[FilterMode|filter mode]] of the Texture.}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|Texture:setFilter}}
 
{{i18n|Texture:setFilter}}

Latest revision as of 03:50, 25 May 2021

Sets the filter mode of the Texture.

Function

Synopsis

Texture:setFilter( min, mag, anisotropy )

Arguments

FilterMode min
Filter mode to use when minifying the texture (rendering it at a smaller size on-screen than its size in pixels).
FilterMode mag (min)
Filter mode to use when magnifying the texture (rendering it at a larger size on-screen than its size in pixels).
Available since LÖVE 0.9.0
number anisotropy (1)
Maximum amount of anisotropic filtering to use.

Returns

Nothing.

Notes

When mipmapping is used, higher anisotropic filtering values increase the quality of the texture when rendering it with a non-uniform scale, at the expense of a bit of performance.

Most systems support up to 8x or 16x anisotropic filtering.

Example

Texture = love.graphics.newImage("char.png")
Texture:setFilter("linear", "nearest")

See Also


Other Languages