4 năm trước cách đây · b555aa5d43
--- a/.github/ISSUE_TEMPLATE.md
+++ b/.github/ISSUE_TEMPLATE.md
@@ -17,7 +17,7 @@ Please also include a live example if possible. You can start from these templat
 
				 ##### Three.js version
			
 
				 
			
 
				 - [ ] Dev
			
 
				-- [ ] r119
			
 
				+- [ ] r120
			
 
				 - [ ] ...
			
 
				 
			
 
				 ##### Browser
			
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ The aim of the project is to create an easy to use, lightweight, 3D library with
 
				 This code creates a scene, a camera, and a geometric cube, and it adds the cube to the scene. It then creates a `WebGL` renderer for the scene and camera, and it adds that viewport to the `document.body` element. Finally, it animates the cube within the scene for the camera.
			
 
				 
			
 
				 ```javascript
			
 
				-import * as THREE from 'js/three.module.js';
			
 
				+import * as THREE from './js/three.module.js';
			
 
				 
			
 
				 var camera, scene, renderer;
			
 
				 var geometry, material, mesh;
			
--- a/build/three.js
+++ b/build/three.js
--- a/build/three.min.js
+++ b/build/three.min.js
--- a/build/three.module.js
+++ b/build/three.module.js
--- a/docs/api/ar/animation/AnimationObjectGroup.html
+++ b/docs/api/ar/animation/AnimationObjectGroup.html
@@ -0,0 +1,83 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">مجموعة من الكائنات التي تتلقى حالة حركة مشتركة.<br /><br />
			
 
				+
			
 
				+			للحصول على نظرة عامة حول العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>الإستعمال:</h2>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			تظيف كائنات يمكن تمريرها عبر المنشئ كـ'جذر' أو عبر وظيفة [page:AnimationMixer.clipAction clipAction] الخاصة بـ [page:AnimationMixer AnimationMixer] أو بدلا من دلك عبر تمرير هدا الكائن الأخير كـ'جذر'.<br /><br />
			
 
				+
			
 
				+
			
 
				+			لاحظ أن كائنات هذه الفئة تظهر ككائن واحد للخالط ، لذا يجب التحكم في ذاكرة التخزين المؤقت للكائنات الفردية على المجموعة.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>التقييدات (Limitations)</h2>
			
 
				+		<p class="desc">
			
 
				+			يجب أن تكون الخصائص المتحركة متوافقة مع جميع الكائنات في المجموعة.<br /><br />
			
 
				+
			
 
				+			يمكن التحكم في خاصية واحدة إما من خلال مجموعة مستهدفة أو بشكل مباشر ، ولكن ليس كلاهما.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+		<h3>[name]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
			
 
				+		<p>
			
 
				+			[page:object obj] - عدد عشوائي من الشبكات التي تشترك في نفس حالة الحركة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[property:object stats]</h3>
			
 
				+		<p>
			
 
				+			كائن يحتوي على بعض المعلومات حول *AnimationObjectGroup* (العدد الإجمالي ، العدد المستخدم ، عدد الروابط لكل كائن)
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:String uuid]</h3>
			
 
				+		<p>
			
 
				+			[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] الخاص بهذا *AnimationObjectGroup*. يتم تعيينه تلقائيًا ولا يجب تحريره.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[method:null add]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
			
 
				+		<p>
			
 
				+			يضيف عددًا عشوائيًا من الكائنات إلى *AnimationObjectGroup*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null remove]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
			
 
				+		<p>
			
 
				+			يزيل عددًا عشوائيًا من الكائنات من *AnimationObjectGroup*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null uncache]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
			
 
				+		<p>
			
 
				+			إلغاء تخصيص كافة موارد الذاكرة للكائنات التي تم تمريرها من *AnimationObjectGroup*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/AnimationUtils.html
+++ b/docs/api/ar/animation/AnimationUtils.html
@@ -0,0 +1,63 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+		كائن مع وظائف مختلفة للمساعدة في الرسوم المتحركة ، ويستخدم داخليًا.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[method:Array arraySlice]( array, from, to )</h3>
			
 
				+		<p>
			
 
				+		نفسه عمل Array.prototype.slice ، ولكنه يعمل أيضًا على المصفوفات المكتوبة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Array convertArray]( array, type, forceClone )</h3>
			
 
				+		<p>
			
 
				+		يحول مصفوفة إلى نوع معين.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Array flattenJSON]( jsonKeys, times, values, valuePropertyName  )</h3>
			
 
				+		<p>
			
 
				+		تستخدم لتحليل تنسيقات AOS keyframe.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Array getKeyframeOrder]( times )</h3>
			
 
				+		<p>
			
 
				+		تُرجع مصفوفة يمكن من خلالها فرز الأوقات والقيم.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Boolean isTypedArray]( object )</h3>
			
 
				+		<p>
			
 
				+		ترجاع *true* إذا كان الكائن مصفوفة مكتوبة (typed array.).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Array sortedArray]( values, stride, order )</h3>
			
 
				+		<p>
			
 
				+		يفرز المصفوفة التي تم إرجاعها مسبقًا بناءا [page:AnimationUtils.getKeyframeOrder getKeyframeOrder].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:AnimationClip subclip]( [param:AnimationClip clip], [param:String name], [param:Number startFrame], [param:Number endFrame], [param:Number fps] )</h3>
			
 
				+		<p>
			
 
				+		ينشئ مقطعًا جديدًا ، يحتوي فقط على جزء من المقطع الأصلي بين الإطارات المحددة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/KeyframeTrack.html
+++ b/docs/api/ar/animation/KeyframeTrack.html
@@ -0,0 +1,227 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			إن [link:https://en.wikipedia.org/wiki/Key_frame keyframes] عبارة عن سلسلة زمنية من الإطارات الرئيسية ، والتي تتكون من قوائم بالأوقات والقيم ذات الصلة ، والتي تُستخدم لتحريك خاصية معينة لكائن.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			للحصول على نظرة عامة على العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع ملف
			
 
				+			مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			على النقيض من التسلسل الهرمي للرسوم المتحركة لتنسيق نموذج [link:https://github.com/mrdoob/three.js/wiki/JSON-Model-format-3 JSON model format] ، فإن *KeyframeTrack* لا يخزن إطارات المفاتيح الفردية الخاصة به ككائنات في مصفوفة "keys" (مع الاحتفاظ بالأوقات والقيم لكل إطار معًا في مكان واحد).
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			بدلاً من ذلك ، هناك دائمًا صفيفتان في *KeyframeTrack*: تقوم المصفوفة [page:.times times] بتخزين قيم الوقت لجميع الإطارات الرئيسية لهذا المسار بترتيب تسلسلي ، وتحتوي المصفوفة [page:.values values] على القيم المتغيرة المقابلة للخاصية المتحركة.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			لا يمكن أن تكون القيمة المفردة ، التي تنتمي إلى نقطة زمنية معينة ، رقمًا بسيطًا فحسب ، بل يمكن (على سبيل المثال) أن تكون *vector* (إذا كان الموضع متحركًا) أو رباعي (إذا كان الدوران متحركًا). لهذا السبب ، قد تكون مصفوفة القيم (وهي مصفوفة مسطحة أيضًا) ثلاثة أو أربعة أضعاف طول مصفوفة الأوقات.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			بالمقابلة مع الأنواع المختلفة الممكنة للقيم المتحركة ، توجد عدة فئات فرعية من *KeyframeTrack* ، ترث معظم الخصائص والطرق:
			
 
				+		</p>
			
 
				+
			
 
				+		<ul>
			
 
				+			<li>[page:BooleanKeyframeTrack]</li>
			
 
				+			<li>[page:ColorKeyframeTrack]</li>
			
 
				+			<li>[page:NumberKeyframeTrack]</li>
			
 
				+			<li>[page:QuaternionKeyframeTrack]</li>
			
 
				+			<li>[page:StringKeyframeTrack]</li>
			
 
				+			<li>[page:VectorKeyframeTrack]</li>
			
 
				+		</ul>
			
 
				+
			
 
				+		<p>
			
 
				+			يمكن العثور على بعض الأمثلة حول كيفية إنشاء [page:AnimationClip AnimationClips] يدويًا بأنواع مختلفة من KeyframeTracks في ملف [link:https://threejs.org/examples/jsm/animation/AnimationClipCreator.js AnimationClipCreator].
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			نظرًا لأن القيم الصريحة محددة فقط لنقاط الوقت المنفصلة المخزنة في مصفوفة الأوقات ، يجب استيفاء جميع القيم الموجودة بينهما.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			يعد اسم المسار مهمًا لربط هذا المسار بخاصية معينة للعقدة المتحركة (تم إجراؤه بواسطة [page:PropertyBinding]).
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:String name], [param:Array times], [param:Array values], [param:Constant interpolation] )</h3>
			
 
				+		<p>
			
 
				+			[page:String name] - معرّف *KeyframeTrack*.<br />
			
 
				+			[page:Array times] - مصفوفة من مرات الإطار الرئيسي ، يتم تحويلها داخليًا إلى ملف
			
 
				+			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array].<br />
			
 
				+			[page:Array values] - مصفوفة بالقيم المتعلقة بمصفوفة الأوقات ، يتم تحويلها داخليًا إلى
			
 
				+			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array].<br />
			
 
				+			[page:Constant interpolation] - نوع الاستيفاء المطلوب استخدامه. أنظر
			
 
				+			[page:Animation Animation Constants] للقيم الممكنة. القيمة الافتراضية هي [page:Animation InterpolateLinear].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[property:String name]</h3>
			
 
				+		<p>
			
 
				+			يمكن أن يشير اسم المسار إلى [page:Geometry.morphTargets morph targets] أو [page:SkinnedMesh bones] أو ربما إلى قيم أخرى داخل كائن متحرك. راجع [page:PropertyBinding.parseTrackName] للتعرف على أشكال السلاسل التي يمكن تحليلها لربط الخاصية:
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			يمكن أن يحدد الاسم العقدة إما باستخدام اسمها أو uuid الخاص بها (على الرغم من أنها تحتاج إلى أن تكون في الشجرة الفرعية لعقدة الرسم البياني للمشهد التي تم تمريرها إلى جهاز المزج). أو ، إذا كان اسم المسار يبدأ بنقطة ، فإن المسار ينطبق على عقدة الجذر التي تم تمريرها إلى الخالط.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			عادة ، بعد العقدة ، سيتم تحديد خاصية مباشرة. ولكن يمكنك أيضًا تحديد خاصية فرعية ، مثل. rotation[x] ، إذا كنت تريد فقط قيادة المكون X للدوران عبر مسار عائم.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			يمكنك أيضًا تحديد العظام أو المواد المتعددة باستخدام اسم كائن ، على سبيل المثال: .bones[R_hand].scale; القناة الحمراء للون المنتشر للمادة الرابعة في مصفوفة المواد - كمثال آخر - يمكن الوصول إليها من خلال .bones[R_hand].scale;.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			ستعمل خاصية PropertyBinding أيضًا على حل أسماء أهداف التحويل ، على سبيل المثال: .morphTargetInfluences[run].
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			ملاحظة: ليس بالضرورة أن يكون اسم المسار فريدًا. يمكن أن تقود مسارات متعددة نفس الممتلكات. يجب أن تستند النتيجة إلى مزيج مرجح بين المسارات المتعددة وفقًا لأوزان الإجراءات الخاصة بكل منها.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Float32Array times]</h3>
			
 
				+		<p>
			
 
				+			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array] تم تحويله من مصفوفة الأوقات التي تم تمريرها في المنشئ.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Float32Array values]</h3>
			
 
				+		<p>
			
 
				+			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array] تم تمحوله من صفيف القيم الذي تم تمريره في المنشئ.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Constant DefaultInterpolation]</h3>
			
 
				+		<p>
			
 
				+			نوع الاستيفاء (interpolation) الافتراضي: [page:Animation InterpolateLinear].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Constant TimeBufferType ]</h3>
			
 
				+		<p>
			
 
				+			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array],
			
 
				+			نوع المخزن المؤقت المستخدم داخليا للأوقات.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Constant ValueBufferType ]</h3>
			
 
				+		<p>
			
 
				+			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array],
			
 
				+			نوع المخزن المؤقت المستخدم داخليًا للقيم.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[method:KeyframeTrack clone]()</h3>
			
 
				+		<p>
			
 
				+			ترجع نسخة من هذا المسار.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null createInterpolant]()</h3>
			
 
				+		<p>
			
 
				+			ينشئ [page:LinearInterpolant LinearInterpolant] أو [page:CubicInterpolant CubicInterpolant] أو [page:DiscreteInterpolant DiscreteInterpolant] ، اعتمادًا على قيمة معلمة الاستيفاء التي تم تمريرها في الباني.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null getInterpolation]()</h3>
			
 
				+		<p>
			
 
				+			إرجاع نوع الاستيفاء (interpolation).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Number getValueSize]()</h3>
			
 
				+		<p>
			
 
				+			ترجع حجم كل قيمة (طول صفيف القيم [page:.values values] مقسومًا على طول صفيف الأوقات [page:.times times]).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:DiscreteInterpolant InterpolantFactoryMethodDiscrete]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
			
 
				+		<p>
			
 
				+			ينشئ [page:DiscreteInterpolant DiscreteInterpolant] جديدًا من [page:KeyframeTrack.times times] و [page:KeyframeTrack.times values]. يمكن تمرير Float32Array الذي سيحصل على النتائج. وإلا فسيتم إنشاء مصفوفة جديدة بالحجم المناسب تلقائيًا.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null InterpolantFactoryMethodLinear]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
			
 
				+		<p>
			
 
				+			ينشئ [page:LinearInterpolant LinearInterpolant] جديدًا من page:KeyframeTrack.times times] و [page:KeyframeTrack.times values]. يمكن تمرير Float32Array الذي سيتلقى النتائج. وإلا فسيتم إنشاء مصفوفة جديدة بالحجم المناسب تلقائيًا.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null InterpolantFactoryMethodSmooth]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
			
 
				+		<p>
			
 
				+			قم بإنشاء [page:CubicInterpolant CubicInterpolant] جديد من [page:KeyframeTrack.times times] و [page:KeyframeTrack.times values]. يمكن تمرير Float32Array الذي سيحصل على النتائج. وإلا فسيتم إنشاء مصفوفة جديدة بالحجم المناسب تلقائيًا.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:this optimize]()</h3>
			
 
				+		<p>
			
 
				+			يزيل المفاتيح المتسلسلة المكافئة الشائعة في تسلسلات الهدف التحويلية.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:this scale]()</h3>
			
 
				+		<p>
			
 
				+			يغير قياس جميع مرات الإطار الرئيسي بعامل.<br /><br />
			
 
				+
			
 
				+			ملاحظة: هذا مفيد ، على سبيل المثال ، للتحويلات إلى معدل معين من الإطارات في الثانية (كما يتم داخليًا بواسطة [page:AnimationClip.CreateFromMorphTargetSequence animationClip.CreateFromMorphTargetSequence]).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:this setInterpolation]( [param:Constant interpolationType] )</h3>
			
 
				+		<p>
			
 
				+			يحدد نوع الاستيفاء. انظر [page:Animation Animation Constants] للاختيارات.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:this shift]( [param:Number timeOffsetInSeconds] )</h3>
			
 
				+		<p>
			
 
				+			ينقل جميع الإطارات الرئيسية إما للأمام أو للخلف في الوقت المناسب.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h3>[method:this trim]( [param:Number startTimeInSeconds], [param:Number endTimeInSeconds] )</h3>
			
 
				+		<p>
			
 
				+			يزيل الإطارات الرئيسية قبل *startTime* وبعد *endTime* ، بدون تغيير أي قيم في النطاق  [*startTime*, *endTime*].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Boolean validate]()</h3>
			
 
				+		<p>
			
 
				+			يؤدي الحد الأدنى من التحقق من الصحة على المسارات. يرجع *true* إذا كان صحيحا.
			
 
				+		</p>
			
 
				+
			
 
				+		<p>
			
 
				+			تقوم هذه الطريقة بتسجيل الأخطاء في وحدة التحكم ، إذا كان المسار فارغًا ، أو إذا كان [page:.valueSize value size] غير صالح ، أو إذا كان عنصر في المصفوفة [page:.times times] أو [page:.values values] ليس رقمًا صالحًا أو إذا كانت العناصر الموجودة في المصفوفة *times* خارج الترتيب.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>الوظائف الساكنة (Static Methods)</h2>
			
 
				+
			
 
				+		<h3>[method:KeyframeTrack parse]( [param:JSON json] )</h3>
			
 
				+		<p>
			
 
				+		يحلل كائن JSON ويعيد مسار إطار رئيسي جديد من النوع الصحيح.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:JSON toJSON]( [param:KeyframeTrack track] )</h3>
			
 
				+		<p>
			
 
				+		يحول المسار إلى JSON.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/PropertyBinding.html
+++ b/docs/api/ar/animation/PropertyBinding.html
@@ -0,0 +1,133 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			هذا يشير إلى الممتلكات الموجودة في الرسم البياني للمشهد ؛ تستخدم داخليا.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:Object3D rootNode], path, parsedPath )</h3>
			
 
				+		<p>
			
 
				+			-- [page:Object3D rootNode]:
			
 
				+			-- path
			
 
				+			-- parsedPath (optional)
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+		<h3>[property:Number path]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number parsedPath]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number node]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number rootNode]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Object BindingType]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Object Versioning]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Array GetterByBindingType]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Array SetterByBindingTypeAndVersioning]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+		<h3>[method:null getValue]( [param:Array targetArray], [param:Number offset] )</h3>
			
 
				+		<p>
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null setValue]( [param:Array sourceArray], [param:Number offset] )</h3>
			
 
				+		<p>
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null bind]( )</h3>
			
 
				+		<p>
			
 
				+			إنشاء زوج getter / setter لخاصية في الرسم البياني للمشهد. تستخدم داخليا من قبل
			
 
				+			[page:PropertyBinding.getValue getValue] و [page:PropertyBinding.setValue setValue].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null unbind]( )</h3>
			
 
				+		<p>
			
 
				+			تقوم بفك ربط زوج getter / setter لخاصية في الرسم البياني للمشهد.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Constructor Composite]( targetGroup, path, optionalParsedPath )</h3>
			
 
				+		<p>
			
 
				+			قم بإنشاء مركب جديد PropertyBinding.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Constructor create]( root, path, parsedPath )</h3>
			
 
				+		<p>
			
 
				+			تقوم بإنشاء رابط خاصية مركب جديد (إذا كان الجذر هو [page:AnimationObjectGroup) أو PropertyBinding.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Constructor parseTrackName]( trackName )</h3>
			
 
				+		<p>
			
 
				+			يطابق الـ strings في الأشكال التالية:<br />
			
 
				+			-- nodeName.property<br />
			
 
				+			-- nodeName.property[accessor]<br />
			
 
				+			-- nodeName.material.property[accessor]<br />
			
 
				+			-- uuid.property[accessor]<br />
			
 
				+			-- uuid.objectName[objectIndex].propertyName[propertyIndex]<br />
			
 
				+			-- parentName/nodeName.property<br />
			
 
				+			-- parentName/parentName/nodeName.property[index]<br />
			
 
				+			-- .bone[Armature.DEF_cog].position<br />
			
 
				+			-- scene:helium_balloon_model:helium_balloon_model.position
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Constructor findNode]( root, nodeName )</h3>
			
 
				+		<p>
			
 
				+			تبحث عن عقدة في شجرة العقدة أو [page:Skeleton Skeleton].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/PropertyMixer.html
+++ b/docs/api/ar/animation/PropertyMixer.html
@@ -0,0 +1,99 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+		خاصية الرسم البياني للمشهد المخزنة التي تسمح بالتراكم الموزون ؛ تستخدم داخليا.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:PropertyBinding binding], [param:String typeName], [param:Number valueSize] )</h3>
			
 
				+		<p>
			
 
				+			-- binding <br />
			
 
				+			-- typeName <br />
			
 
				+			-- valueSize <br />
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[property:PropertyBinding binding]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:TypedArray buffer]</h3>
			
 
				+		<p>
			
 
				+			 حاجز (buffer)  بحجم [page:PropertyMixer valueSize] * 4. <br /><br />
			
 
				+			هذا لديه التخطيط: [ incoming | accu0 | accu1 | orig ]<br /><br />
			
 
				+			يمكن Interpolators استخدام .buffer كـ .result ثم تنتقل البيانات إلى "incoming". <br/>
			
 
				+			يتم استخدام 'accu0' و 'accu1' مع الإطارات المتداخلة للنتيجة التراكمية ويتم مقارنتها لاكتشاف التغييرات. يقوم "orig" بتخزين الحالة الأصلية للممتلكات.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number cumulativeWeight]</h3>
			
 
				+		<p>
			
 
				+			الافتراضي هو *0*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number valueSize]</h3>
			
 
				+		<p>
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number referenceCount]</h3>
			
 
				+		<p>
			
 
				+			الافتراضي هو *0*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number useCount]</h3>
			
 
				+		<p>
			
 
				+			الافتراضي هو *0*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[method:null accumulate]( [param:Number accuIndex], [param:Number weight] )</h3>
			
 
				+		<p>
			
 
				+			تجميع البيانات في [page:PropertyMixer.buffer buffer][accuIndex] منطقة 'incoming' في 'accu[i]'.<br />
			
 
				+
			
 
				+			إذا كان الوزن *0* فهذا لا يفعل شيئًا.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null apply]( [param:Number accuIndex] )</h3>
			
 
				+		<p>
			
 
				+			تطبيق حالة [page:PropertyMixer.buffer buffer] 'accu[i]' على الربط عند اختلاف الاتهام.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null saveOriginalState]( )</h3>
			
 
				+		<p>
			
 
				+			تذكر حالة الملكية المقيدة وتنسخها إلى كلا المتهمين.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null restoreOriginalState](  )</h3>
			
 
				+		<p>
			
 
				+			تقوم بتطبيق الحالة التي تم التقاطها مسبقًا عبر 'saveOriginalState' إلى binding.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/tracks/BooleanKeyframeTrack.html
+++ b/docs/api/ar/animation/tracks/BooleanKeyframeTrack.html
@@ -0,0 +1,80 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		[page:KeyframeTrack] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			تتبع للقيمة الخاصة بـ*boolean keyframe*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:String name], [param:Array times], [param:Array values] )</h3>
			
 
				+		<p>
			
 
				+			[page:String name] - (ضرورية) المعرف الخاص بـ*KeyframeTrack*.<br />
			
 
				+			[page:Array times] - (ضرورية) جدول يتضمن مجموعة من الـ*keyframe times*.<br />
			
 
				+			[page:Array values] - القيم الخاصة بـ *keyframes* في وقت محدد لها.<br />
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Constant DefaultInterpolation]</h3>
			
 
				+		<p>
			
 
				+			الـ*interpolation* الإفتراضي للإستعمال، [page:Animation InterpolateDiscrete].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Array ValueBufferType]</h3>
			
 
				+		<p>
			
 
				+			جدول عادي (ليس *Float32Array* في هذه الحالة، ما عدى *ValueBufferType* الخاص بـ [page:KeyframeTrack]).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:String ValueTypeName]</h3>
			
 
				+		<p>
			
 
				+			String 'bool'.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null InterpolantFactoryMethodLinear ]()</h3>
			
 
				+		<p>
			
 
				+			قيمة هذه الوضيفة هي 'undefined'، حيث أنه لا يوجد سبب لإستعمالها على الخصائص المتفردة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null InterpolantFactoryMethodSmooth ]()</h3>
			
 
				+		<p>
			
 
				+			قيمة هذه الوضيفة هي 'undefined'، حيث أنه لا يوجد سبب لإستعمالها على الخصائص المتفردة.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/tracks/ColorKeyframeTrack.html
+++ b/docs/api/ar/animation/tracks/ColorKeyframeTrack.html
@@ -0,0 +1,63 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		[page:KeyframeTrack] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			تتبع للقيم التابعة لـ*keyframe* التي تمثل تغيرات لون ما.<br /><br />
			
 
				+			التنفيذ الأساسي لهذه الفئة الفرعية فلا يوجد أي شيء خاص حتى الآن. ومع ذلك ، هذا هو المكان المناسب لوضع معلمات مساحة اللون.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:String name], [param:Array times], [param:Array values] )</h3>
			
 
				+		<p>
			
 
				+			[page:String name] - (ضرورية) المعرف الخاص بـ*KeyframeTrack*.<br />
			
 
				+			[page:Array times] - (ضرورية) جدول الأوقات الخاصة بـ*keyframe*.<br />
			
 
				+			[page:Array values] - القيم الخاصة بالـ*keyframes* في وقت محدد.<br />
			
 
				+			[page:Constant interpolation] - نوع الـ*interpolation* الذي يجب إستعماله. أنظر
			
 
				+			[page:Animation Animation Constants] للقيم الممكنة. الإفتراضي هو
			
 
				+			[page:Animation InterpolateLinear].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:String ValueTypeName]</h3>
			
 
				+		<p>
			
 
				+			String 'color'.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/tracks/NumberKeyframeTrack.html
+++ b/docs/api/ar/animation/tracks/NumberKeyframeTrack.html
@@ -0,0 +1,64 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		[page:KeyframeTrack] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			تتبع للقيمة الرقمية الخاصة بـ*keyframe* ما.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:String name], [param:Array times], [param:Array values] )</h3>
			
 
				+		<p>
			
 
				+			[page:String name] - (ضرورية) المعرف الخاص بالـ*KeyframeTrack*.<br />
			
 
				+			[page:Array times] - (ضرورية) جدول الأوقات الخاصة بـ*keyframe*.<br />
			
 
				+			[page:Array values] - القيم الخاصة بالـ*keyframes* في وقت محدد.<br />
			
 
				+			[page:Constant interpolation] - نوع الـ*interpolation* الذي يجب إستعماله. أنظر
			
 
				+			[page:Animation Animation Constants] من أجل القيم المتاحة. الإفتراضي هو
			
 
				+			[page:Animation InterpolateLinear].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h3>[property:String ValueTypeName]</h3>
			
 
				+		<p>
			
 
				+			String 'number'.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/tracks/QuaternionKeyframeTrack.html
+++ b/docs/api/ar/animation/tracks/QuaternionKeyframeTrack.html
@@ -0,0 +1,75 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		[page:KeyframeTrack] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			 تتبع للقيمة الرقمية الخاصة بـإطار رباعي *quaternion keyframe*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:String name], [param:Array times], [param:Array values] )</h3>
			
 
				+		<p>
			
 
				+			[page:String name] (ضرورية) المعرف الخاص بالـ*KeyframeTrack*.<br />
			
 
				+			[page:Array times] - (ضرورية) جدول الأوقات الخاصة بـ*keyframe*.<br />
			
 
				+			[page:Array values] - القيم الخاصة بالـ*keyframes* في وقت محدد.<br />
			
 
				+			[page:Constant interpolation] - نوع الـ*interpolation*  الذي يجب إستعماله. أنظر
			
 
				+			[page:Animation Animation Constants] من أجل القيم المتاحة. الإفتراضي هو
			
 
				+			[page:Animation InterpolateLinear].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Constant DefaultInterpolation]</h3>
			
 
				+		<p>
			
 
				+			نوع الـ*interpolation* الافتراضي المراد استخدامه ،
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:String ValueTypeName]</h3>
			
 
				+		<p>
			
 
				+			String 'quaternion'.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null InterpolantFactoryMethodLinear]()</h3>
			
 
				+		<p>
			
 
				+			إرجاع قيمة من نوع [page:QuaternionLinearInterpolant QuaternionLinearInterpolant] بناءا على
			
 
				+			[page:KeyframeTrack.values values], [page:KeyframeTrack.times times] و
			
 
				+			[page:KeyframeTrack.valueSize valueSize] التابعين لـ*keyframes*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/tracks/StringKeyframeTrack.html
+++ b/docs/api/ar/animation/tracks/StringKeyframeTrack.html
@@ -0,0 +1,83 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		[page:KeyframeTrack] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			 تتبع للقيم الخاصة بـ*string keyframe*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:String name], [param:Array times], [param:Array values] )</h3>
			
 
				+		<p>
			
 
				+			[page:String name] - (ضرورية) معرّف KeyframeTrack.<br />
			
 
				+			[page:Array times] - (ضرورية) جدول الأوقات الخاصة بـ*keyframe*.<br />
			
 
				+			[page:Array values] - القيم الخاصة بالـ*keyframes* في وقت محدد.<br />
			
 
				+			[page:Constant interpolation] - نوع الـ*interpolation*  الذي يجب إستعماله. أنظر
			
 
				+			[page:Animation Animation Constants] من أجل القيم المتاحة. الإفتراضي هو
			
 
				+			[page:Animation InterpolateDiscrete].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Constant DefaultInterpolation]</h3>
			
 
				+		<p>
			
 
				+				نوع الـ*interpolation* الافتراضي المراد استخدامه ، [page:Animation InterpolateDiscrete].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Array ValueBufferType]</h3>
			
 
				+		<p>
			
 
				+			جدول (مصفوفة) عادي (ليس Float32Array في هذه الحالة، بخلاف *ValueBufferType* من [page:KeyframeTrack]).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:String ValueTypeName]</h3>
			
 
				+		<p>
			
 
				+			String 'string'.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null InterpolantFactoryMethodLinear]()</h3>
			
 
				+		<p>
			
 
				+			قيمة هذه الطريقة هنا 'undefined' ، لأنها لا معنى لها بالنسبة للخصائص المنفصلة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null InterpolantFactoryMethodSmooth]()</h3>
			
 
				+		<p>
			
 
				+			قيمة هذه الطريقة هنا 'undefined' ، لأنها لا معنى لها بالنسبة للخصائص المنفصلة.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/animation/tracks/VectorKeyframeTrack.html
+++ b/docs/api/ar/animation/tracks/VectorKeyframeTrack.html
@@ -0,0 +1,63 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		[page:KeyframeTrack] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			 تتبع للقيم الخاصة بـ*vector keyframe*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:String name], [param:Array times], [param:Array values] )</h3>
			
 
				+		<p>
			
 
				+			[page:String name] - (ضرورية) معرّف KeyframeTrack.<br />
			
 
				+			[page:Array times] - (ضرورية) جدول الأوقات الخاصة بـ*keyframe*.<br />
			
 
				+			[page:Array values] - القيم الخاصة بالـ*keyframes* في وقت محدد.<br />
			
 
				+			[page:Constant interpolation] - نوع الـ*interpolation*  الذي يجب إستعماله. أنظر
			
 
				+			[page:Animation Animation Constants] من أجل القيم المتاحة. الإفتراضي هو
			
 
				+			[page:Animation InterpolateLinear].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:String ValueTypeName]</h3>
			
 
				+		<p>
			
 
				+			String 'vector'.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			أنظر [page:KeyframeTrack] من أجل الخصائص الموروثة
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/audio/Audio.html
+++ b/docs/api/ar/audio/Audio.html
@@ -0,0 +1,230 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		[page:Object3D] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			يقوم بإنشاء كائن صوتي غير موضعي (عام).<br /><br />
			
 
				+
			
 
				+			يستخدم هذا [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>مثال التعليمة البرمجية</h2>
			
 
				+
			
 
				+		<code>
			
 
				+		// create an AudioListener and add it to the camera
			
 
				+		var listener = new THREE.AudioListener();
			
 
				+		camera.add( listener );
			
 
				+
			
 
				+		// create a global audio source
			
 
				+		var sound = new THREE.Audio( listener );
			
 
				+
			
 
				+		// load a sound and set it as the Audio object's buffer
			
 
				+		var audioLoader = new THREE.AudioLoader();
			
 
				+		audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
			
 
				+			sound.setBuffer( buffer );
			
 
				+			sound.setLoop( true );
			
 
				+			sound.setVolume( 0.5 );
			
 
				+			sound.play();
			
 
				+		});
			
 
				+		</code>
			
 
				+
			
 
				+		<h2>أمثلة (Examples)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[example:webaudio_sandbox webaudio / sandbox ]<br />
			
 
				+			[example:webaudio_visualizer webaudio / visualizer ]
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( [param:AudioListener listener] )</h3>
			
 
				+		<p>
			
 
				+		listener — (ضرورية) كائن [page:AudioListener AudioListener].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+		<h3>[property:Boolean autoplay]</h3>
			
 
				+		<p>ما إذا كان سيتم بدء التشغيل تلقائيًا. الافتراضي هو *false*.</p>
			
 
				+
			
 
				+		<h3>[property:AudioContext context]</h3>
			
 
				+		<p>الـ[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] من [page:AudioListener listener] المعطاة في المنشئ.</p>
			
 
				+
			
 
				+		<h3>[property:Number detune]</h3>
			
 
				+		<p>تعديل درجة الصوت ، مقاسة بالسنت. +/- 100 نصف نغمة. +/- 1200 هو *octave*. الافتراضي هو *0*.</p>
			
 
				+
			
 
				+		<h3>[property:Array filters]</h3>
			
 
				+		<p>يمثل مجموعة من [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes]. يمكن استخدامه لتطبيق مجموعة متنوعة من المرشحات ذات الترتيب المنخفض لإنشاء مؤثرات صوتية أكثر تعقيدًا. يتم ضبط المرشحات عبر [page:Audio.setFilter] أو [page:Audio.setFilters].</p>
			
 
				+
			
 
				+		<h3>[property:GainNode gain]</h3>
			
 
				+		<p>[link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] تم إنشاؤه باستخدام [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().</p>
			
 
				+
			
 
				+		<h3>[property:Boolean hasPlaybackControl]</h3>
			
 
				+		<p>ما إذا كان يمكن التحكم في التشغيل باستخدام طرق [page:Audio.play play]() و [page:Audio.pause pause]() وما إلى ذلك. الافتراضي هو *true*.</p>
			
 
				+
			
 
				+		<h3>[property:Boolean isPlaying]</h3>
			
 
				+		<p>ما إذا كان الصوت قيد التشغيل حاليًا.</p>
			
 
				+
			
 
				+		<h3>[property:AudioListener listener]</h3>
			
 
				+		<p>مرجع إلى كائن المستمع لهذا الصوت.</p>
			
 
				+
			
 
				+		<h3>[property:Number playbackRate]</h3>
			
 
				+		<p>سرعة التشغيل. الافتراضي هو *1*.</p>
			
 
				+
			
 
				+		<h3>[property:Number offset]</h3>
			
 
				+		<p>إزاحة للوقت الذي يجب أن يبدأ فيه التشغيل داخل المخزن المؤقت للصوت. مثل المعلمة *offset* لـ [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). القيمة الافتراضية هي *0*.</p>
			
 
				+
			
 
				+		<h3>[property:Number duration]</h3>
			
 
				+		<p>يتجاوز مدة الصوت. مثل المعلمة *duration* لـ[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). الافتراضي هو *undefined* لتشغيل المخزن المؤقت بالكامل.</p>
			
 
				+
			
 
				+		<h3>[property:String source]</h3>
			
 
				+		<p>[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode]  تم إنشاؤها باستخدام [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource]().</p>
			
 
				+
			
 
				+		<h3>[property:String sourceType]</h3>
			
 
				+		<p>نوع مصدر الصوت. الافتراضي هو السلسلة 'empty'.</p>
			
 
				+
			
 
				+		<h3>[property:String type]</h3>
			
 
				+		<p>سلسلة تشير إلى النوع ، مضبوطة على 'Audio'.</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+		<h3>[method:Audio connect]()</h3>
			
 
				+		<p>
			
 
				+		متصل بـ [page:Audio.source]. يستخدم هذا داخليًا عند التهيئة وعند ضبط / إزالة المرشحات.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio disconnect]()</h3>
			
 
				+		<p>
			
 
				+		قطع الاتصال من [page:Audio.source]. يستخدم هذا داخليًا عند تعيين / إزالة المرشحات.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:BiquadFilterNode getFilter]()</h3>
			
 
				+		<p>
			
 
				+		إرجاع العنصر الأول من الجدول [page:Audio.filters filters].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Array getFilters]()</h3>
			
 
				+		<p>
			
 
				+		تُرجع جدول (مصفوفة)  [page:Audio.filters filters].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Boolean getLoop]()</h3>
			
 
				+		<p>
			
 
				+		تقوم بإرجاع القيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] (ما إذا كان يجب تكرار التشغيل).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:GainNode getOutput]()</h3>
			
 
				+		<p>
			
 
				+		ترجع [page:Audio.gain gainNode].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Float getPlaybackRate]()</h3>
			
 
				+		<p>
			
 
				+		ترجع القيمة الخاصة بـ[page:Audio.playbackRate playbackRate].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Float getVolume]( value )</h3>
			
 
				+		<p>
			
 
				+		إعادة الحجم الحالي.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio play]( delay )</h3>
			
 
				+		<p>
			
 
				+		إذا كانت [page:Audio.hasPlaybackControl hasPlaybackControl] تحمل قيمة *true* ، يبدأ التشغيل.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio pause]()</h3>
			
 
				+		<p>
			
 
				+		إذا كانت [page:Audio.hasPlaybackControl hasPlaybackControl] تحمل قيمة *true* ، يقوم بإقاف التشغيل.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:null onEnded]()</h3>
			
 
				+		<p>
			
 
				+		يتم مناداته تلقائيًا عند انتهاء التشغيل.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setBuffer]( audioBuffer )</h3>
			
 
				+		<p>
			
 
				+		تقوم بإعداد [page:Audio.source source] إلى *audioBuffer* ، وتقوم بتعيين [page:Audio.sourceType sourceType] إلى 'buffer'.<br />
			
 
				+		إذا كان [page:Audio.autoplay autoplay] ، يبدأ التشغيل أيضًا.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setFilter]( filter )</h3>
			
 
				+		<p>
			
 
				+		يطبق [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNode] واحدًا على الصوت.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setFilters]( [param:Array value] )</h3>
			
 
				+		<p>
			
 
				+		value - جداول (صفائف) المرشحات.<br />
			
 
				+		يطبق جدول (مصفوفة) من [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes] على الصوت.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setLoop]( [param:Boolean value] )</h3>
			
 
				+		<p>
			
 
				+		يضبط [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] على *value* (ما إذا كان يجب تكرار التشغيل).
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setLoopStart]( [param:Float value] )</h3>
			
 
				+		<p>
			
 
				+		يضبط [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopStart source.loopStart] على *value*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setLoopEnd]( [param:Float value] )</h3>
			
 
				+		<p>
			
 
				+		يضبط [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopEnd source.loopEnd] على *value*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setMediaElementSource]( mediaElement )</h3>
			
 
				+		<p>
			
 
				+		يطبق الكائن المحدد من النوع [link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement] كمصدر لهذا الصوت.<br />
			
 
				+		يحدد أيضًا [page:Audio.hasPlaybackControl hasPlaybackControl] إلى false.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setMediaStreamSource]( mediaStream )</h3>
			
 
				+		<p>
			
 
				+		يطبق الكائن المحدد من النوع [link:https://developer.mozilla.org/en-US/docs/Web/API/MediaStream MediaStream] كمصدر لهذا الصوت.<br />
			
 
				+		يحدد أيضًا [page:Audio.hasPlaybackControl hasPlaybackControl] إلى false.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setNodeSource]( audioNode )</h3>
			
 
				+		<p>
			
 
				+		يقوم بإعداد [page:Audio.source source] إلى audioBuffer ، ويقوم بتعيين [page:Audio.sourceType sourceType] على 'audioNode'.<br />
			
 
				+		يضبط أيضًا [page:Audio.hasPlaybackControl hasPlaybackControl] إلى false.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setPlaybackRate]( [param:Float value] )</h3>
			
 
				+		<p>
			
 
				+		إذا تم تمكين [page:Audio.hasPlaybackControl hasPlaybackControl] ، فيتم ضبط [page:Audio.playbackRate playbackRate] على *value*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio setVolume]( [param:Float value] )</h3>
			
 
				+		<p>
			
 
				+		تضبط مستوى الصوت.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Audio stop]()</h3>
			
 
				+		<p>
			
 
				+		إذا تم تمكين [page:Audio.hasPlaybackControl hasPlaybackControl] ، فسيتوقف عن التشغيل.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/audio/AudioAnalyser.html
+++ b/docs/api/ar/audio/AudioAnalyser.html
@@ -0,0 +1,98 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			يقوم بإنشاء كائن AudioAnalyser ، والذي يستخدم [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] لتحليل البيانات الصوتية.<br /><br />
			
 
				+
			
 
				+			هذا يستخدم [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>مثال التعليمة البرمجية</h2>
			
 
				+
			
 
				+		<code>
			
 
				+		// create an AudioListener and add it to the camera
			
 
				+		var listener = new THREE.AudioListener();
			
 
				+		camera.add( listener );
			
 
				+
			
 
				+		// create an Audio source
			
 
				+		var sound = new THREE.Audio( listener );
			
 
				+
			
 
				+		// load a sound and set it as the Audio object's buffer
			
 
				+		var audioLoader = new THREE.AudioLoader();
			
 
				+		audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
			
 
				+			sound.setBuffer( buffer );
			
 
				+			sound.setLoop(true);
			
 
				+			sound.setVolume(0.5);
			
 
				+			sound.play();
			
 
				+		});
			
 
				+
			
 
				+		// create an AudioAnalyser, passing in the sound and desired fftSize
			
 
				+		var analyser = new THREE.AudioAnalyser( sound, 32 );
			
 
				+
			
 
				+		// get the average frequency of the sound
			
 
				+		var data = analyser.getAverageFrequency();
			
 
				+		</code>
			
 
				+
			
 
				+		<h2>أمثلة (Examples)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[example:webaudio_sandbox webaudio / sandbox ]<br />
			
 
				+			[example:webaudio_visualizer webaudio / visualizer ]
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name]( audio, [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize fftSize] )</h3>
			
 
				+		<p>
			
 
				+		يقوم بإنشاء [page:AudioAnalyser AudioAnalyser] جديد.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+		<h3>[property:AnalyserNode analyser]</h3>
			
 
				+		<p>[link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] يستخدم لتحليل الصوت.</p>
			
 
				+
			
 
				+		<h3>[property:Integer fftSize]</h3>
			
 
				+		<p>
			
 
				+		قدرة غير صفرية تصل إلى 2048 ، تمثل حجم FFT (Fast Fourier Transform) لاستخدامها لتحديد مجال التردد (frequency domain).
			
 
				+		انظر [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize this page] للحصول على التفاصيل.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Uint8Array data]</h3>
			
 
				+		<p>
			
 
				+		*Uint8Array* بالحجم المحدد بواسطة [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount] يستخدم للاحتفاظ ببيانات التحليل.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[method:Uint8Array getFrequencyData]()</h3>
			
 
				+		<p>
			
 
				+		يستخدم طريقة [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] الخاصة بـ Web Audio. انظر تلك الصفحة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Number getAverageFrequency]()</h3>
			
 
				+		<p>
			
 
				+		تقوم بإرجاع  متوسط الترددات المعادة بطريقة [page:AudioAnalyser.getFrequencyData getFrequencyData].
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/audio/AudioContext.html
+++ b/docs/api/ar/audio/AudioContext.html
@@ -0,0 +1,43 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+		هذا يحتوي على طرق لإعداد [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].<br /><br />
			
 
				+
			
 
				+		تستخدم داخليا من قبل فئتي [page: AudioListener AudioListener] و [page:AudioLoader AudioLoader].<br /><br />
			
 
				+
			
 
				+		يستخدم هذا [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+		<h3>[method:AudioContext getContext]()</h3>
			
 
				+		<p>
			
 
				+		تقوم بإرجاع قيمة المتغير *context* في النطاق الخارجي ، إذا تم تحديده ، أو قم بتعيينه على [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] جديدًا.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:AudioContext setContext]( [param:AudioContext value] )</h3>
			
 
				+		<p>
			
 
				+		 تضبط المتغير *context* في النطاق الخارجي على *value*.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/audio/AudioListener.html
+++ b/docs/api/ar/audio/AudioListener.html
@@ -0,0 +1,112 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		[page:Object3D] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			يمثل هذا المكون [link:https://developer.mozilla.org/de/docs/Web/API/AudioListener listener] افتراضيًا من جميع المؤثرات الصوتية الموضعية وغير الموضعية في المشهد.<br />
			
 
				+			عادةً ما يُنشئ تطبيق three.js مثيلاً واحدًا من هذا الكائن. إنها معلمة تفسير إلزامية لكيانات الصوت مثل [page:Audio Audio] و [page:PositionalAudio PositionalAudio].<br />
			
 
				+			في معظم الحالات ، يكون الكائن المستمع هو كائن فرعي للكاميرا. لذا فإن التحول ثلاثي الأبعاد للكاميرا يمثل التحول ثلاثي الأبعاد للمستمع.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>مثال التعليمة البرمجية</h2>
			
 
				+
			
 
				+		<code>
			
 
				+		// create an AudioListener and add it to the camera
			
 
				+		var listener = new THREE.AudioListener();
			
 
				+		camera.add( listener );
			
 
				+
			
 
				+		// create a global audio source
			
 
				+		var sound = new THREE.Audio( listener );
			
 
				+
			
 
				+		// load a sound and set it as the Audio object's buffer
			
 
				+		var audioLoader = new THREE.AudioLoader();
			
 
				+		audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
			
 
				+			sound.setBuffer( buffer );
			
 
				+			sound.setLoop(true);
			
 
				+			sound.setVolume(0.5);
			
 
				+			sound.play();
			
 
				+		});
			
 
				+		</code>
			
 
				+
			
 
				+		<h2>أمثلة (Examples)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[example:webaudio_sandbox webaudio / sandbox ]<br />
			
 
				+			[example:webaudio_timing webaudio / timing ]<br />
			
 
				+			[example:webaudio_visualizer webaudio / visualizer ]
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[name](  )</h3>
			
 
				+		<p>
			
 
				+		يقوم بإنشاء AudioListener جديد.
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+		<h3>[property:AudioContext context]</h3>
			
 
				+		<p>الـ[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] الخاصة بـ[page:AudioListener listener] المعطاة في المنشئ.</p>
			
 
				+
			
 
				+		<h3>[property:GainNode gain]</h3>
			
 
				+		<p>[link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] تم إنشاؤه باستخدام [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain](). </p>
			
 
				+
			
 
				+		<h3>[property:AudioNode filter]</h3>
			
 
				+		<p>الافتراضي هو *null*.</p>
			
 
				+
			
 
				+		<h3>[property:Number timeDelta]</h3>
			
 
				+		<p>قيمة دلتا الخاصة بالوقت للكيانات الصوتية. استخدم في سياق [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioParam/linearRampToValueAtTime AudioParam.linearRampToValueAtTimeDefault](). الافتراضي هو *0*.</p>
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+
			
 
				+		<h3>[method:GainNode getInput]()</h3>
			
 
				+		<p>
			
 
				+		ترجع قيمة [page:AudioListener.gain gainNode].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:AudioListener removeFilter]()</h3>
			
 
				+		<p>
			
 
				+		اضبط قيمة [page:AudioListener.filter filter] على *null*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:AudioNode getFilter]()</h3>
			
 
				+		<p>
			
 
				+		ترجع قيمة الخاصة بـ[page:AudioListener.filter filter].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:AudioListener setFilter]( [param:AudioNode value] )</h3>
			
 
				+		<p>
			
 
				+		تقوم بتعيين خاصية [page:AudioListener.filter filter] إلى *value*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Float getMasterVolume]()</h3>
			
 
				+		<p>
			
 
				+		إعادة *volume*.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:AudioListener setMasterVolume]( [param:Number value] )</h3>
			
 
				+		<p>
			
 
				+		ضبط مستوى الصوت (volume).
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/ar/audio/PositionalAudio.html
+++ b/docs/api/ar/audio/PositionalAudio.html
@@ -0,0 +1,137 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="ar">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body class="rtl">
			
 
				+		[page:Object3D] &rarr; [page:Audio] &rarr;
			
 
				+
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			تقوم بإنشاء كائن صوتي موضعي (positional).<br /><br />
			
 
				+
			
 
				+			يستخدم هذا [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>مثال التعليمة البرمجية</h2>
			
 
				+
			
 
				+		<code>
			
 
				+		// create an AudioListener and add it to the camera
			
 
				+		var listener = new THREE.AudioListener();
			
 
				+		camera.add( listener );
			
 
				+
			
 
				+		// create the PositionalAudio object (passing in the listener)
			
 
				+		var sound = new THREE.PositionalAudio( listener );
			
 
				+
			
 
				+		// load a sound and set it as the PositionalAudio object's buffer
			
 
				+		var audioLoader = new THREE.AudioLoader();
			
 
				+		audioLoader.load( 'sounds/song.ogg', function( buffer ) {
			
 
				+			sound.setBuffer( buffer );
			
 
				+			sound.setRefDistance( 20 );
			
 
				+			sound.play();
			
 
				+		});
			
 
				+
			
 
				+		// create an object for the sound to play from
			
 
				+		var sphere = new THREE.SphereBufferGeometry( 20, 32, 16 );
			
 
				+		var material = new THREE.MeshPhongMaterial( { color: 0xff2200 } );
			
 
				+		var mesh = new THREE.Mesh( sphere, material );
			
 
				+		scene.add( mesh );
			
 
				+
			
 
				+		// finally add the sound to the mesh
			
 
				+		mesh.add( sound );
			
 
				+		</code>
			
 
				+
			
 
				+		<h2>أمثلة (Examples)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[example:webaudio_orientation webaudio / orientation ]<br />
			
 
				+			[example:webaudio_sandbox webaudio / sandbox ]<br />
			
 
				+			[example:webaudio_timing webaudio / timing ]
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المنشئ (Constructor)</h2>
			
 
				+
			
 
				+		<h3>[name]( [param:AudioListener listener] )</h3>
			
 
				+		<p>
			
 
				+		listener — (ضرورية) كائن [page:AudioListener AudioListener] .
			
 
				+		</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الخصائص (Properties)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			تراجع فئة [page:Audio Audio] من أجل الخصائص الموروثة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:PannerNode panner]</h3>
			
 
				+		<p>		خاصية [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode PannerNode] التابعة لـ*PositionalAudio*.</p>
			
 
				+
			
 
				+
			
 
				+		<h2>الوظائف (Methods)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			راجع فئة [page:Audio Audio] من أجل الوظائف الموروثة.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:PannerNode getOutput]()</h3>
			
 
				+		<p>
			
 
				+		ترجع الـ[page:PositionalAudio.panner panner].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Float getRefDistance]()</h3>
			
 
				+		<p>
			
 
				+		تُرجع القيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:PositionalAudio setRefDistance]( [param:Float value] )</h3>
			
 
				+		<p>
			
 
				+		يضبط قيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Float getRolloffFactor]()</h3>
			
 
				+		<p>
			
 
				+		تُرجع القيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:PositionalAudio setRolloffFactor]( [param:Float value] )</h3>
			
 
				+		<p>
			
 
				+		يضبط قيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:String getDistanceModel]()</h3>
			
 
				+		<p>
			
 
				+		تُرجع القيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:PositionalAudio setDistanceModel]( [param:String value] )</h3>
			
 
				+		<p>
			
 
				+		يضبط قيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Float getMaxDistance]()</h3>
			
 
				+		<p>
			
 
				+		تُرجع القيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:PositionalAudio setMaxDistance]( [param:Float value] )</h3>
			
 
				+		<p>
			
 
				+		يضبط قيمة [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance].
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:PositionalAudio setDirectionalCone]( [param:Float coneInnerAngle], [param:Float coneOuterAngle], [param:Float coneOuterGain] )</h3>
			
 
				+		<p>
			
 
				+		يمكن استخدام هذه الطريقة لتحويل الصوت متعدد الاتجاهات إلى [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode directional sound].
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>المصدر (Source)</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>
			
--- a/docs/api/en/cameras/CubeCamera.html
+++ b/docs/api/en/cameras/CubeCamera.html
@@ -30,12 +30,12 @@
 
				 		scene.add( car );
			
 
				 
			
 
				 		// Update the render target cube
			
 
				-		car.setVisible( false );
			
 
				+		car.visible = false;
			
 
				 		cubeCamera.position.copy( car.position );
			
 
				 		cubeCamera.update( renderer, scene );
			
 
				 
			
 
				 		// Render the scene
			
 
				-		car.setVisible( true );
			
 
				+		car.visible = true;
			
 
				 		renderer.render( scene, camera );
			
 
				 		</code>
			
 
				 
			
--- a/docs/api/en/lights/AmbientLight.html
+++ b/docs/api/en/lights/AmbientLight.html
@@ -46,11 +46,6 @@
 
				 				See the base [page:Light Light] class for common properties.
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[property:Boolean castShadow]</h3>
			
 
				-		<p>
			
 
				-			This is set to *undefined* in the constructor as ambient lights cannot cast shadows.
			
 
				-		</p>
			
 
				-
			
 
				 
			
 
				 		<h2>Methods</h2>
			
 
				 		<p>
			
--- a/docs/api/en/lights/HemisphereLight.html
+++ b/docs/api/en/lights/HemisphereLight.html
@@ -52,12 +52,6 @@
 
				 			See the base [page:Light Light] class for common properties.
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[property:Boolean castShadow]</h3>
			
 
				-		<p>
			
 
				-			This is set to *undefined* in the constructor as hemisphere lights cannot cast shadows.
			
 
				-		</p>
			
 
				-
			
 
				-
			
 
				 		<h3>[property:Float color]</h3>
			
 
				 		<p>
			
 
				 			The light's sky color, as passed in the constructor.
			
--- a/docs/api/en/lights/shadows/SpotLightShadow.html
+++ b/docs/api/en/lights/shadows/SpotLightShadow.html
@@ -31,8 +31,9 @@
 
				 		//Set up shadow properties for the light
			
 
				 		light.shadow.mapSize.width = 512;  // default
			
 
				 		light.shadow.mapSize.height = 512; // default
			
 
				-		light.shadow.camera.near = 0.5;       // default
			
 
				+		light.shadow.camera.near = 0.5;    // default
			
 
				 		light.shadow.camera.far = 500      // default
			
 
				+		light.shadow.focus = 1;            // default
			
 
				 
			
 
				 		//Create a sphere that cast shadows (but does not receive them)
			
 
				 		var sphereGeometry = new THREE.SphereBufferGeometry( 5, 32, 32 );
			
@@ -62,28 +63,28 @@
 
				 		<p>See the base [page:LightShadow LightShadow] class for common properties.</p>
			
 
				 
			
 
				 
			
 
				-	 <h3>[property:Camera camera]</h3>
			
 
				-	 <p>
			
 
				-		 The light's view of the world. This is used to generate a depth map of the scene; objects behind
			
 
				-		 other objects from the light's perspective will be in shadow.<br /><br />
			
 
				-
			
 
				-		 The default is a  [page:PerspectiveCamera] with [page:PerspectiveCamera.near near] clipping plane at 0.5.
			
 
				-		 The [page:PerspectiveCamera.fov fov] will track the [page:SpotLight.angle angle] property of the owning
			
 
				-		 [page:SpotLight SpotLight] via the [page:SpotLightShadow.update update] method. Similarly, the
			
 
				-		 [page:PerspectiveCamera.aspect aspect] property will track the aspect of the
			
 
				-		 [page:LightShadow.mapSize mapSize]. If the [page:SpotLight.distance distance] property of the light is
			
 
				-		 set, the [page:PerspectiveCamera.far far] clipping plane will track that, otherwise it defaults to 500.
			
 
				+		<h3>[property:Camera camera]</h3>
			
 
				+		<p>
			
 
				+			The light's view of the world. This is used to generate a depth map of the scene; objects behind
			
 
				+			other objects from the light's perspective will be in shadow.<br /><br />
			
 
				 
			
 
				-	 </p>
			
 
				+			The default is a  [page:PerspectiveCamera] with [page:PerspectiveCamera.near near] clipping plane at 0.5.
			
 
				+			The [page:PerspectiveCamera.fov fov] will track the [page:SpotLight.angle angle] property of the owning
			
 
				+			[page:SpotLight SpotLight] via the [page:SpotLightShadow.update update] method. Similarly, the
			
 
				+			[page:PerspectiveCamera.aspect aspect] property will track the aspect of the
			
 
				+			[page:LightShadow.mapSize mapSize]. If the [page:SpotLight.distance distance] property of the light is
			
 
				+			set, the [page:PerspectiveCamera.far far] clipping plane will track that, otherwise it defaults to 500.
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				-		<p>See the base [page:LightShadow LightShadow] class for common methods.</p>
			
 
				+		</p>
			
 
				 
			
 
				-		<h3>[method:SpotLightShadow update]( [param:SpotLight light] )</h3>
			
 
				+		<h3>[property:Number focus]</h3>
			
 
				 		<p>
			
 
				-		Updates the internal perspective [page:.camera camera] based on the passed in [page:SpotLight light].
			
 
				+			Used to focus the shadow camera. The camera's field of view is set as a percentage of the spotlight's field-of-view. Range is [0, 1]. Default is 1.0.<br/>
			
 
				 		</p>
			
 
				 
			
 
				+		<h2>Methods</h2>
			
 
				+		<p>See the base [page:LightShadow LightShadow] class for common methods.</p>
			
 
				+
			
 
				 		<h2>Source</h2>
			
 
				 
			
 
				 		<p>
			
--- a/docs/api/en/materials/Material.html
+++ b/docs/api/en/materials/Material.html
@@ -45,7 +45,7 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer blendDstAlpha]</h3>
			
 
				-		<p>The transparency of the [page:.blendDst]. Default is *null*.</p>
			
 
				+		<p>The transparency of the [page:.blendDst]. Uses [page:.blendDst] value if null. Default is *null*.</p>
			
 
				 
			
 
				 		<h3>[property:Integer blendEquation]</h3>
			
 
				 		<p>
			
@@ -55,7 +55,7 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer blendEquationAlpha]</h3>
			
 
				-		<p>The tranparency of the [page:.blendEquation]. Default is *null*.</p>
			
 
				+		<p>The transparency of the [page:.blendEquation]. Uses [page:.blendEquation] value if null. Default is *null*.</p>
			
 
				 
			
 
				 		<h3>[property:Blending blending]</h3>
			
 
				 		<p>
			
@@ -72,7 +72,7 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer blendSrcAlpha]</h3>
			
 
				-		<p>The tranparency of the [page:.blendSrc]. Default is *null*.</p>
			
 
				+		<p>The transparency of the [page:.blendSrc]. Uses [page:.blendSrc] value if null. Default is *null*.</p>
			
 
				 
			
 
				 		<h3>[property:Boolean clipIntersection]</h3>
			
 
				 		<p>
			
--- a/docs/api/en/materials/ShaderMaterial.html
+++ b/docs/api/en/materials/ShaderMaterial.html
@@ -55,7 +55,7 @@
 
				 						The loop variable has to be *i*.
			
 
				 					</li>
			
 
				 					<li>
			
 
				-						The loop has to use a certain whitespace formatting.
			
 
				+						The value *UNROLLED_LOOP_INDEX* will be replaced with the explicity value of *i* for the given iteration and can be used in preprocessor statements.
			
 
				 					</li>
			
 
				 				</ul>
			
 
				 				<code>
			
--- a/docs/api/en/renderers/WebGLRenderer.html
+++ b/docs/api/en/renderers/WebGLRenderer.html
@@ -55,10 +55,10 @@
 
				 
			
 
				 		[page:String powerPreference] - Provides a hint to the user agent indicating what configuration
			
 
				 		of GPU is suitable for this WebGL context. Can be *"high-performance"*, *"low-power"* or *"default"*. Default is *"default"*.
			
 
				-		See [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.14.12 WebGL spec] for details.<br />
			
 
				+		See [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.2 WebGL spec] for details.<br />
			
 
				 
			
 
				 		[page:Boolean failIfMajorPerformanceCaveat] - whether the renderer creation will fail upon low perfomance is detected. Default is *false*.
			
 
				-		See [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.14.12 WebGL spec] for details.<br />
			
 
				+		See [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.2 WebGL spec] for details.<br />
			
 
				 
			
 
				 		[page:Boolean depth] - whether the drawing buffer has a
			
 
				 		[link:https://en.wikipedia.org/wiki/Z-buffering depth buffer] of at least 16 bits.
			
--- a/docs/api/en/renderers/webgl/WebGLProgram.html
+++ b/docs/api/en/renderers/webgl/WebGLProgram.html
@@ -92,6 +92,16 @@
 
				 			attribute vec4 skinWeight;
			
 
				 		#endif
			
 
				 		</code>
			
 
				+		<code>
			
 
				+		#ifdef USE_INSTANCING
			
 
				+			// Note that modelViewMatrix is not set when rendering an instanced model,
			
 
				+			// but can be calculated from viewMatrix * modelMatrix.
			
 
				+			//
			
 
				+			// Basic Usage:
			
 
				+			//   gl_Position = projectionMatrix * viewMatrix * modelMatrix * instanceMatrix * vec4(position, 1.0);
			
 
				+			attribute mat4 instanceMatrix;
			
 
				+		#endif
			
 
				+		</code>
			
 
				 		</div>
			
 
				 
			
 
				 		<h3>Fragment shader:</h3>
			
--- a/docs/api/zh/audio/Audio.html
+++ b/docs/api/zh/audio/Audio.html
@@ -75,15 +75,15 @@
 
				 		<p>是否可以使用 [page:Audio.play play](),
			
 
				 			[page:Audio.pause pause]()等方法控制播放. 默认为 *true*.</p>
			
 
				 
			
 
				-		<h3>[property:Number playbackRate]</h3>
			
 
				-		<p>播放速率. 默认为 *1*.</p>
			
 
				-
			
 
				-		<h3>[property:Boolean isPlaying]</h3>
			
 
				-		<p>是否正在播放</p>
			
 
				+		<h3>[property:Boolean isPlaying]</h3>	
			
 
				+		<p>是否正在播放</p>	
			
 
				 
			
 
				-		<h3>[property:AudioListener listener]</h3>
			
 
				+		<h3>[property:AudioListener listener]</h3>	
			
 
				 		<p>A reference to the listener object of this audio.</p>
			
 
				 
			
 
				+		<h3>[property:Number playbackRate]</h3>
			
 
				+		<p>播放速率. 默认为 *1*.</p>
			
 
				+
			
 
				 		<h3>[property:Number offset]</h3>
			
 
				 		<p>音频开始播放的偏移时间. 和[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start]()的*offset*参数一样. 默认为 *0*.</p>
			
 
				 
			
--- a/docs/api/zh/cameras/CubeCamera.html
+++ b/docs/api/zh/cameras/CubeCamera.html
@@ -12,8 +12,7 @@
 
				 
			
 
				 		<h1>立方相机（[name]）</h1>
			
 
				 
			
 
				-
			
 
				-		<p class="desc">创建6个摄像机，并将它们所拍摄的场景渲染到[page:WebGLCubeRenderTarget]上。</p>
			
 
				+		<p class="desc">创建6个渲染到[page:WebGLCubeRenderTarget]的摄像机。</p>
			
 
				 
			
 
				 		<h2>代码示例</h2>
			
 
				 
			
@@ -31,12 +30,12 @@
 
				 		scene.add( car );
			
 
				 
			
 
				 		// Update the render target cube
			
 
				-		car.setVisible( false );
			
 
				+		car.visible = false;
			
 
				 		cubeCamera.position.copy( car.position );
			
 
				 		cubeCamera.update( renderer, scene );
			
 
				 
			
 
				 		// Render the scene
			
 
				-		car.setVisible( true );
			
 
				+		car.visible = true;
			
 
				 		renderer.render( scene, camera );
			
 
				 		</code>
			
 
				 
			
@@ -53,14 +52,13 @@
 
				 
			
 
				 		<h3>[name]( [param:Number near], [param:Number far], [param:WebGLCubeRenderTarget renderTarget] )</h3>
			
 
				 		<p>
			
 
				-
			
 
				 		near -- 近剪切面的距离<br />
			
 
				 		far -- 远剪切面的距离<br />
			
 
				 		renderTarget -- The destination cube render target.
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			构造一个包含6个[page:PerspectiveCamera PerspectiveCameras]（透视摄像机）的立方摄像机，并将其拍摄的场景渲染到一个[page:WebGLCubeRenderTarget]上。
			
 
				-
			
 
				+		构造一个包含6个[page:PerspectiveCamera PerspectiveCameras]（透视摄像机）的立方摄像机，
			
 
				+		并将其拍摄的场景渲染到一个[page:WebGLCubeRenderTarget]上。
			
 
				 		</p>
			
 
				 
			
 
				 
			
@@ -76,21 +74,19 @@
 
				 		<p>共有方法请参见其基类[page:Object3D]。</p>
			
 
				 
			
 
				 
			
 
				-
			
 
				 		<h3>[method:null update]( [param:WebGLRenderer renderer], [param:Scene scene] )</h3>
			
 
				 		<p>
			
 
				 		renderer -- 当前的WebGL渲染器<br />
			
 
				 		scene -- 当前的场景
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			这个方法用来更新[page:CubeCamera.renderTarget renderTarget]（渲染目标对象）。
			
 
				+		这个方法用来更新[page:CubeCamera.renderTarget renderTarget]（渲染目标对象）。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:null clear]( [param:WebGLRenderer renderer], [param:Boolean color], [param:Boolean depth], [param:Boolean stencil] )</h3>
			
 
				 		<p>
			
 
				-			这个方法用来来清除[page:CubeCamera.renderTarget renderTarget]的颜色、深度和/或模板缓冲区。
			
 
				-			颜色缓冲区设置为渲染器当前的“清除”色。参数默认值均为*true*。
			
 
				-
			
 
				+		这个方法用来来清除[page:CubeCamera.renderTarget renderTarget]的颜色、深度和/或模板缓冲区。
			
 
				+		颜色缓冲区设置为渲染器当前的“清除”色。参数默认值均为*true*。
			
 
				 		</p>
			
 
				 
			
 
				 		<h2>源代码</h2>
			
--- a/docs/api/zh/cameras/OrthographicCamera.html
+++ b/docs/api/zh/cameras/OrthographicCamera.html
@@ -18,7 +18,6 @@
 
				 			在这种投影模式下，无论物体距离相机距离远或者近，在最终渲染的图片中物体的大小都保持不变。
			
 
				 			<br /><br />
			
 
				 
			
 
				-
			
 
				 			这对于渲染2D场景或者UI元素是非常有用的。
			
 
				 		</p>
			
 
				 
			
@@ -75,7 +74,7 @@
 
				 		<h3>[property:Float far]</h3>
			
 
				 		<p>
			
 
				 			摄像机视锥体远端面，其默认值为*2000*。<br /><br />
			
 
				-			Must be greater than the current value of [page:.near near] plane.
			
 
				+			该值必须大于[page:.near near] plane（摄像机视锥体近端面）的值。
			
 
				 
			
 
				 		</p>
			
 
				 
			
@@ -102,8 +101,7 @@
 
				 		<p>这个值是由[page:OrthographicCamera.setViewOffset setViewOffset]来设置的，其默认值为*null*。</p>
			
 
				 
			
 
				 		<h3>[property:number zoom]</h3>
			
 
				-		<p>
			
 
				-			获取或者设置摄像机的缩放倍数，其默认值为*1*。</p>
			
 
				+		<p>获取或者设置摄像机的缩放倍数，其默认值为*1*。</p>
			
 
				 
			
 
				 		<h2>方法</h2>
			
 
				 		<p>共有方法请参见其基类[page:Camera]。</p>
			
@@ -124,13 +122,12 @@
 
				 
			
 
				 		<h3>[method:null clearViewOffset]()</h3>
			
 
				 		<p>
			
 
				-			清除任何由.setViewOffset设置的偏移量。
			
 
				+		清除任何由.setViewOffset设置的偏移量。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:null updateProjectionMatrix]()</h3>
			
 
				 		<p>
			
 
				-			更新摄像机投影矩阵。在任何参数被改变以后必须被调用。
			
 
				-
			
 
				+		更新摄像机投影矩阵。在任何参数被改变以后必须被调用。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Object toJSON]([param:object meta])</h3>
			
--- a/docs/api/zh/cameras/PerspectiveCamera.html
+++ b/docs/api/zh/cameras/PerspectiveCamera.html
@@ -62,7 +62,7 @@
 
				 		<p>
			
 
				 			摄像机的远端面，默认值是*2000*。
			
 
				 			<br /><br />
			
 
				-			Must be greater than the current value of [page:.near near] plane.
			
 
				+			该值必须大于[page:.near near] plane（摄像机视锥体近端面）的值。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Float filmGauge]</h3>
			
--- a/docs/api/zh/cameras/StereoCamera.html
+++ b/docs/api/zh/cameras/StereoCamera.html
@@ -12,8 +12,8 @@
 
				 		<h1>立体相机（[name]）</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			双透视摄像机（立体相机）常被用于创建[link:https://en.wikipedia.org/wiki/Anaglyph_3D 3D Anaglyph]（3D立体影像）或者[link:https://en.wikipedia.org/wiki/parallax_barrier Parallax Barrier]（视差效果）。
			
 
				-
			
 
				+			双透视摄像机（立体相机）常被用于创建[link:https://en.wikipedia.org/wiki/Anaglyph_3D 3D Anaglyph]（3D立体影像）
			
 
				+			或者[link:https://en.wikipedia.org/wiki/parallax_barrier Parallax Barrier]（视差屏障）。
			
 
				 		</p>
			
 
				 
			
 
				 		<h2>例子</h2>
			
@@ -46,7 +46,7 @@
 
				 
			
 
				 		<h3>[method:null update]( [param:PerspectiveCamera camera] )</h3>
			
 
				 		<p>
			
 
				-			基于摄像机通过场景，更新立体摄像机。
			
 
				+		基于摄像机通过场景，更新立体摄像机。
			
 
				 		</p>
			
 
				 
			
 
				 		<h2>源代码</h2>
			
--- a/docs/api/zh/constants/Renderer.html
+++ b/docs/api/zh/constants/Renderer.html
@@ -46,6 +46,7 @@
 
				 		THREE.LinearToneMapping
			
 
				 		THREE.ReinhardToneMapping
			
 
				 		THREE.CineonToneMapping
			
 
				+		THREE.ACESFilmicToneMapping
			
 
				 		</code>
			
 
				 		<p>
			
 
				 		这些常量定义了WebGLRenderer中[page:WebGLRenderer.toneMapping toneMapping]的属性。
			
--- a/docs/api/zh/constants/Textures.html
+++ b/docs/api/zh/constants/Textures.html
@@ -69,10 +69,10 @@
 
				 		这些常量用于纹理的[page:Texture.magFilter magFilter]属性，它们定义了当被纹理化的像素映射到小于或者等于1纹理元素（texel）的区域时，将要使用的纹理放大函数。<br /><br />
			
 
				 
			
 
				 		[page:constant NearestFilter]返回与指定纹理坐标（在曼哈顿距离之内）最接近的纹理元素的值。<br /><br />
			
 
				+
			
 
				 		[page:constant LinearFilter]是默认值，返回距离指定的纹理坐标最近的四个纹理元素的加权平均值，
			
 
				 		并且可以包含纹理的其他部分中，被包裹或者被重复的项目，具体取决于 [page:Texture.wrapS wrapS] 和 [page:Texture.wrapT wrapT] 的值，and on the exact mapping。
			
 
				-
			
 
				-	</p>
			
 
				+		</p>
			
 
				 
			
 
				 	<h2>缩小滤镜（Minification Filters）</h2>
			
 
				 	<code>
			
@@ -132,28 +132,57 @@
 
				 	<h2>格式</h2>
			
 
				 	<code>
			
 
				 		THREE.AlphaFormat
			
 
				+		THREE.RedFormat
			
 
				+		THREE.RedIntegerFormat
			
 
				+		THREE.RGFormat
			
 
				+		THREE.RGIntegerFormat
			
 
				 		THREE.RGBFormat
			
 
				+		THREE.RGBIntegerFormat
			
 
				 		THREE.RGBAFormat
			
 
				+		THREE.RGBAIntegerFormat
			
 
				 		THREE.LuminanceFormat
			
 
				 		THREE.LuminanceAlphaFormat
			
 
				 		THREE.RGBEFormat
			
 
				 		THREE.DepthFormat
			
 
				 		THREE.DepthStencilFormat
			
 
				-		</code>
			
 
				+	</code>
			
 
				 	<p>
			
 
				 		这些常量用于纹理的[page:Texture.format format]属性，它们定义了shader（着色器）将如何读取的2D纹理或者*texels*（纹理元素）的元素。.<br /><br />
			
 
				 
			
 
				 		[page:constant AlphaFormat] 丢弃红、绿、蓝分量，仅读取Alpha分量。<br /><br />
			
 
				 
			
 
				+		[page:constant RedFormat] discards the green and blue components and reads just the red component.<br /><br />
			
 
				+
			
 
				+		[page:constant RedIntegerFormat] discards the green and blue components and reads just the red component.
			
 
				+		The texels are read as integers instead of floating point.
			
 
				+		(can only be used with a WebGL 2 rendering context).
			
 
				+		<br /><br />
			
 
				+
			
 
				+		[page:constant RGFormat] discards the alpha, and blue components and reads the red, and green components.
			
 
				+		(can only be used with a WebGL 2 rendering context).
			
 
				+		<br /><br />
			
 
				+
			
 
				+		[page:constant RGIntegerFormat] discards the alpha, and blue components and reads the red, and green components.
			
 
				+		The texels are read as integers instead of floating point.
			
 
				+		(can only be used with a WebGL 2 rendering context).
			
 
				+		<br /><br />
			
 
				+
			
 
				 		[page:constant RGBFormat] 丢弃Alpha分量，仅读取红、绿、蓝分量。<br /><br />
			
 
				 
			
 
				+		[page:constant RGBIntegerFormat] discards the alpha components and reads the red, green and blue components.
			
 
				+		(can only be used with a WebGL 2 rendering context).
			
 
				+		<br /><br />
			
 
				+
			
 
				 		[page:constant RGBAFormat] 是默认值，它将读取红、绿、蓝和Alpha分量。<br /><br />
			
 
				 
			
 
				+		[page:constant RGBAIntegerFormat] is the default and reads the red, green, blue and alpha components.
			
 
				+		The texels are read as integers instead of floating point.
			
 
				+		(can only be used with a WebGL 2 rendering context).
			
 
				+		<br /><br />
			
 
				 
			
 
				 		[page:constant LuminanceFormat] 将每个元素作为单独的亮度分量来读取。
			
 
				 		将其转换为范围限制在[0,1]区间的浮点数，然后通过将亮度值放入红、绿、蓝通道，并将1.0赋给Alpha通道，来组装成一个RGBA元素。<br /><br />
			
 
				 
			
 
				-
			
 
				 		[page:constant LuminanceAlphaFormat] 将每个元素同时作为亮度分量和Alpha分量来读取。
			
 
				 		和上面[page:constant LuminanceFormat]的处理过程是一致的，除了Alpha分量具有除了*1.0*以外的值。<br /><br />
			
 
				 
			
@@ -263,6 +292,259 @@
 
				 	these require support for the [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_compressed_texture_astc/ WEBGL_compressed_texture_astc] extension. <br /><br />
			
 
				 	</p>
			
 
				 
			
 
				+	<h2>Internal Formats</h2>
			
 
				+	<code>
			
 
				+	'ALPHA'
			
 
				+	'RGB'
			
 
				+	'RGBA'
			
 
				+	'LUMINANCE'
			
 
				+	'LUMINANCE_ALPHA'
			
 
				+	'RED_INTEGER'
			
 
				+	'R8'
			
 
				+	'R8_SNORM'
			
 
				+	'R8I'
			
 
				+	'R8UI'
			
 
				+	'R16I'
			
 
				+	'R16UI'
			
 
				+	'R16F'
			
 
				+	'R32I'
			
 
				+	'R32UI'
			
 
				+	'R32F'
			
 
				+	'RG8'
			
 
				+	'RG8_SNORM'
			
 
				+	'RG8I'
			
 
				+	'RG8UI'
			
 
				+	'RG16I'
			
 
				+	'RG16UI'
			
 
				+	'RG16F'
			
 
				+	'RG32I'
			
 
				+	'RG32UI'
			
 
				+	'RG32F'
			
 
				+	'RGB565'
			
 
				+	'RGB8'
			
 
				+	'RGB8_SNORM'
			
 
				+	'RGB8I'
			
 
				+	'RGB8UI'
			
 
				+	'RGB16I'
			
 
				+	'RGB16UI'
			
 
				+	'RGB16F'
			
 
				+	'RGB32I'
			
 
				+	'RGB32UI'
			
 
				+	'RGB32F'
			
 
				+	'RGB9_E5'
			
 
				+	'SRGB8'
			
 
				+	'R11F_G11F_B10F'
			
 
				+	'RGBA4'
			
 
				+	'RGBA8'
			
 
				+	'RGBA8_SNORM'
			
 
				+	'RGBA8I'
			
 
				+	'RGBA8UI'
			
 
				+	'RGBA16I'
			
 
				+	'RGBA16UI'
			
 
				+	'RGBA16F'
			
 
				+	'RGBA32I'
			
 
				+	'RGBA32UI'
			
 
				+	'RGBA32F'
			
 
				+	'RGB5_A1'
			
 
				+	'RGB10_A2'
			
 
				+	'RGB10_A2UI'
			
 
				+	'SRGB8_ALPHA8'
			
 
				+	'DEPTH_COMPONENT16'
			
 
				+	'DEPTH_COMPONENT24'
			
 
				+	'DEPTH_COMPONENT32F'
			
 
				+	'DEPTH24_STENCIL8'
			
 
				+	'DEPTH32F_STENCIL8'
			
 
				+	</code>
			
 
				+
			
 
				+	<p>
			
 
				+
			
 
				+	Heads up: changing the internal format of a texture will only affect the
			
 
				+	texture when using a WebGL 2 rendering context.<br /><br />
			
 
				+
			
 
				+	For use with a texture's [page:Texture.internalFormat internalFormat]	property,
			
 
				+	these define how elements of a texture, or *texels*, are stored on the GPU.<br /><br />
			
 
				+
			
 
				+	[page:constant R8] stores the red component on 8 bits.<br /><br />
			
 
				+
			
 
				+	[page:constant R8_SNORM] stores the red component on 8 bits. The component is stored as normalized. <br /><br />
			
 
				+
			
 
				+	[page:constant R8I] stores the red component on 8 bits. The component is stored as an integer. <br /><br />
			
 
				+
			
 
				+	[page:constant R8UI] stores the red component on 8 bits. The component is stored as an unsigned integer. <br /><br />
			
 
				+
			
 
				+	[page:constant R16I] stores the red component on 16 bits. The component is stored as an integer. <br /><br />
			
 
				+
			
 
				+	[page:constant R16UI] stores the red component on 16 bits. The component is stored as an unsigned integer. <br /><br />
			
 
				+
			
 
				+	[page:constant R16F] stores the red component on 16 bits. The component is stored as floating point. <br /><br />
			
 
				+
			
 
				+	[page:constant R32I] stores the red component on 32 bits. The component is stored as an integer. <br /><br />
			
 
				+
			
 
				+	[page:constant R32UI] stores the red component on 32 bits. The component is stored as an unsigned integer. <br /><br />
			
 
				+
			
 
				+	[page:constant R32F] stores the red component on 32 bits. The component is stored as floating point. <br /><br />
			
 
				+
			
 
				+	[page:constant RG8] stores the red and green components on 8 bits each.<br /><br />
			
 
				+
			
 
				+	[page:constant RG8_SNORM] stores the red and green components on 8 bits each.
			
 
				+	Every component is stored as normalized.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG8I] stores the red and green components on 8 bits each.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG8UI] stores the red and green components on 8 bits each.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG16I] stores the red and green components on 16 bits each.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG16UI] stores the red and green components on 16 bits each.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG16F] stores the red and green components on 16 bits each.
			
 
				+	Every component is stored as floating point.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG32I] stores the red and green components on 32 bits each.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG32UI] stores the red and green components on 32 bits.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RG32F] stores the red and green components on 32 bits.
			
 
				+	Every component is stored as floating point.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB8] stores the red, green, and blue components on 8 bits each.
			
 
				+
			
 
				+	[page:constant RGB8_SNORM] stores the red, green, and blue components on 8 bits each.
			
 
				+	Every component is stored as normalized.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB8I] stores the red, green, and blue components on 8 bits each.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB8UI] stores the red, green, and blue components on 8 bits each.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB16I] stores the red, green, and blue components on 16 bits each.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB16UI] stores the red, green, and blue components on 16 bits each.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB16F] stores the red, green, and blue components on 16 bits each.
			
 
				+	Every component is stored as floating point
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB32I] stores the red, green, and blue components on 32 bits each.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB32UI] stores the red, green, and blue components on 32 bits each.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB32F] stores the red, green, and blue components on 32 bits each.
			
 
				+	Every component is stored as floating point
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant R11F_G11F_B10F] stores the red, green, and blue components respectively on 11 bits, 11 bits, and 10bits.
			
 
				+	Every component is stored as floating point.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB565] stores the red, green, and blue components respectively on 5 bits, 6 bits, and 5 bits.<br /><br />
			
 
				+
			
 
				+	[page:constant RGB9_E5] stores the red, green, and blue components on 9 bits each.<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA8] stores the red, green, blue, and alpha components on 8 bits each.<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA8_SNORM] stores the red, green, blue, and alpha components on 8 bits.
			
 
				+	Every component is stored as normalized.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA8I] stores the red, green, blue, and alpha components on 8 bits each.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA8UI] stores the red, green, blue, and alpha components on 8 bits.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA16I] stores the red, green, blue, and alpha components on 16 bits.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA16UI] stores the red, green, blue, and alpha components on 16 bits.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA16F] stores the red, green, blue, and alpha components on 16 bits.
			
 
				+	Every component is stored as floating point.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA32I] stores the red, green, blue, and alpha components on 32 bits.
			
 
				+	Every component is stored as an integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA32UI] stores the red, green, blue, and alpha components on 32 bits.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGBA32F] stores the red, green, blue, and alpha components on 32 bits.
			
 
				+	Every component is stored as floating point.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant RGB5_A1] stores the red, green, blue, and alpha components respectively on 5 bits, 5 bits, 5 bits, and 1 bit.<br /><br />
			
 
				+
			
 
				+	[page:constant RGB10_A2] stores the red, green, blue, and alpha components respectively on 10 bits, 10 bits, 10 bits and 2 bits.<br /><br />
			
 
				+
			
 
				+	[page:constant RGB10_A2UI] stores the red, green, blue, and alpha components respectively on 10 bits, 10 bits, 10 bits and 2 bits.
			
 
				+	Every component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant SRGB8] stores the red, green, and blue components on 8 bits each.<br /><br />
			
 
				+
			
 
				+	[page:constant SRGB8_ALPHA8] stores the red, green, blue, and alpha components on 8 bits each.<br /><br />
			
 
				+
			
 
				+	[page:constant DEPTH_COMPONENT16] stores the depth component on 16bits.<br /><br />
			
 
				+
			
 
				+	[page:constant DEPTH_COMPONENT24] stores the depth component on 24bits.<br /><br />
			
 
				+
			
 
				+	[page:constant DEPTH_COMPONENT32F] stores the depth component on 32bits. The component is stored as floating point.<br /><br />
			
 
				+
			
 
				+	[page:constant DEPTH24_STENCIL8] stores the depth, and stencil components respectively on 24 bits and 8 bits.
			
 
				+	The stencil component is stored as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	[page:constant DEPTH32F_STENCIL8] stores the depth, and stencil components respectively on 32 bits and 8 bits.
			
 
				+	The depth component is stored as floating point, and the stencil component as an unsigned integer.
			
 
				+	<br /><br />
			
 
				+
			
 
				+	Note that the texture must have the correct [page:Texture.type type] set,
			
 
				+	as well as the correct [page:Texture.format format].
			
 
				+
			
 
				+	See [link:https://developer.mozilla.org/en/docs/Web/API/WebGLRenderingContext/texImage2D WebGLRenderingContext.texImage2D], and
			
 
				+	[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext/texImage3D WebGL2RenderingContext.texImage3D],
			
 
				+	for more details regarding the possible combination of [page:Texture.format format], [page:Texture.internalFormat internalFormat],
			
 
				+	and [page:Texture.type type].<br /><br />
			
 
				+
			
 
				+	For more in-depth information regarding internal formats, you can also refer directly
			
 
				+	to the [link:https://www.khronos.org/registry/webgl/specs/latest/2.0/ WebGL2 Specification] and
			
 
				+	to the [link:https://www.khronos.org/registry/OpenGL/specs/es/3.0/es_spec_3.0.pdf OpenGL ES 3.0 Specification].
			
 
				+	</p>
			
 
				+
			
 
				 	<h2>编码</h2>
			
 
				 	<code>
			
 
				 		THREE.LinearEncoding
			
--- a/docs/api/zh/core/BufferAttribute.html
+++ b/docs/api/zh/core/BufferAttribute.html
@@ -97,6 +97,18 @@
 
				 
			
 
				 		<h2>方法</h2>
			
 
				 
			
 
				+		<h3>[method:this applyMatrix3]( [param:Matrix3 m] )</h3>
			
 
				+		<p>Applies matrix [page:Matrix3 m] to every Vector3 element of this BufferAttribute.</p>
			
 
				+
			
 
				+		<h3>[method:this applyMatrix4]( [param:Matrix4 m] )</h3>
			
 
				+		<p>Applies matrix [page:Matrix4 m] to every Vector3 element of this BufferAttribute.</p>
			
 
				+
			
 
				+		<h3>[method:this applyNormalMatrix]( [param:Matrix3 m] )</h3>
			
 
				+		<p>Applies normal matrix [page:Matrix3 m] to every Vector3 element of this BufferAttribute.</p>
			
 
				+
			
 
				+		<h3>[method:this transformDirection]( [param:Matrix4 m] )</h3>
			
 
				+		<p>Applies matrix [page:Matrix4 m] to every Vector3 element of this BufferAttribute, interpreting the elements as a direction vectors.</p>
			
 
				+
			
 
				 		<h3>[method:BufferAttribute clone]() </h3>
			
 
				 		<p>返回该 BufferAttribute 的拷贝。</p>
			
 
				 
			
--- a/docs/api/zh/core/BufferGeometry.html
+++ b/docs/api/zh/core/BufferGeometry.html
@@ -132,6 +132,13 @@
 
				 			存储 [page:BufferAttribute] 的 Hashmap，存储了几何体 [page:Geometry.morphTargets morphTargets] 的细节信息。
			
 
				 		</p>
			
 
				 
			
 
				+		<h3>[property:Boolean morphTargetsRelative]</h3>
			
 
				+		<p>
			
 
				+			Used to control the morph target behavior; when set to true, the morph target data is treated as relative offsets, rather than as absolute positions/normals.
			
 
				+
			
 
				+			Default is *false*.
			
 
				+		</p>
			
 
				+
			
 
				 		<h3>[property:String name]</h3>
			
 
				 		<p>
			
 
				 			当前 bufferGeometry 实例的可选别名。默认值是空字符串。
			
--- a/docs/api/zh/core/InterleavedBuffer.html
+++ b/docs/api/zh/core/InterleavedBuffer.html
@@ -69,11 +69,6 @@
 
				 			版本号，每次 needsUpdate 属性设置为 true 时，版本号增加。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[property:Integer isInterleavedBuffer]</h3>
			
 
				-		<p>
			
 
				-			默认值为 *true*。
			
 
				-		</p>
			
 
				-
			
 
				 		<h3>[property:Integer needsUpdate]</h3>
			
 
				 		<p>
			
 
				 			默认值为 *false*。该值被设置为 true 时，会导致 [page:InterleavedBuffer.version version] 增加。
			
--- a/docs/api/zh/core/InterleavedBufferAttribute.html
+++ b/docs/api/zh/core/InterleavedBufferAttribute.html
@@ -66,6 +66,9 @@
 
				 
			
 
				 		<h2>方法</h2>
			
 
				 
			
 
				+		<h3>[method:this applyMatrix4]( [param:Matrix4 m] )</h3>
			
 
				+		<p>Applies matrix [page:Matrix4 m] to every Vector3 element of this InterleavedBufferAttribute.</p>
			
 
				+
			
 
				 		<h3>[method:Number getX]( [param:Integer index] ) </h3>
			
 
				 		<p>返回给定索引矢量的第一个元素 （X 值）。</p>
			
 
				 
			
--- a/docs/api/zh/core/Object3D.html
+++ b/docs/api/zh/core/Object3D.html
@@ -224,7 +224,7 @@
 
				 	<p>
			
 
				 		id —— 标识该对象实例的唯一数字。<br /><br />
			
 
				 
			
 
				-		搜索该对象的子级，返回第一个带有匹配id的子对象。<br />
			
 
				+		从该对象开始，搜索一个对象及其子级，返回第一个带有匹配id的子对象。<br />
			
 
				 		请注意，id是按照时间顺序来分配的：1、2、3、……，每增加一个新的对象就自增1。
			
 
				 	</p>
			
 
				 
			
@@ -232,7 +232,7 @@
 
				 	<p>
			
 
				 		name —— 用于来匹配子物体中Object3D.name属性的字符串。<br /><br />
			
 
				 
			
 
				-		搜索该对象的子级，返回第一个带有匹配name的子对象。<br />
			
 
				+		从该对象开始，搜索一个对象及其子级，返回第一个带有匹配name的子对象。<br />
			
 
				 		请注意，大多数的对象中name默认是一个空字符串，要使用这个方法，你将需要手动地设置name属性。
			
 
				 	</p>
			
 
				 
			
@@ -240,7 +240,7 @@
 
				 	<p>
			
 
				 		name —— 将要用于查找的属性的名称。<br />
			
 
				 		value —— 给定的属性的值。 <br /><br />
			
 
				-		搜索该对象的子级，返回第一个给定的属性中包含有匹配的值的子对象。
			
 
				+		从该对象开始，搜索一个对象及其子级，返回第一个给定的属性中包含有匹配的值的子对象。
			
 
				 	</p>
			
 
				 
			
 
				 	<h3>[method:Vector3 getWorldPosition]( [param:Vector3 target] )</h3>
			
@@ -270,9 +270,9 @@
 
				 
			
 
				 	<h3>[method:Vector3 localToWorld]( [param:Vector3 vector] )</h3>
			
 
				 	<p>
			
 
				-		vector - A vector representing a position in this object's local space.<br /><br />
			
 
				+		vector - 一个表示在该物体局部空间中位置的向量。<br /><br />
			
 
				 
			
 
				-		Converts the vector from this object's local space to world space.
			
 
				+		将该向量从物体的局部空间转换到世界空间。
			
 
				 	</p>
			
 
				 
			
 
				 	<h3>[method:null lookAt]( [param:Vector3 vector] )<br />
			
@@ -423,9 +423,9 @@
 
				 
			
 
				 	<h3>[method:Vector3 worldToLocal]( [param:Vector3 vector] )</h3>
			
 
				 	<p>
			
 
				-		vector - A vector representing a position in world space.<br /><br />
			
 
				+		vector - 一个表示在世界空间中位置的向量。<br /><br />
			
 
				 
			
 
				-		Converts the vector from world space to this object's local space.
			
 
				+		将该向量从世界空间转换到物体的局部空间。
			
 
				 	</p>
			
 
				 
			
 
				 	<h2>源代码</h2>
			
--- a/docs/api/zh/core/Raycaster.html
+++ b/docs/api/zh/core/Raycaster.html
@@ -121,7 +121,8 @@
 
				 
			
 
				 		<h3>[property:Object params]</h3>
			
 
				 		<p>
			
 
				-			具有以下属性的对象：<code>
			
 
				+			具有以下属性的对象：
			
 
				+			<code>
			
 
				 {
			
 
				 	Mesh: {},
			
 
				 	Line: { threshold: 1 },
			
--- a/docs/api/zh/extras/core/Curve.html
+++ b/docs/api/zh/extras/core/Curve.html
@@ -102,7 +102,7 @@
 
				 
			
 
				 		<h3>[method:Object computeFrenetFrames]( [param:Integer segments], [param:Boolean closed] )</h3>
			
 
				 		<p>
			
 
				-		Generates the Frenet Frames. Used in geometries like [page:TubeGeometry] or [page:ExtrudeGeometry].
			
 
				+		Generates the Frenet Frames. Requires a curve definition in 3D space. Used in geometries like [page:TubeGeometry] or [page:ExtrudeGeometry].
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Curve clone]()</h3>
			
--- a/docs/api/zh/extras/core/Interpolations.html
+++ b/docs/api/zh/extras/core/Interpolations.html
@@ -11,7 +11,7 @@
 
				 		<h1>插值（[name]）</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			[name] contains spline and Bézier functions internally used by concrete curve classes.
			
 
				+			[name] 包含了由具体的曲线类在内部使用的样条曲线和贝塞尔曲线函数。
			
 
				 		</p>
			
 
				 
			
 
				 		<h2>方法</h2>
			
--- a/docs/api/zh/extras/curves/ArcCurve.html
+++ b/docs/api/zh/extras/curves/ArcCurve.html
@@ -12,7 +12,7 @@
 
				 
			
 
				 		<h1>弧线（[name]）</h1>
			
 
				 
			
 
				-		<p class="desc">[page:EllipseCurve]的别名</p>
			
 
				+		<p class="desc">[page:EllipseCurve]的别名。</p>
			
 
				 
			
 
				 		<h2>属性</h2>
			
 
				 		<p>共有属性请参见其基类[page:EllipseCurve]。</p>
			
--- a/docs/api/zh/extras/curves/CatmullRomCurve3.html
+++ b/docs/api/zh/extras/curves/CatmullRomCurve3.html
@@ -67,7 +67,7 @@
 
				 		<p>可能的值为*centripetal*、*chordal*和*catmullrom*。</p>
			
 
				 
			
 
				 		<h3>[property:float tension]</h3>
			
 
				-		<p>当[page:.type]为*catmullrom*时，定义catmullrom的张力。</p>
			
 
				+		<p>当[page:.curveType]为*catmullrom*时，定义catmullrom的张力。</p>
			
 
				 
			
 
				 
			
 
				 		<h2>方法</h2>
			
--- a/docs/api/zh/extras/curves/QuadraticBezierCurve.html
+++ b/docs/api/zh/extras/curves/QuadraticBezierCurve.html
@@ -10,7 +10,7 @@
 
				 	<body>
			
 
				 		[page:Curve] &rarr;
			
 
				 
			
 
				-		<h1>二维二次贝塞尔曲线（[name])</h1>
			
 
				+		<h1>二维二次贝塞尔曲线（[name]）</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				 			创建一条平滑的二维
			
--- a/docs/api/zh/geometries/ExtrudeBufferGeometry.html
+++ b/docs/api/zh/geometries/ExtrudeBufferGeometry.html
@@ -79,7 +79,7 @@
 
				 				<li>bevelSize — float。斜角与原始形状轮廓之间的延伸距离，默认值为bevelThickness-2。</li>
			
 
				 				<li>bevelOffset — float. Distance from the shape outline that the bevel starts. Default is 0.</li>
			
 
				 				<li>bevelSegments — int。斜角的分段层数，默认值为3。</li>
			
 
				-				<li>extrudePath — THREE.Curve对象。一条沿着被挤出形状的三维样条线。</li>
			
 
				+				<li>extrudePath — THREE.Curve对象。一条沿着被挤出形状的三维样条线。Bevels not supported for path extrusion.</li>
			
 
				 				<li>UVGenerator —  Object。提供了UV生成器函数的对象。</li>
			
 
				 			</ul>
			
 
				 
			
--- a/docs/api/zh/geometries/ExtrudeGeometry.html
+++ b/docs/api/zh/geometries/ExtrudeGeometry.html
@@ -78,7 +78,7 @@
 
				 				<li>bevelSize — float。斜角与原始形状轮廓之间的延伸距离，默认值为bevelThickness-2。</li>
			
 
				 				<li>bevelOffset — float. Distance from the shape outline that the bevel starts. Default is 0.</li>
			
 
				 				<li>bevelSegments — int。斜角的分段层数，默认值为3。</li>
			
 
				-				<li>extrudePath — THREE.Curve对象。一条沿着被挤出形状的三维样条线。</li>
			
 
				+				<li>extrudePath — THREE.Curve对象。一条沿着被挤出形状的三维样条线。Bevels not supported for path extrusion.</li>
			
 
				 				<li>UVGenerator —  Object。提供了UV生成器函数的对象。</li>
			
 
				 			</ul>
			
 
				 
			
--- a/docs/api/zh/geometries/TubeBufferGeometry.html
+++ b/docs/api/zh/geometries/TubeBufferGeometry.html
@@ -68,7 +68,7 @@
 
				 
			
 
				 		<h3>[name]([param:Curve path], [param:Integer tubularSegments], [param:Float radius], [param:Integer radialSegments], [param:Boolean closed])</h3>
			
 
				 		<p>
			
 
				-				path — [page:Curve] - 一个由基类[page:Curve]继承而来的路径。<br />
			
 
				+				path — [page:Curve] - 一个由基类[page:Curve]继承而来的3D路径。<br />
			
 
				 				tubularSegments — [page:Integer] - 组成这一管道的分段数，默认值为64。<br />
			
 
				 				radius — [page:Float] - 管道的半径，默认值为1。<br />
			
 
				 				radialSegments — [page:Integer] - 管道横截面的分段数目，默认值为8。<br />
			
--- a/docs/api/zh/geometries/TubeGeometry.html
+++ b/docs/api/zh/geometries/TubeGeometry.html
@@ -68,7 +68,7 @@
 
				 
			
 
				 		<h3>[name]([param:Curve path], [param:Integer tubularSegments], [param:Float radius], [param:Integer radialSegments], [param:Boolean closed])</h3>
			
 
				 		<p>
			
 
				-		path — [page:Curve] - 一个由基类[page:Curve]继承而来的路径。<br />
			
 
				+		path — [page:Curve] - 一个由基类[page:Curve]继承而来的3D路径。<br />
			
 
				 		tubularSegments — [page:Integer] - 组成这一管道的分段数，默认值为64。<br />
			
 
				 		radius — [page:Float] - 管道的半径，默认值为1。<br />
			
 
				 		radialSegments — [page:Integer] - 管道横截面的分段数目，默认值为8。<br />
			
--- a/docs/api/zh/helpers/ArrowHelper.html
+++ b/docs/api/zh/helpers/ArrowHelper.html
@@ -46,7 +46,7 @@
 
				 		[page:Number length] -- 箭头的长度. 默认为 *1*.<br />
			
 
				 		[page:Number hex] -- 定义的16进制颜色值. 默认为 0xffff00.<br />
			
 
				 		[page:Number headLength] -- 箭头头部(锥体)的长度. 默认为箭头长度的0.2倍(0.2 * length).<br />
			
 
				-		[page:Number headWidth] -- The width of the head of the arrow. Default is 0.2 * headLength.
			
 
				+		[page:Number headWidth] -- The width of the head of the arrow. Default is 0.2 * headLength.<br />
			
 
				 		</p>
			
 
				 
			
 
				 		<h2>属性</h2>
			
--- a/docs/api/zh/lights/AmbientLightProbe.html
+++ b/docs/api/zh/lights/AmbientLightProbe.html
@@ -10,33 +10,33 @@
 
				 	<body>
			
 
				 		[page:Object3D] &rarr; [page:Light] &rarr; [page:LightProbe]
			
 
				 
			
 
				-		<h1>[name]</h1>
			
 
				+		<h1>环境光探针（[name]）</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			Light probes are an alternative way of adding light to a 3D scene. AmbientLightProbe is the light estimation data 
			
 
				-			of a single ambient light in the scene. For more information about light probes, go to [page:LightProbe].
			
 
				+			光照探针是一种在3D场景中添加光源的另一种方法。 AmbientLightProbe 是场景中单个环境光的光照估算数据。
			
 
				+			有关光照探针的更多信息，请转到 [page:LightProbe] 。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Constructor</h2>
			
 
				+		<h2>构造函数</h2>
			
 
				 
			
 
				 		<h3>[name]( [param:Color color], [param:Float intensity] )</h3>
			
 
				 		<p>
			
 
				-		[page:Color color] - (optional) An instance of Color, string representing a color or a number representing a color.<br />
			
 
				-		[page:Float intensity] - (optional) Numeric value of the light probe's intensity. Default is 1.<br /><br />
			
 
				+		[page:Color color] - （可选）一个表示颜色的 Color 的实例、字符串或数字。<br />
			
 
				+		[page:Float intensity] - （可选）光照探针强度的数值。默认值为1。<br /><br />
			
 
				 
			
 
				-		Creates a new [name].
			
 
				+		创建一个新的[name]。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Properties</h2>
			
 
				+		<h2>属性</h2>
			
 
				 		<p>
			
 
				 				See the base [page:LightProbe LightProbe] class for common properties.
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				+		<h2>方法</h2>
			
 
				 		<p>
			
 
				 				See the base [page:LightProbe LightProbe] class for common methods.
			
 
				 		</p>
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/lights/HemisphereLightProbe.html
+++ b/docs/api/zh/lights/HemisphereLightProbe.html
@@ -10,34 +10,34 @@
 
				 	<body>
			
 
				 		[page:Object3D] &rarr; [page:Light] &rarr; [page:LightProbe]
			
 
				 
			
 
				-		<h1>[name]</h1>
			
 
				+		<h1>半球光探针[name]</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			Light probes are an alternative way of adding light to a 3D scene. HemisphereLightProbe is the light estimation data 
			
 
				-			of a single hemisphere light in the scene. For more information about light probes, go to [page:LightProbe].
			
 
				+			光照探针是一种在3D场景中添加光源的另一种方法。 HemisphereLightProbe 是场景中单个半球光的光照估算数据。
			
 
				+			有关光照探针的更多信息，请转到 [page:LightProbe] 。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Constructor</h2>
			
 
				+		<h2>构造函数</h2>
			
 
				 
			
 
				 		<h3>[name]( [param:Color skyColor], [param:Color groundColor], [param:Float intensity] )</h3>
			
 
				 		<p>
			
 
				-			[page:Color skyColor] - (optional) An instance of Color, string representing a color or a number representing a color.<br />
			
 
				-			[page:Color groundColor] - (optional) An instance of Color, string representing a color or a number representing a color.<br />
			
 
				-			[page:Float intensity] - (optional) Numeric value of the light probe's intensity. Default is 1.<br /><br />
			
 
				+			[page:Color skyColor] - （可选）一个表示颜色的 Color 的实例、字符串或数字。<br />
			
 
				+			[page:Color groundColor] - （可选）一个表示颜色的 Color 的实例、字符串或数字。<br />
			
 
				+			[page:Float intensity] - （可选）光照探针强度的数值。默认值为1。<br /><br />
			
 
				 
			
 
				-			Creates a new [name].
			
 
				+			创建一个新的 [name]。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Properties</h2>
			
 
				+		<h2>属性</h2>
			
 
				 		<p>
			
 
				 				See the base [page:LightProbe LightProbe] class for common properties.
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				+		<h2>方法</h2>
			
 
				 		<p>
			
 
				 				See the base [page:LightProbe LightProbe] class for common methods.
			
 
				 		</p>
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/lights/LightProbe.html
+++ b/docs/api/zh/lights/LightProbe.html
@@ -10,58 +10,58 @@
 
				 	<body>
			
 
				 		[page:Object3D] &rarr; [page:Light] &rarr;
			
 
				 
			
 
				-		<h1>[name]</h1>
			
 
				+		<h1>光照探针[name]</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			Light probes are an alternative way of adding light to a 3D scene. Unlike classical light sources (e.g. directional,
			
 
				-			point or spot lights), light probes do not emit light. Instead they store information about light passing through
			
 
				-			3D space. During rendering, the light that hits a 3D object is approximated by using the data from the light probe.
			
 
				+			光照探针是一种在3D场景中添加光源的另一种方法。与经典光源（平行光、点光、聚光）不同，
			
 
				+			光照探针不发光。相反，光照探针存储着有关穿过3D空间的光线的信息。
			
 
				+			渲染过程中，通过使用来自光照探针的数据，来逼近打到3D物体上的光线。
			
 
				 		</p>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			Light probes are usually created from (radiance) environment maps. The class [page:LightProbeGenerator] can
			
 
				-			be used to create light probes from instances of [page:CubeTexture] or [page:WebGLCubeRenderTarget].
			
 
				-			However, light estimation data could also be provided in other forms e.g. by WebXR. This enables the rendering
			
 
				-			of augmented reality content that reacts to real world lighting.
			
 
				+			光照探针通常从（辐射）环境贴图中创建。 [page:LightProbeGenerator] 类可以根据 [page:CubeTexture] 或
			
 
				+			[page:WebGLCubeRenderTarget] 的实例来创建光照探针。
			
 
				+			但是，光照估算数据同样可以以其他形式提供，例如，通过WebXR。
			
 
				+			这将能够渲染可对真实世界的光照做出反应的增强现实内容。
			
 
				 		</p>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			The current probe implementation in three.js supports so-called diffuse light probes. This type of light probe
			
 
				-			is functionally equivalent to an irradiance environment map.
			
 
				+			three.js中，当前的探针实现支持所谓的漫反射光照探针。
			
 
				+			这种类型的光照探针功能上等效于辐照环境贴图。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Examples</h2>
			
 
				+		<h2>例子</h2>
			
 
				 		<p>
			
 
				 			[example:webgl_lightprobe WebGL / light probe ]<br />
			
 
				 			[example:webgl_lightprobe_cubecamera WebGL / light probe / cube camera ]
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Constructor</h2>
			
 
				+		<h2>构造函数</h2>
			
 
				 
			
 
				 		<h3>[name]( [param:SphericalHarmonics3 sh], [param:Float intensity] )</h3>
			
 
				 		<p>
			
 
				-		[page:SphericalHarmonics3 sh] - (optional) An instance of [page:SphericalHarmonics3].<br />
			
 
				-		[page:Float intensity] - (optional) Numeric value of the light probe's intensity. Default is 1.<br /><br />
			
 
				+		[page:SphericalHarmonics3 sh] - （可选）一个[page:SphericalHarmonics3]的实例。<br />
			
 
				+		[page:Float intensity] - （可选）光照探针强度的数值。默认值为1。<br /><br />
			
 
				 
			
 
				-		Creates a new [name].
			
 
				+		创建一个新的 [name] 。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Properties</h2>
			
 
				+		<h2>属性</h2>
			
 
				 		<p>
			
 
				-				See the base [page:Light Light] class for common properties. The [page:Light.color color] property is currently
			
 
				-				not evaluated and thus has no effect.
			
 
				+				See the base [page:Light Light] class for common properties. 
			
 
				+				[page:Light.color color] 属性当前未做评估，因此不生效。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:SphericalHarmonics3 sh]</h3>
			
 
				 		<p>
			
 
				-			A light probe uses spherical harmonics to encode lighting information.
			
 
				+			光照探针使用球面谐波（spherical harmonic）来编码光照信息。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				+		<h2>方法</h2>
			
 
				 		<p>
			
 
				 				See the base [page:Light Light] class for common methods.
			
 
				 		</p>
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/lights/PointLight.html
+++ b/docs/api/zh/lights/PointLight.html
@@ -76,7 +76,7 @@
 
				 			表示以"流明（光通量单位）"为单位的光功率。 缺省值 - *4Math.PI*。 <br /><br />
			
 
				 
			
 
				 			该值与 [page:.intensity intensity] 直接关联
			
 
				-  			<code>
			
 
				+			<code>
			
 
				 				power = intensity * 4&pi;
			
 
				 			</code>
			
 
				 			修改该值也会导致光强度的改变。
			
@@ -86,8 +86,8 @@
 
				 		<p>
			
 
				 			[page:PointLightShadow]用与计算此光照的阴影。<br /><br />
			
 
				 
			
 
				-			此对象的摄像机被设置为 [page:PerspectiveCamera.fov fov] 为90度，[page:PerspectiveCamera.aspect aspect]为1
			
 
				-			,近裁剪面  [page:PerspectiveCamera.near near] 为0，远裁剪面[page:PerspectiveCamera.far far]
			
 
				+			此对象的摄像机被设置为 [page:PerspectiveCamera.fov fov] 为90度，[page:PerspectiveCamera.aspect aspect]为1，
			
 
				+			近裁剪面 [page:PerspectiveCamera.near near] 为0，远裁剪面[page:PerspectiveCamera.far far]
			
 
				 			为500的透视摄像机 [page:PerspectiveCamera]。
			
 
				 		</p>
			
 
				 
			
--- a/docs/api/zh/lights/shadows/SpotLightShadow.html
+++ b/docs/api/zh/lights/shadows/SpotLightShadow.html
@@ -32,8 +32,9 @@
 
				 		//Set up shadow properties for the light
			
 
				 		light.shadow.mapSize.width = 512;  // default
			
 
				 		light.shadow.mapSize.height = 512; // default
			
 
				-		light.shadow.camera.near = 0.5;       // default
			
 
				+		light.shadow.camera.near = 0.5;    // default
			
 
				 		light.shadow.camera.far = 500      // default
			
 
				+		light.shadow.focus = 1;            // default
			
 
				 
			
 
				 		//Create a sphere that cast shadows (but does not receive them)
			
 
				 		var sphereGeometry = new THREE.SphereBufferGeometry( 5, 32, 32 );
			
@@ -61,20 +62,21 @@
 
				 		<h2>属性</h2>
			
 
				 		<p>有关常用属性，请参阅基础LightShadow类。</p>
			
 
				 
			
 
				-	 <h3>[property:Camera camera]</h3>
			
 
				-	 <p>
			
 
				-		 在光的世界里。这用于生成场景的深度图;从光的角度来看，其他物体背后的物体将处于阴影中。<br /><br />
			
 
				+		<h3>[property:Camera camera]</h3>
			
 
				+		<p>
			
 
				+			在光的世界里。这用于生成场景的深度图;从光的角度来看，其他物体背后的物体将处于阴影中。<br /><br />
			
 
				 
			
 
				-		 默认值为PerspectiveCamera，近剪裁平面为0.5。 fov将通过更新方法跟踪拥有SpotLight的角度属性。同样，aspect属性将跟踪mapSize的方面。如果设置了灯光的距离属性，则远剪裁平面将跟踪该值，否则默认为500。
			
 
				-	 </p>
			
 
				+			默认值为PerspectiveCamera，近剪裁平面为0.5。 fov将通过更新方法跟踪拥有SpotLight的角度属性。同样，aspect属性将跟踪mapSize的方面。如果设置了灯光的距离属性，则远剪裁平面将跟踪该值，否则默认为500。
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[property:Number focus]</h3>
			
 
				+		<p>
			
 
				+			Used to focus the shadow camera. The camera's field of view is set as a percentage of the spotlight's field-of-view. Range is [0, 1]. Default is 1.0.<br/>
			
 
				+		</p>
			
 
				 
			
 
				 		<h2>方法</h2>
			
 
				 		<p>有关常用方法，请参阅基础LightShadow类。</p>
			
 
				 
			
 
				-		<h3>[method:SpotLightShadow update]( [param:SpotLight light] )</h3>
			
 
				-		<p>
			
 
				-			根据传入的[page:SpotLight light]更新内部透视[page:.camera camera]。
			
 
				-		</p>
			
 
				 
			
 
				 		<h2>Source</h2>
			
 
				 
			
--- a/docs/api/zh/loaders/CubeTextureLoader.html
+++ b/docs/api/zh/loaders/CubeTextureLoader.html
@@ -40,7 +40,6 @@ scene.background = new THREE.CubeTextureLoader()
 
				 			[example:webgl_materials_cubemap_balls_reflection materials / cubemap / balls / reflection]<br />
			
 
				 			[example:webgl_materials_cubemap_balls_refraction materials / cubemap / balls / refraction]<br />
			
 
				 			[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic]<br />
			
 
				-			[example:webgl_materials_cubemap_dynamic2 materials / cubemap / dynamic2]<br />
			
 
				 			[example:webgl_materials_cubemap_refraction materials / cubemap / refraction]
			
 
				 		</p>
			
 
				 
			
--- a/docs/api/zh/loaders/FileLoader.html
+++ b/docs/api/zh/loaders/FileLoader.html
@@ -69,9 +69,6 @@
 
				 			请参考 [page:.setMimeType]。默认为 *undefined*。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[property:object requestHeader]</h3>
			
 
				-		<p>[link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header] 在HTTP 请求中使用。 请参考 [page:.setRequestHeader]。 默认为 *undefined*.</p>
			
 
				-
			
 
				 		<h3>[property:String responseType]</h3>
			
 
				 		<p>请求的响应类型。 请参考 [page:.setResponseType]. 默认为 *undefined*.</p>
			
 
				 
			
--- a/docs/api/zh/loaders/Loader.html
+++ b/docs/api/zh/loaders/Loader.html
@@ -18,10 +18,10 @@
 
				 
			
 
				 		<h3>[name]( [param:LoadingManager manager] )</h3>
			
 
				 		<p>
			
 
				-			[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use. Default is [page:LoadingManager THREE.DefaultLoadingManager].
			
 
				+			[page:LoadingManager manager] — 加载器将要使用的 [page:LoadingManager loadingManager]。默认为 [page:LoadingManager THREE.DefaultLoadingManager]。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			Creates a new [name].
			
 
				+			创建一个新的[name]。
			
 
				 		</p>
			
 
				 
			
 
				 
			
@@ -29,67 +29,79 @@
 
				 
			
 
				 		<h3>[property:string crossOrigin]</h3>
			
 
				 		<p>
			
 
				-		The crossOrigin string to implement CORS for loading the url from a different domain that allows CORS.
			
 
				-		Default is *anonymous*.
			
 
				+		crossOrigin 字符串用于实现 CORS ，以从允许 CORS 的其他域加载url。
			
 
				+		默认为*anonymous*。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:LoadingManager manager]</h3>
			
 
				 		<p>
			
 
				-			The [page:LoadingManager loadingManager]  the loader is using. Default is [page:DefaultLoadingManager].
			
 
				+			加载器要使用的 [page:LoadingManager loadingManager] 。默认为 [page:DefaultLoadingManager] 。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:String path]</h3>
			
 
				 		<p>
			
 
				-			The base path from which the asset will be loaded.
			
 
				-			Default is the empty string.
			
 
				+			将从中加载资产的基本路径。
			
 
				+			默认为空字符串。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:String resourcePath]</h3>
			
 
				 		<p>
			
 
				-			The base path from which additional resources like textures will be loaded.
			
 
				-			Default is the empty string.
			
 
				+			将从中加载额外资源（例如纹理贴图）的基本路径。
			
 
				+			默认为空字符串。
			
 
				 		</p>
			
 
				 
			
 
				+		<h3>[property:object requestHeader]</h3>
			
 
				+		<p>
			
 
				+			[link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header] 在 HTTP 请求中使用。 请参考 [page:.setRequestHeader]。 默认为 *undefined*。
			
 
				+		</p>	
			
 
				+
			
 
				 		<h2>方法</h2>
			
 
				 
			
 
				 		<h3>[method:void load]()</h3>
			
 
				 		<p>
			
 
				-			This method needs to be implement by all concrete loaders. It holds the logic for loading the asset from the backend.
			
 
				+			该方法需要被所有具体的加载器来实现。它包含了从后端加载资产的逻辑。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Promise loadAsync]( [param:String url], [param:Function onProgress] )</h3>
			
 
				 		<p>
			
 
				-		[page:String url] — A string containing the path/URL of the file to be loaded.<br />
			
 
				-		[page:Function onProgress] — (optional) A function to be called while the loading is in progress. The argument will be the XMLHttpRequest instance, that contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
			
 
				+		[page:String url] — 一个字符串，包含要加载的文件的路径/URL。<br />
			
 
				+		[page:Function onProgress] — （可选）加载过程中将会被调用的函数。参数将是一个XMLHttpRequest实例，其包含了 .[page:Integer total] （总）字节数和 .[page:Integer loaded] （已加载）字节数。<br />
			
 
				 		</p>
			
 
				 		<p>
			
 
				-		This method is equivalent to [page:.load], but returns a [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise Promise].
			
 
				+		该函数等效于[page:.load]，但返回的是一个 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise Promise]。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-		[page:Function onLoad] is handled by [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve Promise.resolve] and [page:Function onError] is handled by [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/reject Promise.reject].
			
 
				+		[page:Function onLoad] 由 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve Promise.resolve] 处理，而 [page:Function onError] 则由 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/reject Promise.reject] 处理。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:void parse]()</h3>
			
 
				 		<p>
			
 
				-			This method needs to be implement by all concrete loaders. It holds the logic for parsing the asset into three.js entities.
			
 
				+			该方法需要被所有具体的加载器来实现。它包含了解析资产到 three.js 实体的逻辑。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Loader setCrossOrigin]( [param:String crossOrigin] )</h3>
			
 
				 		<p>
			
 
				-			[page:String crossOrigin] — The crossOrigin string to implement CORS for loading the url from a different domain that allows CORS.
			
 
				+			[page:String crossOrigin] — crossOrigin字符串用于实现CORS，以从允许CORS的其它域加载url。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Loader setPath]( [param:String path] )</h3>
			
 
				 		<p>
			
 
				-			[page:String path] — Set the base path for the asset.
			
 
				+			[page:String path] — 设置资产的基本路径。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Loader setResourcePath]( [param:String resourcePath] )</h3>
			
 
				 		<p>
			
 
				-			[page:String resourcePath] — Set the base path for dependent resources like textures.
			
 
				+			[page:String resourcePath] — 设置独立资源（如纹理贴图）的基本路径。
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:Loader setRequestHeader]( [param:Object requestHeader] )</h3>
			
 
				+		<p>
			
 
				+			[page:object requestHeader] - key: 要设置header的名称。 value：要设置header的值。<br /><br />
			
 
				+
			
 
				+			设置在 HTTP 请求中使用的 [link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header]（请求头）。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/loaders/managers/LoadingManager.html
+++ b/docs/api/zh/loaders/managers/LoadingManager.html
@@ -11,8 +11,7 @@
 
				 		<h1>[name]</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-
			
 
				-			其功能时处理并跟踪已加载和待处理的数据。如果未手动设置加强管理器，则会为加载器创建和使用默认全局实例加载器管理器
			
 
				+			其功能是处理并跟踪已加载和待处理的数据。如果未手动设置加强管理器，则会为加载器创建和使用默认全局实例加载器管理器
			
 
				 			- 请参阅 [page:DefaultLoadingManager].<br /><br />
			
 
				 
			
 
				 			一般来说，默认的加载管理器已足够使用了，但有时候也需要设置单独的加载器 - 例如，如果你想为对象和纹理显示单独的加载条。
			
@@ -120,38 +119,38 @@
 
				 
			
 
				 		<h3>[property:Function onStart]</h3>
			
 
				 		<p>
			
 
				-			此换上咋加载开始时，被调用.
			
 
				-			有如下参数:<br />
			
 
				+			此函数在加载开始时被调用。
			
 
				+			有如下参数：<br />
			
 
				 			[page:String url] — 被加载的项的url。<br />
			
 
				 			[page:Integer itemsLoaded] — 目前已加载项的个数。<br />
			
 
				 			[page:Iteger itemsTotal] — 总共所需要加载项的个数。<br /><br />
			
 
				 
			
 
				-			此方法默认时未定义。
			
 
				+			该函数默认为undefined。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Function onLoad]</h3>
			
 
				 		<p>
			
 
				-			所有的项加载完成后将调用此函数。默认情况下，此方法时未定义的，除非在构造函数中进行传递。
			
 
				+			所有的项目加载完成后将调用此函数。默认情况下，该函数是未定义的，除非在构造函数中传入。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Function onProgress]</h3>
			
 
				 		<p>
			
 
				 			此方法加载每一个项，加载完成时进行调用。
			
 
				-			有如下参数:<br />
			
 
				+			有如下参数：<br />
			
 
				 		[page:String url] — 被加载的项的url。<br />
			
 
				 		[page:Integer itemsLoaded] — 目前已加载项的个数。<br />
			
 
				 		[page:Iteger itemsTotal] — 总共所需要加载项的个数。<br /><br />
			
 
				 
			
 
				-			默认情况下，此方法时未定义的，除非在构造函数中进行传递。
			
 
				+			默认情况下，该函数为undefined，除非在构造函数中传入。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Function onError]</h3>
			
 
				 		<p>
			
 
				 			此方法将在任意项加载错误时，进行调用。
			
 
				-			有如下参数:<br />
			
 
				-			[page:String url] — 所加载出错误的项的url<br /><br />
			
 
				+			有如下参数：<br />
			
 
				+			[page:String url] — 加载发生错误的项目的url<br /><br />
			
 
				 
			
 
				-			默认情况下，此方法时未定义的，除非在构造函数中进行传递。
			
 
				+			默认情况下，该函数为undefined，除非在构造函数中传入。
			
 
				 		</p>
			
 
				 
			
 
				 
			
--- a/docs/api/zh/materials/Material.html
+++ b/docs/api/zh/materials/Material.html
@@ -105,7 +105,8 @@
 
				 
			
 
				 <h3>[property:Boolean stencilWrite]</h3>
			
 
				 <p>
			
 
				-Whether stencil operations are performed against the stencil buffer. In order to perform writes or comparisons against the stencil buffer this value must be *true*. Default is *false*.</p>
			
 
				+Whether stencil operations are performed against the stencil buffer. In order to perform writes or comparisons against the stencil buffer this value must be *true*. Default is *false*.
			
 
				+</p>
			
 
				 
			
 
				 <h3>[property:Integer stencilWriteMask]</h3>
			
 
				 <p>
			
@@ -286,6 +287,36 @@ Defines whether vertex coloring is used. Default is *false*.
 
				 Unlike properties, the callback is not supported by [page:Material.clone .clone](), [page:Material.copy .copy]() and [page:Material.toJSON .toJSON]().
			
 
				 </p>
			
 
				 
			
 
				+<h3>[method:String customProgramCacheKey]()</h3>
			
 
				+<p>
			
 
				+In case onBeforeCompile is used, this callback can be used to identify values of settings used in onBeforeCompile, so three.js can reuse a cached shader or recompile the shader for this material as needed.
			
 
				+</p>
			
 
				+
			
 
				+<p>
			
 
				+For example, if onBeforeCompile contains a conditional statement like:<br />
			
 
				+
			
 
				+<code>if ( black ) {
			
 
				+
			
 
				+	shader.fragmentShader = shader.fragmentShader.replace('gl_FragColor = vec4(1)', 'gl_FragColor = vec4(0)')
			
 
				+
			
 
				+}
			
 
				+</code>
			
 
				+
			
 
				+then customProgramCacheKey should be set like this:<br />
			
 
				+
			
 
				+<code>material.customProgramCacheKey = function() {
			
 
				+
			
 
				+	return black ? '1' : '0';
			
 
				+
			
 
				+}
			
 
				+</code>
			
 
				+
			
 
				+</p>
			
 
				+
			
 
				+<p>
			
 
				+Unlike properties, the callback is not supported by [page:Material.clone .clone](), [page:Material.copy .copy]() and [page:Material.toJSON .toJSON]().
			
 
				+</p>
			
 
				+
			
 
				 <h3>[method:null setValues]( [param:object values] )</h3>
			
 
				 <p> values -- 具有参数的容器。
			
 
				 	根据*values*设置属性。<br/>
			
--- a/docs/api/zh/materials/MeshBasicMaterial.html
+++ b/docs/api/zh/materials/MeshBasicMaterial.html
@@ -57,7 +57,7 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Texture aoMap]</h3>
			
 
				-		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]属性。</p>
			
 
				+		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float aoMapIntensity]</h3>
			
 
				 		<p>环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
			
@@ -75,7 +75,7 @@
 
				 		<p>环境贴图。默认值为null。</p>
			
 
				 
			
 
				 		<h3>[property:Texture lightMap]</h3>
			
 
				-		<p>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
			
 
				+		<p>光照贴图。默认值为null。lightMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float lightMapIntensity]</h3>
			
 
				 		<p>烘焙光的强度。默认值为1。</p>
			
--- a/docs/api/zh/materials/MeshLambertMaterial.html
+++ b/docs/api/zh/materials/MeshLambertMaterial.html
@@ -63,7 +63,7 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Texture aoMap]</h3>
			
 
				-		<p> 该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
			
 
				+		<p> 该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float aoMapIntensity]</h3>
			
 
				 		<p> 环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
			
@@ -94,7 +94,7 @@
 
				 		<p> 环境贴图。默认值为null。</p>
			
 
				 
			
 
				 		<h3>[property:Texture lightMap]</h3>
			
 
				-		<p>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
			
 
				+		<p>光照贴图。默认值为null。lightMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float lightMapIntensity]</h3>
			
 
				 		<p>烘焙光的强度。默认值为1。</p>
			
--- a/docs/api/zh/materials/MeshMatcapMaterial.html
+++ b/docs/api/zh/materials/MeshMatcapMaterial.html
@@ -96,6 +96,8 @@
 
				 
			
 
				 		<h3>[property:Texture normalMap]</h3>
			
 
				 		<p> 用于创建法线贴图的纹理。RGB值会影响每个像素片段的曲面法线，并更改颜色照亮的方式。法线贴图不会改变曲面的实际形状，只会改变光照。
			
 
				+			In case the material has a normal map authored using the left handed convention, the y component of normalScale
			
 
				+			should be negated to compensate for the different handedness.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer normalMapType]</h3>
			
--- a/docs/api/zh/materials/MeshNormalMaterial.html
+++ b/docs/api/zh/materials/MeshNormalMaterial.html
@@ -75,6 +75,8 @@
 
				 
			
 
				 		<h3>[property:Texture normalMap]</h3>
			
 
				 		<p> 用于创建法线贴图的纹理。RGB值会影响每个像素片段的曲面法线，并更改颜色照亮的方式。法线贴图不会改变曲面的实际形状，只会改变光照。
			
 
				+			In case the material has a normal map authored using the left handed convention, the y component of normalScale
			
 
				+			should be negated to compensate for the different handedness.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer normalMapType]</h3>
			
--- a/docs/api/zh/materials/MeshPhongMaterial.html
+++ b/docs/api/zh/materials/MeshPhongMaterial.html
@@ -61,7 +61,7 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Texture aoMap]</h3>
			
 
				-		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]属性。</p>
			
 
				+		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float aoMapIntensity]</h3>
			
 
				 		<p>环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
			
@@ -115,7 +115,7 @@
 
				 
			
 
				 
			
 
				 		<h3>[property:Texture lightMap]</h3>
			
 
				-		<p>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
			
 
				+		<p>光照贴图。默认值为null。lightMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float lightMapIntensity]</h3>
			
 
				 		<p>烘焙光的强度。默认值为1。</p>
			
@@ -132,6 +132,8 @@
 
				 
			
 
				 		<h3>[property:Texture normalMap]</h3>
			
 
				 		<p> 用于创建法线贴图的纹理。RGB值会影响每个像素片段的曲面法线，并更改颜色照亮的方式。法线贴图不会改变曲面的实际形状，只会改变光照。
			
 
				+			In case the material has a normal map authored using the left handed convention, the y component of normalScale
			
 
				+			should be negated to compensate for the different handedness.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer normalMapType]</h3>
			
--- a/docs/api/zh/materials/MeshStandardMaterial.html
+++ b/docs/api/zh/materials/MeshStandardMaterial.html
@@ -82,7 +82,7 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Texture aoMap]</h3>
			
 
				-		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]属性。</p>
			
 
				+		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float aoMapIntensity]</h3>
			
 
				 		<p>环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
			
@@ -140,7 +140,7 @@
 
				 			请确保将minFilter设置为其中一个MipMap选项，并且未强制禁用mip贴图。</p>
			
 
				 		<p>
			
 
				 			注意：MeshStandardMaterial 仅支持[link:https://threejs.org/docs/#api/textures/CubeTexture cube environment maps]。
			
 
				-			如果要使用equirectangular贴图，则需要使用 [page:WebGLCubeRenderTarget.fromEquirectangularTexture WebGLCubeRenderTarget.fromEquirectangularTexture]().。
			
 
				+			如果要使用equirectangular贴图，则需要使用 [page:WebGLCubeRenderTarget.fromEquirectangularTexture WebGLCubeRenderTarget.fromEquirectangularTexture]()。
			
 
				 			详细信息请参阅此示例[link:https://threejs.org/examples/webgl_materials_envmaps_exr.html example]。
			
 
				 		</p>
			
 
				 
			
@@ -149,7 +149,7 @@
 
				 
			
 
				 
			
 
				 		<h3>[property:Texture lightMap]</h3>
			
 
				-		<p>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
			
 
				+		<p>光照贴图。默认值为null。lightMap需要第二组UV。</p>
			
 
				 
			
 
				 		<h3>[property:Float lightMapIntensity]</h3>
			
 
				 		<p>烘焙光的强度。默认值为1。</p>
			
@@ -174,6 +174,8 @@
 
				 
			
 
				 		<h3>[property:Texture normalMap]</h3>
			
 
				 		<p>用于创建法线贴图的纹理。RGB值会影响每个像素片段的曲面法线，并更改颜色照亮的方式。法线贴图不会改变曲面的实际形状，只会改变光照。
			
 
				+			In case the material has a normal map authored using the left handed convention, the y component of normalScale
			
 
				+			should be negated to compensate for the different handedness.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer normalMapType]</h3>
			
@@ -204,11 +206,13 @@
 
				 		<p>材质是否使用蒙皮。默认值为false。</p>
			
 
				 
			
 
				 		<h3>[property:Boolean vertexTangents]</h3>
			
 
				-		<p>	Defines whether precomputed vertex tangents, which must be provided in a vec4 "tangent" attribute,
			
 
				-			are used. When disabled, tangents are derived automatically. Using precomputed tangents will give
			
 
				-			more accurate normal map details in some cases, such as with mirrored UVs. Default is false.
			
 
				+		<p>
			
 
				+		Defines whether precomputed vertex tangents, which must be provided in a vec4 "tangent" attribute,
			
 
				+		are used. When disabled, tangents are derived automatically. Using precomputed tangents will give
			
 
				+		more accurate normal map details in some cases, such as with mirrored UVs. Default is false.
			
 
				 		</p>
			
 
				 
			
 
				+
			
 
				 		<h3>[property:Boolean wireframe]</h3>
			
 
				 		<p>将几何体渲染为线框。默认值为*false*（即渲染为平面多边形）。</p>
			
 
				 
			
--- a/docs/api/zh/materials/MeshToonMaterial.html
+++ b/docs/api/zh/materials/MeshToonMaterial.html
@@ -64,8 +64,7 @@
 
				 
			
 
				 		<h3>[property:Texture aoMap]</h3>
			
 
				 		<p>The red channel of this texture is used as the ambient occlusion map. Default is null.
			
 
				-		The aoMap requires a second set of UVs, and consequently will ignore the [page:Texture repeat]
			
 
				-		and [page:Texture offset] Texture properties.</p>
			
 
				+		The aoMap requires a second set of UVs.</p>
			
 
				 
			
 
				 		<h3>[property:Float aoMapIntensity]</h3>
			
 
				 		<p>Intensity of the ambient occlusion effect. Default is 1. Zero is no occlusion effect.</p>
			
@@ -127,9 +126,7 @@
 
				 			[page:Textures THREE.NearestFilter] when using this type of texture. Default is *null*.</p>
			
 
				 
			
 
				 		<h3>[property:Texture lightMap]</h3>
			
 
				-		<p>The light map. Default is null. The lightMap requires a second set of UVs,
			
 
				-		and consequently will ignore the [page:Texture repeat] and [page:Texture offset]
			
 
				-		Texture properties.</p>
			
 
				+		<p>The light map. Default is null. The lightMap requires a second set of UVs.</p>
			
 
				 
			
 
				 		<h3>[property:Float lightMapIntensity]</h3>
			
 
				 		<p>Intensity of the baked light. Default is 1.</p>
			
@@ -150,6 +147,8 @@
 
				 		<p>
			
 
				 			The texture to create a normal map. The RGB values affect the surface normal for each pixel fragment and change
			
 
				 			the way the color is lit. Normal maps do not change the actual shape of the surface, only the lighting.
			
 
				+			In case the material has a normal map authored using the left handed convention, the y component of normalScale
			
 
				+			should be negated to compensate for the different handedness.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Integer normalMapType]</h3>
			
--- a/docs/api/zh/materials/PointsMaterial.html
+++ b/docs/api/zh/materials/PointsMaterial.html
@@ -87,7 +87,8 @@
 
				 		<p>材质是否使用morphTargets。默认值为false。</p>
			
 
				 
			
 
				 		<h3>[property:Number size]</h3>
			
 
				-		<p>设置点的大小。默认值为1.0。</p>
			
 
				+		<p>设置点的大小。默认值为1.0。<br/>
			
 
				+			Will be capped if it exceeds the hardware dependent parameter [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/getParameter gl.ALIASED_POINT_SIZE_RANGE].</p>
			
 
				 
			
 
				 		<h3>[property:Boolean sizeAttenuation]</h3>
			
 
				 		<p>指定点的大小是否因相机深度而衰减。（仅限透视摄像头。）默认为true。 </p>
			
--- a/docs/api/zh/materials/ShaderMaterial.html
+++ b/docs/api/zh/materials/ShaderMaterial.html
@@ -44,7 +44,7 @@
 
				 						循环变量必须是*i*。
			
 
				 					</li>
			
 
				 					<li>
			
 
				-						循环必须使用某种空格格式。
			
 
				+						The value *UNROLLED_LOOP_INDEX* will be replaced with the explicity value of *i* for the given iteration and can be used in preprocessor statements.
			
 
				 					</li>
			
 
				 				</ul>
			
 
				 				<code>
			
--- a/docs/api/zh/materials/ShadowMaterial.html
+++ b/docs/api/zh/materials/ShadowMaterial.html
@@ -41,7 +41,7 @@
 
				 
			
 
				 		<h3>[name]( [param:Object parameters] )</h3>
			
 
				 		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
			
 
				-			材质的任何属性都可以从此处传入(包括从[page:Material]]继承的任何属性)。<br /><br />
			
 
				+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
			
 
				 		</p>
			
 
				 
			
 
				 
			
--- a/docs/api/zh/math/Box2.html
+++ b/docs/api/zh/math/Box2.html
@@ -11,7 +11,7 @@
 
				 		<h1>[name]</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			表示二维空间中的一个包围盒。
			
 
				+			表示二维空间中的一个轴对齐包围盒（axis-aligned bounding box，AABB）。
			
 
				 		</p>
			
 
				 
			
 
				 
			
@@ -151,10 +151,11 @@
 
				 
			
 
				 		<h3>[method:Box2 set]( [param:Vector2 min], [param:Vector2 max] )</h3>
			
 
				 		<p>
			
 
				-			[page:Vector2 min] - (必须 ) 表示该盒子的下边界(x, y)。 <br>
			
 
				+			[page:Vector2 min] - (必须) 表示该盒子的下边界(x, y)。 <br>
			
 
				 			[page:Vector2 max]  - (必须) 表示该盒子的上边界(x, y)。 <br /><br />
			
 
				 
			
 
				-			设置这个盒子的上下(x, y)的界限。
			
 
				+			设置这个盒子的上下(x, y)的界限。<br>
			
 
				+			Please note that this method only copies the values from the given objects.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Box2 setFromCenterAndSize]( [param:Vector2 center], [param:Vector2 size] )</h3>
			
--- a/docs/api/zh/math/Box3.html
+++ b/docs/api/zh/math/Box3.html
@@ -11,7 +11,7 @@
 
				 		<h1>[name]</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			在3D空间中表示一个盒子或立方体。其主要用于表示物体在世界坐标中的边界框。
			
 
				+			表示二维空间中的一个轴对齐包围盒（axis-aligned bounding box，AABB）。
			
 
				 		</p>
			
 
				 
			
 
				 		<h2>代码示例</h2>
			
@@ -66,7 +66,7 @@
 
				 
			
 
				 		<h2>方法（Methods）</h2>
			
 
				 
			
 
				-		<h3>[method:Box3 applyMatrix4]( [param:Matrix4 matrix] )</h3>
			
 
				+		<h3>[method:this applyMatrix4]( [param:Matrix4 matrix] )</h3>
			
 
				 		<p>
			
 
				 		[page:Matrix4 matrix] - 要应用的 [page:Matrix4] <br /><br />
			
 
				 
			
@@ -97,7 +97,7 @@
 
				 		当传入的值 [page:Vector3 point] 在包围盒内部或者边界都会返回true。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 copy]( [param:Box3 box] )</h3>
			
 
				+		<h3>[method:this copy]( [param:Box3 box] )</h3>
			
 
				 		<p>
			
 
				 		[page:Box3 box]  - 需要复制的包围盒 [page:Box3] 。<br /><br />
			
 
				 
			
@@ -119,29 +119,30 @@
 
				 		返回true如果传入的值与当前的对象 [page:Box3 box] 有相同的上下边界。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 expandByObject]( [param:Object3D object] )</h3>
			
 
				+		<h3>[method:this expandByObject]( [param:Object3D object] )</h3>
			
 
				 		<p>
			
 
				 		[page:Object3D object] - 包裹在包围盒中的3d对象 [page:Object3D]。<br /><br />
			
 
				 
			
 
				 		扩展此包围盒的边界，使得对象及其子对象在包围盒内，包括对象和子对象的世界坐标的变换。
			
 
				+		The function may result in a larger box than strictly necessary.
			
 
				 
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 expandByPoint]( [param:Vector3 point] )</h3>
			
 
				+		<h3>[method:this expandByPoint]( [param:Vector3 point] )</h3>
			
 
				 		<p>
			
 
				 		[page:Vector3 point] - 需要在包围盒中的点 [page:Vector3]。<br /><br />
			
 
				 
			
 
				 		扩展这个包围盒的边界使得该点（[page:Vector3 point]）在包围盒内。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 expandByScalar]( [param:float scalar] )</h3>
			
 
				+		<h3>[method:this expandByScalar]( [param:float scalar] )</h3>
			
 
				 		<p>
			
 
				 		[page:float scalar] - 扩展包围盒的比例。<br /><br />
			
 
				 
			
 
				 		按 [page:float scalar] 的值展开盒子的每个维度。如果是负数，盒子的尺寸会缩小。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 expandByVector]( [param:Vector3 vector] )</h3>
			
 
				+		<h3>[method:this expandByVector]( [param:Vector3 vector] )</h3>
			
 
				 		<p>
			
 
				 		[page:Vector3 vector] - 扩展包围盒的数值 [page:Vector3] 。<br /><br />
			
 
				 
			
@@ -181,12 +182,12 @@
 
				 		返回包围盒的宽度，高度，和深度。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 intersect]( [param:Box3 box] )</h3>
			
 
				+		<h3>[method:this intersect]( [param:Box3 box] )</h3>
			
 
				 		<p>
			
 
				 		[page:Box3 box] - 与包围盒的交集<br /><br />
			
 
				 
			
 
				-		返回此包围盒和 [page:Box3 box] 的交集，将此框的上界设置为两个框的max的较小部分，
			
 
				-		将此包围盒的下界设置为两个包围盒的min的较大部分。
			
 
				+		计算此包围盒和 [page:Box3 box] 的交集，将此框的上界设置为两个框的max的较小部分，
			
 
				+		将此包围盒的下界设置为两个包围盒的min的较大部分。If there's no overlap, makes this box empty.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Boolean intersectsBox]( [param:Box3 box] )</h3>
			
@@ -223,32 +224,33 @@
 
				 		注意，下界和上界相等的方框仍然包含一个点，即两个边界共享的那个点。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 makeEmpty]()</h3>
			
 
				+		<h3>[method:this makeEmpty]()</h3>
			
 
				 		<p>清空包围盒。</p>
			
 
				 
			
 
				-		<h3>[method:Box3 set]( [param:Vector3 min], [param:Vector3 max] )</h3>
			
 
				+		<h3>[method:this set]( [param:Vector3 min], [param:Vector3 max] )</h3>
			
 
				 		<p>
			
 
				 		[page:Vector3 min] - [page:Vector3] 表示下边界每个纬度（x,y,z）的值。<br />
			
 
				 		[page:Vector3 max] - [page:Vector3] 表示上边界每个纬度（x,y,z）的值。<br /><br />
			
 
				 
			
 
				-		设置包围盒上下边界每个纬度（x,y,z)的值。
			
 
				+		设置包围盒上下边界每个纬度（x,y,z)的值。<br>
			
 
				+		Please note that this method only copies the values from the given objects.
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 setFromArray]( [param:Array array] ) [param:Box3 this]</h3>
			
 
				+		<h3>[method:this setFromArray]( [param:Array array] ) [param:Box3 this]</h3>
			
 
				 		<p>
			
 
				 		array -- 数组当中的所有的点都将被包围盒包裹。<br /><br />
			
 
				 
			
 
				 		设置包围盒的上下边界使得数组 *array* 中的所有点的点都被包含在内。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 setFromBufferAttribute]( [param:BufferAttribute attribute] ) [param:Box3 this]</h3>
			
 
				+		<h3>[method:this setFromBufferAttribute]( [param:BufferAttribute attribute] ) [param:Box3 this]</h3>
			
 
				 		<p>
			
 
				 		[page:BufferAttribute attribute] - 位置的缓冲数据，包含在返回的包围盒内。<br /><br />
			
 
				 
			
 
				 		设置此包围盒的上边界和下边界，以包含 [page:BufferAttribute attribute] 中的所有位置数据。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 setFromCenterAndSize]( [param:Vector3 center], [param:Vector3 size] ) [param:Box3 this]</h3>
			
 
				+		<h3>[method:this setFromCenterAndSize]( [param:Vector3 center], [param:Vector3 size] ) [param:Box3 this]</h3>
			
 
				 		<p>
			
 
				 		[page:Vector3 center], - 包围盒所要设置的中心位置。 <br>
			
 
				 		[page:Vector3 size] - 包围盒所要设置的x、y和z尺寸（宽/高/长）。<br /><br />
			
@@ -256,22 +258,23 @@
 
				 		将当前包围盒的中心点设置为 [page:Vector3 center] ，并将此包围盒的宽度，高度和深度设置为大小指定 [page:Vector3 size] 的值。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 setFromObject]( [param:Object3D object] )</h3>
			
 
				+		<h3>[method:this setFromObject]( [param:Object3D object] )</h3>
			
 
				 		<p>
			
 
				 		[page:Object3D object] - 用来计算包围盒的3D对象 [page:Object3D]。<br /><br />
			
 
				 
			
 
				 		计算和世界轴对齐的一个对象 [page:Object3D] （含其子对象）的包围盒，计算对象和子对象的世界坐标变换。
			
 
				+		The function may result in a larger box than strictly necessary.
			
 
				 
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 setFromPoints]( [param:Array points] )</h3>
			
 
				+		<h3>[method:this setFromPoints]( [param:Array points] )</h3>
			
 
				 		<p>
			
 
				 		[page:Array points] - 计算出的包围盒将包含数组中所有的点 [page:Vector3 Vector3s]<br /><br />
			
 
				 
			
 
				 		设置此包围盒的上边界和下边界，以包含数组 [page:Array points] 中的所有点。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 translate]( [param:Vector3 offset] )</h3>
			
 
				+		<h3>[method:this translate]( [param:Vector3 offset] )</h3>
			
 
				 		<p>
			
 
				 		[page:Vector3 offset] - 偏移方向和距离。<br /><br />
			
 
				 
			
@@ -279,9 +282,9 @@
 
				 		偏移量为 [page:Vector3 offset] 大小。
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:Box3 union]( [param:Box3 box] )</h3>
			
 
				+		<h3>[method:this union]( [param:Box3 box] )</h3>
			
 
				 		<p>
			
 
				-		[page:Box3 box] - 要结合在一起的包围盒。<br /><br />
			
 
				+		[page:Box3 box] - 将被用于与该盒子计算并集的盒子。<br /><br />
			
 
				 
			
 
				 		在 [page:Box3 box] 参数的上边界和已有box对象的上边界之间取较大者，而对两者的下边界取较小者，这样获得一个新的较大的联合盒子。
			
 
				 		</p>
			
--- a/docs/api/zh/math/Frustum.html
+++ b/docs/api/zh/math/Frustum.html
@@ -88,7 +88,7 @@
 
				 
			
 
				 		<h3>[method:this set]( [param:Plane p0], [param:Plane p1], [param:Plane p2], [param:Plane p3], [param:Plane p4], [param:Plane p5] )</h3>
			
 
				 		<p>
			
 
				-		Sets the frustum from the passed planes. No plane order is implied.<br>
			
 
				+		从传入的平面设置当前视锥体。没有隐式的顺序。<br>
			
 
				 		Note that this method only copies the values from the given objects.
			
 
				 		</p>
			
 
				 
			
--- a/docs/api/zh/math/Matrix4.html
+++ b/docs/api/zh/math/Matrix4.html
@@ -116,7 +116,7 @@ m.elements = [ 11, 21, 31, 41,
 
				 
			
 
				 		<h3>[method:this compose]( [param:Vector3 position], [param:Quaternion quaternion], [param:Vector3 scale] )</h3>
			
 
				 		<p>
			
 
				-		设置将该对象由位置[page:Vector3 position]，四元数[page:Quaternion quaternion] 和 缩放[page:Vector3 scale]
			
 
				+		设置将该对象位置 [page:Vector3 position]，四元数[page:Quaternion quaternion] 和 缩放[page:Vector3 scale] 组合变换的矩阵。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:this copy]( [param:Matrix4 m] )</h3>
			
--- a/docs/api/zh/math/Plane.html
+++ b/docs/api/zh/math/Plane.html
@@ -123,7 +123,7 @@
 
				 			[page:Vector3 normal] - 单位长度的向量表示平面的法向量。<br />
			
 
				 			[page:Float constant] - 原点到平面有符号距离。默认值为 *0*。<br /><br />
			
 
				 
			
 
				-			设置平面 [page:.normal normal] 的法线和常量 [page:.constant constant] 属性值。
			
 
				+			设置平面 [page:.normal normal] 的法线和常量 [page:.constant constant] 属性值 by copying the values from the given normal。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Plane setComponents]( [param:Float x], [param:Float y], [param:Float z], [param:Float w] )</h3>
			
--- a/docs/api/zh/math/Quaternion.html
+++ b/docs/api/zh/math/Quaternion.html
@@ -8,11 +8,11 @@
 
				 		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				 	</head>
			
 
				 	<body>
			
 
				-		<h1>[name]</h1>
			
 
				+		<h1>四元数（[name]）</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			Implementation of a [link:http://en.wikipedia.org/wiki/Quaternion quaternion].<br/>
			
 
				-			Quaternions are used in three.js to represent [link:https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation rotations].
			
 
				+			该类实现了 [link:http://en.wikipedia.org/wiki/Quaternion quaternion] 。<br/>
			
 
				+			四元数在three.js中用于表示 [link:https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation rotation] （旋转）。
			
 
				 		</p>
			
 
				 
			
 
				 		<h2>代码示例</h2>
			
@@ -26,19 +26,19 @@
 
				 		</code>
			
 
				 
			
 
				 
			
 
				-		<h2>Constructor</h2>
			
 
				+		<h2>构造函数</h2>
			
 
				 
			
 
				 
			
 
				 		<h3>[name]( [param:Float x], [param:Float y], [param:Float z], [param:Float w] )</h3>
			
 
				 		<p>
			
 
				-		[page:Float x] - x coordinate<br />
			
 
				-		[page:Float y] - y coordinate<br />
			
 
				-		[page:Float z] - z coordinate<br />
			
 
				-		[page:Float w] - w coordinate
			
 
				+		[page:Float x] - x 坐标<br />
			
 
				+		[page:Float y] - y 坐标<br />
			
 
				+		[page:Float z] - z 坐标<br />
			
 
				+		[page:Float w] - w 坐标
			
 
				 		</p>
			
 
				 
			
 
				 
			
 
				-		<h2>Properties</h2>
			
 
				+		<h2>属性</h2>
			
 
				 
			
 
				 		<h3>[property:Float x]</h3>
			
 
				 
			
@@ -49,91 +49,87 @@
 
				 		<h3>[property:Float w]</h3>
			
 
				 
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				+		<h2>方法</h2>
			
 
				 
			
 
				 		<h3>[method:Float angleTo]( [param:Quaternion q] )</h3>
			
 
				 		<p>
			
 
				-			Returns the angle between this quaternion and quaternion [page:Quaternion q] in radians.
			
 
				+			以弧度返回该四元数与四元数 [page:Quaternion q] 之间的夹角。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion clone]()</h3>
			
 
				 		<p>
			
 
				-			Creates a new Quaternion with identical [page:.x x], [page:.y y],
			
 
				-			[page:.z z] and [page:.w w] properties to this one.
			
 
				+			创建一个与该四元数具有相同[page:.x x]、[page:.y y]、[page:.z z]和[page:.w w]
			
 
				+			属性的四元数。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion conjugate]()</h3>
			
 
				 		<p>
			
 
				-		Returns the rotational conjugate of this quaternion. The conjugate of a quaternion
			
 
				-		represents the same rotation in the opposite direction about the rotational axis.
			
 
				+			返回该四元数的旋转共轭。
			
 
				+			四元数的共轭表示的是，围绕旋转轴在相反方向上的相同旋转。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion copy]( [param:Quaternion q] )</h3>
			
 
				 		<p>
			
 
				-			Copies the [page:.x x], [page:.y y],	[page:.z z] and [page:.w w] properties
			
 
				-			of [page:Quaternion q] into this quaternion.
			
 
				+			复制四元数 [page:Quaternion q] 的 [page:.x x]、[page:.y y]、[page:.z z] 和 [page:.w w]
			
 
				+			属性到该四元数中。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Boolean equals]( [param:Quaternion v] )</h3>
			
 
				 		<p>
			
 
				-		[page:Quaternion v] - Quaternion that this quaternion will be compared to.<br /><br />
			
 
				+		[page:Quaternion v] - 用于进行比较的四元数。<br /><br />
			
 
				 
			
 
				-		Compares the [page:.x x], [page:.y y],	[page:.z z] and [page:.w w] properties of
			
 
				-		[page:Quaternion v] to the equivalent properties of this quaternion to determine if they
			
 
				-		represent the same rotation.
			
 
				+		将四元数 [page:Quaternion v] 的 [page:.x x]、 [page:.y y]、	[page:.z z] 和 [page:.w w] 的属性
			
 
				+		与当前四元数的对应属性相比较，以确定它们是否表示相同的旋转。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Float dot]( [param:Quaternion v] )</h3>
			
 
				 		<p>
			
 
				-			Calculates the [link:https://en.wikipedia.org/wiki/Dot_product dot product] of
			
 
				-			quaternions [page:Quaternion v] and this one.
			
 
				+			计算四元数 [page:Quaternion v] 与当前四元数的[link:https://en.wikipedia.org/wiki/Dot_product dot product]（点积）。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion fromArray]( [param:Array array], [param:Integer offset] )</h3>
			
 
				 		<p>
			
 
				-		[page:Array array] - array of format (x, y, z, w) used to construct the quaternion.<br />
			
 
				-		[page:Integer offset] - (optional) an offset into the array.<br /><br />
			
 
				+		[page:Array array] - 用于构造四元数的形如(x, y, z, w)的数组。<br />
			
 
				+		[page:Integer offset] - （可选）数组的偏移量。（译者注：使用数组中从第offset元素算起的四个元素）<br /><br />
			
 
				 
			
 
				-		Sets this quaternion's [page:.x x], [page:.y y],	[page:.z z] and [page:.w w] properties
			
 
				-		from an array.
			
 
				+		从一个数组来设置四元数的 [page:.x x]、 [page:.y y]、[page:.z z] 和 [page:.w w] 的属性。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion identity]()</h3>
			
 
				 		<p>
			
 
				-			Sets this quaternion to the identity quaternion; that is, to the quaternion that represents "no rotation".
			
 
				+			设置该四元数为 identity 四元数，即表示“不旋转”的四元数。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion inverse]()</h3>
			
 
				 		<p>
			
 
				-			Inverts this quaternion - calculates the [page:.conjugate conjugate]. The quaternion is assumed to have unit length.
			
 
				+			翻转该四元数 —— 计算 [page:.conjugate conjugate] 。假定该四元数具有单位长度。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Float length]()</h3>
			
 
				-		<p>Computes the [link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length]
			
 
				-		(straight-line length) of this quaternion, considered as a 4 dimensional vector.</p>
			
 
				+		<p>计算四元数的 [link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length]
			
 
				+		（欧几里得长度，直线长度），视为一个四维向量。</p>
			
 
				 
			
 
				 		<h3>[method:Float lengthSq]()</h3>
			
 
				 		<p>
			
 
				-			Computes the squared [link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length]
			
 
				-			(straight-line length) of this quaternion, considered as a 4 dimensional
			
 
				-			vector. This can be useful if you are comparing the lengths of two quaternions,
			
 
				-			as this is a slightly more efficient calculation than [page:.length length]().
			
 
				+			计算四元数 [link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean length]
			
 
				+			（欧几里得长度，直线长度）的平方，视为一个四维向量。
			
 
				+			如果要比较两个四元数的长度，这可能会十分有用，
			
 
				+			因为这比 [page:.length length]() 的效率稍高一些。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion normalize]()</h3>
			
 
				 		<p>
			
 
				-			[link:https://en.wikipedia.org/wiki/Normalized_vector Normalizes] this quaternion - that is,
			
 
				-		calculated the quaternion that performs the same rotation as this one, but has  [page:.length length]
			
 
				-		equal to *1*.
			
 
				+			[link:https://en.wikipedia.org/wiki/Normalized_vector Normalizes]（归一化）四元数 ——
			
 
				+			即计算与该四元数具有相同旋转、但长度为*1*的四元数。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion multiply]( [param:Quaternion q] )</h3>
			
 
				-		<p>Multiplies this quaternion by [page:Quaternion q].</p>
			
 
				+		<p>将该四元数与[page:Quaternion q]相乘。</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion multiplyQuaternions]( [param:Quaternion a], [param:Quaternion b] )</h3>
			
 
				 		<p>
			
 
				-		Sets this quaternion to [page:Quaternion a] x [page:Quaternion b].<br />
			
 
				-		Adapted from the method outlined [link:http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/code/index.htm here].
			
 
				+		将该四元数设为 [page:Quaternion a] x [page:Quaternion b] 。<br />
			
 
				+		改编自 [link:http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/code/index.htm here] 所概述的方法。	
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion premultiply]( [param:Quaternion q] )</h3>
			
@@ -165,22 +161,22 @@
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion set]( [param:Float x], [param:Float y], [param:Float z], [param:Float w] )</h3>
			
 
				-		<p>Sets [page:.x x], [page:.y y], [page:.z z], [page:.w w] properties of this quaternion.</p>
			
 
				+		<p>设置该四元数的 [page:.x x]、[page:.y y]、[page:.z z]和[page:.w w]属性。</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion setFromAxisAngle]( [param:Vector3 axis], [param:Float angle] )</h3>
			
 
				 		<p>
			
 
				-		Sets this quaternion from rotation specified by [page:Vector3 axis] and [page:Float angle].<br />
			
 
				-		Adapted from the method [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/angleToQuaternion/index.htm here].<br />
			
 
				-		*Axis* is assumed to be normalized, *angle* is in radians.
			
 
				+		从由 [page:Vector3 axis]（轴） 和 [page:Float angle]（角度）所给定的旋转来设置该四元数。<br />
			
 
				+		改编自 [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/angleToQuaternion/index.htm here] 所述的方法。<br />
			
 
				+		假定*Axis*已被归一化，*angle*以弧度来表示。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion setFromEuler]( [param:Euler euler] )</h3>
			
 
				-		<p>Sets this quaternion from the rotation specified by [page:Euler] angle.</p>
			
 
				+		<p>从由 [page:Euler] 角所给定的旋转来设置该四元数。</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion setFromRotationMatrix]( [param:Matrix4 m] )</h3>
			
 
				 		<p>
			
 
				-		Sets this quaternion from rotation component of [page:Matrix4 m].<br />
			
 
				-		Adapted from the method [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToQuaternion/index.htm here].
			
 
				+		从[page:Matrix4 m]的旋转分量中来设置该四元数。<br />
			
 
				+		改编自 [link:http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToQuaternion/index.htm here] 所概述的方法。	
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Quaternion setFromUnitVectors]( [param:Vector3 vFrom], [param:Vector3 vTo] )</h3>
			
@@ -193,30 +189,30 @@
 
				 
			
 
				 		<h3>[method:Array toArray]( [param:Array array], [param:Integer offset] )</h3>
			
 
				 		<p>
			
 
				-		[page:Array array] - An optional array to store the quaternion. If not specified, a new array will be created.<br/>
			
 
				-		[page:Integer offset] - (optional) if specified, the result will be copied
			
 
				-		into this [page:Array].<br /><br />
			
 
				+		[page:Array array] - （可选）存储该四元数的数组。若未指定该参数，则将创建一个新数组。<br/>
			
 
				+		[page:Integer offset] - （可选）若指定了该值，结果将会被拷贝到该
			
 
				+		[page:Array]。<br /><br />
			
 
				 
			
 
				-		Returns the numerical elements of this quaternion in an array of format [x, y, z, w].
			
 
				+		在形如[x, y, z, w]的数组中，返回四元数中的数字元素。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:this fromBufferAttribute]( [param:BufferAttribute attribute], [param:Integer index] )</h3>
			
 
				 		<p>
			
 
				-		[page:BufferAttribute attribute] - the source attribute.<br />
			
 
				-		[page:Integer index] - index in the attribute.<br /><br />
			
 
				+		[page:BufferAttribute attribute] - 源 attribute。<br />
			
 
				+		[page:Integer index] - attribute 中的索引。<br /><br />
			
 
				 
			
 
				-		Sets [page:.x x], [page:.y y], [page:.z z], [page:.w w] properties of this quaternion from the [page:BufferAttribute attribute].
			
 
				+		从 [page:BufferAttribute attribute] 中设置该四元数的[page:.x x]、 [page:.y y]、 [page:.z z]、 [page:.w w]属性。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Static Methods</h2>
			
 
				+		<h2>静态方法</h2>
			
 
				 
			
 
				 		<p>
			
 
				-			Static methods (as opposed to instance methods) are designed to be called directly from the class,
			
 
				-			rather than from a specific instance. So to use the static version of, call it like so:
			
 
				+			静态方法（相对于实例方法）被设计用来直接从类进行调用，而非从特定的实例上进行调用。
			
 
				+			要使用静态版本，需要按照如下方式来调用：
			
 
				 			<code>
			
 
				 THREE.Quaternion.slerp( qStart, qEnd, qTarget, t );
			
 
				 			</code>
			
 
				-			By contrast, to call the 'normal' or instanced slerp method, you would do the following:
			
 
				+			作为对比，要调用“正常”或实例的 slerp 方法，则进行如下操作：
			
 
				 			<code>
			
 
				 //instantiate a quaternion with default values
			
 
				 var q = new THREE.Quaternion();
			
@@ -264,7 +260,7 @@ q.slerp( qb, t )
 
				 
			
 
				 		<!-- Note: Do not add non-static methods to the bottom of this page. Put them above the <h2>Static Methods</h2> -->
			
 
				 
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/math/Ray.html
+++ b/docs/api/zh/math/Ray.html
@@ -194,7 +194,7 @@
 
				 		该向量必须经过标准化（使用[page:Vector3.normalize]），这样才能使方法正常运行。
			
 
				 		<br /><br />
			
 
				 
			
 
				-		将传入的参数赋值给射线的[page:.origin origin]和[page:.direction direction]。
			
 
				+		Sets this ray's [page:.origin origin] and [page:.direction direction] properties by copying the values from the given objects.
			
 
				 		</p>
			
 
				 
			
 
				 
			
--- a/docs/api/zh/math/Sphere.html
+++ b/docs/api/zh/math/Sphere.html
@@ -16,7 +16,7 @@
 
				 		<h3>[name]( [param:Vector3 center], [param:Float radius] )</h3>
			
 
				 		<p>
			
 
				 		[page:Vector3 center] - 球心的位置，默认值是一个位于(0, 0, 0)的[page:Vector3]。<br />
			
 
				-		[page:Float radius] - 球的半径，默认值是0。<br /><br />
			
 
				+		[page:Float radius] - 球的半径，默认值是-1。<br /><br />
			
 
				 
			
 
				 		创建一个新的[name]。
			
 
				 
			
@@ -117,7 +117,8 @@
 
				 			[page:Vector3 center] - 球心位置。<br />
			
 
				 			[page:Float radius] - 球的半径。<br /><br />
			
 
				 
			
 
				-		设置球的[page:.center center]和[page:.radius radius]属性。
			
 
				+		设置球的[page:.center center]和[page:.radius radius]属性。<br>
			
 
				+		Please note that this method only copies the values from the given center.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Sphere setFromPoints]( [param:Array points], [param:Vector3 optionalCenter] )</h3>
			
--- a/docs/api/zh/math/Spherical.html
+++ b/docs/api/zh/math/Spherical.html
@@ -20,8 +20,8 @@
 
				 		<p>
			
 
				 		[page:Float radius] - 半径值，或者说从该点到原点的
			
 
				 		[link:https://en.wikipedia.org/wiki/Euclidean_distance Euclidean distance]（欧几里得距离，即直线距离）。默认值为*1.0*。<br />
			
 
				-		[page:Float phi] - polar angle from the y (up) axis. Default is *0*.<br />
			
 
				-		[page:Float theta] - equator angle around the y (up) axis. Default is *0*.<br /><br />
			
 
				+		[page:Float phi] - polar angle in radians from the y (up) axis. Default is *0*.<br />
			
 
				+		[page:Float theta] - equator angle in radians around the y (up) axis. Default is *0*.<br /><br />
			
 
				 
			
 
				 		The poles (phi) are at the positive and negative y axis. The equator (theta) starts at positive z.
			
 
				 		</p>
			
--- a/docs/api/zh/math/Triangle.html
+++ b/docs/api/zh/math/Triangle.html
@@ -120,7 +120,8 @@
 
				 
			
 
				 		<h3>[method:Triangle set]( [param:Vector3 a], [param:Vector3 b], [param:Vector3 c] ) [param:Triangle this]</h3>
			
 
				 		<p>
			
 
				-			将三角形的[page:.a a]、[page:.b b]和[page:.c c]属性设置为所传入的[page:vector3 vector3]。
			
 
				+			将三角形的[page:.a a]、[page:.b b]和[page:.c c]属性设置为所传入的[page:vector3 vector3]。<br>
			
 
				+			Please note that this method only copies the values from the given objects.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:Triangle setFromPointsAndIndices]( [param:Array points], [param:Integer i0], [param:Integer i1], [param:Integer i2] ) [param:Triangle this]</h3>
			
--- a/docs/api/zh/math/Vector3.html
+++ b/docs/api/zh/math/Vector3.html
@@ -105,6 +105,9 @@
 
				 			将该向量乘以四阶矩阵m（第四个维度隐式地为1），and divides by perspective.
			
 
				 		</p>
			
 
				 
			
 
				+		<h3>[method:this applyNormalMatrix]( [param:Matrix3 m] )</h3>
			
 
				+		<p>Multiplies this vector by normal matrix [page:Matrix3 m] and normalizes the result.</p>
			
 
				+
			
 
				 		<h3>[method:this applyQuaternion]( [param:Quaternion quaternion] )</h3>
			
 
				 		<p>
			
 
				 		将[page:Quaternion]变换应用到该向量。
			
@@ -311,7 +314,7 @@
 
				 		normal from this vector.
			
 
				 		</p>
			
 
				 
			
 
				-		<h3>[method:this projectOnVector]( [param:Vector3] )</h3>
			
 
				+		<h3>[method:this projectOnVector]( [param:Vector3 v] )</h3>
			
 
				 		<p>投影（[link:https://en.wikipedia.org/wiki/Vector_projection Projects]）该向量到向量[page:Vector3 v]上。</p>
			
 
				 
			
 
				 		<h3>[method:this reflect]( [param:Vector3 normal] )</h3>
			
@@ -357,6 +360,11 @@
 
				 		设置该向量的[page:.x x]值、[page:.y y]值和[page:.z z]值。
			
 
				 		</p>
			
 
				 
			
 
				+		<h3>[method:this setFromMatrix3Column]( [param:Matrix3 matrix], [param:Integer index] )</h3>
			
 
				+		<p>
			
 
				+		Sets this vector's [page:.x x], [page:.y y] and [page:.z z] components from [page:Integer index] column of [page:Matrix3 matrix].
			
 
				+		</p>
			
 
				+
			
 
				 		<h3>[method:this setFromMatrixPosition]( [param:Matrix4 m] )</h3>
			
 
				 		<p>
			
 
				 		从变换矩阵（[link:https://en.wikipedia.org/wiki/Transformation_matrix transformation matrix]）[page:Matrix4 m]中，
			
--- a/docs/api/zh/objects/InstancedMesh.html
+++ b/docs/api/zh/objects/InstancedMesh.html
@@ -10,18 +10,17 @@
 
				 	<body>
			
 
				 		[page:Mesh] &rarr;
			
 
				 
			
 
				-		<h1>[name]</h1>
			
 
				+		<h1>实例化网格（[name]）</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-		A special version of [page:Mesh] with instanced rendering support. Use [name] if you have to render a large number of
			
 
				-		objects with the same geometry and 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 rendering performance in your application.
			
 
				+		一种具有实例化渲染支持的特殊版本的[page:Mesh]。你可以使用 [name] 来渲染大量具有相同几何体与材质、但具有不同世界变换的物体。
			
 
				+		使用 [name] 将帮助你减少 draw call 的数量，从而提升你应用程序的整体渲染性能。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-		The current implementation requires that materials are not shared between [name] and other 3D objects.
			
 
				+		当前的实现需要[name]和其它3D物体间不共享材质。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Examples</h2>
			
 
				+		<h2>示例</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[example:webgl_instancing_dynamic WebGL / instancing / dynamic]<br />
			
@@ -31,60 +30,59 @@
 
				 			[example:webgl_instancing_raycast WebGL / instancing / raycast]
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Constructor</h2>
			
 
				+		<h2>构造函数</h2>
			
 
				 		<h3>[name]( [param:BufferGeometry geometry], [param:Material material], [param:Integer count] )</h3>
			
 
				 		<p>
			
 
				-		[page:Geometry geometry] - an instance of [page:BufferGeometry].<br />
			
 
				-		[page:Material material] - an instance of [page:Material]. Default is a new [page:MeshBasicMaterial].<br />
			
 
				-		[page:Integer count] - the number of instances.<br />
			
 
				+		[page:Geometry geometry] - 一个 [page:BufferGeometry] 的实例。<br />
			
 
				+		[page:Material material] - 一个 [page:Material] 的实例。默认为一个新的 [page:MeshBasicMaterial] 。<br />
			
 
				+		[page:Integer count] - 实例的数量<br />
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Properties</h2>
			
 
				+		<h2>属性</h2>
			
 
				 		<p>See the base [page:Mesh] class for common properties.</p>
			
 
				 
			
 
				 		<h3>[property:Integer count]</h3>
			
 
				 		<p>
			
 
				-			The number of instances. The *count* value passed into the constructor represents the maximum number of
			
 
				-			instances of this mesh. You can change the number of instances at runtime to an integer value
			
 
				-			in the range [0, count].
			
 
				+			实例的数量。被传入到构造函数中的*count*表示mesh实例数量的最大值。
			
 
				+			你可以在运行时改变这个数值到 [0, count] 区间的一个整数。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			If you need more instances than the original count value, you have to create a new [name].
			
 
				+			如果你需要比原先的数量更多的实例数量，你需要创建一个新的[name]。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:BufferAttribute instanceMatrix]</h3>
			
 
				 		<p>
			
 
				-			Represents the local transformation of all instances.
			
 
				-			You have to set its [page:BufferAttribute.needsUpdate needsUpdate] flag to true if you modify instanced data via [page:.setMatrixAt]().
			
 
				+			表示所有实例的本地变换。
			
 
				+			如果你要通过 [page:.setMatrixAt]() 来修改实例数据，你必须将它的 [page:BufferAttribute.needsUpdate needsUpdate] 标识为 true 。
			
 
				 		</p>
			
 
				 
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				+		<h2>方法</h2>
			
 
				 		<p>See the base [page:Mesh] class for common methods.</p>
			
 
				 
			
 
				 		<h3>[method:null getMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
			
 
				 		<p>
			
 
				-			[page:Integer index]: The index of an instance. Values have to be in the range [0, count].
			
 
				+			[page:Integer index]: 实例的索引。值必须在 [0, count] 区间。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			[page:Matrix4 matrix]: This 4x4 matrix will be set to the local transformation matrix of the defined instance.
			
 
				+			[page:Matrix4 matrix]: 该4x4矩阵将会被设为已定义实例的本地变换矩阵。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			Get the local transformation matrix of the defined instance.
			
 
				+			获得已定义实例的本地变换矩阵。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:null setMatrixAt]( [param:Integer index], [param:Matrix4 matrix] )</h3>
			
 
				 		<p>
			
 
				-			[page:Integer index]: The index of an instance. Values have to be in the range [0, count].
			
 
				+			[page:Integer index]: 实例的索引。值必须在 [0, count] 区间。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			[page:Matrix4 matrix]: A 4x4 matrix representing the local transformation of a single instance.
			
 
				+			[page:Matrix4 matrix]: 一个4x4矩阵，表示单个实例本地变换。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			Sets the given local transformation matrix to the defined instance.
			
 
				+			设置给定的本地变换矩阵到已定义的实例。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源代码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/objects/LOD.html
+++ b/docs/api/zh/objects/LOD.html
@@ -85,6 +85,10 @@
 
				 			返回一个LOD对象及其所关联的在特定距离中的物体。
			
 
				 		</p>
			
 
				 
			
 
				+		<h3>[method:integer getCurrentLevel]()</h3>
			
 
				+		<p>
			
 
				+		Get the currently active LOD level. As index of the levels array.
			
 
				+		</p>
			
 
				 
			
 
				 		<h3>[method:Object3D getObjectForDistance]( [param:Float distance] )</h3>
			
 
				 		<p>
			
--- a/docs/api/zh/objects/Mesh.html
+++ b/docs/api/zh/objects/Mesh.html
@@ -14,7 +14,7 @@
 
				 
			
 
				 		<p class="desc">
			
 
				 			表示基于以三角形为[link:https://en.wikipedia.org/wiki/Polygon_mesh polygon mesh]（多边形网格）的物体的类。
			
 
				-		  	同时也作为其他类的基类，例如[page:SkinnedMesh]。
			
 
				+			同时也作为其他类的基类，例如[page:SkinnedMesh]。
			
 
				 		</p>
			
 
				 
			
 
				 
			
@@ -49,7 +49,7 @@
 
				 
			
 
				 		<h3>[property:Material material]</h3>
			
 
				 		<p>
			
 
				-			由[page:Material]基类或者一个包含材质的数组派生而来的材质实例，定义了物体的外观。默认值是一个具有随机颜色的[page:MeshBasicMaterial]。
			
 
				+			由[page:Material]基类或者一个包含材质的数组派生而来的材质实例，定义了物体的外观。默认值是一个[page:MeshBasicMaterial]。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Array morphTargetInfluences]</h3>
			
--- a/docs/api/zh/objects/Points.html
+++ b/docs/api/zh/objects/Points.html
@@ -27,7 +27,7 @@
 
				 	<p>
			
 
				 		[page:Geometry geometry] —— （可选）是一个[page:Geometry]或者[page:BufferGeometry]的实例，默认值是一个新的[page:BufferGeometry]。
			
 
				 		<br />
			
 
				-		[page:Material material] —— （可选） 是一个对象，默认值是一个具有随机颜色的新的[page:PointsMaterial]。
			
 
				+		[page:Material material] —— （可选） 是一个对象，默认值是一个[page:PointsMaterial]。
			
 
				 	</p>
			
 
				 
			
 
				 
			
@@ -42,7 +42,7 @@
 
				 
			
 
				 	<h3>[property:Material material]</h3>
			
 
				 	<p>
			
 
				-		[page:Material]的实例。定义了物体的外观。默认值是一个具有随机颜色的[page:PointsMaterial]。
			
 
				+		[page:Material]的实例。定义了物体的外观。默认值是一个的[page:PointsMaterial]。
			
 
				 	</p>
			
 
				 
			
 
				 	<h3>[property:Array morphTargetInfluences]</h3>
			
--- a/docs/api/zh/renderers/WebGL1Renderer.html
+++ b/docs/api/zh/renderers/WebGL1Renderer.html
@@ -13,33 +13,33 @@
 
				 		<h1>[name]</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-		Since r118 [page:WebGLRenderer] automatically uses a WebGL 2 rendering context. When upgrading an existing project to
			
 
				-		=> r118, applications might break because of two reasons:
			
 
				+		自r118起，[page:WebGLRenderer]会自动使用 WebGL 2 渲染上下文。当升级一个已存在的项目到 => r118 ，
			
 
				+		应用程序可能会因为下列两种原因而损坏：
			
 
				 
			
 
				 		<ul>
			
 
				-			<li>Custom shader code needs to be GLSL 3.0 conform.</li>
			
 
				+			<li>自定义着色器代码必须符合GLSL 3.0。</li>
			
 
				 			<li>WebGL 1 extension checks have to be changed.</li>
			
 
				 		</ul>
			
 
				 
			
 
				-		If you can't afford the time to upgrade your code but still want to use the latest version, you can use [name]. This
			
 
				-		version of the renderer will enforce a WebGL 1 rendering context.
			
 
				+		如果你不能够花时间来升级你的代码，但仍然想要使用最新版本，那你就可以使用[name]。
			
 
				+		这一版本的渲染器会强制使用 WebGL 1 渲染上下文。
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Constructor</h2>
			
 
				+		<h2>构造函数</h2>
			
 
				 
			
 
				 		<h3>[name]( [param:Object parameters] )</h3>
			
 
				 		<p>
			
 
				 		Creates a new [name].
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Properties</h2>
			
 
				+		<h2>属性</h2>
			
 
				 		<p>See the base [page:WebGLRenderer] class for common properties.</p>
			
 
				 
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				+		<h2>方法</h2>
			
 
				 		<p>See the base [page:WebGLRenderer] class for common methods.</p>
			
 
				 
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/renderers/WebGLRenderTarget.html
+++ b/docs/api/zh/renderers/WebGLRenderTarget.html
@@ -34,7 +34,7 @@
 
				 		[page:Constant minFilter] - 默认是[page:Textures LinearFilter]. <br />
			
 
				 		[page:Constant format] - 默认是[page:Textures RGBAFormat]. <br />
			
 
				 		[page:Constant type] - 默认是[page:Textures UnsignedByteType]. <br />
			
 
				-		[page:Number anisotropy] - 默认是*1*. 参见[page:Texture.anistropy]<br />
			
 
				+		[page:Number anisotropy] - 默认是*1*. 参见[page:Texture.anisotropy]<br />
			
 
				 		[page:Constant encoding] - 默认是[page:Textures LinearEncoding]. <br />
			
 
				 		[page:Boolean depthBuffer] - 默认是*true*. 如果不需要就设为false <br />
			
 
				 		[page:Boolean stencilBuffer] - default is *false*. Set this to true if you need it.<br /><br />
			
--- a/docs/api/zh/renderers/WebGLRenderer.html
+++ b/docs/api/zh/renderers/WebGLRenderer.html
@@ -363,7 +363,7 @@
 
				 
			
 
				 		<h3>[method:null render]( [param:Object3D scene], [param:Camera camera] )</h3>
			
 
				 		<p>
			
 
				-			用相机([page:Camera camera])渲染一个场景([page:Scene scene])<br />
			
 
				+			用相机([page:Camera camera])渲染一个场景([page:Scene scene])或是其它类型的[page:Object3D object]。<br />
			
 
				 
			
 
				 			渲染一般是在canvas上完成的，或者是[page:WebGLRenderTarget renderTarget](如果有指定)<br />
			
 
				 
			
@@ -376,10 +376,10 @@
 
				 		<p>使用相机和指定材质渲染缓冲几何组。</p>
			
 
				 
			
 
				 		<h3>[method:null renderBufferImmediate]( [param:Object3D object], [param:WebGLProgram program] )</h3>
			
 
				-		<p>object - 一个[page:Object3D]实例<br />
			
 
				-		program - 一个[page:WebGLProgram]实例<br />
			
 
				+		<p>object - an instance of [page:Object3D]<br />
			
 
				+		program - an instance of [page:WebGLProgram]<br />
			
 
				 
			
 
				-		渲染即使缓冲，由renderObjectImmediate对象调用
			
 
				+		Renders an instance of [page:ImmediateRenderObject]，由renderObjectImmediate对象调用。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[method:null setAnimationLoop]( [param:Function callback] )</h3>
			
--- a/docs/api/zh/renderers/shaders/UniformsUtils.html
+++ b/docs/api/zh/renderers/shaders/UniformsUtils.html
@@ -10,7 +10,9 @@
 
				 	<body>
			
 
				 		<h1>[name]</h1>
			
 
				 
			
 
				-		<p class="desc">Uniform工具. 支持uniform变量的合并和克隆</p>
			
 
				+		<p class="desc">
			
 
				+			Provides utility functions for managing uniforms.
			
 
				+		</p>
			
 
				 
			
 
				 		<h2>方法</h2>
			
 
				 
			
--- a/docs/api/zh/scenes/Scene.html
+++ b/docs/api/zh/scenes/Scene.html
@@ -12,7 +12,7 @@
 
				 		<h1>场景（[name]）</h1>
			
 
				 
			
 
				 		<p class="desc">
			
 
				-			场景允许你在什么地方、摆放什么东西来交给three.js来渲染，这是你放置物体、灯光和摄像机的地方。</p>
			
 
				+			场景能够让你在什么地方、摆放什么东西来交给three.js来渲染，这是你放置物体、灯光和摄像机的地方。</p>
			
 
				 
			
 
				 
			
 
				 		<h2>构造器</h2>
			
@@ -34,14 +34,15 @@
 
				 
			
 
				 		<h3>[property:Object background]</h3>
			
 
				 		<p>
			
 
				-		If not null, sets the background used when rendering the scene, and is always rendered first.
			
 
				-		Can be set to a [page:Color] which sets the clear color, a [page:Texture] covering the canvas, a cubemap as a [page:CubeTexture] or [page:WebGLCubeRenderTarget] or an equirectangular as a [page:Texture] . Default is null.
			
 
				+		若不为空，在渲染场景的时候将设置背景，且背景总是首先被渲染的。
			
 
				+		可以设置一个用于的“clear”的[page:Color]（颜色）、一个覆盖canvas的[page:Texture]（纹理），
			
 
				+		或是 a cubemap as a [page:CubeTexture] or [page:WebGLCubeRenderTarget] or an equirectangular as a [page:Texture]。默认值为null。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Texture environment]</h3>
			
 
				 		<p>
			
 
				-		If not null, this texture is set as the environment map for all physical materials in the scene.
			
 
				-		However, it's not possible to overwrite an existing texture assigned to [page:MeshStandardMaterial.envmap]. Default is null.
			
 
				+    若该值不为null，则该纹理贴图将会被设为场景中所有物理材质的环境贴图。
			
 
				+    然而，该属性不能够覆盖已存在的、已分配给 [page:MeshStandardMaterial.envMap] 的贴图。默认为null。
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Fog fog]</h3>
			
--- a/docs/api/zh/textures/CubeTexture.html
+++ b/docs/api/zh/textures/CubeTexture.html
@@ -42,12 +42,15 @@
 
				 
			
 
				 		<h2>属性</h2>
			
 
				 
			
 
				-		<h3>请参阅[page:Texture]页面。</h3>
			
 
				+		<p>
			
 
				+		See the base [page:Texture Texture] class for common properties.
			
 
				+		</p>
			
 
				 
			
 
				 		<h2>方法</h2>
			
 
				 
			
 
				-
			
 
				-		<h3>请参阅[page:Texture]页面。</h3>
			
 
				+		<p>
			
 
				+		See the base [page:Texture Texture] class for common methods.
			
 
				+		</p>
			
 
				 
			
 
				 		<h2>源代码</h2>
			
 
				 
			
--- a/docs/api/zh/textures/DataTexture.html
+++ b/docs/api/zh/textures/DataTexture.html
@@ -12,18 +12,18 @@
 
				 
			
 
				 		<h1>[name]</h1>
			
 
				 
			
 
				-		<p class="desc">Creates a texture directly from raw data, width and height.</p>
			
 
				+		<p class="desc">从原始数据（raw data）、宽（width）、高（height）来直接创建一个纹理贴图。</p>
			
 
				 
			
 
				 
			
 
				-		<h2>Constructor</h2>
			
 
				+		<h2>构造函数</h2>
			
 
				 
			
 
				 		<h3>[name]( data, width, height, format, type, mapping, wrapS, wrapT, magFilter, minFilter, anisotropy )</h3>
			
 
				 		<p>
			
 
				-			The data argument must be an [link:https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView ArrayBufferView].
			
 
				-			Further parameters correspond to the properties inherited from [page:Texture], where both magFilter and minFilter default to THREE.NearestFilter. The properties flipY and generateMipmaps are intially set to false.
			
 
				+			data 参数必须是一个 [link:https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView ArrayBufferView] 。
			
 
				+			其他参数对应于继承自 [page:Texture] 的属性，其中 magFilter 与 minFilter 默认为 THREE.NearestFilter。属性 flipY 和 generateMipmaps 初始设为 false。
			
 
				 		</p>
			
 
				 		<p>
			
 
				-			The interpretation of the data depends on type and format:
			
 
				+			数据的解释取决于type与format：
			
 
				 			If the type is THREE.UnsignedByteType, a Uint8Array will be useful for addressing the texel data.
			
 
				 			If the format is THREE.RGBAFormat, data needs four values for one texel; Red, Green, Blue and Alpha (typically the opacity). Similarly, THREE.RGBFormat specifies a format where only three values are used for each texel.<br />
			
 
				 
			
@@ -59,17 +59,24 @@
 
				 		var texture = new THREE.DataTexture( data, width, height, THREE.RGBFormat );
			
 
				 		</code>
			
 
				 
			
 
				-		<h2>Properties</h2>
			
 
				+		<h2>属性</h2>
			
 
				+
			
 
				+		<p>
			
 
				+		See the base [page:Texture Texture] class for common properties.
			
 
				+		</p>
			
 
				 
			
 
				 		<h3>[property:Image image]</h3>
			
 
				 		<p>
			
 
				 		Overridden with a record type holding data, width and height.
			
 
				 		</p>
			
 
				 
			
 
				-		<h2>Methods</h2>
			
 
				+		<h2>方法</h2>
			
 
				 
			
 
				+		<p>
			
 
				+		See the base [page:Texture Texture] class for common methods.
			
 
				+		</p>
			
 
				 
			
 
				-		<h2>Source</h2>
			
 
				+		<h2>源码</h2>
			
 
				 
			
 
				 		<p>
			
 
				 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
			
--- a/docs/api/zh/textures/DataTexture3D.html
+++ b/docs/api/zh/textures/DataTexture3D.html
@@ -39,6 +39,14 @@
 
				 		共有属性请参见其基类[page:Texture Texture]。
			
 
				 		</p>
			
 
				 
			
 
				+		<h3>[property:number wrapR]</h3>
			
 
				+		<p>
			
 
				+		This defines how the texture is wrapped in the depth direction.<br />
			
 
				+		The default is [page:Textures THREE.ClampToEdgeWrapping], where the edge is clamped to the outer edge texels.
			
 
				+		The other two choices are [page:Textures THREE.RepeatWrapping] and [page:Textures THREE.MirroredRepeatWrapping].
			
 
				+		See the [page:Textures texture constants] page for details.
			
 
				+		</p>
			
 
				+
			
 
				 		<h2>方法</h2>
			
 
				 
			
 
				 		<p>
			
--- a/docs/api/zh/textures/Texture.html
+++ b/docs/api/zh/textures/Texture.html
@@ -117,6 +117,17 @@
 
				 		请参阅[page:Textures texture constants]页面来了解其它格式。
			
 
				 		</p>
			
 
				 
			
 
				+		<h3>[property:String internalFormat]</h3>
			
 
				+		<p>
			
 
				+		The default value is obtained using a combination of [page:Texture.format .format] and
			
 
				+		[page:Texture.type .type].<br />
			
 
				+
			
 
				+		The GPU format allows the developer to specify how the data is going to be
			
 
				+		stored on the GPU.<br /><br />
			
 
				+
			
 
				+		See the [page:Textures texture constants] page for details regarding all supported internal formats.
			
 
				+		</p>
			
 
				+
			
 
				 		<h3>[property:number type]</h3>
			
 
				 		<p>
			
 
				 			这个值必须与[page:Texture.format .format]相对应。默认值为[page:Textures THREE.UnsignedByteType]，
			
@@ -178,7 +189,7 @@
 
				 
			
 
				 		<h3>[property:boolean premultiplyAlpha]</h3>
			
 
				 		<p>
			
 
				-		If set to *true*, the alpha channel, if present, is multiplied into the color channels when the texture is uploaded to the GPU. Defaut is *false*.<br /><br />
			
 
				+		If set to *true*, the alpha channel, if present, is multiplied into the color channels when the texture is uploaded to the GPU. Default is *false*.<br /><br />
			
 
				 
			
 
				 		Note that this property has no effect for [link:https://developer.mozilla.org/de/docs/Web/API/ImageBitmap ImageBitmap].
			
 
				 		You need to configure on bitmap creation instead. See [page:ImageBitmapLoader].
			
--- a/docs/examples/en/controls/DeviceOrientationControls.html
+++ b/docs/examples/en/controls/DeviceOrientationControls.html
@@ -31,6 +31,13 @@
 
				 			</p>
			
 
				 		</p>
			
 
				 
			
 
				+		<h2>Events</h2>
			
 
				+
			
 
				+		<h3>change</h3>
			
 
				+		<p>
			
 
				+			Fires when the camera has been transformed by the controls.
			
 
				+		</p>
			
 
				+
			
 
				 		<h2>Properties</h2>
			
 
				 
			
 
				 		<h3>[property:Number alphaOffset]</h3>
			
--- a/docs/examples/en/controls/FlyControls.html
+++ b/docs/examples/en/controls/FlyControls.html
@@ -35,6 +35,13 @@
 
				 			</p>
			
 
				 		</p>
			
 
				 
			
 
				+		<h2>Events</h2>
			
 
				+
			
 
				+		<h3>change</h3>
			
 
				+		<p>
			
 
				+			Fires when the camera has been transformed by the controls.
			
 
				+		</p>
			
 
				+
			
 
				 		<h2>Properties</h2>
			
 
				 
			
 
				 		<h3>[property:Boolean autoForward]</h3>
			
--- a/docs/examples/en/controls/TrackballControls.html
+++ b/docs/examples/en/controls/TrackballControls.html
@@ -86,12 +86,12 @@
 
				 
			
 
				 		<h3>[property:Number maxDistance]</h3>
			
 
				 		<p>
			
 
				-			 How far you can zoom in. Default is *Infinity*.
			
 
				+			How far you can zoom out. Default is *Infinity*.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>[property:Number minDistance]</h3>
			
 
				 		<p>
			
 
				-			 How far you can zoom in. Default is *0*.
			
 
				+			How far you can zoom in. Default is *0*.
			
 
				 		</p>
			
 
				 
			
 
				 		<h3>
			
@@ -99,9 +99,9 @@
 
				 		<p>
			
 
				 			This object contains references to the mouse actions used by the controls.
			
 
				 			<ul>
			
 
				-				<li>.LEFT is assinged with *THREE.MOUSE.ROTATE*</li>
			
 
				-				<li>.MIDDLE is assinged with *THREE.MOUSE.ZOOM*</li>
			
 
				-				<li>.RIGHT is assinged with *THREE.MOUSE.PAN*</li>
			
 
				+				<li>.LEFT is assigned with *THREE.MOUSE.ROTATE*</li>
			
 
				+				<li>.MIDDLE is assigned with *THREE.MOUSE.ZOOM*</li>
			
 
				+				<li>.RIGHT is assigned with *THREE.MOUSE.PAN*</li>
			
 
				 			</ul>
			
 
				 		</p>
			
 
				 
			
--- a/docs/examples/en/loaders/3DMLoader.html
+++ b/docs/examples/en/loaders/3DMLoader.html
@@ -0,0 +1,177 @@
 
				+<!DOCTYPE html>
			
 
				+<html lang="en">
			
 
				+	<head>
			
 
				+		<meta charset="utf-8" />
			
 
				+		<base href="../../../" />
			
 
				+		<script src="list.js"></script>
			
 
				+		<script src="page.js"></script>
			
 
				+		<link type="text/css" rel="stylesheet" href="page.css" />
			
 
				+	</head>
			
 
				+	<body>
			
 
				+		[page:Loader] &rarr;
			
 
				+		<h1>[name]</h1>
			
 
				+
			
 
				+		<p class="desc">
			
 
				+			A loader for Rhinoceros 3d files and objects. <br /><br />
			
 
				+			Rhinoceros is a 3D modeler used to create, edit, analyze, document, render, animate, and translate NURBS curves, surfaces, solids, point clouds, as well as polygon meshes and SubD objects.
			
 
				+			[link:https://github.com/mcneel/rhino3dm rhino3dm.js] is compiled to WebAssembly from the open source geometry library [link:https://github.com/mcneel/opennurbs openNURBS].
			
 
				+
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>Supported Conversions</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[name] loads the following objects to a respective three.js type:
			
 
				+		</p>
			
 
				+
			
 
				+		<table>
			
 
				+			<tr>
			
 
				+				<th>3dm type</th>
			
 
				+				<th>three.js type</th>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>Point</td>
			
 
				+				<td>[page:Points Points]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>PointSet</td>
			
 
				+				<td>[page:Points Points]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>TextDot</td>
			
 
				+				<td>[page:Sprite Sprite]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>Curve</td>
			
 
				+				<td>[page:Line Line]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>Mesh</td>
			
 
				+				<td>[page:Mesh Mesh]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>Extrusion</td>
			
 
				+				<td>[page:Mesh Mesh]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>BREP</td>
			
 
				+				<td>[page:Object3D Object3D]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>InstanceReferences</td>
			
 
				+				<td>[page:Object3D Object3D]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>DirectionalLight</td>
			
 
				+				<td>[page:DirectionalLight DirectionalLight]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>PointLight</td>
			
 
				+				<td>[page:PointLight PointLight]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>RectangularLight</td>
			
 
				+				<td>[page:RectAreaLight RectAreaLight]</td>
			
 
				+			</tr>
			
 
				+			<tr>
			
 
				+				<td>SpotLight</td>
			
 
				+				<td>[page:SpotLight SpotLight]</td>
			
 
				+			</tr>
			
 
				+		</table>
			
 
				+
			
 
				+		<h2>Code Example</h2>
			
 
				+
			
 
				+		<code>
			
 
				+		// Instantiate a loader
			
 
				+		var loader = new Rhino3dmLoader();
			
 
				+
			
 
				+		// Specify path to a folder containing WASM/JS libraries.
			
 
				+		loader.setLibraryPath( '/examples/jsm/libs/rhino3dm/' );
			
 
				+
			
 
				+		// Load a 3DM file
			
 
				+		loader.load(
			
 
				+			// resource URL
			
 
				+			'model.3dm',
			
 
				+			// called when the resource is loaded
			
 
				+			function ( object ) {
			
 
				+
			
 
				+				scene.add( object );
			
 
				+
			
 
				+			},
			
 
				+			// called as loading progresses
			
 
				+			function ( xhr ) {
			
 
				+
			
 
				+				console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );
			
 
				+
			
 
				+			},
			
 
				+			// called when loading has errors
			
 
				+			function ( error ) {
			
 
				+
			
 
				+				console.log( 'An error happened' );
			
 
				+
			
 
				+			}
			
 
				+		);
			
 
				+		</code>
			
 
				+
			
 
				+		<h2>Examples</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[example:webgl_loader_3dm]
			
 
				+		</p>
			
 
				+
			
 
				+		<hr>
			
 
				+
			
 
				+		<h2>Constructor</h2>
			
 
				+
			
 
				+		<h3>Rhino3dmLoader( [param:LoadingManager manager] )</h3>
			
 
				+		<p>
			
 
				+		[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use. Default is [page:LoadingManager THREE.DefaultLoadingManager].
			
 
				+		</p>
			
 
				+		<p>
			
 
				+		Creates a new Rhino3dmLoader.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>Properties</h2>
			
 
				+		<p>See the base [page:Loader] class for common properties.</p>
			
 
				+
			
 
				+		<h2>Methods</h2>
			
 
				+		<p>See the base [page:Loader] class for common methods.</p>
			
 
				+
			
 
				+		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
			
 
				+		<p>
			
 
				+		[page:String url] — A string containing the path/URL of the <em>.3dm</em> file.<br />
			
 
				+		[page:Function onLoad] — A function to be called after the loading is successfully completed.<br />
			
 
				+		[page:Function onProgress] — (optional) A function to be called while the loading is in progress. The argument will be the XMLHttpRequest instance, that contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
			
 
				+		[page:Function onError] — (optional) A function to be called if an error occurs during loading. The function receives error as an argument.<br />
			
 
				+		</p>
			
 
				+		<p>
			
 
				+		Begin loading from url and call the <em>onLoad</em> function with the geometry.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:this setLibraryPath]( [param:String value] )</h3>
			
 
				+		<p>
			
 
				+		[page:String value] — Path to folder containing the JS and WASM libraries.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:this setWorkerLimit]( [param:Number workerLimit] )</h3>
			
 
				+		<p>
			
 
				+			[page:Number workerLimit] - Maximum number of workers to be allocated. Default is 4.<br />
			
 
				+		</p>
			
 
				+		<p>
			
 
				+		Sets the maximum number of [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers Web Workers]
			
 
				+		to be used during decoding. A lower limit may be preferable if workers are also for other tasks
			
 
				+		in the application.
			
 
				+		</p>
			
 
				+
			
 
				+		<h3>[method:this dispose]()</h3>
			
 
				+		<p>
			
 
				+		Disposes of the loader resources and deallocates memory.
			
 
				+		</p>
			
 
				+
			
 
				+		<h2>Source</h2>
			
 
				+
			
 
				+		<p>
			
 
				+			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/loaders/3DMLoader.js examples/jsm/loaders/3DMLoader.js]
			
 
				+		</p>
			
 
				+	</body>
			
 
				+</html>