r171

mrdoob · Nov 29, 2024 · 2a20741 · 2a20741
1 parent 4bba481
commit 2a20741
Show file tree

Hide file tree

Showing 270 changed files with 80,285 additions and 148,152 deletions.
diff --git a/build/three.cjs b/build/three.cjs
diff --git a/build/three.core.js b/build/three.core.js
diff --git a/build/three.core.min.js b/build/three.core.min.js
diff --git a/build/three.module.js b/build/three.module.js
diff --git a/build/three.module.min.js b/build/three.module.min.js
diff --git a/build/three.tsl.js b/build/three.tsl.js
diff --git a/build/three.tsl.min.js b/build/three.tsl.min.js
diff --git a/build/three.webgpu.js b/build/three.webgpu.js
diff --git a/build/three.webgpu.min.js b/build/three.webgpu.min.js
diff --git a/build/three.webgpu.nodes.js b/build/three.webgpu.nodes.js
diff --git a/build/three.webgpu.nodes.min.js b/build/three.webgpu.nodes.min.js
diff --git a/docs/api/ar/core/Clock.html b/docs/api/ar/core/Clock.html
@@ -8,74 +8,72 @@
 	</head>
 	<body class="rtl">
 		<h1>[name]</h1>
-	 
+
 		<p class="desc">
 		كائن لتتبع الوقت. يستخدم هذا
-		[link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now] إذا كان متاحًا، وإلا فإنه يعود إلى
-		دقة أقل
-		[link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date/now Date.now].
+		[link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now].
 		</p>
-	 
+
 		<h2>المنشئ (Constructor)</h2>
-	 
+
 		<h3>[name]( [param:Boolean autoStart] )</h3>
 		<p>
 		autoStart — (اختياري) ما إذا كان يجب تشغيل الساعة تلقائيًا عندما
 		[page:.getDelta]() يتم استدعاؤه لأول مرة. الافتراضي هو `true`.
 		</p>
-	 
+
 		<h2>الخصائص (Properties)</h2>
-	 
+
 		<h3>[property:Boolean autoStart]</h3>
 		<p>
 		إذا تم تعيينه، يبدأ الساعة تلقائيًا عندما يتم استدعاء [page:.getDelta]()
 		لأول مرة. الافتراضي هو `true`.
 		</p>
-	 
+
 		<h3>[property:Float startTime]</h3>
 		<p>
 		يحمل الوقت الذي تم فيه استدعاء طريقة [page:Clock.start start] للساعة
 		آخر مرة. الافتراضي هو `0`.
 		</p>
-	 
+
 		<h3>[property:Float oldTime]</h3>
 		<p>
 		يحمل الوقت الذي تم فيه استدعاء طرق [page:Clock.start start],
 		[page:.getElapsedTime]() أو [page:.getDelta]() للساعة آخر مرة.
 		الافتراضي هو `0`.
 		</p>
-	 
+
 		<h3>[property:Float elapsedTime]</h3>
 		<p>
 		يتبع المجموع الكلي للوقت الذي كانت تعمل فيه الساعة. الافتراضي هو
 		`0`.
 		</p>
-	 
+
 		<h3>[property:Boolean running]</h3>
 		<p>ما إذا كانت الساعة تعمل أم لا. الافتراضي هو `false`.</p>
-	 
+
 		<h2>الوظائف (Methods)</h2>
-	 
+
 		<h3>[method:undefined start]()</h3>
 		<p>
 		يبدأ الساعة. كما يضبط [page:.startTime] و [page:.oldTime] على
 		الوقت الحالي، ويضبط [page:.elapsedTime] على `0` و [page:.running] على
 		`true`.
 		</p>
-	 
+
 		<h3>[method:undefined stop]()</h3>
 		<p>
 		يوقف الساعة ويضبط [page:Clock.oldTime oldTime] على الوقت الحالي.
 		</p>
-	 
+
 		<h3>[method:Float getElapsedTime]()</h3>
 		<p>
 		احصل على المجموع الكلي للثواني التي مرت منذ بدء تشغيل الساعة وضبط [page:.oldTime] على
 		الوقت الحالي.<br />
 		إذا كان [page:.autoStart] هو `true` والساعة لا تعمل، فإنه يبدأ أيضًا
 		ساعة.
 		</p>
-	 
+
 		<h3>[method:Float getDelta]()</h3>
 		<p>
 		احصل على المجموع الكلي للثواني التي مرت منذ ضبط [page:.oldTime] وضبط

diff --git a/docs/api/en/constants/Renderer.html b/docs/api/en/constants/Renderer.html
@@ -11,8 +11,8 @@ <h1>WebGLRenderer Constants</h1>
 
 		<h2>Cull Face Modes</h2>
 		<code>
