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

Jynxio c4110f7965 Docs: Improve Vector3 page (zh) (#24814) %!s(int64=2) %!d(string=hai) anos
.github af514437fa Update FUNDING.yml %!s(int64=3) %!d(string=hai) anos
build 61b0f545bf Updated builds. %!s(int64=2) %!d(string=hai) anos
docs c4110f7965 Docs: Improve Vector3 page (zh) (#24814) %!s(int64=2) %!d(string=hai) anos
editor b625545db6 Editor: Updated Strings.js (#24804) %!s(int64=2) %!d(string=hai) anos
examples ee75e22c4b Nodes: Static STRING style (#24807) %!s(int64=2) %!d(string=hai) anos
files cd7293a5e1 Examples: Added external tag (#24281) %!s(int64=3) %!d(string=hai) anos
manual e7ff2e2ca0 manual: translate offscreencanvas into chinese (#24761) %!s(int64=2) %!d(string=hai) anos
src aaa1968dbb Material: don't export attenuationDistance when it's set to the default value of Infinity (Fix #24797) (#24798) %!s(int64=2) %!d(string=hai) anos
test 1a8b53fb93 Examples: Add external three-gpu-pathtracer example (#24803) %!s(int64=2) %!d(string=hai) anos
utils a62eaa52f2 Update rollup.config.js %!s(int64=2) %!d(string=hai) anos
.editorconfig f1ba3a32ed Remove indent size from .editorconfig %!s(int64=6) %!d(string=hai) anos
.gitattributes 5446f535d1 git should handle the line endings %!s(int64=7) %!d(string=hai) anos
.gitignore 6bab8bdef3 test-treeshake: Add rollup-plugin-visualizer (#21657) %!s(int64=4) %!d(string=hai) anos
.lgtm.yml 9c3b8dd8d2 add lgtm config (#23062) %!s(int64=3) %!d(string=hai) anos
LICENSE 484f9e24f2 Update LICENSE (#23131) %!s(int64=3) %!d(string=hai) anos
README.md f7ed8217c6 README: Replaced Slack with Discord %!s(int64=3) %!d(string=hai) anos
icon.png 9760d3d86b Optimize icon image (#23238) %!s(int64=3) %!d(string=hai) anos
package-lock.json 3060cbaa1a Updated package-lock.json %!s(int64=2) %!d(string=hai) anos
package.json 3265fc9493 Examples: Use ESM version of lottie. (#24763) %!s(int64=2) %!d(string=hai) anos

README.md

three.js

NPM Package Build Size NPM Downloads DeepScan Discord

JavaScript 3D library

The aim of the project is to create an easy to use, lightweight, cross-browser, general purpose 3D library. The current builds only include a WebGL renderer but WebGPU (experimental), SVG and CSS3D renderers are also available in the examples.

ExamplesDocsManualWikiMigratingQuestionsForumDiscord

Usage

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.

import * as THREE from 'three';

// init

const camera = new THREE.PerspectiveCamera( 70, window.innerWidth / window.innerHeight, 0.01, 10 );
camera.position.z = 1;

const scene = new THREE.Scene();

const geometry = new THREE.BoxGeometry( 0.2, 0.2, 0.2 );
const material = new THREE.MeshNormalMaterial();

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

const renderer = new THREE.WebGLRenderer( { antialias: true } );
renderer.setSize( window.innerWidth, window.innerHeight );
renderer.setAnimationLoop( animation );
document.body.appendChild( renderer.domElement );

// animation

function animation( time ) {

	mesh.rotation.x = time / 2000;
	mesh.rotation.y = time / 1000;

	renderer.render( scene, camera );

}

If everything went well, you should see this.

Cloning this repository

Cloning the repo with all its history results in a ~2 GB download. If you don't need the whole history you can use the depth parameter to significantly reduce download size.

git clone --depth=1 https://github.com/mrdoob/three.js.git

Change log

Releases