samien
/
three.js
зеркало из https://github.com/mrdoob/three.js.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191
							<!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">
			一个三角形由三个表示其三个角的[page:Vector3 Vector3]所定义。
		</p>


		<h2>构造函数</h2>


		<h3>[name]( [param:Vector3 a], [param:Vector3 b], [param:Vector3 c] )</h3>
		<p>
		[page:Vector3 a] - 三角形的第一个角，默认值是一个在(0, 0, 0)处的[page:Vector3]。<br />
		[page:Vector3 b] - 三角形的第二个角，默认值是一个在(0, 0, 0)处的[page:Vector3]。<br />
		[page:Vector3 c] - 三角形的第三个角（最后一个角），默认值是一个在(0, 0, 0)处的[page:Vector3]。<br /><br />

		创建一个新的[name]。
		</p>


		<h2>属性</h2>

		<h3>[property:Vector3 a]</h3>
		<p>
			三角形的第一个角，默认值是一个在(0, 0, 0)处的[page:Vector3]。
		</p>

		<h3>[property:Vector3 b]</h3>
		<p>
			三角形的第二个角，默认值是一个在(0, 0, 0)处的[page:Vector3]。
		</p>

		<h3>[property:Vector3 c]</h3>
		<p>
			三角形的第三个角（最后一个角），默认值是一个在(0, 0, 0)处的[page:Vector3]。
		</p>

		<h2>方法</h2>

		<h3>[method:Triangle clone]()</h3>
		<p>
			返回一个和该三角形具有相同[page:.a a]、[page:.b b]和[page:.c c]属性的新三角形。
		</p>

		<h3>[method:Vector3 closestPointToPoint]( [param:Vector3 point], [param:Vector3 target] )</h3>
		<p>
		[page:Vector3 point] - [page:Vector3] <br />
		[page:Vector3 target] — 结果将被拷贝到这一Vector3中。<br /><br />

		返回三角形上最靠近所给定的[page:Vector3 point]的点。
		</p>

		<h3>[method:Boolean containsPoint]( [param:Vector3 point] )</h3>
		<p>
		[page:Vector3 point] - 将被检测的[page:Vector3]。<br /><br />

		如果传入的点投影到三角形的平面内，则返回true。
		</p>

		<h3>[method:this copy]( [param:Triangle triangle] )</h3>
		<p>
			将传入的三角形的[page:.a a]、[page:.b b]和[page:.c c]属性复制给这一三角形。
		</p>

		<h3>[method:Boolean equals]( [param:Triangle triangle] )</h3>
		<p>
			若这两个三角形具有相同的[page:.a a]、[page:.b b]和[page:.c c]属性，则返回true。
		</p>

		<h3>[method:Float getArea]()</h3>
		<p>返回三角形的面积。</p>

		<h3>[method:Vector3 getBarycoord]( [param:Vector3 point], [param:Vector3 target] )</h3>
		<p>
		[page:Vector3 point] - [page:Vector3] <br />
		[page:Vector3 target] — 结果将会被拷贝到这一Vector3中。<br /><br />

		从给定的向量中返回一个[link:https://en.wikipedia.org/wiki/Barycentric_coordinate_system barycentric coordinate]（重心坐标）。<br/><br/>

		请参阅关于这一概念的相关图片：[link:http://commons.wikimedia.org/wiki/File:Barycentric_coordinates_1.png Picture of barycentric coordinates]。
		</p>

		<h3>[method:Vector3 getMidpoint]( [param:Vector3 target] )</h3>
		<p>
		[page:Vector3 target] — 结果将会被拷贝到这一Vector3中。<br /><br />

		计算三角形的中点。
		</p>

		<h3>[method:Vector3 getNormal]( [param:Vector3 target] )</h3>
		<p>
		[page:Vector3 target] — 结果将会被拷贝到这一Vector3中。<br /><br />

		计算三角形的法向量（[link:https://en.wikipedia.org/wiki/Normal_(geometry) normal vector]）。
		</p>

		<h3>[method:Plane getPlane]( [param:Plane target] )</h3>
		<p>
		[page:Plane target] — 结果将会被拷贝到这一Plane中。<br /><br />

		基于三角形计算出一个平面（[page:Plane plane]）。
		</p>

		<h3>
			[method:Vector getInterpolation]( [param:Vector3 point], [param:Vector3 p1], [param:Vector3 p2], [param:Vector3 p3], [param:Vector v1], [param:Vector v2], [param:Vector v3], [param:Vector target] )
		</h3>
		<p>
			[page:Vector3 point] - 插值点的位置<br />
			[page:Vector3 p1] - 第一个顶点的位置<br />
			[page:Vector3 p2] - 第二个顶点的位置<br />
			[page:Vector3 p3] - 第三个顶点的位置<br />
			[page:Vector v1] - 第一个顶点的值<br />
			[page:Vector v2] - 第二个顶点的值<br />
			[page:Vector v3] - 第三个顶点的值<br />
			[page:Vector target] — 结果将会被拷贝到该向量中<br /><br />

			返回三角形上指定点经过重心插值计算得到的结果值。
			如果是退化三角形(无法形成有效面积)，则返回 `null`。
		</p>

		<h3>
			[method:Vector getInterpolatedAttribute]( [param:BufferAttribute attribute], [param:Number i1], [param:Vector3 i2], [param:Number i3], [param:Vector3 barycoord], [param:Vector3 target] )
		</h3>
		<p>
			[page:BufferAttribute attribute] - 要插入的属性<br />
			p1 - 第一个顶点的索引<br />
			p2 - 第二个顶点的索引<br />
			p3 - 第三个顶点的索引<br />
			barycoord - 用于插值的重心坐标值<br />
			[page:Vector target] — 结果将会被拷贝到该向量中<br /><br />

			返回根据给定属性和索引进行重心插值计算得到的结果值。
		</p>

		<h3>[method:Boolean intersectsBox]( [param:Box3 box] )</h3>
		<p>
		[page:Box3 box] - 将被用于检测是否与三角形有交集的box。<br /><br />

		判定三角形与传入的[page:Box3 box]是否相交。
		</p>

		<h3>[method:Boolean isFrontFacing]( [param:Vector3 direction] )</h3>
		<p>
			[page:Vector3 direction] - 测试的方向<br /><br />

			三角形是否朝向给定的方向。
		</p>

		<h3>[method:this set]( [param:Vector3 a], [param:Vector3 b], [param:Vector3 c] ) [param:Triangle this]</h3>
		<p>
			将三角形的[page:.a a]、[page:.b b]和[page:.c c]属性设置为所传入的[page:Vector3 vector3]。<br>
			请注意，此方法仅复制给定对象的值。
		</p>

		<h3>[method:this setFromAttributeAndIndices]( [param:BufferAttribute attribute], [param:Integer i0], [param:Integer i1], [param:Integer i2] ) [param:Triangle this]</h3>
		<p>
		attribute - [page:BufferAttribute] 顶点数据 <br />
		i0 - 整数（[page:Integer]）索引 <br />
		i1 - 整数（[page:Integer]）索引 <br />
		i2 - 整数（[page:Integer]）索引<br /><br />

		从缓冲区属性顶点数据设置三角形的顶点。
		</p>


		<h3>[method:this setFromPointsAndIndices]( [param:Array points], [param:Integer i0], [param:Integer i1], [param:Integer i2] ) [param:Triangle this]</h3>
		<p>
		points - [page:Vector3]数组（[page:Array]） <br />
		i0 - 整数（[page:Integer]）索引 <br />
		i1 - 整数（[page:Integer]）索引 <br />
		i2 - 整数（[page:Integer]）索引<br /><br />

		设置三角形的向量为数组中的向量。
		</p>

		<h2>源代码</h2>

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