three.js 源码注释(二十六)Core/BufferAttribute.js

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

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

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


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

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

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


/**
 * @author mrdoob / http://mrdoob.com/
 */
/*
///BufferAttribute类用来存储于bufferGeometry相关联的属性数据,更多细节可以参考官方的样例http://threejs.org/
/// 这个类用来存储内置属性例如顶点位置,法线,颜色,等,但也可以用于存储bufferGeometry对象的自定义属性.
///BufferAttribute对象的功能函数采用定义构造的函数原型对象来实现.
/// TODO:增加一个基类setAttr(index,item,itemSize)根据跟多不同的属性相长度设置属性
///
*/
///<summary>BufferAttribute</summary>
///<param name ="array" type="Array">属性数组</param>
///<param name ="itemSize" type="number">属性相长度</param>
///<returns type="BufferAttribute">返回新的属性数组</returns>
THREE.BufferAttribute = function ( array, itemSize ) {

	this.array = array;		//BufferAttribute的array属性
	this.itemSize = itemSize;	//BufferAttribute的itemSize属性

};

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

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

	/*
	///get length 方法用来获取BufferAttribute的数组长度
	///NOTE: get length()BufferAttribute.prototype.length(),这种用法在除ie浏览器以外的浏览器上可以使用.
	*/
	///<summary>get length</summary>
	///<returns type="number">返回BufferAttribute的数组长度</returns>
	get length () {	

		return this.array.length;	//返回BufferAttribute的数组长度

	},

	/*
	///set方法用来重新设置BufferAttribute的属性数组
	*/
	///<summary>set</summary>
	///<param name ="value" type="Array">属性数组</param>
	///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
	set: function ( value ) {

		this.array.set( value );	

		return this;	//返回新的BufferAttribute属性对象

	},

	/*
	///setX方法用来重新设置含有3个属性相的BufferAttribute属性数组的第一个分量
	/// NOTE:setX方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要存放100个点的坐标,坐标有3个属性相,那么属性数组的长度是300,如果想改变第30个点的x坐标就将index设为30
	*/
	///<summary>setX</summary>
	///<param name ="index" type="Number">属性数组的索引</param>
	///<param name ="x" type="Number">属性数组的第一个分量</param>
	///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
	setX: function ( index, x ) {

		this.array[ index * this.itemSize ] = x;

		return this;	//返回新的BufferAttribute属性对象

	},

	/*
	///setY方法用来重新设置含有3个属性相的BufferAttribute属性数组的第二个分量
	/// NOTE:setY方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要存放100个点的坐标,坐标有3个属性相,那么属性数组的长度是300,如果想改变第30个点的Y坐标就将index设为30
	*/
	///<summary>setY</summary>
	///<param name ="index" type="Number">属性数组的索引</param>
	///<param name ="y" type="Number">属性数组的第一个分量</param>
	///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
	setY: function ( index, y ) {

		this.array[ index * this.itemSize + 1 ] = y;

		return this;	//返回新的BufferAttribute属性对象

	},

	/*
	///setZ方法用来重新设置含有3个属性相的BufferAttribute属性数组的第三个分量
	/// NOTE:setY方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要存放100个点的坐标,坐标有3个属性相,那么属性数组的长度是300,如果想改变第30个点的Z坐标就将index设为30
	*/
	///<summary>setZ</summary>
	///<param name ="index" type="Number">属性数组的索引</param>
	///<param name ="z" type="Number">属性数组的第一个分量</param>
	///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
	setZ: function ( index, z ) {

		this.array[ index * this.itemSize + 2 ] = z;

		return this;	//返回新的BufferAttribute属性对象

	},

	/*
	///setXY方法用来重新设置含有3个属性相的BufferAttribute属性数组的第一个和第二个分量
	/// NOTE:setXY方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要存放100个点的坐标,坐标有3个属性相,那么属性数组的长度是300,如果想改变第30个点的x,y坐标就将index设为30
	*/
	///<summary>setXY</summary>
	///<param name ="index" type="Number">属性数组的索引</param>
	///<param name ="x" type="Number">属性数组的第一个分量</param>
	///<param name ="y" type="Number">属性数组的第二个分量</param>
	///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
	setXY: function ( index, x, y ) {

		index *= this.itemSize;

		this.array[ index     ] = x;
		this.array[ index + 1 ] = y;

		return this;	//返回新的BufferAttribute属性对象

	},

	/*
	///setXYZ方法用来重新设置含有3个属性相的BufferAttribute属性数组的第一个,第二个和第三个分量
	/// NOTE:setXY方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要存放100个点的坐标,坐标有3个属性相,那么属性数组的长度是300,如果想改变第30个点的x,y,z坐标就将index设为30
	*/
	///<summary>setXYZ</summary>
	///<param name ="index" type="Number">属性数组的索引</param>
	///<param name ="x" type="Number">属性数组的第一个分量</param>
	///<param name ="y" type="Number">属性数组的第二个分量</param>
	///<param name ="z" type="Number">属性数组的第三个分量</param>
	///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
	setXYZ: function ( index, x, y, z ) {

		index *= this.itemSize;

		this.array[ index     ] = x;
		this.array[ index + 1 ] = y;
		this.array[ index + 2 ] = z;

		return this;	//返回新的BufferAttribute属性对象

	},

	/*
	///setXYZW方法用来重新设置含有3个属性相的BufferAttribute属性数组的第一个,第二个和第三个,第四个分量
	/// NOTE:setXYZW方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要存放100个点的坐标,坐标有4个属性相,那么属性数组的长度是400,如果想改变第30个点的x,y,z,w坐标就将index设为30
	*/
	///<summary>setXYZW</summary>
	///<param name ="index" type="Number">属性数组的索引</param>
	///<param name ="x" type="Number">属性数组的第一个分量</param>
	///<param name ="y" type="Number">属性数组的第二个分量</param>
	///<param name ="z" type="Number">属性数组的第三个分量</param>
	///<param name ="w" type="Number">属性数组的第四个分量</param>
	///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
	setXYZW: function ( index, x, y, z, w ) {

		index *= this.itemSize;

		this.array[ index     ] = x;
		this.array[ index + 1 ] = y;
		this.array[ index + 2 ] = z;
		this.array[ index + 3 ] = w;

		return this;	//返回新的BufferAttribute属性对象

	}

};


/**********************************************************************************
****下面这些方法是定义不同数据类型的属性,已经在新版本中删除,这里保留是为了向后兼容.
***********************************************************************************/
THREE.Int8Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Int8Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};

THREE.Uint8Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Uint8Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};

THREE.Uint8ClampedAttribute = function ( data, itemSize ) {

	console.warn( 'THREE.Uint8ClampedAttribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );


};

THREE.Int16Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Int16Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};

THREE.Uint16Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Uint16Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};

THREE.Int32Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Int32Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};

THREE.Uint32Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Uint32Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};

THREE.Float32Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Float32Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};

THREE.Float64Attribute = function ( data, itemSize ) {

	console.warn( 'THREE.Float64Attribute has been removed. Use THREE.BufferAttribute( array, itemSize ) instead.' );
	return new THREE.BufferAttribute( data, itemSize );

};


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

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

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


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

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

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。