vScriptValDisplaceValues
Offsets points by a hashed noise value, limited to a spherical falloff region.
vScriptValDisplaceValues takes an array of XYZ points and adds a noise offset to each. Amplitude sets the size, Noise Scale the noise frequency, and the falloff sphere limits where the offset applies.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| Noise Scale | Float | 0 | Multiplies the point position before the noise lookup. Slider -1 to 1, default 0. |
| Noise Rate | Float | 0.001 | Length of the modulo applied to each coordinate in the noise lookup. Slider 0 to 1, default 0.001. Values below about 0.005 give the same noise for every point. |
| Animation Speed | Float | 0 | Added to the noise lookup as this value times the render time. Slider 0 to 5, default 0. |
| Amplitude | Float | 0 | Size of the displacement. Slider -1 to 1, default 0. |
| FallOff Sphere X | Float | 0 | X of the falloff sphere center. Slider -1 to 1, default 0. |
+6 more parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| FallOff Sphere Y | Float | 0 | Y of the falloff sphere center. Slider -1 to 1, default 0. |
| FallOff Sphere Z | Float | 0 | Z of the falloff sphere center. Slider -1 to 1, default 0. |
| FallOff Radius | Float | 0 | Radius of the falloff sphere. Minimum 0, slider 0 to 1, default 0. |
| FallOff Tightness | Float | 0.1 | Exponent in the falloff formula. Slider 0.01 to 1, default 0.1. |
| Invert falloff | Integer | 0.0 | Uses 1 minus the falloff when on. Default off. |
| Input | DATATYPE | — | Data to process. |
Read the full description
Each point moves by noise * Amplitude * falloff on X, Y and Z. The noise is a hash of the point position times Noise Scale plus Animation Speed times the render time, with each coordinate wrapped by a modulo of Noise Rate. Its value lies between 0 and 1, so a positive Amplitude moves points toward positive values.
At the default Noise Rate of 0.001 the wrapped coordinates stay so small that every point gets the same noise value (about 0.72). Larger rates give variation between points. Amplitude and Noise Scale default to 0, so nothing moves until they are set.
The falloff is max(0, 1 - (distance / radius) ^ tightness), measured from the FallOff Sphere position. Invert falloff uses 1 minus that value. All three families displace X, Y and Z.
Example Connections
- Disturb a grid and draw it
- Disturb a circle
vScriptValPointsOnGrid.Output -> vScriptValDisplaceValues.ArrayA
vScriptValDisplaceValues.Output -> vScriptValCameraProjection.ArrayA
vScriptValCameraProjection.Output -> vScriptValShapeRender.ArrayPoint
Background.Output -> vScriptValShapeRender.Input
vScriptValPointsOnCircle.Output -> vScriptValDisplaceValues.ArrayA
vScriptValDisplaceValues.Output -> vScriptValCameraProjection.ArrayA