Box3

3D空间内的边框或立方体. 主要是表示对象的世界轴对齐的边界框.

Attributes

min : Vector3(x, y, z)

Default value : new Vector3( +Infinity, +Infinity, +Infinity )
Description : 框的下边界(x, y)

max : Vector3(x, y, z)

Default value : new Vector3( -Infinity, -Infinity, -Infinity )
Description : 框的上边界(x, y)

Methods

set( min, max ) : this
min Vector3 下边界
max Vector3 上边界

设置边框的下边界和上边界.

setFromArray( array ) : this
array Array Box3数组

用 array 中的所有的位置数据来设置边框的下边界和上边界.

setFromBufferAttribute( attribute ) : this
attribute BufferAttribute Box3数组

用 attribute 中的所有的位置数据来设置边框的下边界和上边界.

setFromPoints( points ) : this
points Array 点数组

用 points 中的所有的点来设置边框的下边界和上边界.

setFromCenterAndSize( center, size ) : this
center Vector3 中心点
size Vector3 尺寸

边框的中心在center, 长宽高为size中的值.

setFromObject( object ) : this
object Object3D 3D对象

计算 Object3D(包括其子项)的世界轴对齐边界框,计算对象和子项的世界变换.

makeEmpty( ) : this

使边框为空.

isEmpty( ) : Boolean

边框是否为空.

getCenter( target ) : target
target Vector3 返回的计算结果

把边框的中心点赋值给 target.

getSize( target ) : target
target Vector3 返回的计算结果

把边框的长宽赋值给 target.

expandByPoint( point ) : this
point Vector3 要被包含的点

延伸边框使其包含点 point.

expandByVector( vector ) : this
vector Vector3 扩展向量

通过向量等边扩展边框, 使其宽度在两个方向上依照vector的x分量扩展, 高度在两个方向上依照vector的y分量扩展, 深度在两个方向上依照vector的z分量扩展.

expandByScalar( scalar ) : this
scalar Float 扩展的距离

通过标量扩展框的每个维度, 如果为负数, 则将收缩尺寸.

expandByObject( object ) : this
object Object3D 3D对象

通过object扩展边框, 使其包括对象及其子对象,计算对象和子项的世界变换.

containsPoint( point ) : Boolean
point Vector3

检测点point是否在边框内或边框上.

containsBox( box ) : Boolean
box Box3 边框

检测box是否在边框内, 或者与自身相同.

getParameter( point, target ) : target
point Vector3
target Vector3 要被复制到的目标

点point跟自身在宽度和高度上的比例.

intersectsSphere( sphere ) : Boolean
sphere Shpere 球体

检测sphere是否与自身相交.

intersectsPlane( plane ) : Boolean
plane Plane 平面

检测plane是否与自身相交.

intersectsTriangle( triangle ) : Boolean
triangle Triangle 三角形

检测triangle是否与自身相交.

clampPoint( point, target ) : target
point Vector3
target Vector3 要被复制到的目标

将点point限制在自身范围内.

distanceToPoint( point ) : Float
point Vector3

返回边框的与point的距离. 如果point位于此框内, 则距离将为0.

getBoundingSphere( target ) : target
target Vector3 要被复制到的目标

获取包围球.

intersect( box ) : this
box Box3 边框

返回两个边框的交集, 将上边界设为两个框中的较小者, 下边界设置为两个框中的较大者.

translate( offset ) : this
offset Vector3 偏移量

对边框的上边界和下边界添加偏移量, 使其平移.

applyMatrix4( matrix ) : this
matrix Matrix4 四维矩阵

使用矩阵matrix来作转换.

union( box ) : this
box Box3 边框

合并两个边框, 将上边界设为两个框中的较大者, 下边界设置为两个框中的较小者.

equals( box ) : Boolean
box Box3 边框

检测自身是否与box的下边界、上边界相同.

clone( ) : Box3

复制自身.

copy( b ) : this
b Box3 三维边框

把一个三维边框值赋值到自身.