aboutsummaryrefslogtreecommitdiffhomepage
path: root/starfield/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'starfield/README.md')
-rw-r--r--starfield/README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/starfield/README.md b/starfield/README.md
new file mode 100644
index 0000000..931c46e
--- /dev/null
+++ b/starfield/README.md
@@ -0,0 +1,23 @@
+# Starfield #
+
+3D starfield simulation. Like the good old Windows screensaver, but in JS and improved.
+
+To start the animation, just call this function, and (optionally) pass some options to it to configure the animation to your liking. For it to work you should have a canvas object in your document with id #stars.
+
+```javascript
+warpLaunch({
+ 'max_particles': 500,
+ 'speed': 50,
+ 'step': 2,
+ 'interactive': true,
+ 'color': true,
+});
+```
+
+### What does each option mean ###
+
+* max_particles: The amount of stars that appear onscreen at one given moment
+* speed: How fast stars move towards the screen
+* step: If interactive mode is on, how much the speed changes when the mouse wheel is scrolled
+* interactive: If enabled, allows to control the speed of the simulation with the scroll wheel
+* color: Stars are colored instead of white if enabled