Difference between revisions of "Mesh:getVertex"
(Geometry:getVertex -> Mesh:getVertex) |
(Updated for 11.0) |
||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{newin|[[0.9.0]]|090|type=function}} | {{newin|[[0.9.0]]|090|type=function}} | ||
| − | Gets | + | Gets 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}} | ||
| + | === Synopsis === | ||
| + | <source lang="lua"> | ||
| + | attributecomponent, ... = Mesh:getVertex( index ) | ||
| + | </source> | ||
| + | === Arguments === | ||
| + | {{param|number|index|The one-based index of the vertex you want to retrieve the information for.}} | ||
| + | === Returns === | ||
| + | {{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.}} | ||
| + | === Notes === | ||
| + | The values are returned 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 return two position numbers, two texture coordinate numbers, and four color components: x, y, u, v, r, g, b, a. | ||
| + | |||
| + | == Function == | ||
| + | Gets 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 8: | Line 24: | ||
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | {{param|number|index|The index of | + | {{param|number|index|The index of the vertex you want to retrieve the information for.}} |
=== Returns === | === Returns === | ||
| − | {{param|number|x|The position of the vertex | + | {{param|number|x|The position of the vertex on the x-axis.}} |
| − | {{param|number|y|The position of the vertex | + | {{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.}} | ||
| Line 18: | Line 34: | ||
{{param|number|b|The blue component of the vertex's color.}} | {{param|number|b|The blue component of the vertex's color.}} | ||
{{param|number|a|The alpha component of the vertex's color.}} | {{param|number|a|The alpha component of the vertex's color.}} | ||
| + | |||
== See Also == | == See Also == | ||
* [[parent::Mesh]] | * [[parent::Mesh]] | ||
* [[Mesh:setVertex]] | * [[Mesh:setVertex]] | ||
* [[Mesh:getVertexCount]] | * [[Mesh:getVertexCount]] | ||
| + | * [[Mesh:getVertexAttribute]] | ||
| + | * [[Mesh:getVertexFormat]] | ||
| + | * [[love.graphics.newMesh]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
| − | {{#set:Description=Gets | + | {{#set:Description=Gets the properties of a vertex in the Mesh.}} |
| + | |||
== Other Languages == | == Other Languages == | ||
{{i18n|Mesh:getVertex}} | {{i18n|Mesh:getVertex}} | ||
Latest revision as of 20:23, 1 April 2018
| Available since LÖVE 0.9.0 |
| This function is not supported in earlier versions. |
Gets 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
attributecomponent, ... = Mesh:getVertex( index )
Arguments
number index- The one-based index of the vertex you want to retrieve the information for.
Returns
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.
Notes
The values are returned 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 return two position numbers, two texture coordinate numbers, and four color components: x, y, u, v, r, g, b, a.
Function
Gets the vertex components of a Mesh that wasn't created with a custom vertex format.
Synopsis
x, y, u, v, r, g, b, a = Mesh:getVertex( index )
Arguments
number index- The index of the vertex you want to retrieve the information for.
Returns
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- The red component of the vertex's color.
number g- The green component of the vertex's color.
number b- The blue component of the vertex's color.
number a- The alpha component of the vertex's color.
See Also
- Mesh
- Mesh:setVertex
- Mesh:getVertexCount
- Mesh:getVertexAttribute
- Mesh:getVertexFormat
- love.graphics.newMesh
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
