英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Babylon.js

入门？使用我们的playground直接玩 Babylon.js API。它还包含许多示例，帮助学习如何使用它。

有任何问题吗？ 这是我们的官方论坛。

内容分发网络

⚠️ 警告：CDN 不应在生产环境中使用。我们 CDN 的目的是为学习如何使用平台或进行小规模实验的用户提供 Babylon 包。一旦您构建了应用程序并准备向全世界分享，您应从自己的 CDN 提供所有包。

• https://cdn.babylonjs.com/babylon.js
• https://cdn.babylonjs.com/babylon.max.js

对于预览版本，请使用以下 URL：

• https://preview.babylonjs.com/babylon.js
• https://preview.babylonjs.com/babylon.max.js

额外参考列表可以在 这里 找到。

npm

BabylonJS 及其模块已在 npm 上发布，并提供完整的类型支持。要安装，请使用：

npm install babylonjs --save

或者，您现在可以依赖我们的 ES6 包。使用 ES6 版本将允许进行树摇等打包优化。

这将允许您通过以下方式完整导入 BabylonJS：

import * as BABYLON from 'babylonjs';

或使用单独的类:

import { Scene, Engine } from 'babylonjs';

如果使用 TypeScript，不要忘记在 tsconfig.json 中将 'babylonjs' 添加到 'types'：

    ...
    "types": [
        "babylonjs",
        "anotherAwesomeDependency"
    ],
    ...

要添加模块，请安装相应的软件包。额外软件包的列表及其安装说明可以在 npm 上的 babylonjs 用户页面 上找到。

使用方法

请参阅 入门指南:

// 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 using the SphereBuilder
    var sphere = BABYLON.MeshBuilder.CreateSphere('sphere1', {segments: 16, diameter: 2, sideOrientation: BABYLON.Mesh.FRONTSIDE}, scene);
    // Move the sphere upward 1/2 of its height
    sphere.position.y = 1;
    // Create a built-in "ground" shape;
    var ground = BABYLON.MeshBuilder.CreateGround("ground1", { width: 6, height: 6, subdivisions: 2, updatable: false }, scene);
    // 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();
});

贡献

如果你想贡献，请先阅读我们的贡献指南。

文档

• 文档
• 演示

有用的链接

• 官方网站: www.babylonjs.com
• 在线 playground 通过实验学习
• 在线 sandbox 可以通过简单的拖放测试你的 .babylon 和 glTF 场景
• 在线 着色器创建工具 可以学习如何创建 GLSL 着色器
• 3DS Max 导出器 可用于从 3DS Max 生成 .babylon 文件
• Maya 导出器 可以从 Maya 生成 .babylon 文件
• Blender 导出器 可以从 Blender 3D 生成 .babylon 文件
• Unity 5（已弃用）导出器 可以从 Unity 5 场景编辑器导出你的几何体（支持动画）
• KhronosGroup 的 glTF 工具

功能

要获取支持功能的完整列表，请访问我们的网站。