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

Line3.closestPointToPointParameter()

Line3.closestPointToPointParameter() 方法用于计算一个给定点到三维空间中的直线的最近点的参数化位置。

语法

closestPointToPointParameter(point: Vector3, clampToLine: boolean, optionalTarget: Vector3): number

参数

  • pointVector3 类型,表示要查找最近点的目标点。
  • clampToLineboolean 类型,表示是否将最近点限制在直线的端点之间。默认值为 false
  • optionalTargetVector3 类型,表示可选的用于存储结果的向量。

返回值

  • number:最近点在直线上的参数化位置。

示例

const line = new THREE.Line3(new THREE.Vector3(0, 0, 0), new THREE.Vector3(1, 0, 0));

const targetPoint = new THREE.Vector3(0.5, 1, 0);
const closestPointParameter = line.closestPointToPointParameter(targetPoint);
const closestPoint = new THREE.Vector3();
line.closestPointToPoint(targetPoint, closestPoint); // 可选,用于确认结果是否正确

注意事项

  • closestPointToPointParameter 方法只计算最近点在直线上的参数化位置,如果需要获取最近点的位置向量,需要使用 closestPointToPoint 方法或手动计算(参考代码示例)。