123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194 |
- <!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">
- 表示二维空间中的一个轴对齐包围盒(axis-aligned bounding box,AABB)。
- </p>
- <h2>构造函数(Constructor)</h2>
- <h3>[name]( [param:Vector2 min], [param:Vector2 max] )</h3>
- <p>
- [page:Vector2 min] - (可选) [page:Vector2] 表示该盒子的下边界(x, y)。默认值为( + Infinity, + Infinity )。<br>
- [page:Vector2 max] - (可选) [page:Vector2] 表示该盒子的上边界(x, y)。默认值为( - Infinity, - Infinity )。<br /><br />
- 创建一个介于最小和最大值之间的[name]。
- </p>
- <h2>属性(Properties)</h2>
- <h3>[property:Vector2 min]</h3>
- <p>
- [page:Vector2] 表示该盒子的下边界(x, y)。<br />
- 默认值为( + Infinity, + Infinity )。
- </p>
- <h3>[property:Vector2 max]</h3>
- <p>
- [page:Vector2] 表示该盒子的上边界(x, y)。<br />
- 默认值为( - Infinity, - Infinity )。
- </p>
- <h2>方法(Methods)</h2>
- <h3>[method:Vector2 clampPoint]( [param:Vector2 point], [param:Vector2 target] )</h3>
- <p>
- [page:Vector2 point] - clamp 的位置 ([page:Vector2]) <br>
- [page:Vector2 target] — 结果会被复制到该二维向量中。<br /><br />
- 在该盒子范围内夹紧([link:https://en.wikipedia.org/wiki/Clamping_(graphics) Clamps])[page:Vector2 point]。<br />
- </p>
- <h3>[method:Box2 clone]()</h3>
- <p>返回一个新的[page:Box2],其[page:.min min]和[page:.max max]与此盒子相同。</p>
- <h3>[method:Boolean containsBox]( [param:Box2 box] )</h3>
- <p>
- [page:Box2 box] - 要检查是否被包含的盒子。<br /><br />
- 如果盒子包含整个被检查盒子,则返回true。如果两者重叠,<br>
- 也会返回true。
- </p>
- <h3>[method:Boolean containsPoint]( [param:Vector2 point] )</h3>
- <p>
- [page:Vector2 point] - 要检查是否被包含的点[page:Vector2]。<br /><br />
- 如果指定的点([page:Vector2 point])位于盒子的边界内或边界上,则返回true。
- </p>
- <h3>[method:this copy]( [param:Box2 box] )</h3>
- <p>
- 将[page:Box2 box]的[page:.min min] 和 [page:.max max]复制到此盒子中。
- </p>
- <h3>[method:Float distanceToPoint]( [param:Vector2 point] )</h3>
- <p>
- [page:Vector2 point] - 要测量距离的点([page:Vector2])。<br /><br />
- 返回这个盒子的任何边缘到指定点的距离。如果这个点([page:Vector2 point])位于这个盒子里,距离将是0。
- </p>
- <h3>[method:Boolean equals]( [param:Box2 box] )</h3>
- <p>
- [page:Box2 box] - 要对比的盒子<br /><br />
- 如果这个盒子和被对比盒子具有相同的上下边界,则返回true。
- </p>
- <h3>[method:this expandByPoint]( [param:Vector2 point] )</h3>
- <p>
- [page:Vector2 point] - 应该被盒子包含的点。<br /><br />
- 扩展盒子的边界来包含该点。
- </p>
- <h3>[method:this expandByScalar]( [param:Float scalar] )</h3>
- <p>
- [page:Float scalar] - 盒子扩展的距离。<br /><br />
- 在每个维度上扩展参数scalar所指定的距离,如果为负数,则盒子空间将收缩。
- </p>
- <h3>[method:this expandByVector]( [param:Vector2 vector] )</h3>
- <p>
- [page:Vector2 vector] - 按照该向量扩展。<br /><br />
- 在每个维度中按vector的数值进行扩展。宽度在两个方向上的扩展将由vector的x分量确定,
- 高度在两个方向上的扩展则由y分量确定。
- </p>
- <h3>[method:Vector2 getCenter]( [param:Vector2 target] )</h3>
- <p>
- [page:Vector2 target] — 结果将被复制到此二维向量中。<br /><br />
- 以二维向量形式返回盒子的中心点。
- </p>
- <h3>[method:Vector2 getParameter]( [param:Vector2 point], [param:Vector2 target] ) </h3>
- <p>
- [page:Vector2 point] - 二维向量([page:Vector2]).<br/>
- [page:Vector2 target] — 结果将被复制到此二维向量中。<br /><br />
- 返回一个点作为此盒子的宽度和高度的比例。
- </p>
- <h3>[method:Vector2 getSize]( [param:Vector2 target] )</h3>
- <p>
- [page:Vector2 target] — 结果将被复制到此二维向量中。<br /><br />
- 返回此盒子的宽度和高度。
- </p>
- <h3>[method:this intersect]( [param:Box2 box] )</h3>
- <p>
- [page:Box2 box] - 要相交的盒子。<br /><br />
- 返回两者的相交后的盒子,并将相交后的盒子的上限设置为两者的上限中的较小者,将下限设置为两者的下限中的较大者。
- </p>
- <h3>[method:Boolean intersectsBox]( [param:Box2 box] )</h3>
- <p>
- [page:Box2 box] - 用来检查相交的盒子。<br /><br />
- 确定该盒子是否和其相交。
- </p>
- <h3>[method:Boolean isEmpty]()</h3>
- <p>
- 如果这个盒子包含0个顶点,则返回true。<br>
- 请注意,一个下上边界相等的的盒子仍然包括一个点,一个两个边界共享的点。
- </p>
- <h3>[method:this makeEmpty]()</h3>
- <p>使此盒子为空。</p>
- <h3>[method:this set]( [param:Vector2 min], [param:Vector2 max] )</h3>
- <p>
- [page:Vector2 min] - (必须) 表示该盒子的下边界(x, y)。 <br>
- [page:Vector2 max] - (必须) 表示该盒子的上边界(x, y)。 <br /><br />
- 设置这个盒子的上下(x, y)的界限。<br>
- 请注意,此方法仅复制给定对象的值。
- </p>
- <h3>[method:this setFromCenterAndSize]( [param:Vector2 center], [param:Vector2 size] )</h3>
- <p>
- [page:Vector2 center] - 盒子所要设置的中心位置。 ([page:Vector2]). <br>
- [page:Vector2 size] - 盒子所要设置的x和y尺寸 ([page:Vector2]).<br /><br />
- 使盒子的中心点位于[page:Vector2 center],并设置宽高为[page:Vector2 size]中指定的值。
- </p>
- <h3>[method:this setFromPoints]( [param:Array points] )</h3>
- <p>
- [page:Array points] - 点的集合,由这些点确定的空间将被盒子包围。<br /><br />
- 设置这个盒子的上下边界,来包含所有设置在[page:Array points]参数中的点。
- </p>
- <h3>[method:this translate]( [param:Vector2 offset] )</h3>
- <p>
- [page:Vector2 offset] - 偏移方向和距离。<br /><br />
- 添加 [page:Vector2 offset] 到这个盒子的上下边界,实际上在2D空间移动这个盒子[page:Vector2 offset]个单位。
- </p>
- <h3>[method:this union]( [param:Box2 box] )</h3>
- <p>
- [page:Box2 box] - 将要与该盒子联合的盒子<br /><br />
- 在[page:Box2 box]参数的上边界和该盒子的上边界之间取较大者,而对两者的下边界取较小者,这样获得一个新的较大的联合盒子。
- </p>
- <h2>源码(Source)</h2>
- <p>
- [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
- </p>
- </body>
- </html>
|