Table of Contents

This section contains information about the V-Ray Surface Scattering Component in V-Ray for Grasshopper.


Overview


Creates instances of the Scatter 2 Guests scattered on surfaces (Scatter 2 Hosts). Used as a V-Ray Scatter 2 component’s Scattering Configuration input.





Input Parameters


Mode (Integer) – Specifies the surface scattering mode.

Random Distribution – Scatters instances randomly on all Host mesh objects.
UV Grid – Uses UV mapping to scatter instances in regular patterns.

Instances Count (Number) – Determines the exact number of instances to scatter.

Per Area (Boolean) – When enabled, the total number of instances is determined by the Area Size value combined with the size of the Host’s surface area.

Area Size (Number) – The value specifies the length of the distribution square area side. If the Instances Count value is set to 1, this number determines the relative density for all instances. 

Density Map (AColorTex) – Determines the approximate count of instances based on texture input. Black color in the texture discards all instances in the respective area. Areas colored with white receive the maximum number of instances.

UV Channel (Integer) – Determines the UV channel utilized for scattering.

Slope Limitation (Integer) – Limits scatter only to ‘slope’ at certain angles. The lower the angle range is set, the smaller the angle at which scattering stops.

Local – Slope limitation is measured according to the up vector of each individual Guest object.
World – slope limitation for all Guest objects is measured relative to the world Up vector.

Slope Angles (Domain) – The angle range in degrees outside which instances get filtered out.

Edge Trimming (Boolean) - Trims elements of instances outside of the host’s boundaries.

Grid Pattern (Integer) – Determines the pattern when ‘UV Grid’ surface mode scattering is selected.

Grid – Rectangular grid.
Running Grid – Rectangular grid with every other row offset by half of the grid spacing.
Hexagonal Grid – Arranges instances into hexagons.

Grid Spacing (Vector) – Grid Spacing option works if Mode is set to UV Grid. Scales the pattern in UV space based on vector input. When set to {1,1,0}, the pattern occupies the whole surface. When set to {0.5,0.5,0} it is repeated twice.

Grid Jitter (Vector) – Grid Jitter option works if Mode is set to UV Grid. Determines what percentage of the instances are randomly placed along U and V axes based on vector input. When set to {0,0,0} all instances are placed according to UV mapping. When set to {1, 1, 0}, all instances are randomly placed.

Grid Offset (Vector) – Grid Offset option works if Mode is set to UV Grid. Offsets the pattern by a given value along U and V axes based on vector input. Keep in mind that 0 and 1 Offset give the same result as 1 moves the pattern by 100% or one whole repetition.




Output Parameters


Scattering (Generic Data) – Configuration data specifying the scattering mode. Can be connected to the V-Ray Scatter 2 component’s Scattering Configuration input.





Was this helpful?