-		THREE.CullFaceNone 
-		THREE.CullFaceBack 
+		THREE.CullFaceNone
+		THREE.CullFaceBack
 		THREE.CullFaceFront
 		THREE.CullFaceFrontBack
 		</code>
@@ -25,14 +25,14 @@ <h2>Cull Face Modes</h2>
 
 		<h2>Shadow Types</h2>
 		<code>
-		THREE.BasicShadowMap 
-		THREE.PCFShadowMap 
+		THREE.BasicShadowMap
+		THREE.PCFShadowMap
 		THREE.PCFSoftShadowMap
 		THREE.VSMShadowMap
 		</code>
 		<p>
 			These define the WebGLRenderer's [page:WebGLRenderer.shadowMap.type shadowMap.type] property.<br /><br />
-			[page:constant BasicShadowMap] gives unfiltered shadow maps - fastest, but 
+			[page:constant BasicShadowMap] gives unfiltered shadow maps - fastest, but
 			lowest quality.<br />
 			[page:constant PCFShadowMap] filters shadow maps using the
 			Percentage-Closer Filtering (PCF) algorithm (default).<br />
@@ -44,13 +44,13 @@ <h2>Shadow Types</h2>
 			also cast shadows.
 		</p>
 
-		
+
 		<h2>Tone Mapping</h2>
 		<code>
-		THREE.NoToneMapping 
-		THREE.LinearToneMapping 
+		THREE.NoToneMapping
+		THREE.LinearToneMapping
 		THREE.ReinhardToneMapping
-		THREE.CineonToneMapping 
+		THREE.CineonToneMapping
 		THREE.ACESFilmicToneMapping
 		THREE.AgXToneMapping
 		THREE.NeutralToneMapping
@@ -62,9 +62,9 @@ <h2>Tone Mapping</h2>
 			monitor or mobile device's screen.
 		</p>
 		<p>
-			THREE.LinearToneMapping, THREE.ReinhardToneMapping, THREE.CineonToneMapping, THREE.ACESFilmicToneMapping, 
-			THREE.AgXToneMapping and THREE.NeutralToneMapping are built-inimplementations of tone mapping. 
-			THREE.CustomToneMapping expects a custom implementation by modyfing GLSL code of the material's fragment shader.
+			THREE.LinearToneMapping, THREE.ReinhardToneMapping, THREE.CineonToneMapping, THREE.ACESFilmicToneMapping,
+			THREE.AgXToneMapping and THREE.NeutralToneMapping are built-in implementations of tone mapping.
+			THREE.CustomToneMapping expects a custom implementation by modifying GLSL code of the material's fragment shader.
 			See the [example:webgl_tonemapping WebGL / tonemapping] example.
 		</p>
 		<p>

diff --git a/docs/api/en/core/Clock.html b/docs/api/en/core/Clock.html
@@ -11,9 +11,7 @@ <h1>[name]</h1>
 
 		<p class="desc">
 			Object for keeping track of time. This uses
-			[link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now] if it is available, otherwise it reverts to the less
-			accurate
-			[link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date/now Date.now].
+			[link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now].
 		</p>
 
 		<h2>Constructor</h2>

diff --git a/docs/api/en/objects/BatchedMesh.html b/docs/api/en/objects/BatchedMesh.html
@@ -14,8 +14,8 @@ <h1>[name]</h1>
 		<p class="desc">
 			A special version of [page:Mesh] with multi draw batch rendering support. Use
 			[name] if you have to render a large number of objects with the same
-			material but with different world transformations. The usage of [name] will
-			help you to reduce the number of draw calls and thus improve the overall
+			material but with different geometries or world transformations. The usage of
+			[name] will help you to reduce the number of draw calls and thus improve the overall
 			rendering performance in your application.
 
 			<br/>
@@ -167,7 +167,7 @@ <h3>
 		<p>
 			[page:Integer instanceId]: The id of an instance to get the visibility state of.
 		</p>
-		<p>Get whether the given instance is marked as "visible" or not.</p>		
+		<p>Get whether the given instance is marked as "visible" or not.</p>
 
 		<h3>
 			[method:Object getGeometryRangeAt]( [param:Integer geometryId], [param:Object target] )
@@ -181,7 +181,7 @@ <h3>
 		<p>Get the range representing the subset of triangles related to the attached geometry, indicating the starting offset and count, or `null` if invalid.</p>
 		<p>Return an object of the form:</p>
 		<code>{ start: Integer, count: Integer }</code>
-	
+
 		<h3>
 			[method:Integer getGeometryIdAt]( [param:Integer instanceId] )
 		</h3>
