Difference between revisions of "love.graphics.drawInstanced"
(Created page) |
m |
||
| Line 1: | Line 1: | ||
{{newin|[[0.11.0]]|110|type=function}} | {{newin|[[0.11.0]]|110|type=function}} | ||
| − | Draws | + | Draws many instances of a [[Mesh]] with a single draw call, using hardware geometry instancing. |
Each instance can have unique properties (positions, colors, etc.) but will not by default unless a custom [[Shader]] along with either [[Mesh:attachAttribute|per-instance attributes]] or the <code>love_InstanceID</code> GLSL 3 vertex [[Shader Variables|shader variable]] is used, otherwise they will all render at the same position on top of each other. | Each instance can have unique properties (positions, colors, etc.) but will not by default unless a custom [[Shader]] along with either [[Mesh:attachAttribute|per-instance attributes]] or the <code>love_InstanceID</code> GLSL 3 vertex [[Shader Variables|shader variable]] is used, otherwise they will all render at the same position on top of each other. | ||
| Line 46: | Line 46: | ||
[[Category:Functions]] | [[Category:Functions]] | ||
[[Sub-Category::Drawing| ]] | [[Sub-Category::Drawing| ]] | ||
| − | {{#set:Description=Draws | + | {{#set:Description=Draws many instances of a [[Mesh]] with a single draw call, using hardware geometry instancing.}} |
== Other Languages == | == Other Languages == | ||
{{i18n|love.graphics.drawInstanced}} | {{i18n|love.graphics.drawInstanced}} | ||
Revision as of 04:41, 7 January 2018
| Available since LÖVE 0.11.0 |
| This function is not supported in earlier versions. |
Draws many instances of a Mesh with a single draw call, using hardware geometry instancing.
Each instance can have unique properties (positions, colors, etc.) but will not by default unless a custom Shader along with either per-instance attributes or the love_InstanceID GLSL 3 vertex shader variable is used, otherwise they will all render at the same position on top of each other.
Instancing is not supported by some older GPUs that are only capable of using OpenGL ES 2 or OpenGL 2. Use love.graphics.getSupported to check.
Contents
Function
Synopsis
love.graphics.drawInstanced( mesh, instancecount, x, y, r, sx, sy, ox, oy, kx, ky )
Arguments
Mesh mesh- The mesh to render.
number instancecount- The number of instances to render.
number x (0)- The position to draw the object (x-axis).
number y (0)- The position to draw the object (y-axis).
number r (0)- Orientation (radians).
number sx (1)- Scale factor (x-axis).
number sy (sx)- Scale factor (y-axis).
number ox (0)- Origin offset (x-axis).
number oy (0)- Origin offset (y-axis).
number kx (0)- Shearing factor (x-axis).
number ky (0)- Shearing factor (y-axis).
Returns
Nothing.
Function
Synopsis
love.graphics.drawInstanced( mesh, instancecount, transform )
Arguments
Mesh mesh- The mesh to render.
number instancecount- The number of instances to render.
Transform transform- A transform object.
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
