Skip to content

tiansijie/whitestorm.js

 
 

Repository files navigation

WhitestormJS

jQuery for Three.js


Build Status npm bower

Issues Slack Status bitHound Overall Score



WhitestormJS is a 3D Javascript engine based on Three.js. It uses physics and effects libraries to define WhitestormJS API™ that contains useful scripts for terrain generation, skybox, animation, physics simulation and post-effects. WhitestormJS simplifies Three.js object crafting algorithm to javascript methods with parameters.

WhitestormJS is hosted by jsDelivr. You can link to the latest minified version, full version, or download both.

WhitestormJS


Installation

forthebadge forthebadge

* It is advised to download your own copies of the following libraries, as large changes can break backwards compatibility.

Include Three.js, Wagner, and Physi.js libraries. Include a script tag linking the WhitestormJS library in your head or after your body:

<script src="three.js"></script>
<script src="physi.js"></script>
<script src="wagner.js"></script>
<!-- WhitestormJS library -->
<script src="{path_to_lib}/whitestorm.js"></script>

After adding these libraries, you can configure your game:

var GAME = new WHS.init({
    anaglyph: false, // Anaglyph effect.
    stats: "fps", // fps, ms, mb or false if not need.

    gravity: { // Physic gravity.
        x: 0,
        y: -100,
        z: 0
    }

    path_worker: 'physijs_worker.js' // Path to Physijs worker here.
    path_ammo: 'ammo.js' // Path to Ammo.js.
});

// Define your scene objects here.

GAME.start(); // Start animations and physics simulation.

Join the chat at https://gitter.im/WhitestormJS/whitestorm.js


Structure

Whitestorm.js structure

Examples:

  • FPS (First person example with Wagner effects and terrain.)
  • Basic (Basic "Hello world!" example.)
  • Material (Basic example with material.)
  • Object/Model (Teapot model with Three.js JSONLoader.)
  • Object/Wall (Stone wall (basic).)
  • Plugin/Color (Basic plugin example.)
  • Skybox (Skybox example)
Docs: Look here
Changelog: Look here

Contributors:

Author

Contributor

Contributor

Contributor


License

Лицензия Creative Commons


forthebadge

About

WhitestormJS physics + rendering of 3D

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%