Merge pull request #21164 from Mugen87/dev51

Face3: Remove from core.

Author: mrdoob

docs/api/en/core/Face3.html

@@ -172,7 +172,7 @@ <h3>[method:Array intersectObject]( [param:Object3D object], [param:Boolean recu
 		<p>
 			[page:Float distance] – distance between the origin of the ray and the intersection<br />
 			[page:Vector3 point] – point of intersection, in world coordinates<br />
-			[page:Face3 face] – intersected face<br />
+			[page:Object face] – intersected face<br />
 			[page:Integer faceIndex] – index of the intersected face<br />
 			[page:Object3D object] – the intersected object<br />
 			[page:Vector2 uv] - U,V coordinates at point of intersection<br />

docs/api/en/core/Raycaster.html

@@ -175,7 +175,7 @@ <h3>[method:Array intersectObject]( [param:Object3D object], [param:Boolean recu
 		<p>
 			[page:Float distance] —— 射线投射原点和相交部分之间的距离。<br />
 			[page:Vector3 point] —— 相交部分的点（世界坐标）<br />
-			[page:Face3 face] —— 相交的面<br />
+			[page:Object face] —— 相交的面<br />
 			[page:Integer faceIndex] —— 相交的面的索引<br />
 			[page:Object3D object] —— 相交的物体<br />
 			[page:Vector2 uv] —— 相交部分的点的UV坐标。<br />

docs/api/zh/core/Face3.html

@@ -87,7 +87,6 @@
 				"BufferGeometry": "api/en/core/BufferGeometry",
 				"Clock": "api/en/core/Clock",
 				"EventDispatcher": "api/en/core/EventDispatcher",
-				"Face3": "api/en/core/Face3",
 				"GLBufferAttribute": "api/en/core/GLBufferAttribute",
 				"InstancedBufferAttribute": "api/en/core/InstancedBufferAttribute",
 				"InstancedBufferGeometry": "api/en/core/InstancedBufferGeometry",
@@ -599,7 +598,6 @@
 				"BufferGeometry": "api/zh/core/BufferGeometry",
 				"Clock": "api/zh/core/Clock",
 				"EventDispatcher": "api/zh/core/EventDispatcher",
-				"Face3": "api/zh/core/Face3",
 				"GLBufferAttribute": "api/zh/core/GLBufferAttribute",
 				"InstancedBufferAttribute": "api/zh/core/InstancedBufferAttribute",
 				"InstancedBufferGeometry": "api/zh/core/InstancedBufferGeometry",

docs/api/zh/core/Raycaster.html

@@ -1,7 +1,6 @@
 import {
 	Vector3,
 	Color,
-	Face3,
 	Vector2,
 	Vector4,
 	Box3,
@@ -17,7 +16,7 @@ import {
 } from '../../../src/Three';
 
 /**
- * @deprecated Use {@link Face3} instead.
+ * @deprecated Use Face3 instead.
  */
 
 export interface MorphTarget {
@@ -37,8 +36,6 @@ export interface MorphNormals {
 
 /**
  * Base class for geometries
- *
- * see {@link https://github.com/mrdoob/three.js/blob/master/src/core/Geometry.js|src/core/Geometry.js}
  */
 export class Geometry extends EventDispatcher {
 
@@ -279,3 +276,99 @@ export class Geometry extends EventDispatcher {
 	animations: AnimationClip[];
 
 }
+
+/**
+ * Triangle face.
+ */
+export class Face3 {
+
+	/**
+	 * @param a Vertex A index.
+	 * @param b Vertex B index.
+	 * @param c Vertex C index.
+	 * @param normal Face normal or array of vertex normals.
+	 * @param color Face color or array of vertex colors.
+	 * @param materialIndex Material index.
+	 */
+	constructor(
+		a: number,
+		b: number,
+		c: number,
+		normal?: Vector3,
+		color?: Color,
+		materialIndex?: number
+	);
+	constructor(
+		a: number,
+		b: number,
+		c: number,
+		normal?: Vector3,
+		vertexColors?: Color[],
+		materialIndex?: number
+	);
+	constructor(
+		a: number,
+		b: number,
+		c: number,
+		vertexNormals?: Vector3[],
+		color?: Color,
+		materialIndex?: number
+	);
+	constructor(
+		a: number,
+		b: number,
+		c: number,
+		vertexNormals?: Vector3[],
+		vertexColors?: Color[],
+		materialIndex?: number
+	);
+
+	/**
+	 * Vertex A index.
+	 */
+	a: number;
+
+	/**
+	 * Vertex B index.
+	 */
+	b: number;
+
+	/**
+	 * Vertex C index.
+	 */
+	c: number;
+
+	/**
+	 * Face normal.
+	 * @default new THREE.Vector3()
+	 */
+	normal: Vector3;
+
+	/**
+	 * Array of 3 vertex normals.
+	 * @default []
+	 */
+	vertexNormals: Vector3[];
+
+	/**
+	 * Face color.
+	 * @default new THREE.Color()
+	 */
+	color: Color;
+
+	/**
+	 * Array of 3 vertex colors.
+	 * @default []
+	 */
+	vertexColors: Color[];
+
+	/**
+	 * Material index (points to {@link Mesh.material}).
+	 * @default 0
+	 */
+	materialIndex: number;
+
+	clone(): Face3;
+	copy( source: Face3 ): this;
+
+}