This page provides information on the Particle Instancer.

Overview


The VRayInstancer plugin creates instances of objects over a variety of supported particles input: ParticleFlow system, Alembic particles loaded through VRayProxy, Thinking particles, and PRT particles loaded with KrakatoaPRTLoader. In comparison to the Particle Flow itself, which can only work with mesh objects, the VRayInstancer can instantiate any renderable object, including VRayProxy, hair, displaced objects, Alembic particles (through VRayProxy), etc.

The source code for the VRayInstancer plugin is included with the V-Ray SDK.

 

||Create menu|| > V-Ray > V-Ray Instancer

 

||Create panel|| > Geometry > VRay category > VRayInstancer

 


Parameters


Instance mode – Specifies how particles will be associated with one of the source objects.

Cycle – The first particle is assigned the first source object, the second particle - the second object etc., with the source objects list wrapping back to the beginning.
Random – Each particle is randomly assigned a source object based on its particle ID.
By particleInteger – Source objects are assigned based on the .particleInteger value of each Particle Flow particle. This value can be customly scripted in the Particle Flow system.

Source objects – A list of source objects that will be instanced over the particle system. The way source objects are associated with particles is controlled by the Instance mode parameter.

Add/RemoveUse the two buttons to add or remove source objects from this list.

Remove All – Remove all source objects from the list.

Particles – A list of particle systems that will be used to create the instances.

Add/RemoveUse the two buttons to add or remove particle systems from this list.

Remove All – Remove all particle systems from the list.

 

 

Particle Flow Parameters


All Particle Flow Events – When enabled, all particle flow events of the particle systems specified in the Particles list are used. When disabled, VRayInstancer will only consider the events specified in the Particle Flow Events list for generating instances.

Add/Remove – Use the two buttons to add or remove particle flow events from this list.

Remove All – Removes all particle flow events from the list.

 

 

Options


Icon text – When enabled, shows the VRayInstancer icon text in the viewport.

Random seed – When the Instance mode is set to Random, this parameter allows the user to change the seed used for the random distribution.

Render % – Allows the user to render only a portion of the instanced geometry. The number of rendered instances is determined as a percentage of the total instances.

Override node properties – Enabling this option allows global override of the object properties of the instances by the properties specified in VRayInstancer.

Multithreaded – An experimental option to use multithreaded generation of the instanced meshes.

 

 

Notes


  • VRayInstancer uses the materials assigned to the instanced geometry, unless a material is specified in the Particle Flow system. In that case the particles' material is applied. This feature is not yet available with V-Ray GPU.