{{newin|[[0.10.0]]|100|type=function}}
Attaches a vertex attribute from a different Mesh onto this Mesh, for use when drawing. This can be used to share vertex attribute data between several different Meshes.
== Function ==
=== Synopsis ===
<source lang="lua">
Mesh:attachAttribute( name, mesh )
</source>
=== Arguments ===
{{param|string|name|The name of the vertex attribute to attach.}}
{{param|Mesh|mesh|The Mesh to get the vertex attribute from.}}
=== Returns ===
Nothing.

== Function ==
{{newin|[[11.0]]|110|type=variant}}
=== Synopsis ===
<source lang="lua">
Mesh:attachAttribute( name, mesh, step, attachname )
</source>
=== Arguments ===
{{param|string|name|The name of the vertex attribute to attach.}}
{{param|Mesh|mesh|The Mesh to get the vertex attribute from.}}
{{param|VertexAttributeStep|step ("pervertex")|Whether the attribute will be per-vertex or [[love.graphics.drawInstanced|per-instance]] when the mesh is drawn.}}
{{param|string|attachname (name)|The name of the attribute to use in shader code. Defaults to the name of the attribute in the given mesh. Can be used to use a different name for this attribute when rendering.}}
=== Returns ===
Nothing.

== Notes ==
If a Mesh wasn't [[love.graphics.newMesh|created]] with a custom vertex format, it will have 3 vertex attributes named <code>VertexPosition</code>, <code>VertexTexCoord</code>, and <code>VertexColor</code>.

Custom named attributes can be accessed in a [[Shader|vertex shader]] by declaring them as <code>attribute vec4 MyCustomAttributeName;</code> at the top-level of the vertex shader code. The name must match what was specified in the Mesh's vertex format and in the <code>name</code> argument of [[Mesh:attachAttribute]].

== See Also ==
* [[parent::Mesh]]
* [[Mesh:getVertexFormat]]
* [[love.graphics.draw]]
[[Category:Functions]]
{{#set:Description=Attaches a vertex attribute from a different Mesh onto this Mesh, for use when drawing. Optionally allows per-[[love.graphics.drawInstanced|instance]] attributes.}}
== Other Languages ==
{{i18n|Mesh:attachAttribute}}