three.js 源码注释(二十六)Core/BufferAttribute.js
来源:程序员人生 发布时间:2014-12-23 08:37:54 阅读次数:3174次
商域无疆 (http://blog.csdn.net/omni360/)
本文遵守“署名-非商业用处-保持1致”创作公用协议
转载请保存此句:商域无疆 - 本博客专注于 敏捷开发及移动和物联装备研究:数据可视化、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:增加1个基类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属性数组的第1个份量
/// NOTE:setX方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要寄存100个点的坐标,坐标有3个属性相,那末属性数组的长度是300,如果想改变第30个点的x坐标就将index设为30
*/
///<summary>setX</summary>
///<param name ="index" type="Number">属性数组的索引</param>
///<param name ="x" type="Number">属性数组的第1个份量</param>
///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
setX: function ( index, x ) {
this.array[ index * this.itemSize ] = x;
return this; //返回新的BufferAttribute属性对象
},
/*
///setY方法用来重新设置含有3个属性相的BufferAttribute属性数组的第2个份量
/// NOTE:setY方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要寄存100个点的坐标,坐标有3个属性相,那末属性数组的长度是300,如果想改变第30个点的Y坐标就将index设为30
*/
///<summary>setY</summary>
///<param name ="index" type="Number">属性数组的索引</param>
///<param name ="y" type="Number">属性数组的第1个份量</param>
///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
setY: function ( index, y ) {
this.array[ index * this.itemSize + 1 ] = y;
return this; //返回新的BufferAttribute属性对象
},
/*
///setZ方法用来重新设置含有3个属性相的BufferAttribute属性数组的第3个份量
/// NOTE:setY方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要寄存100个点的坐标,坐标有3个属性相,那末属性数组的长度是300,如果想改变第30个点的Z坐标就将index设为30
*/
///<summary>setZ</summary>
///<param name ="index" type="Number">属性数组的索引</param>
///<param name ="z" type="Number">属性数组的第1个份量</param>
///<returns type="BufferAttribute">返回新的BufferAttribute属性对象</returns>
setZ: function ( index, z ) {
this.array[ index * this.itemSize + 2 ] = z;
return this; //返回新的BufferAttribute属性对象
},
/*
///setXY方法用来重新设置含有3个属性相的BufferAttribute属性数组的第1个和第2个份量
/// NOTE:setXY方法中,属性数组的长度是属性相的长度乘以属性的个数.比如要寄存100个点的坐标,坐标有3个属性相,那末属性数组的长度是300,如果想改变第30个点的x,y坐标就将index设为30
*/
///<summary>setXY</summary>
///<param name ="index" type="Number">属性数组的索引</param>
///<param name ="x" type="Number">属性数组的第1个份量</param>
///<param name ="y" type="Number">属性数组的第2个份量</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属性数组的第1个,第2个和第3个份量
/// 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">属性数组的第1个份量</param>
///<param name ="y" type="Number">属性数组的第2个份量</param>
///<param name ="z" type="Number">属性数组的第3个份量</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属性数组的第1个,第2个和第3个,第4个份量
/// 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">属性数组的第1个份量</param>
///<param name ="y" type="Number">属性数组的第2个份量</param>
///<param name ="z" type="Number">属性数组的第3个份量</param>
///<param name ="w" type="Number">属性数组的第4个份量</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/)
本文遵守“署名-非商业用处-保持1致”创作公用协议
转载请保存此句:商域无疆 - 本博客专注于 敏捷开发及移动和物联装备研究:数据可视化、GOLANG、Html5、WEBGL、THREE.JS,否则,出自本博客的文章谢绝转载或再转载,谢谢合作。
以下代码是THREE.JS 源码文件中Core/BufferAttribute.js文件的注释.
更多更新在 : https://github.com/omni360/three.js.sourcecode
生活不易,码农辛苦
如果您觉得本网站对您的学习有所帮助,可以手机扫描二维码进行捐赠