123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359 |
- <!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">
- 表示2D [link:https://en.wikipedia.org/wiki/Vector_space vector](二维向量)的类。
- 一个二维向量是一对有顺序的数字(标记为x和y),可用来表示很多事物,例如:
- </p>
- <ul>
- <li>
- 一个位于二维空间中的点(例如一个在平面上的点)。
- </li>
- <li>
- 一个在平面上的方向与长度的定义。在three.js中,长度总是从(0, 0)到(x, y)的
- [link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean distance](欧几里德距离,即直线距离),
- 方向也是从(0, 0)到(x, y)的方向。
- </li>
- <li>
- 任意的、有顺序的一对数字。
- </li>
- </ul>
- <p>
- 其他的一些事物也可以使用二维向量进行表示,比如说动量矢量、复数等等;但以上这些是它在three.js中的常用用途。
- </p>
- <p>
- 对 [name] 实例进行遍历将按相应的顺序生成它的分量 (x, y)。
- </p>
- <h2>代码示例</h2>
- <code>
- const a = new THREE.Vector2( 0, 1 );
- //no arguments; will be initialised to (0, 0)
- const b = new THREE.Vector2( );
- const d = a.distanceTo( b );
- </code>
- <h2>构造函数</h2>
- <h3>[name]( [param:Float x], [param:Float y] )</h3>
- <p>
- [page:Float x] - 向量的x值,默认为*0*。<br />
- [page:Float y] - 向量的y值,默认为*0*。<br /><br />
- 创建一个新的[name]。
- </p>
- <h2>属性</h2>
- <h3>[property:Float height]</h3>
- <p>[page:.y y]的别名。</p>
- <h3>[property:Boolean isVector2]</h3>
- <p>
- Read-only flag to check if a given object is of type [name].
- </p>
- <h3>[property:Float width]</h3>
- <p>[page:.x x]的别名。</p>
- <h3>[property:Float x]</h3>
- <h3>[property:Float y]</h3>
- <h2>方法</h2>
- <h3>[method:this add]( [param:Vector2 v] )</h3>
- <p>将传入的向量[page:Vector2 v]和这个向量相加。</p>
- <h3>[method:this addScalar]( [param:Float s] )</h3>
- <p>将传入的标量[page:Float s]和这个向量的[page:.x x]值、[page:.y y]值相加。</p>
- <h3>[method:this addScaledVector]( [param:Vector2 v], [param:Float s] )</h3>
- <p>将所传入的[page:Vector2 v]与[page:Float s]相乘所得乘积和这个向量相加。</p>
- <h3>[method:this addVectors]( [param:Vector2 a], [param:Vector2 b] )</h3>
- <p>将该向量设置为 [page:Vector2 a] + [page:Vector2 b]。</p>
- <h3>[method:Float angle]()</h3>
- <p>
- 计算该向量相对于x轴正方向的弧度角度。
- </p>
- <h3>[method:Float angleTo]( [param:Vector2 v] )</h3>
- <p>
- 以弧度返回该向量与向量[page:Vector2 v]之间的角度。
- </p>
- <h3>[method:this applyMatrix3]( [param:Matrix3 m] )</h3>
- <p>
- 将该向量乘以三阶矩阵m(第三个值隐式地为1)。
- </p>
- <h3>[method:this ceil]()</h3>
- <p>
- 向量中的[page:.x x]分量和[page:.y y]分量向上取整为最接近的整数值。
- </p>
- <h3>[method:this clamp]( [param:Vector2 min], [param:Vector2 max] )</h3>
- <p>
- [page:Vector2 min] - 在限制范围内,x和y的最小值。<br />
- [page:Vector2 max] - 在限制范围内,x和y的最大值。<br /><br />
- 如果该向量的x值或y值大于限制范围内最大x值或y值,则该值将会被所对应的值取代。<br /><br />
- 如果该向量的x值或y值小于限制范围内最小x值或y值,则该值将会被所对应的值取代。
- </p>
- <h3>[method:this clampLength]( [param:Float min], [param:Float max] )</h3>
- <p>
- [page:Float min] - 长度将被限制为的最小值 <br />
- [page:Float max] - 长度将被限制为的最大值<br /><br />
- 如果向量长度大于最大值,则它将会被最大值所取代。<br /><br />
- 如果向量长度小于最小值,则它将会被最小值所取代。
- </p>
- <h3>[method:this clampScalar]( [param:Float min], [param:Float max] )</h3>
- <p>
- [page:Float min] - 分量将被限制为的最小值 <br />
- [page:Float max] - 分量将被限制为的最大值<br /><br />
- 如果该向量的x值或y值大于最大值,则它们将被最大值所取代。<br /><br />
- 如果该向量的x值或y值小于最小值,则它们将被最小值所取代。
- </p>
- <h3>[method:Vector2 clone]()</h3>
- <p>
- 返回一个新的Vector2,其具有和当前这个向量相同的[page:.x x]和[page:.y y]。
- </p>
- <h3>[method:this copy]( [param:Vector2 v] )</h3>
- <p>
- 将所传入Vector2的[page:.x x]和[page:.y y]属性复制给这一Vector2。
- </p>
- <h3>[method:Float distanceTo]( [param:Vector2 v] )</h3>
- <p>计算该vector到传入的[page:Vector2 v]的距离。</p>
- <h3>[method:Float manhattanDistanceTo]( [param:Vector2 v] )</h3>
- <p>
- 计算该vector到传入的[page:Vector2 v]的曼哈顿距离([link:https://en.wikipedia.org/wiki/Taxicab_geometry Manhattan distance])。
- </p>
- <h3>[method:Float distanceToSquared]( [param:Vector2 v] )</h3>
- <p>
- 计算该向量到传入的[page:Vector2 v]的平方距离。
- 如果你只是将该距离和另一个距离进行比较,则应当比较的是距离的平方,
- 因为它的计算效率会更高一些。
- </p>
- <h3>[method:this divide]( [param:Vector2 v] )</h3>
- <p>将该向量除以向量[page:Vector2 v]。</p>
- <h3>[method:this divideScalar]( [param:Float s] )</h3>
- <p>
- 将该向量除以标量[page:Float s]。
- </p>
- <h3>[method:Float dot]( [param:Vector2 v] )</h3>
- <p>
- 计算该vector和所传入[page:Vector2 v]的点积([link:https://en.wikipedia.org/wiki/Dot_product dot product])。
- </p>
- <h3>[method:Float cross]( [param:Vector2 v] )</h3>
- <p>
- 计算该vector和所传入[page:Vector2 v]的叉积([link:https://en.wikipedia.org/wiki/Cross_product cross product])。
- 请注意,“叉积”在2D中并没有被明确定义。该函数计算的是2D图形中经常使用的几何叉积。
- </p>
- <h3>[method:Boolean equals]( [param:Vector2 v] )</h3>
- <p>检查该向量和[page:Vector2 v]的严格相等性。</p>
- <h3>[method:this floor]()</h3>
- <p>
- 向量中的[page:.x x]分量和[page:.y y]分量向下取整为最接近的整数值。
- </p>
- <h3>[method:this fromArray]( [param:Array array], [param:Integer offset] )</h3>
- <p>
- [page:Array array] - 来源的数组。<br />
- [page:Integer offset] - (可选)在数组中的元素偏移量,默认值为0。<br /><br />
- 设置向量中的[page:.x x]值为array[ offset ],[page:.y y]值为array[ offset + 1 ]。
- </p>
- <h3>[method:this fromBufferAttribute]( [param:BufferAttribute attribute], [param:Integer index] )</h3>
- <p>
- [page:BufferAttribute attribute] - 来源的attribute。<br />
- [page:Integer index] - 在attribute中的索引。<br /><br />
- 从[page:BufferAttribute attribute]中设置向量的[page:.x x]值和[page:.y y]值。
- 、 </p>
- <h3>[method:Float getComponent]( [param:Integer index] )</h3>
- <p>
- [page:Integer index] - 0 或 1<br /><br />
- 如果index值为0则返回[page:.x x]值。<br />
- 如果index值为1则返回[page:.y y]值。
- </p>
- <h3>[method:Float length]()</h3>
- <p>
- 计算从(0, 0)到(x, y)的欧几里得长度
- ([link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length],即直线长度)。
- </p>
- <h3>[method:Float manhattanLength]()</h3>
- <p>
- 计算该向量的曼哈顿长度([link:http://en.wikipedia.org/wiki/Taxicab_geometry Manhattan length])。
- </p>
- <h3>[method:Float lengthSq]()</h3>
- <p>
- 计算从(0, 0)到(x, y)的欧几里得长度
- ([link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length],即直线长度)的平方。
- 如果你正在比较向量的长度,应当比较的是长度的平方,因为它的计算效率更高一些。
- </p>
- <h3>[method:this lerp]( [param:Vector2 v], [param:Float alpha] )</h3>
- <p>
- [page:Vector2 v] - 朝着进行插值的[page:Vector2]。<br />
- [page:Float alpha] - 插值因数,其范围通常在[0, 1]闭区间。<br /><br />
- 在该向量与传入的向量[page:Vector2 v]之间的线性插值,alpha是沿着线的长度的百分比
- —— alpha = 0 时表示的是当前向量,alpha = 1 时表示的是所传入的向量[page:Vector2 v]。
- </p>
- <h3>[method:this lerpVectors]( [param:Vector2 v1], [param:Vector2 v2], [param:Float alpha] )</h3>
- <p>
- [page:Vector2 v1] - 起始的[page:Vector2]。<br />
- [page:Vector2 v2] - 朝着进行插值的[page:Vector2]。<br />
- [page:Float alpha] - 插值因数,其范围通常在[0, 1]闭区间。<br /><br />
- 将此向量设置为在[page:Vector2 v1]和[page:Vector2 v2]之间进行线性插值的向量,
- 其中alpha为两个向量之间连线的长度的百分比
- —— alpha = 0 时表示的是[page:Vector2 v1],alpha = 1 时表示的是[page:Vector2 v2]。
- </p>
- <h3>[method:this negate]()</h3>
- <p>向量取反,即: x = -x , y = -y。</p>
- <h3>[method:this normalize]()</h3>
- <p>
- 将该向量转换为单位向量([link:https://en.wikipedia.org/wiki/Unit_vector unit vector]),
- 也就是说,将该向量的方向设置为和原向量相同,但是其长度([page:.length length])为1。
- </p>
- <h3>[method:this max]( [param:Vector2 v] )</h3>
- <p>
- 如果该向量的x值或y值小于所传入[page:Vector2 v]的x值或y值,则将该值替换为对应的最大值。
- </p>
- <h3>[method:this min]( [param:Vector2 v] )</h3>
- <p>
- 如果该向量的x值或y值大于所传入[page:Vector2 v]的x值或y值,则将该值替换为对应的最小值。
- </p>
- <h3>[method:this multiply]( [param:Vector2 v] )</h3>
- <p>将该向量与所传入的向量[page:Vector2 v]进行相乘。</p>
- <h3>[method:this multiplyScalar]( [param:Float s] )</h3>
- <p>将该向量与所传入的标量[page:Float s]进行相乘。</p>
- <h3>[method:this rotateAround]( [param:Vector2 center], [param:Float angle] )</h3>
- <p>
- [page:Vector2 center] - 将被围绕旋转的点。<br />
- [page:Float angle] - 将要旋转的角度,以弧度来表示。<br /><br />
- 将向量围绕着[page:Vector2 center]旋转[page:Float angle]弧度。
- </p>
- <h3>[method:this round]()</h3>
- <p>
- 向量中的[page:.x x]分量和[page:.y y]分量四舍五入取整为最接近的整数值。
- </p>
- <h3>[method:this roundToZero]()</h3>
- <p>
- 向量中的分量朝向0取整数(若分量为负数则向上取整,若为正数则向下取整)。
- </p>
- <h3>[method:this set]( [param:Float x], [param:Float y] )</h3>
- <p>设置该向量的[page:.x x]和[page:.y y]分量。</p>
- <h3>[method:this setComponent]( [param:Integer index], [param:Float value] )</h3>
- <p>
- [page:Integer index] - 0 或 1<br />
- [page:Float value] - [page:Float]<br /><br />
- 如果index值为0则将[page:.x x]值设置为[page:Float value]。<br />
- 如果index值为1则将[page:.y y]值设置为[page:Float value]
- </p>
- <h3>[method:this setLength]( [param:Float l] )</h3>
- <p>
- 将该向量的方向设置为和原向量相同,但是长度([page:.length length])为[page:Float l]。
- </p>
- <h3>[method:this setScalar]( [param:Float scalar] )</h3>
- <p>
- 将该向量的[page:.x x]、[page:.y y]值同时设置为等于传入的[page:Float scalar]。
- </p>
- <h3>[method:this setX]( [param:Float x] )</h3>
- <p>将向量中的[page:.x x]值替换为[page:Float x]。</p>
- <h3>[method:this setY]( [param:Float y] )</h3>
- <p>将向量中的[page:.y y]值替换为[page:Float y]。</p>
- <h3>[method:this sub]( [param:Vector2 v] )</h3>
- <p>从该向量减去向量[page:Vector2 v]。</p>
- <h3>[method:this subScalar]( [param:Float s] )</h3>
- <p>从该向量的[page:.x x]和[page:.y y]中减去标量[page:Float s]。</p>
- <h3>[method:this subVectors]( [param:Vector2 a], [param:Vector2 b] )</h3>
- <p>将该向量设置为[page:Vector2 a] - [page:Vector2 b]。</p>
- <h3>[method:Array toArray]( [param:Array array], [param:Integer offset] )</h3>
- <p>
- [page:Array array] - (可选)被用于存储向量的数组。如果这个值没有传入,则将创建一个新的数组。<br />
- [page:Integer offset] - (可选) 数组中元素的偏移量。<br /><br />
- 返回一个数组[x, y],或者将x和y复制到所传入的[page:Array array]中。
- </p>
- <h3>[method:this random]()</h3>
- <p>
- 将该向量的每个分量(x、y)设置为介于 0 和 1 之间的伪随机数,不包括 1。
- </p>
- <h2>源代码</h2>
- <p>
- [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
- </p>
- </body>
- </html>
|