فهرست منبع

Docs: Improve `OrbitControls` page. (#26541)

* Docs: Improve `OrbitControls` page.

* Examples: Update screenshot.

* E2E: Add webgl2_volume_instancing to exception list.
Michael Herzog 2 سال پیش
والد
کامیت
6774f1e4aa

+ 4 - 3
docs/examples/en/controls/OrbitControls.html

@@ -91,7 +91,7 @@
 		<h3>[property:Boolean autoRotate]</h3>
 		<p>
 			Set to true to automatically rotate around the target.<br> Note that if this is enabled, you must call [page:.update]
-			() in your animation loop.
+			() in your animation loop. If you want the animation to be frame rate independent, apply a time delta value to [page:.update]().
 		</p>
 
 		<h3>[property:Float autoRotateSpeed]</h3>
@@ -320,10 +320,11 @@ controls.touches = {
 			Removes the key event listener previously defined with [page:.listenToKeyEvents]().
 		</p>
 
-		<h3>[method:Boolean update] ()</h3>
+		<h3>[method:Boolean update] ( [param:Number deltaTime] )</h3>
 		<p>
 			Update the controls. Must be called after any manual changes to the camera's transform,
-			or in the update loop if [page:.autoRotate] or [page:.enableDamping] are set.
+			or in the update loop if [page:.autoRotate] or [page:.enableDamping] are set. `deltaTime` is optional
+			and only required if you want [page:.autoRotate] to be frame rate independent.
 		</p>
 
 		<h2>Source</h2>

+ 3 - 2
docs/examples/ko/controls/OrbitControls.html

@@ -91,7 +91,7 @@
 		<h3>[property:Boolean autoRotate]</h3>
 		<p>
 			대상 주위를 자동으로 회전하려면 true로 설정합니다.<br> autoRotate를 활성할 경우, 애니메이션 루프에서 [page:.update()]를 호출해야 합니다.
-
+			If you want the animation to be frame rate independent, apply a time delta value to [page:.update]().
 		</p>
 
 		<h3>[property:Float autoRotateSpeed]</h3>
@@ -317,9 +317,10 @@ controls.touches = {
 			Removes the key event listener previously defined with [page:.listenToKeyEvents]().
 		</p>
 
-		<h3>[method:Boolean update] ()</h3>
+		<h3>[method:Boolean update] (  [param:Number deltaTime]  )</h3>
 		<p>
 			컨트롤을 업데이트합니다. 카메라를 수동으로 변환하거나, [page:.autoRotate] 또는 [page:.enableDamping]을 설정할 경우 업데이트 루프에서 호출해야 합니다.
+			`deltaTime` is optional and only required if you want [page:.autoRotate] to be frame rate independent.
 		</p>
 
 		<h2>Source</h2>

+ 3 - 1
docs/examples/zh/controls/OrbitControls.html

@@ -93,6 +93,7 @@
 		<p>
 			将其设为true,以自动围绕目标旋转。<br>
 			请注意,如果它被启用,你必须在你的动画循环里调用[page:.update]()。
+			If you want the animation to be frame rate independent, apply a time delta value to [page:.update]().
 		</p>
 
 		<h3>[property:Float autoRotateSpeed]</h3>
@@ -319,10 +320,11 @@ controls.touches = {
 			Removes the key event listener previously defined with [page:.listenToKeyEvents]().
 		</p>
 
-		<h3>[method:Boolean update] ()</h3>
+		<h3>[method:Boolean update] ( [param:Number deltaTime] )</h3>
 		<p>
 			更新控制器。必须在摄像机的变换发生任何手动改变后调用,
 			或如果[page:.autoRotate]或[page:.enableDamping]被设置时,在update循环里调用。
+			`deltaTime` is optional and only required if you want [page:.autoRotate] to be frame rate independent.
 		</p>
 
 		<h2>源代码</h2>

BIN
examples/screenshots/webgl2_volume_instancing.jpg


+ 1 - 0
test/e2e/puppeteer.js

@@ -98,6 +98,7 @@ const exceptionList = [
 	'webgl_shadowmap_progressive',
 	'webgl_test_memory2',
 	'webgl_tiled_forward',
+	'webgl2_volume_instancing',
 
 	// TODO: implement determinism for setTimeout and setInterval
 	// could it fix some examples from above?