BufferGeometry
Object3D
Raycaster
Camera
CubeCamera
PerspectiveCamera
OrthographicCamera
StereoCamera
Clock
Curve
CurvePath
Path
Shape
ShapePath
ArrowHelper
AxesHelper
BoxHelper
Box3Helper
CameraHelper
DirectionalLightHelper
GridHelper
PolarGridHelper
HemisphereLightHelper
PlaneHelper
PointLightHelper
SkeletonHelper
SpotLightHelper
Light
PointLight
RectAreaLight
SpotLight
DirectionalLight
HemisphereLight
LightShadow
PointLightShadow
AnimationLoader
AudioLoader
BufferGeometryLoader
CompressedTextureLoader
CubeTextureLoader
DataTextureLoader
FileLoader
ImageBitmapLoader
ImageLoader
Loader
LoaderUtils
MaterialLoader
ObjectLoader
TextureLoader
LoadingManager
Material
Box2
Box3
Color
Cylindrical
Euler
Frustum
Interpolant
Line3
MathUtils
Matrix3
Matrix4
Plane
Quaternion
AnimationAction
AnimationClip
AnimationMixer
AnimationObjectGroup
AnimationUtils
keyframeTrack
PropertyBinding
PropertyMixer
BooleanKeyframeTrack
QuaternionKeyframeTrack
StringKeyframeTrack
Audio
AudioAnalyser
AudioContext
AudioListener
PositionalAudio

Box3.distanceToPoint()

Box3.distanceToPoint() 方法计算一个给定点与三维矩形框(Box3)的最小距离。

语法

distanceToPoint(point: Vector3): number

参数

point:一个 Vector3 对象,包含需要计算距离的点的坐标。

返回值

返回值是一个数字,代表点与矩形框的最小距离。

示例

const box = new THREE.Box3(new THREE.Vector3(-5, -5, -5), new THREE.Vector3(5, 5, 5));
const point = new THREE.Vector3(8, 8, 8);
const distance = box.distanceToPoint(point);
console.log(distance); // 输出 6.928203230275509

注:distance 的值是点 point 到矩形框 box 最近的距离。在这个示例中,点 point 与矩形框 box 相切于一角,所以最小距离为该角的对角线长度。

备注

  • 这个方法会改变 Box3 对象的大小,因为它使用了矩形框的 minmax 属性。所以,在计算距离之前,你需要确保这些属性包含了你需要考虑的矩形框。
  • 如果点在矩形框内部,则返回值为 0。
  • 如果点在矩形框外部,则返回的值为负数。
  • 如果想要检查点是否在矩形框内部,可以使用 Box3.containsPoint() 方法。如果想要检查另一个矩形框是否与当前矩形框相交,可以使用 Box3.intersectsBox() 方法。