MeshInstancer_v3 Op

Ops.Gl.MeshInstancer_v3

Op author: cables

There is a newer version of this op!

This version will not receive any updates. It is recommended to use a newer version.

Current version: Ops.Gl.MeshInstancer_v4

Draw the same mesh multiple times on the GPU

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.

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.

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 Documentation

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

Changelog

created op
2019-11-14 - cables

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

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