@@ -313,7 +313,7 @@ <h3>
 		</h3>
 		<p>
 			Resizes the available space in [name]'s vertex and index buffer attributes to the provided sizes. If the provided arguments shrink the geometry buffers
-			but there is not enough unused space at the end of the geometry attributes then an error is thrown. 
+			but there is not enough unused space at the end of the geometry attributes then an error is thrown.
 		</p>
 		<p>
 			[page:Integer maxVertexCount] - the max number of vertices to be used by all unique geometries to resize to.<br />

diff --git a/docs/api/en/objects/ClippingGroup.html b/docs/api/en/objects/ClippingGroup.html
@@ -0,0 +1,62 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<base href="../../../" />
+		<script src="page.js"></script>
+		<link type="text/css" rel="stylesheet" href="page.css" />
+	</head>
+	<body>
+		[page:Group] &rarr;
+
+		<h1>[name]</h1>
+
+		<p class="desc">
+			A special version of the Group object that defines clipping planes for decendant objects.
+			ClippingGroups can be nested, with clipping planes accumulating by type: intersection or union.
+		</p>
+
+		<p>Note: ClippingGroup is only supported with WebGPURenderer.</p>
+
+		<h2>Constructor</h2>
+
+		<h3>[name]( )</h3>
+
+		<h2>Properties</h2>
+		<p>See the base [page:Group] class for common properties.</p>
+
+		<h3>[property:Boolean isClippingGroup]</h3>
+		<p>Read-only flag to check if a given object is of type [name].</p>
+
+		<h3>[property:Array clippingPlanes]</h3>
+		<p>
+			User-defined clipping planes specified as THREE.Plane objects in world
+			space. These planes apply to the objects that are children of this ClippingGroup.
+			Points in space whose signed distance to the plane is negative are clipped
+			(not rendered). See the [example:webgpu_clipping webgpu / clipping] example. Default is `[]`.
+		</p>
+
+		<h3>[property:Boolean enabled]</h3>
+		<p>Determines if the clipping planes defined by this object are applied. Default is `true`.</p>
+
+		<h3>[property:Boolean clipIntersection]</h3>
+		<p>
+			Changes the behavior of clipping planes so that only their intersection is
+			clipped, rather than their union. Default is `false`.
+		</p>
+
+		<h3>[property:Boolean clipShadows]</h3>
+		<p>
+			Defines whether to clip shadows according to the clipping planes specified
+			by this ClippingGroup. Default is `false`.
+		</p>
+
+		<h2>Methods</h2>
+		<p>See the base [page:Object3D] class for common methods.</p>
+
+		<h2>Source</h2>
+		<p>
+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+		</p>
+	</body>
+</html>
diff --git a/docs/api/en/renderers/WebGLRenderer.html b/docs/api/en/renderers/WebGLRenderer.html
@@ -201,8 +201,13 @@ <h3>[property:Object extensions]</h3>
 			<li>`WEBGL_compressed_texture_s3tc`</li>
 			<li>`WEBGL_compressed_texture_pvrtc`</li>
 			<li>`WEBGL_compressed_texture_etc1`</li>
+			<li>See more: <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/Using_Extensions#extension_list" target="_blank">Extension list</a></li>
 		</ul>
 
+		<p>
+			- [page:Boolean has]( [param:String extensionName] ): `true` if the extension is supported.
+		</p>
+
 		<h3>[property:string outputColorSpace]</h3>
 		<p>
 			Defines the output color space of the renderer. Default is [page:Textures THREE.SRGBColorSpace].
@@ -380,7 +385,7 @@ <h3>
 		</p>
 
 		<h3>
-			[method:undefined copyTextureToTexture]( [param:Texture srcTexture], [param:Texture dstTexture], [param:Box2 srcRegion] | [param:Box3 srcRegion], [param:Vector2 dstPosition] | [param:Vector3 dstPosition], [param:Number dstLevel] )
+			[method:undefined copyTextureToTexture]( [param:Texture srcTexture], [param:Texture dstTexture], [param:Box2 srcRegion] | [param:Box3 srcRegion], [param:Vector2 dstPosition] | [param:Vector3 dstPosition], [param:Number srcLevel], [param:Number dstLevel] )
 		</h3>
 		<p>
 			Copies the pixels of a texture in the bounds '[page:Box3 srcRegion]' in the destination texture starting from the given position.

diff --git a/docs/api/it/core/Clock.html b/docs/api/it/core/Clock.html
@@ -10,8 +10,7 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-      Oggetto per tenere traccia del tempo. Questa classe utilizza [link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now]
-      se disponibile, altrimenti utilizza il meno accurato [link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date/now Date.now].
+    	  Oggetto per tenere traccia del tempo. Questa classe utilizza [link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now].
 		</p>
 
 		<h2>Costruttore</h2>

