Skip to content
Branch: master
Find file History
Latest commit 8a2fba8 May 26, 2019
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
glTF2Interface 4.1.0-alpha.1 May 10, 2019
gui Nightly May 25, 2019
inspector Nightly May 25, 2019
loaders Nightly May 25, 2019
materialsLibrary Nightly May 25, 2019
nodeEditor Nightly May 25, 2019
postProcessesLibrary Nightly May 25, 2019
proceduralTexturesLibrary Nightly May 25, 2019
serializers Nightly May 24, 2019
viewer Nightly May 25, 2019
Oimo.js Oimo min fix Jan 21, 2019
Oimo.license Add license files for 3rd party libraries Feb 12, 2018
_headers Adding CORS header Oct 3, 2017
_redirects try redirect Mar 1, 2019
ammo.js Ammo.js library updates May 24, 2019
babylon.d.ts
babylon.js Nightly May 25, 2019
babylon.max.js Nightly May 25, 2019
babylon.max.js.map Nightly May 25, 2019
babylon.module.d.ts Nightly May 25, 2019
cannon.js Adding the newest cannon.js Oct 15, 2015
cannon.license Add license files for 3rd party libraries Feb 12, 2018
documentation.d.ts Nightly May 25, 2019
draco.license Add license files for 3rd party libraries Feb 12, 2018
draco_decoder_gltf.js Simplify Draco configuration Apr 5, 2018
draco_decoder_gltf.wasm Update Draco Aug 10, 2018
draco_wasm_wrapper_gltf.js Simplify Draco configuration Apr 5, 2018
earcut.license Earcut is now an external ooptional dependency Mar 24, 2018
earcut.min.js Earcut is now an external ooptional dependency Mar 24, 2018
gltf_validator.js Update gltf validator to 2.0.0-dev.2.7 Apr 30, 2019
package.json 4.1.0-alpha.1 May 10, 2019
packagesSizeBaseLine.json Nightly May 25, 2019
readme.md 4.0.3 May 1, 2019
split.js Merge upstream Jul 27, 2017
typedocValidationBaseline.json w000000000t Sep 24, 2018
what's new.md Patch 29 (#10) May 24, 2019

readme.md

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

Additional references can be found on https://cdn.babylonjs.com/xxx where xxx is the folder structure you can find in the /dist folder like https://cdn.babylonjs.com/gui/babylon.gui.min.js

For the preview release, use the following URLs:

Additional references can be found on https://preview.babylonjs.com/xxx where xxx is the folder structure you can find in the /dist/preview release folder like https://preview.babylonjs.com/gui/babylon.gui.min.js

npm

BabylonJS and its modules are published on npm with full typing support. To install, use:

npm install babylonjs --save

This will allow you to import BabylonJS entirely using:

import * as BABYLON from 'babylonjs';

or individual classes using:

import { Scene, Engine } from 'babylonjs';

If using TypeScript, don't forget to add 'babylonjs' to 'types' in tsconfig.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:

// 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();
});

Preview release

Preview version of 4.1 can be found here. If you want to contribute, please read our contribution guidelines first.

Documentation

Contributing

Please see the Contributing Guidelines

Useful links

  • Official web site: www.babylonjs.com
  • Online playground to learn by experimentating
  • Online sandbox where you can test your .babylon and glTF scenes with a simple drag'n'drop
  • Online shader creation tool where you can learn how to create GLSL shaders
  • 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 3DS Max
  • 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)
  • glTF Tools by KhronosGroup

Features

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

Build

Babylon.js is automatically built using Gulp. Further instructions can be found in the documentation or in the readme at /Tools/Gulp.

You can’t perform that action at this time.