diff --git a/docs/api/core/Object3D.html b/docs/api/core/Object3D.html
index 776242c2f01f39b6cc6734fc1f360faac25eb8e3..82b8de89914c63e244b51bad556d84f8a62123b6 100644
--- a/docs/api/core/Object3D.html
+++ b/docs/api/core/Object3D.html
@@ -299,6 +299,11 @@
Rotate an object along an axis in object space. The axis is assumed to be normalized.
+
+ Abstract method to get intersections between a casted ray and this object. Subclasses such as [page:Mesh], [page:Line], and [page:PointCloud] implement this method in order to participate in raycasting.
+
This class makes raycasting easier. Raycasting is used for picking and more.
+
+
+
Example
+
+ var raycaster = new THREE.Raycaster();
+ var mouse = new THREE.Vector2();
+
+ function onMouseMove( event ) {
+
+ // calculate mouse position in normalized device coordinates
+ // (-1 to +1) for both components
+
+ mouse.x = ( event.clientX / window.innerWidth ) * 2 - 1
+ mouse.y = - ( event.clientY / window.innerHeight ) * 2 + 1
+
+ }
+
+ function render() {
+
+ // update the picking ray with the camera and mouse position
+ raycaster.setFromCamera( mouse, camera );
+
+ // calculate objects intersecting the picking ray
+ var intersects = raycaster.intersectObjects( scene.children );
+
+ for ( var intersect in intersects ) {
+
+ intersect.object.material.color = new THREE.Color( 0xff0000 );
+ }
+
+ renderer.render( scene, camera );
+
+ }
+
+ window.addEventListener( 'mousemove', onMouseMove, false );
+
+ window.requestAnimationFrame(render);
+
+
+
Examples: [example:webgl_interactive_cubes Raycasting to a Mesh],
+ [example:webgl_interactive_cubes_ortho Raycasting to a Mesh in using an OrthographicCamera],
+ [example:webgl_interactive_buffergeometry Raycasting to a Mesh with BufferGeometry],
+ [example:webgl_interactive_lines Raycasting to a Line],
+ [example:webgl_interactive_raycasting_pointcloud Raycasting to a PointCloud],
+ [example:webgl_geometry_terrain_raycast Terrain raycasting],
+ [example:webgl_octree_raycasting Raycasting using an octree],
+ [example:webgl_interactive_voxelpainter Raycasting to paint voxels]
[page:Vector3 origin] — The origin vector where the ray casts from.
[page:Vector3 direction] — The direction vector that gives direction to the ray.
- [page:Float near] — All results returned are further away then near. Near can't be negative. Default value is 0.
+ [page:Float near] — All results returned are further away than near. Near can't be negative. Default value is 0.
[page:Float far] — All results returned are closer then far. Far can't be lower then near . Default value is Infinity.
@@ -51,7 +100,12 @@
[property:float precision]
- The precision factor of the raycaster.
+ The precision factor of the raycaster when intersecting [page:Mesh] objects.
+
+
+
.[page:float linePrecision]
+
+ The precision factor of the raycaster when intersecting [page:Line] objects.
Methods
@@ -65,16 +119,45 @@
Updates the ray with a new origin and direction.
+ [page:Vector2 coords] — 2D coordinates of the mouse, in normalized device coordinates (NDC)---X and Y components should be between -1 and 1.
+ [page:Camera camera] — camera from which the ray should originate
+
+
+ Updates the ray with a new origin and direction.
+
[page:Object3D object] — The object to check for intersection with the ray.
[page:Boolean recursive] — If set, it also checks all descendants. Otherwise it only checks intersecton with the object.
+
- checks all intersection between the ray and the object with or without the descendants. Intersections are returned sorted by distance, closest first.
+ Checks all intersection between the ray and the object with or without the descendants. Intersections are returned sorted by distance, closest first. An array of intersections is returned...
- [ { distance, point, face, faceIndex, object }, ... ]
+ [ { distance, point, face, faceIndex, indices, object }, ... ]
+
+ [page:Float distance] – distance between the origin of the ray and the intersection
+ [page:Vector3 point] – point of intersection, in world coordinates
+ [page:Face3 face] – intersected face
+ [page:Integer faceIndex] – index of the intersected face
+ [page:Array indices] – indices of vertices comprising the intersected face
+ [page:Object3D object] – the intersected object
+
+
+ When intersecting a [page:Mesh] with a [page:BufferGeometry], the *faceIndex* will be *undefined*, and *indices* will be set; when intersecting a [page:Mesh] with a [page:Geometry], *indices* will be *undefined*.
+
+
+ *Raycaster* delegates to the [page:Object3D.raycast raycast] method of the passed object, when evaluating whether the ray intersects the object or not. This allows [page:Mesh meshes] to respond differently to ray casting than [page:Line lines] and [page:PointCloud pointclouds].
+
+
+ *Note* that for meshes, faces must be pointed towards the origin of the [page:.ray 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 the [page:Mesh.material material]'s [page:Material.side side] property to *THREE.DoubleSide*.
+
@@ -83,10 +166,7 @@
[page:Boolean recursive] — If set, it also checks all descendants of the objects. Otherwise it only checks intersecton with the objects.
- checks all intersection between the ray and the objects with or without the descendants. Intersections are returned sorted by distance, closest first.
-
- [ { distance, point, face, faceIndex, object }, ... ]
-
+ Checks all intersection between the ray and the objects with or without the descendants. Intersections are returned sorted by distance, closest first. Intersections are of the same form as those returned by [page:.intersectObject].
+ Get intersections between a casted ray and this Line. [page:Raycaster.intersectObject] will call this method.
+
+
Source
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
diff --git a/docs/api/objects/Mesh.html b/docs/api/objects/Mesh.html
index 9984a97ee74ce0f536af3fe18316e30d531e9c6e..94bdfb2c092d6a186f92f03dd789152f29a1b41d 100644
--- a/docs/api/objects/Mesh.html
+++ b/docs/api/objects/Mesh.html
@@ -60,6 +60,12 @@
Updates the morphtargets to have no influence on the object.
+