Difference between revisions of "Mesh:setVertex"
(Updated for 0.10.0) |
|||
| Line 1: | Line 1: | ||
{{newin|[[0.9.0]]|090|type=function}} | {{newin|[[0.9.0]]|090|type=function}} | ||
Sets the properties of a vertex in the Mesh. | Sets the properties of a vertex in the Mesh. | ||
| + | |||
== Function == | == Function == | ||
| + | {{newin|[[0.10.0]]|100|type=variant}} | ||
| + | === Synopsis === | ||
| + | <source lang="lua"> | ||
| + | Mesh:setVertex( index, attributecomponent, ... ) | ||
| + | </source> | ||
| + | === Arguments === | ||
| + | {{param|number|index|The index of the the vertex you want to modify.}} | ||
| + | {{param|number|attributecomponent|The first component of the first vertex attribute in the specified vertex.}} | ||
| + | {{param|number|...|Additional components of all vertex attributes in the specified vertex.}} | ||
| + | === Returns === | ||
| + | Nothing. | ||
| + | === Notes === | ||
| + | The arguments are in the same order as the vertex attributes in the Mesh's [[Mesh:getVertexFormat|vertex format]]. A standard Mesh that wasn't [[love.graphics.newMesh|created]] with a custom vertex format will use two position numbers, two texture coordinate numbers, and four color components per vertex: x, y, u, v, r, g, b, a. | ||
| + | |||
| + | If no value is supplied for a specific vertex attribute component, it will be set to a default value of 0 if its [[AttributeDataType|data type]] is "float", or 255 if its data type is "byte". | ||
| + | |||
| + | == Function == | ||
| + | {{newin|[[0.10.0]]|100|type=variant}} | ||
| + | === Synopsis === | ||
| + | <source lang="lua"> | ||
| + | Mesh:setVertex( index, vertex ) | ||
| + | </source> | ||
| + | === Arguments === | ||
| + | {{param|number|index|The index of the the vertex you want to modify.}} | ||
| + | {{param|table|vertex|A table with vertex information, in the form of <code>{attributecomponent, ...}</code>.}} | ||
| + | {{subparam|number|attributecomponent|The first component of the first vertex attribute in the specified vertex.}} | ||
| + | {{subparam|number|...|Additional components of all vertex attributes in the specified vertex.}} | ||
| + | === Returns === | ||
| + | Nothing. | ||
| + | === Notes === | ||
| + | The table indices are in the same order as the vertex attributes in the Mesh's [[Mesh:getVertexFormat|vertex format]]. A standard Mesh that wasn't [[love.graphics.newMesh|created]] with a custom vertex format will use two position numbers, two texture coordinate numbers, and four color components per vertex: x, y, u, v, r, g, b, a. | ||
| + | |||
| + | If no value is supplied for a specific vertex attribute component, it will be set to a default value of 0 if its [[AttributeDataType|data type]] is "float", or 255 if its data type is "byte". | ||
| + | |||
| + | == Function == | ||
| + | Sets the vertex components of a Mesh that wasn't [[love.graphics.newMesh|created]] with a custom vertex format. | ||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
| Line 18: | Line 55: | ||
=== Returns === | === Returns === | ||
Nothing. | Nothing. | ||
| + | |||
== Function == | == Function == | ||
| + | Sets the vertex components of a Mesh that wasn't [[love.graphics.newMesh|created]] with a custom vertex format. | ||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
| Line 36: | Line 75: | ||
=== Returns === | === Returns === | ||
Nothing. | Nothing. | ||
| + | |||
== See Also == | == See Also == | ||
* [[parent::Mesh]] | * [[parent::Mesh]] | ||
* [[Mesh:getVertex]] | * [[Mesh:getVertex]] | ||
* [[Mesh:getVertexCount]] | * [[Mesh:getVertexCount]] | ||
| + | * [[Mesh:getVertexFormat]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
{{#set:Description=Sets the properties of a vertex in the Mesh.}} | {{#set:Description=Sets the properties of a vertex in the Mesh.}} | ||
== Other Languages == | == Other Languages == | ||
{{i18n|Mesh:setVertex}} | {{i18n|Mesh:setVertex}} | ||
Revision as of 03:45, 18 December 2015
| Available since LÖVE 0.9.0 |
| This function is not supported in earlier versions. |
Sets the properties of a vertex in the Mesh.
Contents
Function
| Available since LÖVE 0.10.0 |
| This variant is not supported in earlier versions. |
Synopsis
Mesh:setVertex( index, attributecomponent, ... )
Arguments
number index- The index of the the vertex you want to modify.
number attributecomponent- The first component of the first vertex attribute in the specified vertex.
number ...- Additional components of all vertex attributes in the specified vertex.
Returns
Nothing.
Notes
The arguments are in the same order as the vertex attributes in the Mesh's vertex format. A standard Mesh that wasn't created with a custom vertex format will use two position numbers, two texture coordinate numbers, and four color components per vertex: x, y, u, v, r, g, b, a.
If no value is supplied for a specific vertex attribute component, it will be set to a default value of 0 if its data type is "float", or 255 if its data type is "byte".
Function
| Available since LÖVE 0.10.0 |
| This variant is not supported in earlier versions. |
Synopsis
Mesh:setVertex( index, vertex )
Arguments
number index- The index of the the vertex you want to modify.
table vertex- A table with vertex information, in the form of
{attributecomponent, ...}.
Returns
Nothing.
Notes
The table indices are in the same order as the vertex attributes in the Mesh's vertex format. A standard Mesh that wasn't created with a custom vertex format will use two position numbers, two texture coordinate numbers, and four color components per vertex: x, y, u, v, r, g, b, a.
If no value is supplied for a specific vertex attribute component, it will be set to a default value of 0 if its data type is "float", or 255 if its data type is "byte".
Function
Sets the vertex components of a Mesh that wasn't created with a custom vertex format.
Synopsis
Mesh:setVertex( index, x, y, u, v, r, g, b, a )
Arguments
number index- The index of the the vertex you want to modify.
number x- The position of the vertex (x-axis).
number y- The position of the vertex (y-axis).
number u- The horizontal component of the texture coordinate.
number v- The vertical component of the texture coordinate.
number r (255)- The red component of the vertex's color.
number g (255)- The green component of the vertex's color.
number b (255)- The blue component of the vertex's color.
number a (255)- The alpha component of the vertex's color.
Returns
Nothing.
Function
Sets the vertex components of a Mesh that wasn't created with a custom vertex format.
Synopsis
Mesh:setVertex( index, vertex )
Arguments
number index- The index of the the vertex you want to modify.
table vertex- A table with vertex information.
number [1]- The position of the vertex on the x-axis.
number [2]- The position of the vertex on the y-axis.
number [3]- The u texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see WrapMode.)
number [4]- The v texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see WrapMode.)
number [5] (255)- The red color component.
number [6] (255)- The green color component.
number [7] (255)- The blue color component.
number [8] (255)- The alpha color component.
Returns
Nothing.
See Also
Other Languages
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info