diff --git a/docs/api/ko/core/Clock.html b/docs/api/ko/core/Clock.html
@@ -10,7 +10,7 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		시간을 파악하는 객체입니다. [link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now]를 우선적으로 사용하며, 사용이 불가능할 때는 덜 정확한 [link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date/now Date.now]를 사용합니다.
+		시간을 파악하는 객체입니다. [link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now]
 		</p>
 
 

diff --git a/docs/api/zh/core/Clock.html b/docs/api/zh/core/Clock.html
@@ -9,8 +9,7 @@
 	<body>
 		<h1>[name]</h1>
 		<p class="desc">
-			该对象用于跟踪时间。如果[link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now]可用，则
-			Clock 对象通过该方法实现，否则回落到使用略欠精准的[link:https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date/now Date.now]来实现。
+			该对象用于跟踪时间。如果[link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now]。
 		</p>
 
 

diff --git a/docs/api/zh/renderers/WebGLRenderer.html b/docs/api/zh/renderers/WebGLRenderer.html
@@ -141,14 +141,19 @@ <h3>[property:Object extensions]</h3>
 		- [page:Object get]( [param:String extensionName] ):
 			用于检查是否支持各种扩展，并返回一个对象，其中包含扩展的详细信息。
 			该方法检查以下扩展：<br />
+		</p>
 
 		<ul>
 			<li>*WEBGL_depth_texture*</li>
 			<li>*EXT_texture_filter_anisotropic*</li>
 			<li>*WEBGL_compressed_texture_s3tc*</li>
 			<li>*WEBGL_compressed_texture_pvrtc*</li>
 			<li>*WEBGL_compressed_texture_etc1*</li>
+			<li>查看更多：<a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/Using_Extensions#extension_list" target="_blank">Extension list</a></li>
 		</ul>
+
+		<p>
+			- [page:Boolean has]( [param:String extensionName] ): 如果支持该扩展则返回 `true`。
 		</p>
 
 		<h3>[property:string outputColorSpace]</h3>

diff --git a/docs/examples/en/controls/ArcballControls.html b/docs/examples/en/controls/ArcballControls.html
@@ -132,6 +132,11 @@ <h3>[property:Boolean enableAnimations]</h3>
 			Set to true to enable animations for rotation (damping) and focus operation. Default is true.
 		</p>
 
+		<h3>[property:Boolean enableFocus]</h3>
+		<p>
+			Enable or disable camera focusing on double-tap (or click) operations. Default is true.
+		</p>
+
 		<h3>[property:Boolean enableGrid]</h3>
 		<p>
 			When set to true, a grid will appear when panning operation is being performed (desktop interaction only). Default is false.

diff --git a/docs/examples/en/exporters/GLTFExporter.html b/docs/examples/en/exporters/GLTFExporter.html
@@ -52,6 +52,8 @@ <h2>Extensions</h2>
 			<li>KHR_materials_volume</li>
 			<li>KHR_mesh_quantization</li>
 			<li>KHR_texture_transform</li>
+			<li>EXT_materials_bump</li>
+			<li>EXT_mesh_gpu_instancing</li>
 		</ul>
 
 		<p>

diff --git a/docs/examples/en/lines/LineGeometry.html b/docs/examples/en/lines/LineGeometry.html
@@ -75,6 +75,12 @@ <h3>[method:this setPositions]( [param:Array array] )</h3>
 			The length must be a multiple of three.
 		</p>
 
+		<h3>[method:this setFromPoints]( [param:Array points] )</h3>
+		<p>
+			Replace the vertex positions with an array of points.
+			Can be either a `Vector3` or `Vector2` array.
+		</p>
+
 		<h2>Source</h2>
 
 		<p>

diff --git a/docs/examples/en/loaders/MMDLoader.html b/docs/examples/en/loaders/MMDLoader.html
@@ -44,7 +44,7 @@ <h2>Code Example</h2>
 				scene.add( mesh );
 
 			},
-			// called when loading is in progresses
+			// called when loading is in progress
 			function ( xhr ) {
 
 				console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );

diff --git a/docs/examples/en/loaders/OBJLoader.html b/docs/examples/en/loaders/OBJLoader.html
@@ -45,7 +45,7 @@ <h2>Code Example</h2>
 				scene.add( object );
 
 			},
-			// called when loading is in progresses
+			// called when loading is in progress
 			function ( xhr ) {
 
 				console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );

diff --git a/docs/examples/en/loaders/PCDLoader.html b/docs/examples/en/loaders/PCDLoader.html
@@ -50,7 +50,7 @@ <h2>Code Example</h2>
 				scene.add( points );
 
 			},
-			// called when loading is in progresses
+			// called when loading is in progress
 			function ( xhr ) {
 
 				console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );