babylonjs

* We recommend using the [Core ES6-supported version](https://www.npmjs.com/package/@babylonjs/core);

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
babylonjs
22,448857.3.12 days ago10 years agoMinified + gzip package size for babylonjs in KB

Readme

Babylon.js
Getting started? Play directly with the Babylon.js API using our playground. It also contains a lot of samples to learn how to use it. npm version Build Status Average time to resolve an issue Percentage of issues still open Build Size Twitter Any questions? Here is our official forum.

CDN

For the preview release, use the following URLs:

npm

BabylonJS and its modules are published on npm with full typing support. To install, use: ```text npm install babylonjs --save ``` This will allow you to import BabylonJS entirely using: ```javascript import as BABYLON from 'babylonjs'; ``` or individual classes using: ```javascript import { Scene, Engine } from 'babylonjs'; ``` If using TypeScript, don't forget to add 'babylonjs' to 'types' in tsconfig.json: ```json
...
"types": [
"babylonjs",
"anotherAwesomeDependency"
],
...
``` To add a module, install the respective package. A list of extra packages and their installation instructions can be found on the babylonjs user on npm
.

Usage

See Getting Started: ```javascript // Get the canvas DOM element var canvas = document.getElementById('renderCanvas'); // Load the 3D engine var engine = new BABYLON.Engine(canvas, true, {preserveDrawingBuffer: true, stencil: true}); // CreateScene function that creates and return the scene var createScene = function(){
// Create a basic BJS Scene object
var scene = new BABYLON.Scene(engine);
// Create a FreeCamera, and set its position to {x: 0, y: 5, z: -10}
var camera = new BABYLON.FreeCamera('camera1', new BABYLON.Vector3(0, 5, -10), scene);
// Target the camera to scene origin
camera.setTarget(BABYLON.Vector3.Zero());
// Attach the camera to the canvas
camera.attachControl(canvas, false);
// Create a basic light, aiming 0, 1, 0 - meaning, to the sky
var light = new BABYLON.HemisphericLight('light1', new BABYLON.Vector3(0, 1, 0), scene);
// Create a built-in "sphere" shape; its constructor takes 6 params: name, segment, diameter, scene, updatable, sideOrientation
var sphere = BABYLON.Mesh.CreateSphere('sphere1', 16, 2, scene, false, BABYLON.Mesh.FRONTSIDE);
// Move the sphere upward 1/2 of its height
sphere.position.y = 1;
// Create a built-in "ground" shape; its constructor takes 6 params : name, width, height, subdivision, scene, updatable
var ground = BABYLON.Mesh.CreateGround('ground1', 6, 6, 2, scene, false);
// Return the created scene
return scene;
} // call the createScene function var scene = createScene(); // run the render loop engine.runRenderLoop(function(){
scene.render();
}); // the canvas/window resize event handler window.addEventListener('resize', function(){
engine.resize();
}); ```

Documentation

Contributing

Please see the Contributing Guidelines.

Useful links

  • Online sandbox where you can test your .babylon and glTF scenes with a simple drag'n'drop
  • 3DS Max exporter can be used to generate a .babylon file from 3DS Max
  • Maya exporter can be used to generate a .babylon file from Maya
  • Blender exporter can be used to generate a .babylon file from Blender 3d
  • Unity 5 (deprecated) exporter can be used to export your geometries from Unity 5 scene editor(animations are supported)

Features

To get a complete list of supported features, please visit Babylon.js website.