aframe-brownian-motion v2.2.0
AFrame-brownian-motion
This is based on:
- https://github.com/keijiro/ProceduralMotion/blob/master/Packages/jp.keijiro.klak.motion/Runtime/BrownianMotion.cs
- https://github.com/josephg/noisejs
Demo
Quick Start
Include the script in the head of your page
<!-- in head -->
<script src="https://cdn.jsdelivr.net/npm/aframe-brownian-motion@2.0.1/build/aframe-brownian-motion.min.js"></script>Basic
This has the objects fly randomly
<!-- in a-scene -->
<a-cylinder shadow position="0 1 -2" radius="0.2" height="0.4" brownian-motion="speed:0.2;"></a-cylinder>
<a-torus-knot shadow position="0 1 -2" radius-tubular="0.03" radius="0.15" height="0.4" brownian-motion="speed:0.5;positionVariance:2 2 2;rotationVariance:5 5 5;"></a-torus-knot>
<a-box shadow position="-0.5 0.2 -2" width="0.4" depth="0.4" height="0.4" brownian-motion="speed:0.9;positionVariance:2 0 2;rotationVariance:5 5 5;"></a-box>Flocking Behaviour
The space vector component can be used have objects follow similar but divergent over time paths.
It's 6 numbers representing x,y,z and position and x,y,z Euler rotation. If two numbers are the same then the corresponding values in the animation will remain the same.
These also make animations reproducable. If you set the spaceVector to a number it will do the same animation everytime you reload the page.
Similar numbers will behave similarly:
i.e. 10 and 10 will do the exact same animation. 128 and 128.1 will do very similar but slightly animations.
If you leave any of the numbers undefined then they will be assigned random numbers. So ,,,20,30,40 will do random position motion but fixed rotation motion
<a-cylinder brownian-motion="positionVariance:3 3 3;spaceVector:10.1,20.1,30.1,10.1,20.1,30.1;speed:0.5;" shadow position="0 1 0" radius="0.2" height="0.4" ></a-cylinder>
<a-torus-knot brownian-motion="positionVariance:3 3 3;spaceVector:10.2,20.2,30.2,10.2,20.2,30.2;speed:0.5;" shadow position="0 1 0" radius-tubular="0.03" radius="0.15" height="0.4" ></a-torus-knot>
<a-box brownian-motion="positionVariance:3 3 3;spaceVector:10.3,20.3,30.3,10.3,20.3,30.3;speed:0.5;" shadow position="0 1 0" width="0.4" depth="0.4" height="0.4" ></a-box>Instancing and Paths
There is a more complex component which can pick an element which will clone with instancing, so you can have many of them, and move them along along a brownian path. You can make them move synchronously or indepently by controlling the spaceVectorOffset parameter.
Example, this will draw 40 lines and clone the object 40 times to travel along those lines, either the lines can be turned off or the object not provided to hide one or the other
<a-torus-knot shadow radius-tubular="0.002" id="thing-to-clone" visible="false" radius="0.1"></a-torus-knot>
<a-entity position="0 1 0" brownian-path="count:40;object:#thing-to-clone;positionVariance:2 2 2;showLine:true;spaceVectorOffset:0.02,0.02,0.02,0.02,0.02,0.02;" shadow></a-entity>Docs
brownian-motion component
This component animates an object
| Property | Type | Description | Default |
|---|---|---|---|
| spaceVector | array | Where in the phase space the starts, this should be an array of 6 values where empty spaces become a random number between -1000 and 1000 | |
| octaves | number | How fine grained the motion is | 2 |
| positionVariance | vec3 | How much it should be moved by | {} |
| rotationVariance | vec3 | How much it should rotate by | {} |
| speed | number | Speed multiplier | 1 |
| rotationFollowsAxis | string | If the object should follow the path along certain axis, set it here. One of x, y, z, -x, -y, -z, , none | "none" |
brownian-path component
This component animates an object
| Property | Type | Description | Default |
|---|---|---|---|
| object | selector | Which object to instance with brownian-motion | |
| showLine | boolean | Whether to draw lines | false |
| lineColor1 | color | Color of the first line | "orange" |
| lineColor2 | color | Color of the last line | "hotpink" |
| lineStart | number | Time stamp to start drawing the lines at | 0 |
| lineStep | number | Steps to take in drawing the path | 20 |
| lineEnd | number | Time stamp to stop drawing the lines at | 10000 |
| spaceVectorOffset | array | Space vector offset for each instance/line | |
| count | number | Number of lines or instances | 10 |
| spaceVector | array | Where in the phase space the starts, this should be an array of 6 values where empty spaces become a random number between -1000 and 1000 | |
| octaves | number | How fine grained the motion is | 2 |
| positionVariance | vec3 | How much it should be moved by | {} |
| rotationVariance | vec3 | How much it should rotate by | {} |
| speed | number | Speed multiplier | 1 |
| rotationFollowsAxis | string | If the object should follow the path along certain axis, set it here. One of x, y, z, -x, -y, -z, , none | "none" |