samien
/
three.js
mirror of https://github.com/mrdoob/three.js.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124
							<!DOCTYPE html>
<html lang="zh">
	<head>
		<meta charset="utf-8" />
		<base href="../../../" />
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body>
		<h1>[name]</h1>

		<p class="desc">
			"交叉存储" 表明多个类型的 attributes （例如，顶点位置、法向量、UV 和颜色值）被存储到一个队列中。
			<br/><br/>
			如下链接有对交叉存储更详细的介绍: [link:https://blog.tojicode.com/2011/05/interleaved-array-basics.html Interleaved array basics]
		</p>

		<h2>例子</h2>

		<p>[example:webgl_buffergeometry_points_interleaved webgl / buffergeometry / points / interleaved]</p>

		<h2>构造函数</h2>
		<h3>[name]( [param:TypedArray array], [param:Integer stride] )</h3>
		<p>
			[page:TypedArray array] -- 一个基于共享缓存的类型化队列。该队列存储几何体相关数据。<br/>
			[page:Integer stride] -- 每个顶点占用类型化队列的多少个元素。
		</p>

		<h2>属性</h2>

		<h3>[property:Array array]</h3>
		<p>
			一个基于共享缓存的类型化队列。该队列存储几何体相关数据。
		</p>

		<h3>[property:Integer stride]</h3>
		<p>
			每个顶点占用类型化队列的多少个元素。
		</p>

		<h3>[property:Integer count]</h3>
		<p>
			类型化队列中，所有元素的数目。
		</p>

		<h3>[property:Object updateRange]</h3>
		<p>
			对象存储着需要更新的数据的偏移量和数量。<br />
			- [page:Number offset]: 默认值为 *0*。<br />
			- [page:Number count]: 默认值为 *-1*。<br />
		</p>

		<h3>[property:String uuid]</h3>
		<p>
		该类所创建的实例的[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID]。它是自动被指定的，因此它不应当被编辑、更改。
		</p>

		<h3>[property:Integer version]</h3>
		<p>
			版本号，每次 needsUpdate 属性设置为 true 时，版本号增加。
		</p>

		<h3>[property:Integer needsUpdate]</h3>
		<p>
			默认值为 *false*。该值被设置为 true 时，会导致 [page:InterleavedBuffer.version version] 增加。
		</p>

		<h3>[property:Usage usage]</h3>
		<p>
			定义数据存储的预期使用模式，以实现优化目的。对应 [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bufferData WebGLRenderingContext.bufferData]() 的 *usage* 参数。
		</p>

		<h2>方法</h2>

		<h3>[method:this addUpdateRange]( [param:Integer start], [param:Integer count] )</h3>
		<p>
			在数据数组中添加要在 GPU 上更新的数据范围。将描述该范围的对象添加到 [page:InterleavedBuffer.updateRanges updateRanges] 数组。
		</p>

		<h3>[method:this clearUpdateRanges]()</h3>
		<p>
			清除 [page:InterleavedBuffer.updateRanges updateRanges] 数组。
		</p>

		<h3>[method:this copy]( [param:InterleavedBuffer source] ) </h3>
		<p>
			将参数指定的 [name] 拷贝到当前 [name]。
		</p>

		<h3>[method:this copyAt]( [param:Integer index1], [param:InterleavedBuffer attribute], [param:Integer index2] ) </h3>
		<p> 将数据从 attribute[index2] 拷贝到 [page:InterleavedBuffer.array array][index1]。</p>

		<h3>[method:this set]( [param:TypedArray value], [param:Integer offset] ) </h3>
		<p>
			value - 被拷贝的源（类型化）队列。<br/>
			offset - 源队列中，数据开始拷贝的偏移量。默认值是 *0*.<br/><br />

			将源队列数据拷贝到目标队列缓存中。
		</p>

		<h3>[method:InterleavedBuffer clone]( [param:Object data] ) </h3>
		<p>
			data - 该对象保存正确克隆具有交错属性的几何图形所需的共享数组缓冲区。<br/><br />

			创建此 [name] 的克隆。
		</p>

		<h3>[method:this setUsage] ( [param:Usage value] ) </h3>
		<p>设置 [page:InterleavedBuffer.usage usage] 的值。</p>

		<h3>[method:Object toJSON]( [param:Object data] ) </h3>
		<p>
			data - 该对象包含正确序列化具有交错属性的几何图形所需的共享数组缓冲区。<br/><br />

			序列化这个 [name]。
		</p>

		<h2>源代码</h2>

		<p>
			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
		</p>
	</body>
</html>