three.js 源码注释(十六)Math/Frustum.js

时间:2021-09-28 03:16:47

商域无疆 (http://blog.csdn.net/omni360/)

本文遵循“署名-非商业用途-保持一致”创作公用协议

转载请保留此句:商域无疆 -  本博客专注于 敏捷开发及移动和物联设备研究:数据可视化、GOLANG、Html5、WEBGL、THREE.JS否则,出自本博客的文章拒绝转载或再转载,谢谢合作。


俺也是刚开始学,好多地儿肯定不对还请见谅.

以下代码是THREE.JS 源码文件中Math/Frustum.js文件的注释.

更多更新在 : https://github.com/omni360/three.js.sourcecode/blob/master/Three.js


// File:src/math/Frustum.js

/**
 * @author mrdoob / http://mrdoob.com/
 * @author alteredq / http://alteredqualia.com/
 * @author bhouston / http://exocortex.com
 */
/*
///Frustum对象的构造函数.用来在三维空间内创建一个平截头体对象.Frustum对象的功能函数采用
///定义构造的函数原型对象来实现,平截头体由6个平面对象构成.
*/
///<summary>Frustum</summary>
///<param name ="p0" type="THREE.Plane">组成平截头体的面p0</param>
///<param name ="p1" type="THREE.Plane">组成平截头体的面p1</param>
///<param name ="p2" type="THREE.Plane">组成平截头体的面p2</param>
///<param name ="p3" type="THREE.Plane">组成平截头体的面p3</param>
///<param name ="p4" type="THREE.Plane">组成平截头体的面p4</param>
///<param name ="p5" type="THREE.Plane">组成平截头体的面p5</param>
THREE.Frustum = function ( p0, p1, p2, p3, p4, p5 ) {

	this.planes = [

		( p0 !== undefined ) ? p0 : new THREE.Plane(),
		( p1 !== undefined ) ? p1 : new THREE.Plane(),
		( p2 !== undefined ) ? p2 : new THREE.Plane(),
		( p3 !== undefined ) ? p3 : new THREE.Plane(),
		( p4 !== undefined ) ? p4 : new THREE.Plane(),
		( p5 !== undefined ) ? p5 : new THREE.Plane()

	];

};

/****************************************
****下面是Frustum对象提供的功能函数.
****************************************/
THREE.Frustum.prototype = {

	constructor: THREE.Frustum,	//构造器,返回对创建此对象的Frustum函数的引用

	/*
	///set方法用来重新设置平截头体的起始点,结束点,p0, p1, p2, p3, p4, p5.并返回新的坐标值的平截头体.
	*/
	///<summary>set</summary>
	///<param name ="p0" type="THREE.Plane">组成平截头体的面p0</param>
	///<param name ="p1" type="THREE.Plane">组成平截头体的面p1</param>
	///<param name ="p2" type="THREE.Plane">组成平截头体的面p2</param>
	///<param name ="p3" type="THREE.Plane">组成平截头体的面p3</param>
	///<param name ="p4" type="THREE.Plane">组成平截头体的面p4</param>
	///<param name ="p5" type="THREE.Plane">组成平截头体的面p5</param>
	///<returns type="Frustum">返回新的平截头体</returns>
	set: function ( p0, p1, p2, p3, p4, p5 ) {

		var planes = this.planes;

		planes[ 0 ].copy( p0 );
		planes[ 1 ].copy( p1 );
		planes[ 2 ].copy( p2 );
		planes[ 3 ].copy( p3 );
		planes[ 4 ].copy( p4 );
		planes[ 5 ].copy( p5 );

		return this;		//返回新的平截头体

	},

	/*
	///copy方法用来复制组成平截头体的六个面,p0, p1, p2, p3, p4, p5.并返回新的平截头体.
	*/
	///<summary>copy</summary>
	///<param name ="frustum" type="Frustum">平截头体</param>
	///<returns type="Frustum">返回新的平截头体</returns>
	copy: function ( frustum ) {

		var planes = this.planes;

		for ( var i = 0; i < 6; i ++ ) {

			planes[ i ].copy( frustum.planes[ i ] );

		}

		return this;	//返回新的平截头体

	},

	/*
	///setFromMatrix方法通过对当前平截头体应用变换,返回新的平截头体.
	*/
	///<summary>setFromMatrix</summary>
	///<param name ="m" type="Matrix4">4x4矩阵</param>
	///<returns type="Frustum">返回新的平截头体</returns>
	setFromMatrix: function ( m ) {

		var planes = this.planes;
		var me = m.elements;
		var me0 = me[ 0 ], me1 = me[ 1 ], me2 = me[ 2 ], me3 = me[ 3 ];
		var me4 = me[ 4 ], me5 = me[ 5 ], me6 = me[ 6 ], me7 = me[ 7 ];
		var me8 = me[ 8 ], me9 = me[ 9 ], me10 = me[ 10 ], me11 = me[ 11 ];
		var me12 = me[ 12 ], me13 = me[ 13 ], me14 = me[ 14 ], me15 = me[ 15 ];

		planes[ 0 ].setComponents( me3 - me0, me7 - me4, me11 - me8, me15 - me12 ).normalize();
		planes[ 1 ].setComponents( me3 + me0, me7 + me4, me11 + me8, me15 + me12 ).normalize();
		planes[ 2 ].setComponents( me3 + me1, me7 + me5, me11 + me9, me15 + me13 ).normalize();
		planes[ 3 ].setComponents( me3 - me1, me7 - me5, me11 - me9, me15 - me13 ).normalize();
		planes[ 4 ].setComponents( me3 - me2, me7 - me6, me11 - me10, me15 - me14 ).normalize();
		planes[ 5 ].setComponents( me3 + me2, me7 + me6, me11 + me10, me15 + me14 ).normalize();

		return this;	//返回新的平截头体

	},

	/*
	///intersectsObject方法获取当前平截头体是否与参数object对象相交,返回true 或者 false
	*/
	///<summary>intersectsObject</summary>
	///<param name ="object" type="Object3d">3d立体对象</param>
	///<returns type="Boolean">返回true 或者 false</returns>
	intersectsObject: function () {

		var sphere = new THREE.Sphere();

		return function ( object ) {

			var geometry = object.geometry;

			if ( geometry.boundingSphere === null ) geometry.computeBoundingSphere();

			sphere.copy( geometry.boundingSphere );
			sphere.applyMatrix4( object.matrixWorld );

			return this.intersectsSphere( sphere );	//返回true 或者 false

		};

	}(),

	/*
	///intersectsSphere方法获取当前平截头体是否与参数sphere球体对象相交,返回true 或者 false
	*/
	///<summary>intersectsSphere</summary>
	///<param name ="sphere" type="Sphere">一个Sphere的球体</param>
	///<returns type="Boolean">返回true 或者 false</returns>
	intersectsSphere: function ( sphere ) {

		var planes = this.planes;
		var center = sphere.center;
		var negRadius = - sphere.radius;

		for ( var i = 0; i < 6; i ++ ) {

			var distance = planes[ i ].distanceToPoint( center );

			if ( distance < negRadius ) {

				return false;	//不相交返回false

			}

		}

		return true;	//相交返回true

	},

	/*
	///intersectsBox方法获取当前平截头体是否与参数box立方体对象相交,返回true 或者 false
	*/
	///<summary>intersectsBox</summary>
	///<param name ="box" type="Box3">立方体对象</param>
	///<returns type="Boolean">返回true 或者 false</returns>
	intersectsBox: function () {

		var p1 = new THREE.Vector3(),
			p2 = new THREE.Vector3();

		return function ( box ) {

			var planes = this.planes;

			for ( var i = 0; i < 6 ; i ++ ) {

				var plane = planes[ i ];

				p1.x = plane.normal.x > 0 ? box.min.x : box.max.x;
				p2.x = plane.normal.x > 0 ? box.max.x : box.min.x;
				p1.y = plane.normal.y > 0 ? box.min.y : box.max.y;
				p2.y = plane.normal.y > 0 ? box.max.y : box.min.y;
				p1.z = plane.normal.z > 0 ? box.min.z : box.max.z;
				p2.z = plane.normal.z > 0 ? box.max.z : box.min.z;

				var d1 = plane.distanceToPoint( p1 );
				var d2 = plane.distanceToPoint( p2 );

				// if both outside plane, no intersection
				// 如果立方体的p1,p2都与平面不想交,表示立方体和平截头体不相交.

				if ( d1 < 0 && d2 < 0 ) {

					return false;		//不相交返回false

				}
			}

			return true;	//相交返回true.
		};

	}(),


	/*
	///containsPoint方法用来获得参数point(一个Vector3的三维点坐标)是否在当前平截头体内.
	*/
	///<summary>containsPoint</summary>
	///<param name ="point" type="THREE.Vector3">一个Vector3的三维点坐标</param>
	///<returns type="Boolean">返回true 或者 false</returns>
	containsPoint: function ( point ) {

		var planes = this.planes;

		for ( var i = 0; i < 6; i ++ ) {

			if ( planes[ i ].distanceToPoint( point ) < 0 ) {

				return false;	//不在边界内,返回false

			}

		}

		return true;		//在边界内,返回true

	},

	/*clone方法
	///clone方法克隆一个平截头体对象.
	*/
	///<summary>clone</summary>
	///<returns type="Frustum">返回平截头体对象</returns>	
	clone: function () {

		return new THREE.Frustum().copy( this );	//返回平截头体对象

	}

};


商域无疆 (http://blog.csdn.net/omni360/)

本文遵循“署名-非商业用途-保持一致”创作公用协议

转载请保留此句:商域无疆 -  本博客专注于 敏捷开发及移动和物联设备研究:数据可视化、GOLANG、Html5、WEBGL、THREE.JS否则,出自本博客的文章拒绝转载或再转载,谢谢合作。


以下代码是THREE.JS 源码文件中Math/Frustum.js文件的注释.

更多更新在 : https://github.com/omni360/three.js.sourcecode/blob/master/Three.js