Difference between revisions of "love.graphics.setBackgroundColor"

m
m
 
(12 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
Sets the background color.
 
Sets the background color.
 +
 +
{{notice|In versions prior to [[11.0]], color component values were within the range of 0 to 255 instead of 0 to 1.}}
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
love.graphics.setBackgroundColor( red, green, blue )
+
love.graphics.setBackgroundColor( red, green, blue, alpha )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|number|red|The red component (0-255).}}
+
{{param|number|red|The red component (0-1).}}
{{param|number|green|The green component (0-255).}}
+
{{param|number|green|The green component (0-1).}}
{{param|number|blue|The blue component (0-255).}}
+
{{param|number|blue|The blue component (0-1).}}
 +
{{New feature|0.8.0|
 +
{{param|number|alpha (1)|The alpha component (0-1).}}
 +
|080}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
  
 
== Function ==
 
== Function ==
{{newin|[[0.8.0]]|080|type=variant}}
+
{{newin|[[0.7.0]]|070|type=variant}}
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
love.graphics.setBackgroundColor( red, green, blue, alpha )
+
love.graphics.setBackgroundColor( rgb )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|number|red|The red component (0-255).}}
+
{{param|table|rgb|A numerical indexed table with the red, green and blue values as [[number]]s.}}
{{param|number|green|The green component (0-255).}}
 
{{param|number|blue|The blue component (0-255).}}
 
{{param|number|alpha|The alpha component (0-255).}}
 
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
  
 
== Function ==
 
== Function ==
{{newin|[[0.7.0]]|070|type=variant}}
+
{{newin|[[0.8.0]]|080|type=variant}}
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
love.graphics.setBackgroundColor( rgb )
+
love.graphics.setBackgroundColor( rgba )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|table|rgb|A numerical indexed table with the red, green and blue values as [[number]]s.}}
+
{{param|table|rgba|A numerical indexed table with the red, green, blue and alpha values as [[number]]s.}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
 +
== Examples ==
 +
<source lang="lua">
 +
-- set background color to #84C1EE (132, 193, 238)
 +
local r, g, b = love.math.colorFromBytes(132, 193, 238)
 +
love.graphics.setBackgroundColor(r, g, b)
 +
 +
 +
function love.draw()
 +
-- draw any geometry:
 +
love.graphics.setColor(1,1,1)
 +
love.graphics.circle('fill', 400, 300, 250)
 +
love.graphics.setColor(0,0,0)
 +
love.graphics.circle('line', 400, 300, 250)
 +
end
 +
</source>
  
 
== See Also ==
 
== See Also ==
 
* [[parent::love.graphics]]
 
* [[parent::love.graphics]]
 +
* [[love.graphics.clear]]
 +
* [[love.graphics.getBackgroundColor]]
 +
* [[love.run]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
{{#set:Description=Sets the background color.}}
 
{{#set:Description=Sets the background color.}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 +
{{#set:Sub-Category=State}}
 +
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.graphics.setBackgroundColor}}
 
{{i18n|love.graphics.setBackgroundColor}}

Latest revision as of 18:32, 18 February 2024

Sets the background color.

O.png In versions prior to 11.0, color component values were within the range of 0 to 255 instead of 0 to 1.  


Function

Synopsis

love.graphics.setBackgroundColor( red, green, blue, alpha )

Arguments

number red
The red component (0-1).
number green
The green component (0-1).
number blue
The blue component (0-1).
Available since LÖVE 0.8.0
number alpha (1)
The alpha component (0-1).

Returns

Nothing.

Function

Available since LÖVE 0.7.0
This variant is not supported in earlier versions.

Synopsis

love.graphics.setBackgroundColor( rgb )

Arguments

table rgb
A numerical indexed table with the red, green and blue values as numbers.

Returns

Nothing.

Function

Available since LÖVE 0.8.0
This variant is not supported in earlier versions.

Synopsis

love.graphics.setBackgroundColor( rgba )

Arguments

table rgba
A numerical indexed table with the red, green, blue and alpha values as numbers.

Returns

Nothing.

Examples

-- set background color to #84C1EE (132, 193, 238)
local r, g, b = love.math.colorFromBytes(132, 193, 238)
love.graphics.setBackgroundColor(r, g, b)


function love.draw()
	-- draw any geometry:
	love.graphics.setColor(1,1,1)
	love.graphics.circle('fill', 400, 300, 250)
	love.graphics.setColor(0,0,0)
	love.graphics.circle('line', 400, 300, 250)
end

See Also



Other Languages