Difference between revisions of "Mesh:setVertex"
m |
(Updated for 11.0) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 2: | Line 2: | ||
Sets the properties of a vertex in the Mesh. | Sets the properties of a vertex in the Mesh. | ||
| + | In versions prior to [[11.0]], color and byte component values were within the range of 0 to 255 instead of 0 to 1. | ||
== Function == | == Function == | ||
{{newin|[[0.10.0]]|100|type=variant}} | {{newin|[[0.10.0]]|100|type=variant}} | ||
| Line 9: | Line 10: | ||
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | {{param|number|index|The index of the the vertex you want to modify.}} | + | {{param|number|index|The index of the the vertex you want to modify (one-based).}} |
{{param|number|attributecomponent|The first component of the first vertex attribute in the specified vertex.}} | {{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.}} | {{param|number|...|Additional components of all vertex attributes in the specified vertex.}} | ||
| Line 17: | Line 18: | ||
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. | 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 | + | 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 1 if its data type is "byte". |
== Function == | == Function == | ||
| Line 26: | Line 27: | ||
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | {{param|number|index|The index of the the vertex you want to modify.}} | + | {{param|number|index|The index of the the vertex you want to modify (one-based).}} |
{{param|table|vertex|A table with vertex information, in the form of <code>{attributecomponent, ...}</code>.}} | {{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|attributecomponent|The first component of the first vertex attribute in the specified vertex.}} | ||
| Line 35: | Line 36: | ||
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. | 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 | + | 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 1 if its data type is "byte". |
== Function == | == Function == | ||
| Line 44: | Line 45: | ||
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | {{param|number|index|The index of the the vertex you want to modify.}} | + | {{param|number|index|The index of the the vertex you want to modify (one-based).}} |
{{param|number|x|The position of the vertex on the x-axis.}} | {{param|number|x|The position of the vertex on the x-axis.}} | ||
{{param|number|y|The position of the vertex on the y-axis.}} | {{param|number|y|The position of the vertex on the y-axis.}} | ||
{{param|number|u|The horizontal component of the texture coordinate.}} | {{param|number|u|The horizontal component of the texture coordinate.}} | ||
{{param|number|v|The vertical component of the texture coordinate.}} | {{param|number|v|The vertical component of the texture coordinate.}} | ||
| − | {{param|number|r ( | + | {{param|number|r (1)|The red component of the vertex's color.}} |
| − | {{param|number|g ( | + | {{param|number|g (1)|The green component of the vertex's color.}} |
| − | {{param|number|b ( | + | {{param|number|b (1)|The blue component of the vertex's color.}} |
| − | {{param|number|a ( | + | {{param|number|a (1)|The alpha component of the vertex's color.}} |
=== Returns === | === Returns === | ||
Nothing. | Nothing. | ||
| Line 63: | Line 64: | ||
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | {{param|number|index|The index of the the vertex you want to modify.}} | + | {{param|number|index|The index of the the vertex you want to modify (one-based).}} |
{{param|table|vertex|A table with vertex information.}} | {{param|table|vertex|A table with vertex information.}} | ||
{{subparam|number|[1]|The position of the vertex on the x-axis.}} | {{subparam|number|[1]|The position of the vertex on the x-axis.}} | ||
| Line 69: | Line 70: | ||
{{subparam|number|[3]|The u texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see [[WrapMode]].)}} | {{subparam|number|[3]|The u texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see [[WrapMode]].)}} | ||
{{subparam|number|[4]|The v texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see [[WrapMode]].)}} | {{subparam|number|[4]|The v texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see [[WrapMode]].)}} | ||
| − | {{subparam|number|[5] ( | + | {{subparam|number|[5] (1)|The red color component.}} |
| − | {{subparam|number|[6] ( | + | {{subparam|number|[6] (1)|The green color component.}} |
| − | {{subparam|number|[7] ( | + | {{subparam|number|[7] (1)|The blue color component.}} |
| − | {{subparam|number|[8] ( | + | {{subparam|number|[8] (1)|The alpha color component.}} |
=== Returns === | === Returns === | ||
Nothing. | Nothing. | ||
Latest revision as of 20:23, 1 April 2018
| Available since LÖVE 0.9.0 |
| This function is not supported in earlier versions. |
Sets the properties of a vertex in the Mesh.
In versions prior to 11.0, color and byte component values were within the range of 0 to 255 instead of 0 to 1.
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 (one-based).
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 1 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 (one-based).
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 1 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 (one-based).
number x- The position of the vertex on the x-axis.
number y- The position of the vertex on the y-axis.
number u- The horizontal component of the texture coordinate.
number v- The vertical component of the texture coordinate.
number r (1)- The red component of the vertex's color.
number g (1)- The green component of the vertex's color.
number b (1)- The blue component of the vertex's color.
number a (1)- 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 (one-based).
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] (1)- The red color component.
number [6] (1)- The green color component.
number [7] (1)- The blue color component.
number [8] (1)- 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
