Browse Source

Docs: Enhance FAQ with input validation question. (#24116)

* Docs: Enhance FAQ with input validation question.

* Docs: Fix typo.
Michael Herzog 3 years ago
parent
commit
a6ff6c6bde

+ 5 - 0
docs/manual/ar/introduction/FAQ.html

@@ -52,5 +52,10 @@ visible_height = 2 * Math.tan( ( Math.PI / 180 ) * camera.fov / 2 ) * distance_f
 
 			<code>material.side = THREE.DoubleSide</code>
 		</p>
+
+		<h2>Why does three.js sometimes return strange results for invalid inputs?</h2>
+		<p>
+			For performance reasons, three.js doesn't validate inputs in most cases. It's your app's responsibility to make sure that all inputs are valid.
+		</p>
 	</body>
 </html>

+ 5 - 0
docs/manual/en/introduction/FAQ.html

@@ -51,5 +51,10 @@ visible_height = 2 * Math.tan( ( Math.PI / 180 ) * camera.fov / 2 ) * distance_f
 			This could be because of face culling. Faces have an orientation that decides which side is which. And the culling removes the backside in normal circumstances. To see if this is your problem, change the material side to THREE.DoubleSide.
 			<code>material.side = THREE.DoubleSide</code>
 		</p>
+
+		<h2>Why does three.js sometimes return strange results for invalid inputs?</h2>
+		<p>
+			For performance reasons, three.js doesn't validate inputs in most cases. It's your app's responsibility to make sure that all inputs are valid.
+		</p>
 	</body>
 </html>

+ 6 - 1
docs/manual/ja/introduction/FAQ.html

@@ -54,6 +54,11 @@ visible_height = 2 * Math.tan( ( Math.PI / 180 ) * camera.fov / 2 ) * distance_f
         これはface cullingが原因かもしれません。Faceにはどちらの面かを決める向きがあります。 そして、cullingは通常の状況では裏面を削除します。 これが問題となって非表示になっているかどうかを確認するには、 マテリアルの面をTHREE.DoubleSideに変更してください。
         <code>material.side = THREE.DoubleSide</code>
     </p>
+
+		<h2>Why does three.js sometimes return strange results for invalid inputs?</h2>
+		<p>
+			For performance reasons, three.js doesn't validate inputs in most cases. It's your app's responsibility to make sure that all inputs are valid.
+		</p>
 </body>
 
-</html>
+</html>

+ 6 - 1
docs/manual/ko/introduction/FAQ.html

@@ -50,5 +50,10 @@ visible_height = 2 * Math.tan( ( Math.PI / 180 ) * camera.fov / 2 ) * distance_f
 			이는 페이스 컬링 문제일 수 있습니다. 각 면들은 어느 방향이 어느 방향인지에 대한 정보를 가지고 있습니다. 그리고 컬링은 일반적으로 뒷편의 면을 제거해 버립니다. 이 문제가 의심된다면 재질의 면을 THREE.DoubleSide로 변경해 보세요.
 			<code>material.side = THREE.DoubleSide</code>
 		</p>
+
+		<h2>Why does three.js sometimes return strange results for invalid inputs?</h2>
+		<p>
+			For performance reasons, three.js doesn't validate inputs in most cases. It's your app's responsibility to make sure that all inputs are valid.
+		</p>
 	</body>
-</html>
+</html>

+ 5 - 0
docs/manual/zh/introduction/FAQ.html

@@ -49,5 +49,10 @@ visible_height = 2 * Math.tan( ( Math.PI / 180 ) * camera.fov / 2 ) * distance_f
 			在正常情况下,渲染时会将背面进行剔除。要查看这是不是你所遇到的问题,请将material的side更改为THREE.DoubleSide。
 			<code>material.side = THREE.DoubleSide</code>
 		</p>
+
+		<h2>Why does three.js sometimes return strange results for invalid inputs?</h2>
+		<p>
+			For performance reasons, three.js doesn't validate inputs in most cases. It's your app's responsibility to make sure that all inputs are valid.
+		</p>
 	</body>
 </html>