265行JavaScript代码的第一人称3D H5游戏Demo【个人总结1】

本文目的是分解前面的代码。其实，它得逻辑很清楚，只是对于我这种只是用过 Canvas 画线（用过 Fabric.js Canvas库）的人来说，这个还是很复杂的。我研究这个背景天空也是搞了一天，下面就是只加载天空的代码及分析。

在线效果点击：http://1.codemo2.sinaapp.com/3d_demo_265line/index.html   【可以用键盘“左右”键控制】【手机浏览器触控有些异常】

原理大概就是：

1. 创建主循环

2. 主循环内重复调用绘制方法

3. 绘制方法: 针对 Player 的位置和方向，绘制背景图

其中用到了 H5 的 requestAnimationFrame（callback），bind(this, argu，...) 比较难以理解的函数。

Player 是人物，含有平面x,y位置和方向三个特性；Controls 用来响应键盘和触屏操作；Map 是背景图还有后面的墙壁；Camera 是最重要的摄像机，用来绘制我们看到的炫酷图像；GameLoop 是整个程序的入口，一直循环调用 Camera 刷新绘制图形。

一、主循环

程序入口是

var loop = new GameLoop();
loop.start(function frame(seconds){});//将 frame(secondes) 函数赋值给 GameLoop 对象的callback

GameLoop.prototype.start = function(callback) {
        this.callback = callback;
        requestAnimationFrame(this.frame);
    }

紧接着在 loop.start() 里立即调用 requestAnimationFrame(this.frame); 通知浏览器 loop.frame 函数要播放动画。

看看 loop.frame() 里面都干了啥：

GameLoop.prototype.frame = function(time){
        var seconds = (time - this.lastTime) / 1000;
        this.lastTime = time;
        if (seconds < 0.2) this.callback(seconds);//【this.callback在loop.start之后才被赋值为function frame(seconds){}】
        requestAnimationFrame(this.frame);//调用自己，产生无限循环；requestAnimationFrame 用法类似 setTimeout()

}

注意：要区分清楚 this.callback(argu) 函数和 this.frame(argu) 。

其中，this.callback(seconds); 调用 传给 loop.start() 的这个 函数：

loop.start(function frame(seconds){
        player.update(controls.states, map, seconds);//更新 player 的面向、地图/背景图
        camera.render(player, map);//绘制 player 和地图/背景图
    });

下面就是如何更新和绘制 player 和地图/背景图了。

---

二、Player和地图更新及绘制

player.update(controls.states, map, seconds);//更新 player 的面向、地图/背景图

player 对象去读取全局变量 controls （里面记录着用户是否点击上下左右按键或触屏事件），如果用户按了【左】键，player 的 面向就发生改变。代码：

Player.prototype.update = function(controls, map, seconds){
        if (controls.left) {this.rotate(-Math.PI * seconds)};
        if (controls.right) this.rotate(Math.PI * seconds);
    }

其中controls 监听键盘和触控事件，遇到 keydown/keyup/touchstart等事件，调用事件响应函数，将触屏事件转化为键盘值，再转化为 Player 的【左右转动和前后移动】并更新 player 的状态。（代码多且简单，此处不列）

接下来是真正的绘制背景了。      camera.render(player, map);//绘制 player 和地图/背景图

我们来看看 camera.render() 函数的实现：

function Camera(canvas, resolution , focalLength){
        this.ctx = canvas.getContext('2d');
        this.width = canvas.width = window.innerWidth * 0.5;
        this.height = canvas.height = window.innerHeight * 0.5;
        this.resolution = resolution;
        this.spacing = this.width / resolution;
        this.focalLength = focalLength || 0.8;
        this.range = MOBILE ? 8 : 14;
        this.lightRange = 5;
        this.scale = (this.width + this.height) / 1200;
    }

Camera.prototype.render = function(player, map){
        this.drawSky(player.direction, map.skybox, map.light);//player的面向，地图背景图，地图环境光
    }

Camera.prototype.drawSky = function(direction, sky, ambient){
        var width = sky.width * (this.height / sky.height) * 2;//保持背景图宽高比的同时，将图重复左右拼接
        var left = (direction / CIRCLE) * -width;

this.ctx.save();
        this.ctx.drawImage(sky.image, left, 0, width, this.height);//调用 Canvas 2d 的 drawImage()
        if (left < width - this.width) {
          this.ctx.drawImage(sky.image, left + width, 0, width, this.height);
        }
        this.ctx.restore();
    }

这里看不懂了。。。为何 left  是个 负数？

三、背景图的拼接显示

想了三天终于想清楚了，关键点是 HTML5 Canvas 的 drawImage(img,x,y,width,height) 函数没有理解清楚。平时使用 drawImage() 时，参数均是正数，没有思考当5个参数时 x, y 为负数时的含义。x , y 的准确意义是【在画布上的 x ,y 处定位图像】。当 x, y 为负数时，即说明在画布的 -100，-100 处开始绘制原图，简单说就是，原图的左上角被隐藏了。见图1：

<img id="tulip" src="flower.jpg" width="400" height="266" />
<canvas id="myCanvas" width="800" height="300" />var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var img=document.getElementById("tulip");
ctx.drawImage(img,-400,-133,,266);//img,x,y,width,height
//先拉伸原图，再隐藏部分区域
//结果见图1

var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var img=document.getElementById("tulip");
ctx.drawImage(img,0,0,,266);//img,x,y,width,height

//拉伸原图
//结果见图2

var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var img=document.getElementById("tulip");
ctx.drawImage(img,-400,0,800,266);//绘制被拉伸2倍后图片的左半边，这时画布右半边是空白
ctx.drawImage(img,,0,800,266);//接着绘制画布右半边，内容还是被拉伸后的图片
//画布上显示的结果就是原图的首尾（左右）连接了起来
//同理，本文的背景星空图也就是这样首尾连接起来的
//结果见图3

    

图1 drawImage第23参数为负隐藏部分图片   图2 drawImage的width参数为原图片两倍_自动拉伸图片  图3 使用drawImage将原图左右连接起来

回头再看看

Camera.prototype.drawSky = function(direction, sky, ambient){
        var width = sky.width * (this.height / sky.height) * 2;//保持背景图宽高比的同时，将图重复左右拼接
        var left = (direction / CIRCLE) * -width;

this.ctx.save();
        this.ctx.drawImage(sky.image, left, 0, width, this.height);//调用 Canvas 2d 的 drawImage()
        if (left < width - this.width) {
          this.ctx.drawImage(sky.image, left + width, 0, width, this.height);
        }
        this.ctx.restore();
    }

其中 CIRCLE 是定义为 2*Math.PI 的常量，direction 前面也有说明 等于 (this.direction + angle + CIRCLE) % (CIRCLE);  即永远在 0 ~ 2Pi 之间，所以 (direction / CIRCLE) 也永远在 0~1 之间，于是

left = (direction / CIRCLE) * -width 也就在 （-width , 0）之间。

下面是我用PPT画的说明图，这就能解释为何 left 为负数，width 要用原图宽度乘以2了。

---

参考：http://www.ituring.com.cn/article/48955#  有关3D Camera