Difference between revisions of "Mesh:setVertexColors"

(Geometry:setVertexColors -> Mesh:setVertexColors)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=function}}
 
{{newin|[[0.9.0]]|090|type=function}}
Sets if the per-vertex colors are used when rendering instead of the constant color (constant color being [[love.graphics.setColor]] or [[SpriteBatch:setColor]])
+
Sets whether per-vertex colors are used instead of the constant color when drawing the Mesh (constant color being [[love.graphics.setColor]].)
  
The per-vertex colors are automatically enabled by default when making a new [[Geometry]] or when doing [[Geometry:setVertex]], but only if at least one vertex color is not the default (255,255,255,255).
+
Per-vertex colors are enabled by default for a Mesh if at least one vertex color was not the default (255, 255, 255, 255) when the Mesh was [[love.graphics.newMesh|created]].
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Geometry:setVertexColors( on )
+
Mesh:setVertexColors( on )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|boolean|on|True to use per-vertex coloring.}}
+
{{param|boolean|on|True to use per-vertex coloring, otherwise [[love.graphics.setColor]] is used when drawing.}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 
== See Also ==
 
== See Also ==
* [[parent::Geometry]]
+
* [[parent::Mesh]]
* [[Geometry:hasVertexColors]]
+
* [[Mesh:hasVertexColors]]
* [[Geometry:setVertex]]
+
* [[love.graphics.newMesh]]
* [[love.graphics.setColor]]
 
* [[SpriteBatch:setColor]]
 
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Sets if the per-vertex colors are used when rendering instead of the constant color.}}
+
{{#set:Description=Sets whether per-vertex colors are used instead of the constant color when drawing the Mesh.}}
 
== Other Languages ==
 
== Other Languages ==
{{i18n|Geometry:setVertexColors}}
+
{{i18n|Mesh:setVertexColors}}

Revision as of 23:54, 9 October 2013

Available since LÖVE 0.9.0
This function is not supported in earlier versions.

Sets whether per-vertex colors are used instead of the constant color when drawing the Mesh (constant color being love.graphics.setColor.)

Per-vertex colors are enabled by default for a Mesh if at least one vertex color was not the default (255, 255, 255, 255) when the Mesh was created.

Function

Synopsis

Mesh:setVertexColors( on )

Arguments

boolean on
True to use per-vertex coloring, otherwise love.graphics.setColor is used when drawing.

Returns

Nothing.

See Also

Other Languages