THREE.TextGeometry: .height -> .depth (#27949)

* THREE.TextGeometry: `.height` -> `.depth`

- depreciating `height` parameter in TextGeometry options for `depth`
  for consistency with ExtrudeGeometry, which refers to the thickness
  the Text will be extruded. using `height` is still supported but
  will emit a warning in the console
- updated examples, manual and docs

* missed one reference

Author: zz85

docs/examples/en/geometries/TextGeometry.html

@@ -38,7 +38,7 @@ <h2>Code Example</h2>
 			const geometry = new TextGeometry( 'Hello three.js!', {
 				font: font,
 				size: 80,
-				height: 5,
+				depth: 5,
 				curveSegments: 12,
 				bevelEnabled: true,
 				bevelThickness: 10,
@@ -64,7 +64,7 @@ <h3>[name]([param:String text], [param:Object parameters])</h3>
 		<ul>
 			<li>font — an instance of THREE.Font.</li>
 			<li>size — Float. Size of the text. Default is 100.</li>
-			<li>height — Float. Thickness to extrude text.  Default is 50.</li>
+			<li>depth — Float. Thickness to extrude text.  Default is 50.</li>
 			<li>curveSegments — Integer. Number of points on the curves. Default is 12.</li>
 			<li>bevelEnabled — Boolean. Turn on bevel. Default is False.</li>
 			<li>bevelThickness — Float. How deep into text bevel goes. Default is 10.</li>

docs/examples/zh/geometries/TextGeometry.html

@@ -38,7 +38,7 @@ <h2>代码示例</h2>
 			const geometry = new TextGeometry( 'Hello three.js!', {
 				font: font,
 				size: 80,
-				height: 5,
+				depth: 5,
 				curveSegments: 12,
 				bevelEnabled: true,
 				bevelThickness: 10,
@@ -63,7 +63,7 @@ <h3>[name]([param:String text], [param:Object parameters])</h3>
 		<ul>
 			<li>font — THREE.Font的实例。</li>
 			<li>size — Float。字体大小，默认值为100。</li>
-			<li>height — Float。挤出文本的厚度。默认值为50。</li>
+			<li>depth — Float。挤出文本的厚度。默认值为50。</li>
 			<li>curveSegments — Integer。（表示文本的）曲线上点的数量。默认值为12。</li>
 			<li>bevelEnabled — Boolean。是否开启斜角，默认为false。</li>
 			<li>bevelThickness — Float。文本上斜角的深度，默认值为20。</li>

examples/jsm/geometries/TextGeometry.js

@@ -5,7 +5,7 @@
  *  font: <THREE.Font>, // font
  *
  *  size: <float>, // size of the text
- *  height: <float>, // thickness to extrude text
+ *  depth: <float>, // thickness to extrude text
  *  curveSegments: <int>, // number of points on the curves
  *
  *  bevelEnabled: <bool>, // turn on bevel
@@ -35,7 +35,15 @@ class TextGeometry extends ExtrudeGeometry {
 
 			// translate parameters to ExtrudeGeometry API
 
-			parameters.depth = parameters.height !== undefined ? parameters.height : 50;
+			if ( parameters.depth === undefined && parameters.height !== undefined ) {
+
+				console.warn( 'THREE.TextGeometry: .height is now depreciated. Please use .depth instead' ); // @deprecated, r163
+
+			}
+
+			parameters.depth = parameters.depth !== undefined ?
+				parameters.depth : parameters.height !== undefined ?
+					parameters.height : 50;
 
 			// defaults
 

examples/webgl_camera_logarithmicdepthbuffer.html

@@ -189,7 +189,7 @@
 					const labelgeo = new TextGeometry( labeldata[ i ].label, {
 						font: font,
 						size: labeldata[ i ].size,
-						height: labeldata[ i ].size / 2
+						depth: labeldata[ i ].size / 2
 					} );
 
 					labelgeo.computeBoundingSphere();

examples/webgl_custom_attributes_lines.html

@@ -110,7 +110,7 @@
 					font: font,
 
 					size: 50,
-					height: 15,
+					depth: 15,
 					curveSegments: 10,
 
 					bevelThickness: 5,

examples/webgl_geometry_text.html

@@ -50,7 +50,7 @@
 				fontName = 'optimer', // helvetiker, optimer, gentilis, droid sans, droid serif
 				fontWeight = 'bold'; // normal bold
 
-			const height = 20,
+			const depth = 20,
 				size = 70,
 				hover = 30,
 
@@ -298,7 +298,7 @@
 					font: font,
 
 					size: size,
-					height: height,
+					depth: depth,
 					curveSegments: curveSegments,
 
 					bevelThickness: bevelThickness,
@@ -328,7 +328,7 @@
 
 					textMesh2.position.x = centerOffset;
 					textMesh2.position.y = - hover;
-					textMesh2.position.z = height;
+					textMesh2.position.z = depth;
 
 					textMesh2.rotation.x = Math.PI;
 					textMesh2.rotation.y = Math.PI * 2;

examples/webgl_loader_ttf.html

@@ -35,7 +35,7 @@
 			let firstLetter = true;
 
 			let text = 'three.js';
-			const height = 20,
+			const depth = 20,
 				size = 70,
 				hover = 30,
 				curveSegments = 4,
@@ -193,7 +193,7 @@
 					font: font,
 
 					size: size,
-					height: height,
+					depth: depth,
 					curveSegments: curveSegments,
 
 					bevelThickness: bevelThickness,
@@ -224,7 +224,7 @@
 
 					textMesh2.position.x = centerOffset;
 					textMesh2.position.y = - hover;
-					textMesh2.position.z = height;
+					textMesh2.position.z = depth;
 
 					textMesh2.rotation.x = Math.PI;
 					textMesh2.rotation.y = Math.PI * 2;

examples/webgl_materials_toon.html

@@ -119,7 +119,7 @@
 						font: font,
 
 						size: 20,
-						height: 1,
+						depth: 1,
 						curveSegments: 1
 
 					} );

examples/webgl_modifier_curve.html

@@ -110,7 +110,7 @@
 					const geometry = new TextGeometry( 'Hello three.js!', {
 						font: font,
 						size: 0.2,
-						height: 0.05,
+						depth: 0.05,
 						curveSegments: 12,
 						bevelEnabled: true,
 						bevelThickness: 0.02,

examples/webgl_modifier_curve_instanced.html

@@ -123,7 +123,7 @@
 					const geometry = new TextGeometry( 'Hello three.js!', {
 						font: font,
 						size: 0.2,
-						height: 0.05,
+						depth: 0.05,
 						curveSegments: 12,
 						bevelEnabled: true,
 						bevelThickness: 0.02,