beta
cables is under heavy development.
There might be one or another bug, please let us know about it!
MeshInstancer
Ops.Gl.MeshInstancer_v4
Namespace: Ops.Gl
Draw the same mesh multiple times on the GPU

summary (oneliner)

For better performance you should use the "Trigger Once" op on the mesh going into the Geom input. Check the example patch to see this being applied.

doc

issues

youtube id

collections

related ops

Inputs

exe (Trigger)

Trigger In


geom (Object)

The shape that will be instanced


Scale (Number)

Global scale for all instances, disabled if scale array is used


Limit Number of Instances

Limit Instances (boolean /Number)

Enable to set a limit on how many instances are created


Limit (integer /Number)

If limit instances is enabled this number determines how many instances are created


Parameters

positions (Array)

Needs an XYZ array to determine the positions of each instance


Scale Array (Array)

Needs an XYZ array to determine the scale of each instance


Rotations (Array)

Needs an XYZ array to determine the XYZ rotation of each instance. 0 - 360 degrees.


Rotation Type index (integer /Number)

Parameters

Rotation Type (String)

Material blend mode index (integer /Number)

Pick a material blend mode with an integer


Material blend mode (String)

Multiply, Add or Normal. Pick the blending mode the material for instances


Colors (Array)

Needs an RGBA array to determine the color of each instance.


Outputs

Trigger Out (Trigger)

Trigger Out


Num (Number)

Total number of instances/shapes


Caught a mistake or want to contribute to the documentation?

Edit Documentationcancel save
mesh instancer:

This patch demonstrates how we can generate 3 arrays of random numbers between 0-1.
Using the arrayMultiply op allows us to smoothly change the range of each array going into the position, scale and rotation arrays.

Open Example In Editor


Credits


Changelog


created op
2019-11-14 - cables

Ops.User.cables.MeshInstancer_v3 renamed to Ops.Gl.MeshInstancer_v3
2019-11-14 - cables

Ops.Gl.MeshInstancer_v3 renamed to Ops.Gl.MeshInstancer_v4
2020-07-23 - pandur

added core lib: cgl_shadermodifier
2020-07-23 - pandur

Examples using MeshInstancer_v4

Public Patches using MeshInstancer_v4