ce - The distance from the ray's origin to the intersection point. * @property {number} distanceToRay - Some 3D objects e.g. {@link Points} provide the distance of the * intersection to the nearest point on the ray. For other objects it will be `undefined`. * @property {Vector3} point - The intersection point, in world coordinates. * @property {Object} face - The face that has been intersected. * @property {number} faceIndex - The face index. * @property {Object3D} object - The 3D object that has been intersected. * @property {Vector2} uv - U,V coordinates at point of intersection. * @property {Vector2} uv1 - Second set of U,V coordinates at point of intersection. * @property {Vector3} normal - Interpolated normal vector at point of intersection. * @property {number} instanceId - The index number of the instance where the ray * intersects the {@link InstancedMesh}. */ /** * Checks all intersection between the ray and the object with or without the * descendants. Intersections are returned sorted by distance, closest first. * * `Raycaster` delegates to the `raycast()` method of the passed 3D object, when * evaluating whether the ray intersects the object or not. This allows meshes to respond * differently to ray casting than lines or points. * * Note that for meshes, faces must be pointed towards the origin of the ray in order * to be detected; intersections of the ray passing through the back of a face will not * be detected. To raycast against both faces of an object, you'll want to set {@link Material#side} * to `THREE.DoubleSide`. * * Note that a ray hitting a triangle mesh exactly along an edge shared by two faces may be * reported by both faces, resulting in two coincident intersections (identical point and * distance) in the returned array. * * @param {Object3D} object - The 3D object to check for intersection with the ray. * @param {boolean} [recursive=true] - If set to `true`, it also checks all descendants. * Otherwise it only checks intersection with the object. * @param {Array} [intersects=[]] The target array that holds the result of the method. * @return {Array} An array holding the intersection points. */ intersectObject( object, recursive = true, intersects = [] ) { intersect( object, this, intersects, recursive ); intersects.sort( ascSort ); return intersects; } /** * Checks all intersection between the ray and the objects with or without * the descendants. Intersections are returned sorted by distance, closest first. * * @param {Array} objects - The 3D objects to check for intersection with the ray. * @param {boolean} [recursive=true] - If set to `true`, it also checks all descendants. * Otherwise it only checks intersection with the object. * @param {Array} [intersects=[]] The target array that holds the result of the method. * @return {Array} An array holding the intersection points. */ intersectObjects( objects, recursive = true, intersects = [] ) { for ( let i = 0, l = objects.length; i < l; i ++ ) { intersect( objects[ i ], this, intersects, recursive ); } intersects.sort( ascSort ); return intersects; } } function ascSort( a, b ) { return a.distance - b.distance; } function intersect( object, raycaster, intersects, recursive ) { let propagate = true; if ( object.layers.test( raycaster.layers ) ) { const result = object.raycast( raycaster, intersects ); if ( result === false ) propagate = false; } if ( propagate === true && recursive === true ) { const children = object.children; for ( let i = 0, l = children.length; i < l; i ++ ) { intersect( children[ i ], raycaster, intersects, true ); } } } /** * Class for keeping track of time. * * @deprecated since r183. */ class Clock { /** * Constructs a new clock. * * @deprecated since 183. * @param {boolean} [autoStart=true] - Whether to automatically start the clock when * `getDelta()` is called for the first time. */ constructor( autoStart = true ) { /** * If set to `true`, the clock starts automatically when `getDelta()` is called * for the first time. * * @type {boolean} * @default true */ this.autoStart = autoStart; /** * Holds the time at which the clock's `start()` method was last called. * * @type {number} * @default 0 */ this.startTime = 0; /** * Holds the time at which the clock's `start()`, `getElapsedTime()` or * `getDelta()` methods were last called. * * @type {number} * @default 0 */ this.oldTime = 0; /** * Keeps track of the total time that the clock has been running. * * @type {number} * @default 0 */ this.elapsedTime = 0; /** * Whether the clock is running or not. * * @type {boolean} * @default