Three.js 3D rendering library for javascript #gamedev #game-engine #rendering #javascript

Mr.doob f8e0e542d4 Editor: Include VRControls/VREffect when needed. 9 years ago
.github ea09112d93 Update ISSUE_TEMPLATE.md (#8943) 9 years ago
build 31a78db2ec Updated builds. 9 years ago
docs a06fd31ebe Correct object3d and its main derivatives' clone() method documentation. (#9030) 9 years ago
editor f8e0e542d4 Editor: Include VRControls/VREffect when needed. 9 years ago
examples 257024c429 EffectComposer: Check if MaskPass is defined. Fixes #9042. 9 years ago
src 9693af7a9a Merge branch 'dev' of https://github.com/mrdoob/three.js into dev 9 years ago
test 741724fb63 Fixed tests. 9 years ago
utils c06169348a npm run build-watch - automatically rebuild three.js when changes made (#9004) 9 years ago
.gitignore 472ed080fc Merged changes from master- into dev-branch #17 10 years ago
.npmignore 28b292583f Removed the src/extras from npmignore, which is already included in the build 9 years ago
LICENSE c2e049403f Update LICENSE 9 years ago
README.md 84e6749fa3 Simplified README 9 years ago
bower.json 635b3e274d Fix bower.json ignores 10 years ago
package.json c06169348a npm run build-watch - automatically rebuild three.js when changes made (#9004) 9 years ago

README.md

three.js

JavaScript 3D library

The aim of the project is to create a lightweight 3D library with a very low level of complexity — in other words, for dummies. The library provides <canvas>, <svg>, CSS3D and WebGL renderers.

ExamplesDocumentationMigratingHelp

Usage

Download the minified library and include it in your html. Alternatively see how to build the library yourself.

<script src="js/three.min.js"></script>

This code creates a scene, a camera, and a geometric cube, and it adds the cube to the scene. It then creates a WebGL renderer for the scene and camera, and it adds that viewport to the document.body element. Finally it animates the cube within the scene for the camera.

var scene, camera, renderer;
var geometry, material, mesh;

init();
animate();

function init() {

	scene = new THREE.Scene();

	camera = new THREE.PerspectiveCamera( 75, window.innerWidth / window.innerHeight, 1, 10000 );
	camera.position.z = 1000;

	geometry = new THREE.BoxGeometry( 200, 200, 200 );
	material = new THREE.MeshBasicMaterial( { color: 0xff0000, wireframe: true } );

	mesh = new THREE.Mesh( geometry, material );
	scene.add( mesh );

	renderer = new THREE.WebGLRenderer();
	renderer.setSize( window.innerWidth, window.innerHeight );

	document.body.appendChild( renderer.domElement );

}

function animate() {

	requestAnimationFrame( animate );

	mesh.rotation.x += 0.01;
	mesh.rotation.y += 0.02;

	renderer.render( scene, camera );

}

If everything went well you should see this.

Change log

releases