Tween.js 是一个小型的 JavaScript 库,可以从 https://github.com/sole/tween.js 下载。这个库可以用来定义某个属性在两个值之间的过渡,自动计算起始值和结束值之间的所有中间值。这个过程叫 tweening(补间)。例如,你可以用这个库将一个网格 x 轴上的位置在 10 秒钟内从 10 递减到 3,如下代码片段所示:
var tween = new TWEEN.Tween({x: 10})
.to({x: 3}, 10 000)
.easing(TWEEN.Easing.Elastic.InOut)
.onUpdate(function() {
// 更新你的 Mesh
})
.onComplete(function(){
// 如果需要,在此进行后处理动作
});
在这段简短的示例代码中,我们创建了一个 TWEEN.Tween 对象,这个对象可以保证 x 属性在 10 秒钟内从 10 变化到 3。通过 Tween.js 你还可以指定在指定时间内属性如何变化,是线性的、指数性的,还是其他任何可能的方式(具体看可参考官方指南https://github.com/sole/tween.js/blob/master/docs/user_guide.md)。
属性值在指定时间内的变化成为 easing(缓动),在 Tween.js 中,你可以通过 .easing() 函数来配置缓动效果。在 three.js 中使用这个库非常简单。下面我们给出一个完整的示例,代码如下所示:
<!DOCTYPE html>
<html>
<head>
<title>示例 09.03 - 补间动画</title>
<script src="../build/three.js"></script>
<script src="../build/js/controls/OrbitControls.js"></script>
<script src="../build/js/libs/stats.min.js"></script>
<script src="../build/js/libs/dat.gui.min.js"></script>
<script src="../build/js/libs/tween.js"></script>
<script src="../jquery/jquery-3.2.1.min.js"></script>
<style>
body {
/* 设置 margin 为 0,并且 overflow 为 hidden,来完成页面样式 */
margin: 0;
overflow: hidden;
}
/* 统计对象样式 */
#Stats-output {
position: absolute;
left: 0px;
top: 0px;
}
</style>
</head>
<body>
<!-- 用于 WebGL 输出的 Div -->
<div id="webgl-output"></div>
<!-- 用于统计 FPS 输出的 Div -->
<div id="stats-output"></div>
<!-- 运行 Three.js 示例的 Javascript 代码 -->
<script type="text/javascript">
var scene;
var camera;
var render;
var webglRender;
//var canvasRender;
var controls;
var stats;
var guiParams;
var gui;
var ambientLight;
var spotLight;
var axesHelper;
//var cameraHelper;
$(function() {
initStats();
initRender();
initCamera();
initControls();
scene = new THREE.Scene();
//createAxesHelper();
createAmbientLight();
createSpotLight();
createGuiControls();
// 加入地面
createGround()
// 创建网格
createMesh();
// 创建补间动画
createTween();
renderScene();
});
/** 初始化 stats 统计对象 */
function initStats() {
stats = new Stats();
stats.setMode(0); // 0 为监测 FPS;1 为监测渲染时间
$('#stats-output').append(stats.domElement);
return stats;
}
/** 初始化渲染器 */
function initRender() {
webglRender = new THREE.WebGLRenderer( {antialias: true, alpha: true} ); // antialias 抗锯齿
webglRender.setSize(window.innerWidth, window.innerHeight);
webglRender.setClearColor(0xEEEEEE, 1.0); // 0xeeeeee
render = webglRender;
render.shadowMap.enabled = true; // 允许阴影投射
$('#webgl-output')[0].appendChild(render.domElement);
window.addEventListener('resize', onWindowResize, false);
}
/** 初始化相机 */
function initCamera() {
camera = new THREE.PerspectiveCamera(45, window.innerWidth / window.innerHeight, 0.01, 2147483647); // 2147483647
camera.position.set(-30, 40, 30);
}
/** 初始化鼠标控制器 */
function initControls() {
var target = new THREE.Vector3(0, 0 , 0);
controls = new THREE.OrbitControls(camera, render.domElement);
controls.target = target;
camera.lookAt(target);
}
/** 当浏览器窗口大小变化时触发 */
function onWindowResize() {
camera.aspect = window.innerWidth / window.innerHeight;
camera.updateProjectionMatrix();
render.setSize(window.innerWidth, window.innerHeight);
}
/** 渲染场景 */
function renderScene() {
requestAnimationFrame(renderScene);
render.render(scene, camera);
stats.update();
TWEEN.update();
//animateMesh(); // 使物体动
}
/** 创建补间动画 */
var rotationTween;
var rotationTweenBack;
var p1 = {speed: 0}, p2 = {speed: Math.PI*2};
function createTween() {
rotationTween = new TWEEN.Tween(p1)
.to({speed: Math.PI*2}, 2000)
.easing(TWEEN.Easing.Linear.None)
.onUpdate(animateMesh)
.onComplete(function(){
p1.speed = 0;
});
rotationTweenBack = new TWEEN.Tween(p2)
.to({speed: 0}, 2000)
.easing(TWEEN.Easing.Linear.None)
.onUpdate(animateMesh)
.onComplete(function(){
p2.speed = Math.PI*2;
});
rotationTween.chain(rotationTweenBack);
rotationTweenBack.chain(rotationTween);
rotationTween.start();
}
/** 物体动画 */
var mesh;
function animateMesh() {
guiParams.rotationSpeed = this.speed;
guiParams.bouncingSpeed = this.speed;
guiParams.scalingSpeed = this.speed;
gui.updateDisplay();
mesh = scene.getObjectByName('cube');
mesh.rotation.x = guiParams.rotationSpeed;
mesh.rotation.y = guiParams.rotationSpeed;
mesh.rotation.z = guiParams.rotationSpeed;
mesh = scene.getObjectByName('sphere');
var px = 20 + ( 10 * (Math.cos(guiParams.bouncingSpeed)));
var py = 2 + ( 10 * Math.abs(Math.sin(guiParams.bouncingSpeed)));
mesh.position.set(px, py, 0);
mesh = scene.getObjectByName('cylinder');
var scaleX = Math.abs(Math.sin(guiParams.scalingSpeed / 4));
var scaleY = Math.abs(Math.cos(guiParams.scalingSpeed / 5));
var scaleZ = Math.abs(Math.sin(guiParams.scalingSpeed / 7));
mesh.scale.set(scaleX, scaleY, scaleZ);
}
/** 创建一个坐标轴:X(橙色)、Y(绿色)、Z(蓝色) */
function createAxesHelper() {
axesHelper = new THREE.AxesHelper(60);
scene.add(axesHelper);
}
/** 创建一个 AmbientLight 环境光源 */
function createAmbientLight() {
ambientLight = new THREE.AmbientLight(0x0c0c0c);
scene.add(ambientLight);
}
/** 创建一个 AmbientLight 环境光源 */
function createSpotLight() {
spotLight = new THREE.SpotLight(0xffffff);
spotLight.position.set(-40, 60, -10);
spotLight.castShadow = true;
spotLight.shadow.mapSize.set(2048, 2048); // 必须是 2的幂,默认值为 512
scene.add(spotLight);
//cameraHelper = new THREE.CameraHelper(spotLight.shadow.camera);
//scene.add(cameraHelper);
}
/** 用来保存那些需要修改的变量 */
function createGuiControls() {
guiParams = new function() {
this.rotationSpeed = 0.02;
this.bouncingSpeed = 0.03;
this.scalingSpeed = 0.03;
this.startTween = true;
}
/** 定义 dat.GUI 对象,并绑定 guiParams 的几个属性 */
gui = new dat.GUI();
gui.add(guiParams, 'rotationSpeed');
gui.add(guiParams, 'bouncingSpeed');
gui.add(guiParams, 'scalingSpeed');
gui.add(guiParams, 'startTween').onChange(function(e) {
if (guiParams.startTween) {
rotationTween.start();
} else {
rotationTween.stop();
}
});
}
/** 加入地面 */
function createGround() {
var groundGeom = new THREE.PlaneGeometry(60, 20);
var groundMaterial = new THREE.MeshPhongMaterial( { color: 0xbbbbbb, side: THREE.DoubleSide} ); // 0x777777
var ground = new THREE.Mesh(groundGeom, groundMaterial);
ground.name = 'ground';
ground.receiveShadow = true; // 地面接收阴影
ground.rotation.x = -0.5 * Math.PI;
ground.position.set(15, 0, 0);
scene.add(ground);
}
/** 创建网格 */
function createMesh() {
// 创建方块
var cubeGeometry = new THREE.BoxGeometry(4, 4, 4);
var cubeMaterial = new THREE.MeshLambertMaterial({color: 0xff0000});
var cube = new THREE.Mesh(cubeGeometry, cubeMaterial);
cube.name = 'cube';
cube.position.x = -9;
cube.position.y = 3;
cube.position.z = 0;
scene.add(cube);
// 创建球体
var sphereGeometry = new THREE.SphereGeometry(4, 20, 20);
var sphereMaterial = new THREE.MeshLambertMaterial({color: 0x7777ff});
var sphere = new THREE.Mesh(sphereGeometry, sphereMaterial);
sphere.name = 'sphere';
sphere.position.x = 20;
sphere.position.y = 0;
sphere.position.z = 2;
scene.add(sphere);
// 创建柱体
var cylinderGeometry = new THREE.CylinderGeometry(2, 2, 20);
var cylinderMaterial = new THREE.MeshLambertMaterial({color: 0x77ff77});
var cylinder = new THREE.Mesh(cylinderGeometry, cylinderMaterial);
cylinder.name = 'cylinder';
cylinder.position.set(0, 0, 1);
scene.add(cylinder);
}
</script>
</body>
</html>
在这个示例中,我们使用了两个 Tween 对象,并通过其 .chain() 函数将彼此首尾相连。这样在启动动画之后,程序就会在两个补间动画循环执行。你可以通过右上角的 UI 来观察各个值的实时变化情况。也可以通过菜单上的 startTween 复选钮开启或关闭这两个补间动画。
未完待续···