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了。

 <!--

 1. draw sky

 -->

 <!doctype html>

 <html>

   <head>

       <meta charset="utf-8">

     <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">

     <title>Raycaster Demo - PlayfulJS</title>

   </head>

   <body style='background: #000; margin: 0; padding: 0; width: 100%; height: 100%;'>

     <canvas id='display' width='1' height='1' style='width: 100%; height: 100%;' />

     <script>

     var CIRCLE = Math.PI * 2;

     var MOBILE = /Android|webOS|iPhone|iPad|iPod|BlackBerry/i.test(navigator.userAgent)

     function Controls(){

         this.codes  = { 37: 'left', 39: 'right', 38: 'forward', 40: 'backward' };

         this.states = { 'left': false, 'right': false, 'forward': false, 'backward': false };

         document.addEventListener('keydown', this.onKey.bind(this, true), false);

         document.addEventListener('keyup', this.onKey.bind(this, false), false);

         document.addEventListener('touchstart', this.onTouch.bind(this), false);

         document.addEventListener('touchmove', this.onTouch.bind(this), false);

         document.addEventListener('toucheend', this.onTouchEnd.bind(this), false);

     }

     Controls.prototype.onTouch = function(e){

         var t = e.touches[0];

         this.onTouchEnd(e);

         if (t.pageY < window.innerHeight * 0.5) this.onKey(true, { keyCode: 38 });

         else if (t.pageX < window.innerWidth * 0.5) this.onKey(true, { keyCode: 37 });

         else if (t.pageY > window.innerWidth * 0.5) this.onKey(true, { keyCode: 39 });

     }

     Controls.prototype.onTouchEnd = function(e){

         this.states = { 'left': false, 'right': false, 'forward': false, 'backward': false };

         e.preventDefault();

         e.stopPropagation();

     }

     Controls.prototype.onKey = function(val,e){

         var state = this.codes[e.keyCode];

         if (typeof state === 'undefined') return;

         this.states[state] = val;

         e.preventDefault && e.preventDefault();

         e.stopPropagation && e.stopPropagation();

         // console.log(e.keyCode);

     }

     function Bitmap(url, width, height){

         this.image = new Image();

         this.image.src = url;

         this.width = width;

         this.height = height;

     }

     function Map(){

         this.skybox = new Bitmap('assets/deathvalley_panorama.jpg', 2000, 750);

     }

     function Player(x, y, direction){

         this.x = x;

         this.y = y;

         this.direction = direction;

     }

     //弧度制

     Player.prototype.rotate = function(angle){

         console.log(angle);

         this.direction = (this.direction + angle + CIRCLE) % (CIRCLE);

     }

     Player.prototype.update = function(controls, map, seconds){

         if (controls.left) {this.rotate(-Math.PI * seconds)};

         if (controls.right) this.rotate(Math.PI * seconds);

         // console.log("sdf");

     }

     //http://www.ituring.com.cn/article/50019

     //camera renderer scene

     //resolution : 分辨率

     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);

     }

     //ambient: environment light

     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);

         if (left < width - this.width) {

           this.ctx.drawImage(sky.image, left + width, 0, width, this.height);

         }

         this.ctx.restore();

     }

     function GameLoop(){

         // this.start =

         this.lastTime = 0;        //control FPS

         this.frame = this.frame.bind(this);

         this.callback = function(){};        //place holder

     }

     //requestAnimationFrame make borswer start animate,argu is callbadk

     GameLoop.prototype.start = function(callback) {

         this.callback = callback;

         requestAnimationFrame(this.frame);

         // body...

     }

     GameLoop.prototype.frame = function(time){

         var seconds = (time - this.lastTime) / 1000;

         this.lastTime = time;

         if (seconds < 0.2) this.callback(seconds);

         requestAnimationFrame(this.frame);

     }

     var display = document.getElementById('display');

     var player  = new Player(15.3, -1.2, Math.PI * 0.3);

     var camera = new Camera(display, MOBILE ? 160 : 320, 0.8);

     var map = new Map();

     var controls = new Controls();

     var loop = new GameLoop();

     loop.start(function frame(seconds){

         //update map

         // update player

         player.update(controls.states, map, seconds);

         // console.log("refresh..");

         camera.render(player, map);

     });

     </script>

   </body>

 </html>

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

巴特西

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

最新文章

热门文章