5 年之前 · ac7b57d69e
--- a/.github/CODE_OF_CONDUCT.md
+++ b/.github/CODE_OF_CONDUCT.md
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -56,13 +56,6 @@ The next most important script runs all the appropriate testing.
 
															 The linting is there to keep a consistent code-style across the all of the code and the testing is
														
 
															 there to help catch bugs and check that the code behaves as expected. It is important that
														
 
															 neither of these steps comes up with any errors due to your changes.
														
 
															-* If you’d like the linter to fix any errors that it can change, make the following addition to the “test-lint” script.
														
 
															-        
														
 
															-        {
														
 
															-        ...
														
 
															-        "test-lint": "eslint src --ext js --ext ts --fix && tsc -p utils/build/tsconfig.lint.json"
														
 
															-        ...
														
 
															-        }
														
 
															 If you’d like to make a minified version of the build files i.e. ‘build/three.min.js’ run:
														
--- 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
														
 
															-- [ ] r118
														
 
															+- [ ] r119
														
 
															 - [ ] ...
														
 
															 ##### Browser
														
--- 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/AnimationAction.html
+++ b/docs/api/ar/animation/AnimationAction.html
@@ -0,0 +1,317 @@
 
															+<!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">
														
 
															+			تقوم AnimationActions بجدولة أداء الرسوم المتحركة المخزنة في [page:AnimationClip AnimationClips].
														
 
															+			<br /><br />
														
 
															+
														
 
															+			ملاحظة: يمكن ربط معظم أساليب AnimationAction.<br /><br />
														
 
															+
														
 
															+			للحصول على نظرة عامة حول العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>المنشئ (Constructor)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[name]( [param:AnimationMixer mixer], [param:AnimationClip clip], [param:Object3D localRoot] )</h3>
														
 
															+		<p>
														
 
															+			[page:AnimationMixer mixer] هو *AnimationMixer* الذي يتحكم فيه هذا الإجراء.<br />
														
 
															+			[page:AnimationClip clip] هو *AnimationClip* الذي يحتفظ ببيانات الرسوم المتحركة لهذا الإجراء.<br />
														
 
															+			[page:Object3D localRoot] هو الكائن الجذر الذي يتم تنفيذ هذا الإجراء عليه.<br /><br />
														
 
															+
														
 
															+			ملاحظة: بدلاً من استدعاء هذا المُنشئ مباشرةً ، يجب إنشاء AnimationAction برقم [page:AnimationMixer.clipAction] نظرًا لأن هذه الطريقة توفر التخزين المؤقت للحصول على أداء أفضل.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الخصائص (Properties)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[property:Boolean clampWhenFinished]</h3>
														
 
															+		<p>
														
 
															+			إذا تم ضبط *clampWhenFinished* على true ، فسيتم تلقائيًا إيقاف [page:.paused paused] للرسوم المتحركة مؤقتًا في إطارها الأخير.<br /><br />
														
 
															+
														
 
															+			إذا تم ضبط *clampWhenFinished* على false ، فسيتم تحويل [page:.enabled enabled] تلقائيًا إلى false عند انتهاء آخر حلقة من الإجراء ، بحيث لا يكون لهذا الإجراء أي تأثير آخر.<br /><br />
														
 
															+
														
 
															+			القيمة الافتراضية هو خطأ (false).<br /><br />
														
 
															+
														
 
															+			ملاحظة: *clampWhenFinished* ليس له أي تأثير إذا تم مقاطعة الإجراء (يكون له تأثير فقط إذا انتهت الحلقة الأخيرة بالفعل).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean enabled]</h3>
														
 
															+		<p>
														
 
															+			يؤدي تعيين *enabled* إلى *false* إلى تعطيل هذا الإجراء ، بحيث لا يكون له أي تأثير. الافتراضي هو *true*.<br /><br />
														
 
															+
														
 
															+			عند إعادة تمكين الإجراء ، يستمر الرسم المتحرك من وقته الحالي [page:.time time] (الإعداد *enabled* إلى *false* لا يعيد تعيين الإجراء).<br /><br />
														
 
															+
														
 
															+			ملاحظة: لا يؤدي إعداد *enabled* إلى *true* إلى إعادة تشغيل الرسوم المتحركة تلقائيًا. سيؤدي ضبط *enabled* إلى *true* إلى إعادة تشغيل الرسوم المتحركة فورًا فقط إذا تم استيفاء الشرط التالي:
														
 
															+			[page:.paused paused] تحتوي قيمة *false* ، لم يتم إلغاء تنشيط هذا الإجراء في هذه الأثناء (بتنفيذ أمر [page:.stop stop] أو [page:.reset reset]) ، وليس [page:.weight weight] أو [page:.timeScale timeScale] يساوي 0.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Number loop]</h3>
														
 
															+		<p>
														
 
															+			وضع التكرار (يمكن تغييره بـ [page:.setLoop setLoop]). الافتراضي هو [page:Animation THREE.LoopRepeat] (مع عدد لا نهائي من [page:.repetitions repetitions])<br /><br />
														
 
															+
														
 
															+			يجب أن يكون أحد هذه الثوابت:<br /><br />
														
 
															+			[page:Animation THREE.LoopOnce] - تشغيل المقطع مرة واحدة ،<br />
														
 
															+			[page:Animation THREE.LoopRepeat] - تشغيل المقطع مع العدد المختار من *التكرارات* ،
														
 
															+			في كل مرة تقفز من نهاية المقطع مباشرة إلى بدايته ،<br />
														
 
															+			[page:Animation THREE.LoopPingPong] - تشغيل المقطع مع العدد المختار من *التكرارات* ، بدلاً من التشغيل للأمام والخلف.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean paused]</h3>
														
 
															+		<p>
														
 
															+			يؤدي تعيين *paused* إلى *true* إلى إيقاف تنفيذ الإجراء مؤقتًا عن طريق تعيين مقياس الوقت الفعال على 0. الافتراضي هو *false*.<br /><br />
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Number repetitions]</h3>
														
 
															+		<p>
														
 
															+			عدد التكرارات التي تم إجراؤها [page:AnimationClip] على مدار هذا الإجراء. يمكن تعيينه عبر [page:.setLoop setLoop]. الافتراضي هو *Infinity*.<br /><br />
														
 
															+			ضبط هذا الرقم ليس له أي تأثير ، إذا تم ضبط [page:.loop loop mode] على [page:Animation THREE.LoopOnce].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Number time]</h3>
														
 
															+		<p>
														
 
															+			the local time of this action (in seconds, starting with 0).<br /><br />
														
 
															+
														
 
															+			يتم تثبيت القيمة أو لفها إلى 0 ... مدة المقطع (وفقًا لحالة الحلقة).
														
 
															+			يمكن تغير قيمتها بالنسبة إلى وقت لخالط الحركات الرئيسي عن طريق تغيير [page:.timeScale timeScale] (باستخدام [page:.setEffectiveTimeScale setEffectiveTimeScale] أو [page:.setDuration setDuration]).<br />
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Number timeScale]</h3>
														
 
															+		<p>
														
 
															+			Sعامل التحجيم للوقت [page:.time time]. تؤدي القيمة 0 إلى توقف الرسوم المتحركة مؤقتًا. تؤدي القيم السالبة إلى تشغيل الرسوم المتحركة بشكل عكسي. الافتراضي هو 1.<br /><br />
														
 
															+			الخصائص / الطرق المتعلقة *timeScale* (على التوالي *time*) هم:
														
 
															+			[page:.getEffectiveTimeScale getEffectiveTimeScale],
														
 
															+			[page:.halt halt],
														
 
															+			[page:.paused paused],
														
 
															+			[page:.setDuration setDuration],
														
 
															+			[page:.setEffectiveTimeScale setEffectiveTimeScale],
														
 
															+			[page:.stopWarping stopWarping],
														
 
															+			[page:.syncWith syncWith],
														
 
															+			[page:.warp warp].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Number weight]</h3>
														
 
															+		<p>
														
 
															+			درجة تأثير هذا الإجراء (في المجال القائم بين [0 ، 1]). يمكن استخدام القيم بين 0 (بدون تأثير) و 1 (تأثير كامل) للمزج بين عدة إجراءات. الافتراضي هو 1. <br /><br />
														
 
															+			الخصائص / الطرق المتعلقة *weight* هي:
														
 
															+			[page:.crossFadeFrom crossFadeFrom],
														
 
															+			[page:.crossFadeTo crossFadeTo],
														
 
															+			[page:.enabled enabled],
														
 
															+			[page:.fadeIn fadeIn],
														
 
															+			[page:.fadeOut fadeOut],
														
 
															+			[page:.getEffectiveWeight getEffectiveWeight],
														
 
															+			[page:.setEffectiveWeight setEffectiveWeight],
														
 
															+			[page:.stopFading stopFading].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean zeroSlopeAtEnd]</h3>
														
 
															+		<p>
														
 
															+			يتيح تشغيل السلس بدون مقاطع منفصلة للبداية والحلقة والنهاية. الافتراضي هو *true*.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean zeroSlopeAtStart]</h3>
														
 
															+		<p>
														
 
															+			يتيح تشغيل السلس بدون مقاطع منفصلة للبداية والحلقة والنهاية. الافتراضي هو *true*.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الوظائف (Methods)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[method:AnimationAction crossFadeFrom]( [param:AnimationAction fadeOutAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3>
														
 
															+		<p>
														
 
															+			يؤدي هذا الإجراء إلى تلاشي [page:.fadeIn fade in] ، مما يؤدي إلى تلاشي إجراء آخر في نفس الوقت ، خلال الفترة الزمنية المنقضية. يمكن تقييد هذه الطريقة.<br /><br />
														
 
															+
														
 
															+			إذا كانت warpBoolean تحمل قيمة true ، فسيتم تطبيق [page:.warp warping] إضافيًا (تغييرات تدريجية في المقاييس الزمنية).<br /><br />
														
 
															+
														
 
															+			ملاحظة: كما هو الحال مع *fadeIn*/*fadeOut* ، يبدأ / ينتهي التلاشي بوزن 1.
														
 
															+
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction crossFadeTo]( [param:AnimationAction fadeInAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3>
														
 
															+		<p>
														
 
															+			يؤدي هذا الإجراء إلى تلاشي [page:.fadeOut fade out] ، يتلاشى في إجراء آخر في وقت واحد ، خلال الفترة الزمنية المنقضية. يمكن تقييد هذه الطريقة ضمن سلسلة.<br /><br />
														
 
															+			إذا كانت warpBoolean صحيحة ، فسيتم تطبيق [page:.warp warping] إضافيًا (تغييرات تدريجية في المقاييس الزمنية).<br /><br />
														
 
															+
														
 
															+			ملاحظة: كما هو الحال مع *fadeIn*/*fadeOut* ، يبدأ / ينتهي التلاشي بوزن 1.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction fadeIn]( [param:Number durationInSeconds] )</h3>
														
 
															+		<p>
														
 
															+			يزيد [page:.weight weight] هذا الإجراء تدريجياً من 0 إلى 1 ، خلال الفترة الزمنية المنقضية. يمكن تقييد هذه الطريقة ضمن سلسلة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction fadeOut]( [param:Number durationInSeconds] )</h3>
														
 
															+		<p>
														
 
															+			يقلل [page:.weight weight] هذا الإجراء تدريجيًا من 1 إلى 0 ، خلال الفترة الزمنية المنقضية. يمكن تقييد هذه الطريقة ضمن سلسلة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:Number getEffectiveTimeScale]()</h3>
														
 
															+		<p>
														
 
															+			تُرجع مقياس الوقت الفعال (مع الأخذ في الاعتبار حالات التواء و قيمة [page:.paused paused] الحالية).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:number getEffectiveWeight]()</h3>
														
 
															+		<p>
														
 
															+			تُرجع الوزن الفعال (مع الأخذ في الاعتبار حالات التلاشي الحالية و [page:.enabled enabled]).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationClip getClip]()</h3>
														
 
															+		<p>
														
 
															+			تُرجع المقطع الذي يحتوي على بيانات الرسوم المتحركة لهذا الإجراء.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationMixer getMixer]()</h3>
														
 
															+		<p>
														
 
															+			تُرجع الخالط المسؤول عن تشغيل هذا الإجراء.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:Object3D getRoot]()</h3>
														
 
															+		<p>
														
 
															+			تُرجع الكائن الجذر الذي تم تنفيذ هذا الإجراء عليه.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction halt]( [param:Number durationInSeconds] )</h3>
														
 
															+		<p>
														
 
															+			تعمل على إبطاء سرعة هذه الرسوم المتحركة إلى 0 من خلال إنقاص [page:.timeScale timeScale] تدريجيًا (بدءًا من قيمتها الحالية) ، خلال الفترة الزمنية المنقضية. يمكن تقييد هذه الطريقة ضمن سلسلة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:Boolean isRunning]()</h3>
														
 
															+		<p>
														
 
															+			تُرجع true إذا كان الإجراء [page:.time time] قيد التشغيل حاليًا.<br /><br />
														
 
															+
														
 
															+			بالإضافة إلى تفعيله في الخالط (انظر [page:.isScheduled isScheduled]) ، يجب استيفاء الشروط التالية:
														
 
															+			<br/>
														
 
															+			[page:.paused paused] يساوي false ،<br/> [page:.enabled enabled] يساوي true ،
														
 
															+			<br/>
														
 
															+			[page:.timeScale timeScale] يختلف عن 0 ، ولا توجد جدولة لبدء متأخر ([page:.startAt startAt]).<br /><br />
														
 
															+
														
 
															+			ملاحظة: لا يعني كون *isRunning* تحمل قيمة *true* أنه يمكن رؤية الرسوم المتحركة بالفعل. هذا هو الحال فقط ، إذا تم تعيين [page:.weight weight] بشكل إضافي على قيمة غير صفرية.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:Boolean isScheduled]()</h3>
														
 
															+		<p>
														
 
															+			تُرجع قيمة *true* ، إذا تم تنشيط هذا الإجراء في الخالط.<br /><br />
														
 
															+			ملاحظة: هذا لا يعني بالضرورة أن الرسوم المتحركة تعمل بالفعل (قارن الشروط الإضافية لـ [page:.isRunning isRunning]).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction play]()</h3>
														
 
															+		<p>
														
 
															+			يعلم الخالط بضرورة البدء في تنشيط الحدث (action). يمكن تقييد هذه الطريقة ضمن سلسلة. <br /><br />
														
 
															+
														
 
															+			ملاحظة: لا يعني تنشيط هذا الإجراء بالضرورة أن الرسوم المتحركة تبدأ على الفور: إذا كان الإجراء قد انتهى بالفعل من قبل (من خلال الوصول إلى نهاية الحلقة الأخيرة) ، أو إذا تم تعيين وقت لبدء متأخر (عبر [page:.startAt startAt]) ،
														
 
															+			يجب تنفيذ [page:.reset reset] أولاً. يمكن لبعض الإعدادات الأخرى ([page:.paused paused]=true, [page:.enabled enabled]=false,
														
 
															+			[page:.weight weight]=0, [page:.timeScale timeScale]=0) منع تشغيل الرسوم المتحركة أيضًا.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction reset]()</h3>
														
 
															+		<p>
														
 
															+			يتم إعادة الحدث إلى وضع البداية. يمكن تقييد هذه الطريقة ضمن سلسلة.<br /><br />
														
 
															+
														
 
															+			تقوم هذه الطريقة بتعيين [page:.paused paused] إلى false ، و [page:.enabled enabled] إلى true ، ومن [page:.time time] إلى 0 ، وتقطع أي تزييف مجدول ، وتزيل عدد الحلقات الداخلية وجدولة البدء المتأخر.<br /><br />
														
 
															+
														
 
															+			ملاحظة: يتم استدعاء. *reset* دائمًا بواسطة [page:.stop stop] ، ولكن *reset* لا يتصل بـ *stop* نفسه.
														
 
															+			هذا يعني: إذا كنت تريد كلاهما ، reset وstop ، لا تتصل بـ *reset* بل إتصل بـ *stop* بدلا من ذلك.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction setDuration]( [param:Number durationInSeconds] )</h3>
														
 
															+		<p>
														
 
															+			يضبط المدة لحلقة واحدة من هذا الإجراء (بضبط [page:.timeScale timeScale] وإيقاف أي إلتفاف مجدول). يمكن تقييد هذه الطريقة ضمن سلسلة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction setEffectiveTimeScale]( [param:Number timeScale] )</h3>
														
 
															+		<p>
														
 
															+			يضبط [page:.timeScale timeScale] ويوقف أي إلتفاف مجدول. يمكن تقييد هذه الطريقة ضمن سلسلة. <br /><br />
														
 
															+
														
 
															+			إذا كانت القيمة [page:.paused paused] تحمل false ، فسيتم أيضًا تعيين المقياس الزمني الفعال (خاصية داخلية) على هذه القيمة ؛
														
 
															+			وإلا فسيتم تعيين النطاق الزمني الفعال (الذي يؤثر بشكل مباشر على الرسم المتحرك في هذه اللحظة) على 0.<br /><br />
														
 
															+
														
 
															+			ملاحظة: *paused* لن يتم تحويله إلى *true* تلقائيًا ، إذا تم ضبط *timeScale* على 0 بهذه الطريقة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction setEffectiveWeight]( [param:Number weight] )</h3>
														
 
															+		<p>
														
 
															+			تضبط [page:.weight weight] وتوقف أي تضاؤل مجدول. يمكن تقييد هذه الطريقة ضمن سلسلة. <br /><br />
														
 
															+
														
 
															+			إذا كانت قيمة [page:.enabled enabled] هي true ، فسيتم أيضًا تعيين الوزن الفعال (خاصية داخلية) على هذه القيمة ؛
														
 
															+			وإلا فسيتم تعيين الوزن الفعال (الذي يؤثر بشكل مباشر على الرسم المتحرك في هذه اللحظة) على 0.<br /><br />
														
 
															+
														
 
															+			ملاحظة: لن يتم تحويل *enabled* إلى false تلقائيًا ، إذا تم ضبط *weight* على 0 بهذه الطريقة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction setLoop]( [param:Number loopMode], [param:Number repetitions] )</h3>
														
 
															+		<p>
														
 
															+			يعين [page:.loop loop mode] وعدد [page:.repetitions repetitions]. يمكن تقييد هذه الطريقة ضمن سلسلة
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction startAt]( [param:Number startTimeInSeconds] )</h3>
														
 
															+		<p>
														
 
															+			يحدد وقت البداية المتأخرة (عادةً ما يتم تمريره كـ [page:AnimationMixer.time] + deltaTimeInSeconds). يمكن تقييد هذه الطريقة ضمن سلسلة. <br /><br />
														
 
															+
														
 
															+			ملاحظة: ستبدأ الرسوم المتحركة فقط في الوقت المحدد ، إذا تم ربط *startAt* بـ [page:.play play] ،
														
 
															+			أو إذا تم بالفعل تنشيط الإجراء في الخالط (عن طريق استدعاء سابق لـ. *play* ، دون إيقافه أو إعادة تعيينه في هذه الأثناء).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction stop]()</h3>
														
 
															+		<p>
														
 
															+			يخبر الخالط بإلغاء تنشيط هذا الإجراء. يمكن تقييد هذه الطريقة ضمن سلسلة. <br /><br />
														
 
															+
														
 
															+			سيتم إيقاف الإجراء على الفور وإعادة تعيين [page:.reset reset] بالكامل.<br /><br />
														
 
															+
														
 
															+			ملاحظة: يمكنك إيقاف جميع الإجراءات النشطة على نفس الخالط دفعة واحدة عبر [page:AnimationMixer.stopAllAction mixer.stopAllAction].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction stopFading]()</h3>
														
 
															+		<p>
														
 
															+			يوقف أي [page:.fadeIn fading] مجدولًا يتم تطبيقه على هذا الحدث. يمكن تقييد هذه الطريقة ضمن سلسلة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction stopWarping]()</h3>
														
 
															+		<p>
														
 
															+			يوقف أي [page:.warp warping] مجدولًا يتم تطبيقه على هذا الحدث. يمكن تقييد هذه الوظيفة ضمن سلسلة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction syncWith]( [param:AnimationAction otherAction] )</h3>
														
 
															+		<p>
														
 
															+			يزامن هذا الإجراء مع الإجراء الآخر الذي تم تمريره. يمكن تقييد هذه الوظيفة ضمن سلسلة. <br /><br />
														
 
															+
														
 
															+			تتم المزامنة عن طريق تعيين قيم [page:.time time] و [page:.timeScale timeScale] لهذا الإجراء على القيم المقابلة للإجراء الآخر (إيقاف أي التواء مجدول).<br /><br />
														
 
															+
														
 
															+			ملاحظة: لن يتم الكشف عن التغييرات المستقبلية في *time* و *timeScale* للإجراء الآخر.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction warp]( [param:Number startTimeScale], [param:Number endTimeScale], [param:Number durationInSeconds] )</h3>
														
 
															+		<p>
														
 
															+			يغير سرعة التشغيل ، خلال الفترة الزمنية المنقضية ، عن طريق تعديل [page:.timeScale timeScale] تدريجيًا من *startTimeScale* إلى *endTimeScale*.يمكن تقييد هذه الوظيفة ضمن سلسلة.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الأحداث (Events)</h2>
														
 
															+
														
 
															+
														
 
															+		<p class="desc">
														
 
															+			هناك حدثان يشيران عند انتهاء حلقة واحدة من الإجراء على التوالي. يمكنك الرد عليهم من خلال:
														
 
															+		</p>
														
 
															+		<code>
														
 
															+		mixer.addEventListener( 'loop', function( e ) { …} ); // properties of e: type, action and loopDelta
														
 
															+		mixer.addEventListener( 'finished', function( e ) { …} ); // properties of e: type, action and direction
														
 
															+		</code>
														
 
															+
														
 
															+		<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/AnimationClip.html
+++ b/docs/api/ar/animation/AnimationClip.html
@@ -0,0 +1,130 @@
 
															+<!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">
														
 
															+			AnimationClip عبارة عن مجموعة قابلة لإعادة الاستخدام من مسارات الإطارات الرئيسية التي تمثل رسمًا متحركًا.<br /><br />
														
 
															+
														
 
															+			للحصول على نظرة عامة حول العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>المنشئ (Constructor)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[name]( [param:String name], [param:Number duration], [param:Array tracks] )</h3>
														
 
															+		<p>
														
 
															+			[page:String name] - اسم لهذا المقطع.<br />
														
 
															+			[page:Number duration] - مدة هذا المقطع (بالثواني). إذا تم تمرير قيمة سالبة ، فسيتم حساب المدة من *tracks* التي تم تمريرها.<br />
														
 
															+			[page:Array tracks] - مجموعة (جدول) من [page:KeyframeTrack KeyframeTracks].<br /><br />
														
 
															+
														
 
															+			ملاحظة: بدلاً من إنشاء AnimationClip مباشرةً مع المُنشئ ، يمكنك استخدام إحدى طرقه الثابتة لإنشاء AnimationClips: من JSON ([page:.parse parse]) ، من تسلسلات الهدف التحويلية ([page:.CreateFromMorphTargetSequence CreateFromMorphTargetSequence] ،
														
 
															+			[page:.CreateClipsFromMorphTargetSequences CreateClipsFromMorphTargetSequences]) أو من التسلسلات الهرمية للرسوم المتحركة ([page:.parseAnimation parseAnimation]) - إذا كان النموذج الخاص بك لا يحتوي بالفعل على AnimationClips في مجموعة الرسوم المتحركة الخاصة بهندسة.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الخصائص (Properties)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[property:Number duration]</h3>
														
 
															+		<p>
														
 
															+			مدة هذا المقطع (بالثواني). يمكن حساب ذلك من مجموعة [page:.tracks tracks]  عبر [page:.resetDuration resetDuration].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:String name]</h3>
														
 
															+		<p>
														
 
															+			اسم لهذا المقطع. يمكن البحث عن مقطع معين طريق بإستعمال [page:.findByName findByName].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Array tracks]</h3>
														
 
															+		<p>
														
 
															+			جدول يحتوي على [page:KeyframeTrack] لكل خاصية يتم تحريكها بواسطة هذا المقطع.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:String uuid]</h3>
														
 
															+		<p>
														
 
															+			[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] لهذا المقطع. يتم تعيينه تلقائيًا ولا يجب تحريره.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الوظائف (Methods)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[method:AnimationClip clone]()</h3>
														
 
															+		<p>
														
 
															+			إرجاع نسخة من هذا المقطع.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:this optimize]()</h3>
														
 
															+		<p>
														
 
															+			يحسن من أداء كل مسار عن طريق إزالة المفاتيح المتسلسلة المتكررة (الشائعة في تسلسلات هدف التحويل - morph target sequences).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:this resetDuration]()</h3>
														
 
															+		<p>
														
 
															+			يضبط [page:.duration duration] للمقطع على أطول مدة [page:KeyframeTrack] ممكنة.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:this trim]()</h3>
														
 
															+		<p>
														
 
															+			اقتطاع كل المسارات حسب مدة المقطع.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:Boolean validate]()</h3>
														
 
															+		<p>
														
 
															+			يقوم بتأدية الحد الأدنى من التحقق من الصحة على كل مسار في المقطع. إرجاع *true* إذا كانت جميع المسارات صالحة.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الوظائف الساكنة (Static Methods)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[method:Array CreateClipsFromMorphTargetSequences]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
														
 
															+		<p>
														
 
															+			تُرجع مصفوفة من AnimationClips الجديدة التي تم إنشاؤها من [page:Geometry.morphTargets morph target sequences] من الشكل الهندسي ، في محاولة لفرز أسماء الأهداف التحويلية إلى أنماط قائمة على مجموعة الرسوم المتحركة مثل "Walk_001 ، Walk_002 ، Run_001 ، Run_002 ...".
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationClip CreateFromMorphTargetSequence]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
														
 
															+		<p>
														
 
															+			يُرجع مقطع رسوم متحركة جديدًا من [page:Geometry.morphTargets morph targets array] تم تمريره لشكل هندسي ، مع أخذ اسم وعدد الإطارات في الثانية.<br /><br />
														
 
															+
														
 
															+			ملاحظة: قيمة fps مطلوبة و ضرورية ، ولكن يمكن إعادة ضبظ سرعة الرسوم المتحركة في *AnimationAction* عبر [page:AnimationAction.setDuration animationAction.setDuration].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationClip findByName]( [param:Object objectOrClipArray], [param:String name] )</h3>
														
 
															+		<p>
														
 
															+			يبحث عن AnimationClip بالاسم ، مع الأخذ كقيمة إما مصفوفة من AnimationClips ، أو شبكة أو شكل هندسي يحتوي على جدول مسمى "animations".
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationClip parse]( [param:Object json] )</h3>
														
 
															+		<p>
														
 
															+			يترجم تمثيل JSON لمقطع ويعيد AnimationClip.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationClip parseAnimation]( [param:Object animation], [param:Array bones] )</h3>
														
 
															+		<p>
														
 
															+			يوزع تنسيق animation.hierarchy ويعيد AnimationClip.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:Object toJSON]( [param:AnimationClip clip] )</h3>
														
 
															+		<p>
														
 
															+			يأخذ AnimationClip ويعيد كائن 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/AnimationMixer.html
+++ b/docs/api/ar/animation/AnimationMixer.html
@@ -0,0 +1,110 @@
 
															+<!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">
														
 
															+			AnimationMixer هو مشغل للرسوم المتحركة على كائن معين في المشهد. عندما يتم تحريك كائنات متعددة في المشهد بشكل مستقل ، يمكن استخدام AnimationMixer واحد لكل كائن.<br /><br />
														
 
															+
														
 
															+			للحصول على نظرة عامة حول العناصر المختلفة لنظام الرسوم المتحركة three.js ، راجع مقالة "نظام الحركات" في قسم "الخطوات التالية" من الدليل.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>المنشئ (Constructor)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[name]( [param:Object3D rootObject] )</h3>
														
 
															+		<p>
														
 
															+			[page:Object3D rootObject] - الكائن الذي سيتم تشغيل رسومه المتحركة بواسطة هذا الخالط.<br />
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الخصائص (Properties)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[property:Number time]</h3>
														
 
															+		<p>
														
 
															+			وقت الخالط الكامل (بالثواني ؛ بدءًا من 0 عند إنشاء الخالط).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Number timeScale]</h3>
														
 
															+		<p>
														
 
															+			عامل تحجيم لـ [page:.time mixer time].<br /><br />
														
 
															+
														
 
															+			ملاحظة: يأدي ضبط مقياس وقت الخلاط على 0 والعودة لاحقًا إلى 1 إلى إمكانية إيقاف / إلغاء إيقاف مؤقت لجميع الإجراءات التي يتحكم فيها هذا الخالط.
														
 
															+		</p>
														
 
															+
														
 
															+
														
 
															+		<h2>الوظائف (Methods)</h2>
														
 
															+
														
 
															+
														
 
															+		<h3>[method:AnimationAction clipAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
														
 
															+		<p>
														
 
															+			إرجاع [page:AnimationAction] للمقطع الذي تم تمريره ، اختيارياً باستخدام كائن جذر مختلف عن الجذر الافتراضي لجهاز المزج. يمكن أن تكون القيمة الأولى إما كائن [page:AnimationClip] أو اسم AnimationClip.<br /><br />
														
 
															+
														
 
															+			إذا لم يكن هناك إجراء يلائم المقطع ومعلمات الجذر ، فسيتم إنشاؤه بهذه الطريقة. استدعاء هذه الطريقة عدة مرات مع نفس المقطع ومعلمات الجذر يؤدي دائمًا إلى إرجاع نفس مثيل المقطع.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationAction existingAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
														
 
															+		<p>
														
 
															+			إرجاع [page:AnimationAction] موجود للمقطع الذي تم تمريره ، اختيارياً باستخدام كائن جذر مختلف عن الجذر الافتراضي لجهاز الخالط.<br /><br />
														
 
															+
														
 
															+			يمكن أن تكون القيمة الأولى إما كائن [page:AnimationClip] أو اسم AnimationClip.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:Object3D getRoot]()</h3>
														
 
															+		<p>
														
 
															+			إرجاع جذركائن الخالط.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationMixer stopAllAction]()</h3>
														
 
															+		<p>
														
 
															+			يقوم بإلغاء تنشيط كافة الإجراءات المجدولة مسبقًا على هذا الخالط.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationMixer update]([param:Number deltaTimeInSeconds]) </h3>
														
 
															+		<p>
														
 
															+			يعمل على تقدم وقت الخالط العالمي وتحديث الرسوم المتحركة.<br /><br />
														
 
															+
														
 
															+			يتم ذلك عادةً في حلقة العرض ، حيث يتم تمرير [page:Clock.getDelta clock.getDelta] مقياسًا بواسطة جهاز الخلاط [page:.timeScale timeScale]).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:AnimationMixer setTime]([param:Number timeInSeconds]) </h3>
														
 
															+		<p>
														
 
															+			يضبط الخالط العام على وقت محدد ويقوم بتحديث الرسوم المتحركة وفقًا لذلك.<br /><br />
														
 
															+
														
 
															+			يكون هذا مفيدًا عندما تحتاج إلى الانتقال إلى وقت محدد في رسم متحرك. سيتم قياس القيمة المدخلة حسب مقياس الوقت لجهاز الخالط [page:.timeScale timeScale].
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:null uncacheClip]([param:AnimationClip clip])</h3>
														
 
															+
														
 
															+		<p>
														
 
															+			إلغاء تخصيص كل موارد الذاكرة لمقطع.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:null uncacheRoot]([param:Object3D root]) </h3>
														
 
															+		<p>
														
 
															+			إلغاء تخصيص كافة موارد الذاكرة لكائن جذر.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[method:null uncacheAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</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/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/en/core/GLBufferAttribute.html
+++ b/docs/api/en/core/GLBufferAttribute.html
@@ -0,0 +1,117 @@
 
															+<!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>
														
 
															+		<h1>[name]</h1>
														
 
															+
														
 
															+		<p class="desc">
														
 
															+			This buffer attribute class does not construct a VBO. Instead, it uses
														
 
															+			whatever VBO is passed in constructor and can later be altered via the
														
 
															+			*buffer* property.<br /><br />
														
 
															+			It is required to pass additional params alongside the VBO. Those are:
														
 
															+			the GL context, the GL data type, the number of components per vertex,
														
 
															+			the number of bytes per component, and the number of vertices.<br /><br />
														
 
															+			The most common use case for this class is when some kind of GPGPU
														
 
															+			calculation interferes or even produces the VBOs in question.
														
 
															+		</p>
														
 
															+
														
 
															+		<h2>Constructor</h2>
														
 
															+		<h3>[name]( [param:WebGLBuffer buffer], [param:GLenum type], [param:Integer itemSize], [param:Integer elementSize], [param:Integer count] )</h3>
														
 
															+		<p>
														
 
															+		*buffer* — Must be a <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGLBuffer" target="_blank">WebGLBuffer</a>.
														
 
															+		<br />
														
 
															+		*type* — One of <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/Constants#Data_types" target="_blank">WebGL Data Types</a>.
														
 
															+		<br />
														
 
															+		*itemSize* — The number of values of the array that should be associated with
														
 
															+		a particular vertex. For instance, if this
														
 
															+		attribute is storing a 3-component vector (such as a position, normal, or color), then itemSize should be 3.
														
 
															+		<br />
														
 
															+		*elementSize* — 1, 2 or 4. The corresponding size (in bytes) for the given "type" param.
														
 
															+		<ul>
														
 
															+			<li>gl.FLOAT: 4</li>
														
 
															+			<li>gl.UNSIGNED_SHORT: 2</li>
														
 
															+			<li>gl.SHORT: 2</li>
														
 
															+			<li>gl.UNSIGNED_INT: 4</li>
														
 
															+			<li>gl.INT: 4</li>
														
 
															+			<li>gl.BYTE: 1</li>
														
 
															+			<li>gl.UNSIGNED_BYTE: 1</li>
														
 
															+		</ul>
														
 
															+		*count* — The expected number of vertices in VBO.
														
 
															+		</p>
														
 
															+
														
 
															+		<h2>Properties</h2>
														
 
															+
														
 
															+		<h3>[property:WebGLBuffer buffer]</h3>
														
 
															+		<p>
														
 
															+			The current <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGLBuffer" target="_blank">WebGLBuffer</a> instance.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Integer count]</h3>
														
 
															+		<p>
														
 
															+			The expected number of vertices in VBO.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Integer itemSize]</h3>
														
 
															+		<p>
														
 
															+			How many values make up each item (vertex).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Integer elementSize]</h3>
														
 
															+		<p>
														
 
															+			Stores the corresponding size in bytes for the current *type* property value.
														
 
															+		</p>
														
 
															+		<p>
														
 
															+			See above (constructor) for a list of known type sizes.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:GLenum type]</h3>
														
 
															+		<p>
														
 
															+			A <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/Constants#Data_types" target="_blank">WebGL Data Type</a>
														
 
															+			describing the underlying VBO contents.
														
 
															+		</p>
														
 
															+		<p>
														
 
															+			Set this property together with *elementSize*. The recommended way is
														
 
															+			using the *setType* method.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean isGLBufferAttribute]</h3>
														
 
															+		<p>
														
 
															+			Read-only. Always *true*.
														
 
															+		</p>
														
 
															+
														
 
															+		<h2>Methods</h2>
														
 
															+
														
 
															+		<h3>[method:null setBuffer]( buffer ) </h3>
														
 
															+		<p>Sets the *buffer* property.</p>
														
 
															+
														
 
															+		<h3>[method:null setType]( type, elementSize ) </h3>
														
 
															+		<p>Sets the both *type* and *elementSize* properties.</p>
														
 
															+
														
 
															+		<h3>[method:null setItemSize]( itemSize ) </h3>
														
 
															+		<p>Sets the *itemSize* property.</p>
														
 
															+
														
 
															+		<h3>[method:null setCount]( count ) </h3>
														
 
															+		<p>Sets the *count* property.</p>
														
 
															+
														
 
															+		<h3>[property:Integer version]</h3>
														
 
															+		<p>
														
 
															+		A version number, incremented every time the needsUpdate property is set to true.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean needsUpdate]</h3>
														
 
															+		<p>
														
 
															+		Default is *false*. Setting this to true increments [page:GLBufferAttribute.version version].
														
 
															+		</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/core/Object3D.html
+++ b/docs/api/en/core/Object3D.html
@@ -286,9 +286,9 @@
 
															 		<h3>[method:Vector3 localToWorld]( [param:Vector3 vector] )</h3>
														
 
															 		<p>
														
 
															-		vector - A vector representing a position in local (object) space.<br /><br />
														
 
															+		vector - A vector representing a position in this object's local space.<br /><br />
														
 
															-		Converts the vector from local space to world space.
														
 
															+		Converts the vector from this object's local space to world space.
														
 
															 		</p>
														
 
															 		<h3>[method:null lookAt]( [param:Vector3 vector] )<br />
														
@@ -447,9 +447,9 @@
 
															 		<h3>[method:Vector3 worldToLocal]( [param:Vector3 vector] )</h3>
														
 
															 		<p>
														
 
															-		vector - A world vector.<br /><br />
														
 
															+		vector - A vector representing a position in world space.<br /><br />
														
 
															-		Updates the vector from world space to local space.
														
 
															+		Converts the vector from world space to this object's local space.
														
 
															 		</p>
														
 
															 		<h2>Source</h2>
														
--- a/docs/api/en/helpers/ArrowHelper.html
+++ b/docs/api/en/helpers/ArrowHelper.html
@@ -33,8 +33,6 @@
 
															 		<h2>Examples</h2>
														
 
															 		<p>
														
 
															-			[example:webgl_geometries WebGL / geometries]<br/>
														
 
															-			[example:webgl_geometry_normals WebGL / geometry / normals]<br/>
														
 
															 			[example:webgl_shadowmesh WebGL / shadowmesh]
														
 
															 		</p>
														
--- a/docs/api/en/materials/Material.html
+++ b/docs/api/en/materials/Material.html
@@ -211,7 +211,7 @@
 
															 		<h3>[property:Boolean premultipliedAlpha]</h3>
														
 
															 		<p>
														
 
															 		Whether to premultiply the alpha (transparency) value.
														
 
															-		See [Example:webgl_materials_physical_transparency WebGL / Materials / Physical / Transparency] for an example of the difference.
														
 
															+		See [Example:webgl_materials_physical_transmission WebGL / Materials / Physical / Transmission] for an example of the difference.
														
 
															 		Default is *false*.
														
 
															 		</p>
														
--- a/docs/api/en/materials/ShaderMaterial.html
+++ b/docs/api/en/materials/ShaderMaterial.html
@@ -346,6 +346,12 @@ this.extensions = {
 
															 		as a string directly or loaded via AJAX instead.
														
 
															 		</p>
														
 
															+		<h3>[property:String glslVersion]</h3>
														
 
															+		<p>
														
 
															+		Defines the GLSL version of custom shader code. Only relevant for WebGL 2 in order to define whether to specify
														
 
															+		GLSL 3.0 or not. Valid values are *THREE.GLSL1* or *THREE.GLSL3*. Default is *null*.
														
 
															+		</p>
														
 
															+
														
 
															 		<h3>[property:String index0AttributeName]</h3>
														
 
															 		<p>
														
 
															 			If set, this calls [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bindAttribLocation gl.bindAttribLocation]
														
@@ -378,19 +384,11 @@ this.extensions = {
 
															 		When set to true, morph normal attributes are available in the vertex shader. Default is *false*.
														
 
															 		</p>
														
 
															-
														
 
															-		<h3>[property:WebGLProgram program]</h3>
														
 
															-		<p>
														
 
															-		The compiled shader program associated with this material, generated by [page:WebGLRenderer].
														
 
															-		You should not need to access this property.
														
 
															-		</p>
														
 
															-
														
 
															 		<h3>[property:Boolean flatShading]</h3>
														
 
															 		<p>
														
 
															 		Define whether the material is rendered with flat shading. Default is false.
														
 
															 		</p>
														
 
															-
														
 
															 		<h3>[property:Boolean skinning]</h3>
														
 
															 		<p>
														
 
															 		Define whether the material uses skinning; true to pass skinning attributes to the shader. Default is false.
														
--- a/docs/api/en/renderers/WebGLCubeRenderTarget.html
+++ b/docs/api/en/renderers/WebGLCubeRenderTarget.html
@@ -42,7 +42,7 @@
 
															 		[page:Number anisotropy] - default is *1*. See [page:Texture.anistropy]<br />
														
 
															 		[page:Constant encoding] - default is [page:Textures LinearEncoding]. <br />
														
 
															 		[page:Boolean depthBuffer] - default is *true*. Set this to false if you don't need it. <br />
														
 
															-		[page:Boolean stencilBuffer] - default is *true*. Set this to false if you don't need it.<br /><br />
														
 
															+		[page:Boolean stencilBuffer] - default is *false*. Set this to true if you need it.<br /><br />
														
 
															 		Creates a new [name]
														
 
															 		</p>
														
--- a/docs/api/en/renderers/WebGLRenderTarget.html
+++ b/docs/api/en/renderers/WebGLRenderTarget.html
@@ -41,7 +41,7 @@
 
															 		[page:Number anisotropy] - default is *1*. See [page:Texture.anisotropy]<br />
														
 
															 		[page:Constant encoding] - default is [page:Textures LinearEncoding]. <br />
														
 
															 		[page:Boolean depthBuffer] - default is *true*. Set this to false if you don't need it. <br />
														
 
															-		[page:Boolean stencilBuffer] - default is *true*. Set this to false if you don't need it.<br /><br />
														
 
															+		[page:Boolean stencilBuffer] - default is *false*. Set this to true if you need it.<br /><br />
														
 
															 		Creates a new [name]
														
 
															 		</p>
														
@@ -85,7 +85,7 @@
 
															 		<h3>[property:boolean stencilBuffer]</h3>
														
 
															 		<p>
														
 
															-		Renders to the stencil buffer. Default is true.
														
 
															+		Renders to the stencil buffer. Default is false.
														
 
															 		</p>
														
 
															 		<h3>[property:DepthTexture depthTexture]</h3>
														
--- a/docs/api/en/scenes/Scene.html
+++ b/docs/api/en/scenes/Scene.html
@@ -33,7 +33,8 @@
 
															 		<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, or a cubemap as a [page:CubeTexture] or [page:WebGLCubeRenderTarget]. Default is null.
														
 
															+		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.
														
 
															 		</p>
														
 
															 		<h3>[property:Texture environment]</h3>
														
@@ -52,11 +53,6 @@
 
															 		<h2>Methods</h2>
														
 
															-		<h3>[method:null dispose]()</h3>
														
 
															-		<p>
														
 
															-		Clears scene related data internally cached by [page:WebGLRenderer].
														
 
															-		</p>
														
 
															-
														
 
															 		<h3>[method:Object toJSON]( [param:Object meta] )</h3>
														
 
															 		<p>
														
 
															 		meta -- object containing metadata such as textures or images for the scene.<br />
														
--- a/docs/api/en/textures/DepthTexture.html
+++ b/docs/api/en/textures/DepthTexture.html
@@ -13,8 +13,8 @@
 
															 		<h1>[name]</h1>
														
 
															 		<p class="desc">
														
 
															-		Creates a texture for use as a Depth Texture. Require support for the
														
 
															-	[link:https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/ WEBGL_depth_texture] extension.
														
 
															+		This class can be used to automatically save the depth information of a rendering into a texture.
														
 
															+		When using a WebGL 1 rendering context, [name] requires support for the [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/ WEBGL_depth_texture] extension.
														
 
															 		</p>
														
 
															 		<h2>Examples</h2>
														
@@ -31,11 +31,11 @@
 
															 		[page:Number height] -- height of the texture.<br />
														
 
															-		[page:Constant type] -- Default is [page:Textures THREE.UnsignedShortType].
														
 
															+		[page:Constant type] -- Default is [page:Textures THREE.UnsignedShortType] when unsing [page:Textures DepthFormat] and [page:Textures THREE.UnsignedInt248Type] when using  [page:Textures DepthStencilFormat].
														
 
															 		See [page:Textures type constants] for other choices.<br />
														
 
															 		[page:Constant mapping] --
														
 
															-		See [page:Textures type constants] for details.<br />
														
 
															+		See [page:Textures mapping mode constants] for details.<br />
														
 
															 		[page:Constant wrapS] -- The default is [page:Textures THREE.ClampToEdgeWrapping].
														
 
															 		See [page:Textures wrap mode constants] for other choices.<br />
														
@@ -73,7 +73,7 @@
 
															 		<h3>[page:Texture.type .type]</h3>
														
 
															 		<p>
														
 
															-		Default is [page:Textures THREE.UnsignedShortType].
														
 
															+		Default is [page:Textures THREE.UnsignedShortType] when unsing [page:Textures DepthFormat] and [page:Textures THREE.UnsignedInt248Type] when using [page:Textures DepthStencilFormat].
														
 
															 		See [page:Textures format constants] for details.<br />
														
 
															 		</p>
														
--- 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>
														
@@ -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/GLBufferAttribute.html
+++ b/docs/api/zh/core/GLBufferAttribute.html
@@ -0,0 +1,117 @@
 
															+<!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>
														
 
															+		<h1>[name]</h1>
														
 
															+
														
 
															+		<p class="desc">
														
 
															+			This buffer attribute class does not construct a VBO. Instead, it uses
														
 
															+			whatever VBO is passed in constructor and can later be altered via the
														
 
															+			*buffer* property.<br /><br />
														
 
															+			It is required to pass additional params alongside the VBO. Those are:
														
 
															+			the GL context, the GL data type, the number of components per vertex,
														
 
															+			the number of bytes per component, and the number of vertices.<br /><br />
														
 
															+			The most common use case for this class is when some kind of GPGPU
														
 
															+			calculation interferes or even produces the VBOs in question.
														
 
															+		</p>
														
 
															+
														
 
															+		<h2>Constructor</h2>
														
 
															+		<h3>[name]( [param:WebGLBuffer buffer], [param:GLenum type], [param:Integer itemSize], [param:Integer elementSize], [param:Integer count] )</h3>
														
 
															+		<p>
														
 
															+		*buffer* — Must be a <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGLBuffer" target="_blank">WebGLBuffer</a>.
														
 
															+		<br />
														
 
															+		*type* — One of <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/Constants#Data_types" target="_blank">WebGL Data Types</a>.
														
 
															+		<br />
														
 
															+		*itemSize* — The number of values of the array that should be associated with
														
 
															+		a particular vertex. For instance, if this
														
 
															+		attribute is storing a 3-component vector (such as a position, normal, or color), then itemSize should be 3.
														
 
															+		<br />
														
 
															+		*elementSize* — 1, 2 or 4. The corresponding size (in bytes) for the given "type" param.
														
 
															+		<ul>
														
 
															+			<li>gl.FLOAT: 4</li>
														
 
															+			<li>gl.UNSIGNED_SHORT: 2</li>
														
 
															+			<li>gl.SHORT: 2</li>
														
 
															+			<li>gl.UNSIGNED_INT: 4</li>
														
 
															+			<li>gl.INT: 4</li>
														
 
															+			<li>gl.BYTE: 1</li>
														
 
															+			<li>gl.UNSIGNED_BYTE: 1</li>
														
 
															+		</ul>
														
 
															+		*count* — The expected number of vertices in VBO.
														
 
															+		</p>
														
 
															+
														
 
															+		<h2>Properties</h2>
														
 
															+
														
 
															+		<h3>[property:WebGLBuffer buffer]</h3>
														
 
															+		<p>
														
 
															+			The current <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGLBuffer" target="_blank">WebGLBuffer</a> instance.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Integer count]</h3>
														
 
															+		<p>
														
 
															+			The expected number of vertices in VBO.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Integer itemSize]</h3>
														
 
															+		<p>
														
 
															+			How many values make up each item (vertex).
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Integer elementSize]</h3>
														
 
															+		<p>
														
 
															+			Stores the corresponding size in bytes for the current *type* property value.
														
 
															+		</p>
														
 
															+		<p>
														
 
															+			See above (constructor) for a list of known type sizes.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:GLenum type]</h3>
														
 
															+		<p>
														
 
															+			A <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/Constants#Data_types" target="_blank">WebGL Data Type</a>
														
 
															+			describing the underlying VBO contents.
														
 
															+		</p>
														
 
															+		<p>
														
 
															+			Set this property together with *elementSize*. The recommended way is
														
 
															+			using the *setType* method.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean isGLBufferAttribute]</h3>
														
 
															+		<p>
														
 
															+			Read-only. Always *true*.
														
 
															+		</p>
														
 
															+
														
 
															+		<h2>Methods</h2>
														
 
															+
														
 
															+		<h3>[method:null setBuffer]( buffer ) </h3>
														
 
															+		<p>Sets the *buffer* property.</p>
														
 
															+
														
 
															+		<h3>[method:null setType]( type, elementSize ) </h3>
														
 
															+		<p>Sets the both *type* and *elementSize* properties.</p>
														
 
															+
														
 
															+		<h3>[method:null setItemSize]( itemSize ) </h3>
														
 
															+		<p>Sets the *itemSize* property.</p>
														
 
															+
														
 
															+		<h3>[method:null setCount]( count ) </h3>
														
 
															+		<p>Sets the *count* property.</p>
														
 
															+
														
 
															+		<h3>[property:Integer version]</h3>
														
 
															+		<p>
														
 
															+		A version number, incremented every time the needsUpdate property is set to true.
														
 
															+		</p>
														
 
															+
														
 
															+		<h3>[property:Boolean needsUpdate]</h3>
														
 
															+		<p>
														
 
															+		Default is *false*. Setting this to true increments [page:GLBufferAttribute.version version].
														
 
															+		</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/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,8 +270,9 @@
 
															 	<h3>[method:Vector3 localToWorld]( [param:Vector3 vector] )</h3>
														
 
															 	<p>
														
 
															-		vector - 一个表示局部（物体）空间中位置的向量。 <br /><br />
														
 
															-		将局部空间向量转换为世界空间向量。
														
 
															+		vector - 一个表示在该物体局部空间中位置的向量。<br /><br />
														
 
															+
														
 
															+		将该向量从物体的局部空间转换到世界空间。
														
 
															 	</p>
														
 
															 	<h3>[method:null lookAt]( [param:Vector3 vector] )<br />
														
@@ -422,8 +423,9 @@
 
															 	<h3>[method:Vector3 worldToLocal]( [param:Vector3 vector] )</h3>
														
 
															 	<p>
														
 
															-		vector - 一个世界向量.<br /><br />
														
 
															-		将世界空间中的向量转换为局部空间向量。
														
 
															+		vector - 一个表示在世界空间中位置的向量。<br /><br />
														
 
															+
														
 
															+		将该向量从世界空间转换到物体的局部空间。
														
 
															 	</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
@@ -33,8 +33,6 @@
 
															 		<h2>例子</h2>
														
 
															 		<p>
														
 
															-			[example:webgl_geometries WebGL / geometries]<br/>
														
 
															-			[example:webgl_geometry_normals WebGL / geometry / normals]<br/>
														
 
															 			[example:webgl_shadowmesh WebGL / shadowmesh]
														
 
															 		</p>
														
@@ -48,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/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>
														
@@ -181,7 +182,7 @@ Which stencil operation to perform when the comparison function returns true and
 
															 </p>
														
 
															 <h3>[property:Boolean premultipliedAlpha]</h3>
														
 
															-<p> 是否预乘alpha（透明度）值。有关差异的示例，请参阅[Example:webgl_materials_physical_transparency WebGL / Materials / Physical / Transparency]。
														
 
															+<p> 是否预乘alpha（透明度）值。有关差异的示例，请参阅[Example:webgl_materials_physical_transmission WebGL / Materials / Physical / Transmission]。
														
 
															 	默认值为*false*。
														
 
															 </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>
														
@@ -94,6 +94,8 @@
 
															 		<h3>[property:Float refractionRatio]</h3>
														
 
															 		<p> 空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
														
 
															 			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
														
 
															+			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
														
 
															+			It is used with environment mapping mode [page:Textures THREE.CubeRefractionMapping].
														
 
															 			折射率不应超过1。默认值为*0.98*。
														
 
															 		</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>
														
@@ -115,6 +115,8 @@
 
															 		<h3>[property:Float refractionRatio]</h3>
														
 
															 		<p>空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
														
 
															 			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
														
 
															+			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
														
 
															+			It is used with environment mapping mode [page:Textures THREE.CubeRefractionMapping].
														
 
															 			折射率不应超过1。默认值为*0.98*。
														
 
															 		</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>
														
@@ -151,6 +153,8 @@
 
															 		<h3>[property:Float refractionRatio]</h3>
														
 
															 		<p> 空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
														
 
															 			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
														
 
															+			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
														
 
															+			It is used with environment mapping mode [page:Textures THREE.CubeRefractionMapping].
														
 
															 			折射率不应超过1。默认值为*0.98*。
														
 
															 		</p>
														
--- 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>
														
@@ -188,6 +190,8 @@
 
															 		<h3>[property:Float refractionRatio]</h3>
														
 
															 		<p> 空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
														
 
															 			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
														
 
															+			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
														
 
															+			It is used with environment mapping mode [page:Textures THREE.CubeRefractionMapping].
														
 
															 			折射率不应超过1。默认值为*0.98*。
														
 
															 		</p>
														
@@ -202,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
@@ -310,6 +310,12 @@ this.extensions = {
 
															 			它也可以作为一个字符串直接传递或者通过AJAX加载。
														
 
															 		</p>
														
 
															+		<h3>[property:String glslVersion]</h3>
														
 
															+		<p>
														
 
															+		Defines the GLSL version of custom shader code. Only relevant for WebGL 2 in order to define whether to specify
														
 
															+		GLSL 3.0 or not. Valid values are *THREE.GLSL1* or *THREE.GLSL3*. Default is *null*.
														
 
															+		</p>
														
 
															+
														
 
															 		<h3>[property:String index0AttributeName]</h3>
														
 
															 		<p> 如果设置，则调用[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bindAttribLocation gl.bindAttribLocation]
														
 
															 			将通用顶点索引绑定到属性变量。默认值未定义。
														
@@ -333,10 +339,6 @@ this.extensions = {
 
															 		<p> When set to true, morph normal attributes are available in the vertex shader. Default is *false*.
														
 
															 		</p>
														
 
															-		<h3>[property:WebGLProgram program]</h3>
														
 
															-		<p> 与此材质相关联的编译后的shader程序，由[page:WebGLRenderer]生成。您应该不需要访问此属性。
														
 
															-		</p>
														
 
															-
														
 
															 		<h3>[property:Boolean flatShading]</h3>
														
 
															 		<p> 定义材质是否使用平面着色进行渲染。默认值为false。
														
 
															 		</p>
														
--- 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/WebGLCubeRenderTarget.html
+++ b/docs/api/zh/renderers/WebGLCubeRenderTarget.html
@@ -39,7 +39,7 @@
 
															 		[page:Number anisotropy] - 默认是 *1*. 参见[page:Texture.anistropy]<br />
														
 
															 		[page:Constant encoding] - 默认是[page:Textures LinearEncoding]. <br />
														
 
															 		[page:Boolean depthBuffer] - 默认是*true*.如果不需要就设为false <br />
														
 
															-		[page:Boolean stencilBuffer] - 默认是*true*.如果不需要就设为false<br /><br />
														
 
															+		[page:Boolean stencilBuffer] - default is *false*. Set this to true if you need it.<br /><br />
														
 
															 		创建一个新[name]
														
 
															 		</p>
														
--- a/docs/api/zh/renderers/WebGLRenderTarget.html
+++ b/docs/api/zh/renderers/WebGLRenderTarget.html
@@ -34,10 +34,10 @@
 
															 		[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] - 默认是*true*. 如果不需要就设为false <br /><br />
														
 
															+		[page:Boolean stencilBuffer] - default is *false*. Set this to true if you need it.<br /><br />
														
 
															 		创建一个新[name]
														
 
															 		</p>
														
@@ -81,7 +81,7 @@
 
															 		<h3>[property:boolean stencilBuffer]</h3>
														
 
															 		<p>
														
 
															-		渲染到模板缓冲区。默认true.
														
 
															+		Renders to the stencil buffer. Default is false.
														
 
															 		</p>
														
 
															 		<h3>[property:DepthTexture depthTexture]</h3>
														
--- 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>
														
 
															-			若不为空，在渲染场景的时候将设置背景，且背景总是首先被渲染的。
														
 
															-			可以设置一个用于的“clear”的[page:Color]（颜色）、一个覆盖canvas的[page:Texture]（纹理），或是一个[page:CubeTexture]。默认值为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>
														
@@ -55,11 +56,6 @@
 
															 		<h2>方法</h2>
														
 
															-		<h3>[method:null dispose]()</h3>
														
 
															-		<p>
														
 
															-			清除[page:WebGLRenderer]内部所缓存的场景相关的数据。
														
 
															-		</p>
														
 
															-
														
 
															 		<h3>[method:JSON toJSON]</h3>
														
 
															 		<p>
														
 
															 			meta -- 包含有元数据的对象，例如场景中的的纹理或图片。
														
--- 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/DepthTexture.html
+++ b/docs/api/zh/textures/DepthTexture.html
@@ -13,7 +13,8 @@
 
															 		<h1>深度纹理（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															-		创建一个作为深度纹理贴图来使用的纹理。需要支持[link:https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/ WEBGL_depth_texture]扩展。
														
 
															+		This class can be used to automatically save the depth information of a rendering into a texture.
														
 
															+		When using a WebGL 1 rendering context, [name] requires support for the [link:https://www.khronos.org/registry/webgl/extensions/WEBGL_depth_texture/ WEBGL_depth_texture] extension.
														
 
															 		</p>
														
 
															 		<h2>例子</h2>
														
@@ -29,11 +30,11 @@
 
															 		[page:Number height] -- 纹理的高度。<br />
														
 
															-		[page:Constant type] -- 默认值是[page:Textures THREE.UnsignedShortType]。
														
 
															+		[page:Constant type] -- Default is [page:Textures THREE.UnsignedShortType] when unsing [page:Textures DepthFormat] and [page:Textures THREE.UnsignedInt248Type] when using  [page:Textures DepthStencilFormat].
														
 
															 		请参阅[page:Textures type constants]（类型常量）来了解其他选项。<br />
														
 
															 		[page:Constant mapping] --
														
 
															-		请参阅[page:Textures mapping constants]（映射模式常量）来了解其他选项。<br />
														
 
															+		请参阅[page:Textures mapping mode constants]（映射模式常量）来了解其他选项。<br />
														
 
															 		[page:Constant wrapS] -- 默认值是[page:Textures THREE.ClampToEdgeWrapping].
														
 
															 		请参阅[page:Textures wrap mode constants]（包裹模式常量）来了解其他选项。<br />
														
@@ -71,7 +72,7 @@
 
															 		<h3>[page:Texture.type .type]</h3>
														
 
															 		<p>
														
 
															-		默认值是[page:Textures THREE.UnsignedShortType]。
														
 
															+		Default is [page:Textures THREE.UnsignedShortType] when unsing [page:Textures DepthFormat] and [page:Textures THREE.UnsignedInt248Type] when using [page:Textures DepthStencilFormat].
														
 
															 		请参阅[page:Textures format constants]来了解详细信息。<br />
														
 
															 		</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/OrbitControls.html
+++ b/docs/examples/en/controls/OrbitControls.html
@@ -107,7 +107,7 @@
 
															 		<h3>[property:Boolean enabled]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the controls are enabled.
														
 
															+			When set to *false*, the controls will not respond to user input. Default is *true*.
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean enableDamping]</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/zh/controls/DeviceOrientationControls.html
+++ b/docs/examples/zh/controls/DeviceOrientationControls.html
@@ -9,25 +9,25 @@
 
															 	</head>
														
 
															 	<body>
														
 
															-		<h1>[name]</h1>
														
 
															+		<h1>设备朝向控制器（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															-			Can be used to orient the camera based on the mobile device's orientation.
														
 
															+			通过使用设备朝向来确定摄像机的朝向。
														
 
															 		</p>
														
 
															 		<h2>例子</h2>
														
 
															 		<p>[example:misc_controls_deviceorientation misc / controls / deviceorientation ]</p>
														
 
															-		<h2>Constructor</h2>
														
 
															+		<h2>构造函数</h2>
														
 
															 		<h3>[name]( [param:Camera object] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Camera object]: The camera to be controlled.
														
 
															+				[page:Camera object]: 被控制的摄像机。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Creates a new instance of [name].
														
 
															+				创建一个新的 [name] 实例。
														
 
															 			</p>
														
 
															 		</p>
														
@@ -38,56 +38,56 @@
 
															 			Fires when the camera has been transformed by the controls.
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															 		<h3>[property:Number alphaOffset]</h3>
														
 
															 		<p>
														
 
															-			The alpha offset in radians. Default is *0*.
														
 
															+			alpha角偏移量，以弧度表示，默认为*0*。
														
 
															 		</p>
														
 
															 		<h3>[property:Object deviceOrientation]</h3>
														
 
															 		<p>
														
 
															-			The current *deviceorientation* event object.
														
 
															+			当前 *deviceorientation* 事件的对象。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean enabled]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the controls are enabled.
														
 
															+			是否启用控制器。
														
 
															 		</p>
														
 
															 		<h3>[property:Camera object]</h3>
														
 
															 		<p>
														
 
															-			The camera to be controlled.
														
 
															+			被控制的摄像机。
														
 
															 		</p>
														
 
															 		<h3>[property:Number screenOrientation]</h3>
														
 
															 		<p>
														
 
															-			The orientation in degrees (in 90-degree increments) of the viewport relative to the device's natural orientation. Default is *0*.
														
 
															+			相对于设备自然朝向的视口朝向，以角度表示（增量为90）。默认为*0*。
														
 
															 		</p>
														
 
															-		<h2>Methods</h2>
														
 
															+		<h2>方法</h2>
														
 
															 		<h3>[method:null connect] ()</h3>
														
 
															 		<p>
														
 
															-			Adds the event listeners of the controls and enables it.
														
 
															+			增加控制器的事件监听，并启用控制器。
														
 
															 		</p>
														
 
															 		<h3>[method:null disconnect] ()</h3>
														
 
															 		<p>
														
 
															-			Removes the event listeners of the controls and disables it.
														
 
															+			移除控制器的事件监听，并禁用控制器。
														
 
															 		</p>
														
 
															 		<h3>[method:null dispose] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the controls is no longer required.
														
 
															+			若不再需要该控制器，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:null update] ()</h3>
														
 
															 		<p>
														
 
															-			Updates the controls. Usually called in the animation loop.
														
 
															+			更新控制器，常被用在动画循环中。
														
 
															 		</p>
														
 
															-		<h2>Source</h2>
														
 
															+		<h2>源代码</h2>
														
 
															 		<p>
														
 
															 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/DeviceOrientationControls.js examples/jsm/controls/DeviceOrientationControls.js]
														
--- a/docs/examples/zh/controls/DragControls.html
+++ b/docs/examples/zh/controls/DragControls.html
@@ -10,10 +10,10 @@
 
															 	<body>
														
 
															 		[page:EventDispatcher] &rarr;
														
 
															-		<h1>[name]</h1>
														
 
															+		<h1>拖放控制器（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															-		This class can be used to provide a drag'n'drop interaction.
														
 
															+		该类被用于提供一个拖放交互。
														
 
															 		</p>
														
 
															 		<h2>代码示例</h2>
														
@@ -45,51 +45,51 @@
 
															 		<h3>[name]( [param:Array objects], [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Array objects]: An array of draggable 3D objects.
														
 
															+			[page:Array objects]: 一组可被拖拽的3D Objects。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-			[page:Camera camera]: The camera of the rendered scene.
														
 
															+			[page:Camera camera]: 渲染场景的摄像机。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-			[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
														
 
															+			[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Creates a new instance of [name].
														
 
															+				创建一个新的 [name] 实例。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Events</h2>
														
 
															+		<h2>事件</h2>
														
 
															 		<h3>dragstart</h3>
														
 
															 		<p>
														
 
															-			Fires when the user starts to drag a 3D object.
														
 
															+			当用户开始拖拽3D Objects时触发。
														
 
															 		</p>
														
 
															 		<h3>drag</h3>
														
 
															 		<p>
														
 
															-			Fires when the user drags a 3D object.
														
 
															+			当用户拖拽3D Objects时触发。
														
 
															 		</p>
														
 
															 		<h3>dragend</h3>
														
 
															 		<p>
														
 
															-			Fires when the user has finished dragging a 3D object.
														
 
															+			当用户开始完成3D Objects时触发。
														
 
															 		</p>
														
 
															 		<h3>hoveron</h3>
														
 
															 		<p>
														
 
															-			Fires when the pointer is moved onto a 3D object, or onto one of its children.
														
 
															+			当指针移动到一个3D Object或者其某个子级上时触发。
														
 
															 		</p>
														
 
															 		<h3>hoveroff</h3>
														
 
															 		<p>
														
 
															-			Fires when the pointer is moved out of a 3D object.
														
 
															+			当指针移出一个3D Object时触发。
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															 		<h3>[property:Boolean enabled]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the controls are enabled.
														
 
															+			是否启用控制器。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean transformGroup]</h3>
														
@@ -100,21 +100,21 @@
 
															 		<h2>Methods</h2>
														
 
															-		<p>See the base [page:EventDispatcher] class for common methods.</p>
														
 
															+		<p>共有方法请参见其基类[page:EventDispatcher]。</p>
														
 
															 		<h3>[method:null activate] ()</h3>
														
 
															 		<p>
														
 
															-			Adds the event listeners of the controls.
														
 
															+			添加控制器的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[method:null deactivate] ()</h3>
														
 
															 		<p>
														
 
															-			Removes the event listeners of the controls.
														
 
															+			移除控制器的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[method:null dispose] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the controls is no longer required.
														
 
															+			若不再需要该控制器，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:Array getObjects] ()</h3>
														
--- a/docs/examples/zh/controls/FirstPersonControls.html
+++ b/docs/examples/zh/controls/FirstPersonControls.html
@@ -9,57 +9,56 @@
 
															 	</head>
														
 
															 	<body>
														
 
															-		<h1>[name]</h1>
														
 
															+		<h1>第一人称控制器（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															-			This class is an alternative implementation of [page:FlyControls].
														
 
															+			该类是 [page:FlyControls] 的另一个实现。
														
 
															 		</p>
														
 
															 		<h2>例子</h2>
														
 
															 		<p>[example:webgl_geometry_terrain webgl / geometry / terrain ]</p>
														
 
															-		<h2>Constructor</h2>
														
 
															+		<h2>构造函数</h2>
														
 
															 		<h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Camera object]: The camera to be controlled.
														
 
															+				[page:Camera object]: 被控制的摄像机。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
														
 
															+				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Creates a new instance of [name].
														
 
															+				创建一个新的 [name] 实例。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															 		<h3>[property:Boolean activeLook]</h3>
														
 
															 		<p>
														
 
															-			Whether or not it's possible to look around. Default is *true*.
														
 
															+			是否能够环视四周。默认为*true*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean autoForward]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the camera is automatically moved forward. Default is *false*.
														
 
															+			摄像机是否自动向前移动。默认为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean constrainVertical]</h3>
														
 
															 		<p>
														
 
															-			Whether or not looking around is vertically constrained by [[page:.verticalMin], [page:.verticalMax]]. Default is *false*.
														
 
															+			垂直环视是否约束在[[page:.verticalMin], [page:.verticalMax]]之间。默认值为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:HTMLDOMElement domElement]</h3>
														
 
															 		<p>
														
 
															-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
														
 
															-			not set up new event listeners.
														
 
															+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean enabled]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the controls are enabled. Default is *true*.
														
 
															+			是否启用控制器。默认为*true*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number heightCoef]</h3>
														
@@ -79,55 +78,55 @@
 
															 		<h3>[property:Boolean heightSpeed]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the camera's height influences the forward movement speed. Default is *false*.
														
 
															-			Use the properties [page:.heightCoef], [page:.heightMin] and [page:.heightMax] for configuration.
														
 
															+			摄像机的高度是否影响向前移动的速度。默认值为*false*。
														
 
															+			使用属性 [page:.heightCoef]、 [page:.heightMin] 和 [page:.heightMax] 来进行配置。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean lookVertical]</h3>
														
 
															 		<p>
														
 
															-			Whether or not it's possible to vertically look around. Default is *true*.
														
 
															+			是否能够垂直环视。默认为*true*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number lookSpeed]</h3>
														
 
															 		<p>
														
 
															-			The look around speed. Default is *0.005*.
														
 
															+			环视速度。默认为*0.005*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean mouseDragOn]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the mouse is pressed down. Read-only property.
														
 
															+			鼠标是否被按下。只读属性。
														
 
															 		</p>
														
 
															 		<h3>[property:Number movementSpeed]</h3>
														
 
															 		<p>
														
 
															-			The movement speed. Default is *1*.
														
 
															+			移动速度。默认为*1*。
														
 
															 		</p>
														
 
															 		<h3>[property:Camera object]</h3>
														
 
															 		<p>
														
 
															-			The camera to be controlled.
														
 
															+			被控制的摄像机。
														
 
															 		</p>
														
 
															 		<h3>[property:Number verticalMax]</h3>
														
 
															 		<p>
														
 
															-			How far you can vertically look around, upper limit. Range is 0 to Math.PI radians. Default is *Math.PI*.
														
 
															+			你能够垂直环视角度的上限。范围在 0 到 Math.PI 弧度之间。默认为*Math.PI*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number verticalMin]</h3>
														
 
															 		<p>
														
 
															-			How far you can vertically look around, lower limit. Range is 0 to Math.PI radians. Default is *0*.
														
 
															+			你能够垂直环视角度的下限。范围在 0 到 Math.PI 弧度之间。默认为*0*。
														
 
															 		</p>
														
 
															-		<h2>Methods</h2>
														
 
															+		<h2>方法</h2>
														
 
															 		<h3>[method:null dispose] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the controls is no longer required.
														
 
															+			若不再需要该控制器，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:null handleResize] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the application window is resized.
														
 
															+			若应用程序窗口大小发生改变，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:FirstPersonControls lookAt]( [param:Vector3 vector] )<br />
														
@@ -135,14 +134,14 @@
 
															 		<p>
														
 
															 			<p>
														
 
															 				<p>
														
 
															-					vector - A vector representing the target position.
														
 
															+					vector - 一个表示目标位置的向量。
														
 
															 				</p>
														
 
															 				<p>
														
 
															-					Optionally, the x, y, z components of the world space position.
														
 
															+					或者，世界空间位置的x、y、z分量。
														
 
															 				</p>
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Ensures the controls orient the camera towards the defined target position.
														
 
															+				确保控制器将相机方向朝向到所传入的目标的位置。
														
 
															 			</p>
														
 
															 		</p>
														
@@ -152,11 +151,11 @@
 
															 				[page:Number delta]: Time delta value.
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Updates the controls. Usually called in the animation loop.
														
 
															+				更新控制器，常被用在动画循环中。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Source</h2>
														
 
															+		<h2>源代码</h2>
														
 
															 		<p>
														
 
															 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/FirstPersonControls.js examples/jsm/controls/FirstPersonControls.js]
														
--- a/docs/examples/zh/controls/FlyControls.html
+++ b/docs/examples/zh/controls/FlyControls.html
@@ -9,29 +9,29 @@
 
															 	</head>
														
 
															 	<body>
														
 
															-		<h1>[name]</h1>
														
 
															+		<h1>飞行控制器（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															-			[name] enables a navigation similar to fly modes in DCC tools like Blender. You can arbitrarily transform the camera in
														
 
															-			3D space without any limitations (e.g. focus on a specific target).
														
 
															+			[name] 启用了一种类似于数字内容创建工具（例如Blender）中飞行模式的导航方式。
														
 
															+			你可以在3D空间中任意变换摄像机，并且无任何限制（例如，专注于一个特定的目标）。
														
 
															 		</p>
														
 
															 		<h2>例子</h2>
														
 
															 		<p>[example:misc_controls_fly misc / controls / fly ]</p>
														
 
															-		<h2>Constructor</h2>
														
 
															+		<h2>构造函数</h2>
														
 
															 		<h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Camera object]: The camera to be controlled.
														
 
															+				[page:Camera object]: 被控制的摄像机。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
														
 
															+				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Creates a new instance of [name].
														
 
															+				创建一个新的 [name] 实例。
														
 
															 			</p>
														
 
															 		</p>
														
@@ -42,44 +42,43 @@
 
															 			Fires when the camera has been transformed by the controls.
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															 		<h3>[property:Boolean autoForward]</h3>
														
 
															 		<p>
														
 
															-			If set to *true*, the camera automatically moves forward (and does not stop) when initially translated. Default is *false*.
														
 
															+			若该值设为*true*，初始变换后，摄像机将自动向前移动（且不会停止）。默认为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:HTMLDOMElement domElement]</h3>
														
 
															 		<p>
														
 
															-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
														
 
															-			not set up new event listeners.
														
 
															+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean dragToLook]</h3>
														
 
															 		<p>
														
 
															-			If set to *true*, you can only look around by performing a drag interaction. Default is *false*.
														
 
															+			若该值设为*true*，你将只能通过执行拖拽交互来环视四周。默认为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number movementSpeed]</h3>
														
 
															 		<p>
														
 
															-			The movement speed. Default is *1*.
														
 
															+			移动速度，默认为*1*。
														
 
															 		</p>
														
 
															 		<h3>[property:Camera object]</h3>
														
 
															 		<p>
														
 
															-			The camera to be controlled.
														
 
															+			被控制的摄像机。
														
 
															 		</p>
														
 
															 		<h3>[property:Number rollSpeed]</h3>
														
 
															 		<p>
														
 
															-			The rotation speed. Default is *0.005*.
														
 
															+			旋转速度。默认为*0.005*。
														
 
															 		</p>
														
 
															-		<h2>Methods</h2>
														
 
															+		<h2>方法</h2>
														
 
															 		<h3>[method:null dispose] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the controls is no longer required.
														
 
															+			若不再需要该控制器，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:null update] ( [param:Number delta] )</h3>
														
@@ -88,11 +87,11 @@
 
															 				[page:Number delta]: Time delta value.
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Updates the controls. Usually called in the animation loop.
														
 
															+				更新控制器，常被用在动画循环中。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Source</h2>
														
 
															+		<h2>源代码</h2>
														
 
															 		<p>
														
 
															 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/FlyControls.js examples/jsm/controls/FlyControls.js]
														
--- a/docs/examples/zh/controls/OrbitControls.html
+++ b/docs/examples/zh/controls/OrbitControls.html
@@ -57,7 +57,7 @@
 
															 		<p>
														
 
															 			[page:Camera object]: （必须）将要被控制的相机。该相机不允许是其他任何对象的子级，除非该对象是场景自身。<br><br>
														
 
															-			[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
														
 
															+			[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
														
 
															 		</p>
														
 
															 		<h2>Events</h2>
														
@@ -77,7 +77,7 @@
 
															 			Fires when an interaction has finished.
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															 		<h3>[property:Boolean autoRotate]</h3>
														
 
															 		<p>
														
@@ -100,13 +100,12 @@
 
															 		<h3>[property:HTMLDOMElement domElement]</h3>
														
 
															 		<p>
														
 
															-			用于监听鼠标事件或触摸事件的HTMLDOMElement（DOM元素）。该值必须在构造函数中进行传入；
														
 
															-			在此更改它将不会设置新的事件监听器
														
 
															+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean enabled]</h3>
														
 
															 		<p>
														
 
															-			控制器是否被启用。
														
 
															+			When set to *false*, the controls will not respond to user input. Default is *true*.
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean enableDamping]</h3>
														
@@ -173,7 +172,7 @@ controls.keys = {
 
															 		<h3>[property:Float maxZoom]</h3>
														
 
															 		<p>
														
 
															-			你能够将相机缩小多少( 仅适用于[page:OrthographicCamera] only )，其默认值为Infinity。
														
 
															+			你能够将相机缩小多少（仅适用于[page:OrthographicCamera]），其默认值为Infinity。
														
 
															 		</p>
														
 
															 		<h3>[property:Float minAzimuthAngle]</h3>
														
@@ -193,13 +192,13 @@ controls.keys = {
 
															 		<h3>[property:Float minZoom]</h3>
														
 
															 		<p>
														
 
															-			你能够将相机放大多少( 仅适用于[page:OrthographicCamera] )，其默认值为0。
														
 
															+			你能够将相机放大多少（仅适用于[page:OrthographicCamera]），其默认值为0。
														
 
															 		</p>
														
 
															 		<h3>
														
 
															 			[property:Object mouseButtons]</h3>
														
 
															 		<p>
														
 
															-			这一对象包含了对用于控制的鼠标按钮的引用。
														
 
															+			该对象包含由控件所使用的鼠标操作的引用。
														
 
															 			<code>
														
 
															 controls.mouseButtons = {
														
 
															 	LEFT: THREE.MOUSE.ROTATE,
														
@@ -226,7 +225,7 @@ controls.mouseButtons = {
 
															 		<h3>[property:Float rotateSpeed]</h3>
														
 
															 		<p>
														
 
															-			旋转的速度，其默认值为1.
														
 
															+			旋转的速度，其默认值为1。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean screenSpacePanning]</h3>
														
--- a/docs/examples/zh/controls/PointerLockControls.html
+++ b/docs/examples/zh/controls/PointerLockControls.html
@@ -10,11 +10,11 @@
 
															 	<body>
														
 
															 		[page:EventDispatcher] &rarr;
														
 
															-		<h1>[name]</h1>
														
 
															+		<h1>指针锁定控制器（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															-		The implementation of this class is based on the [link:https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API Pointer Lock API].
														
 
															-		[name] is a perfect choice for first person 3D games.
														
 
															+		该类的实现是基于[link:https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API Pointer Lock API]的。
														
 
															+		对于第一人称3D游戏来说， [name] 是一个非常完美的选择。
														
 
															 		</p>
														
 
															 		<h2>代码示例</h2>
														
@@ -46,45 +46,44 @@
 
															 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-			[page:Camera camera]: The camera of the rendered scene.
														
 
															+			[page:Camera camera]: 渲染场景的摄像机。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-			[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
														
 
															+			[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Creates a new instance of [name].
														
 
															+				创建一个新的 [name] 实例。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Events</h2>
														
 
															+		<h2>事件</h2>
														
 
															 		<h3>change</h3>
														
 
															 		<p>
														
 
															-			Fires when the user moves the mouse.
														
 
															+			当用户移动鼠标时触发。
														
 
															 		</p>
														
 
															 		<h3>lock</h3>
														
 
															 		<p>
														
 
															-			Fires when the pointer lock status is "locked" (in other words: the mouse is captured).
														
 
															+			当指针状态为 “locked” （即鼠标被捕获）时触发。
														
 
															 		</p>
														
 
															 		<h3>unlock</h3>
														
 
															 		<p>
														
 
															-			Fires when the pointer lock status is "unlocked" (in other words: the mouse is not captured anymore).
														
 
															+			当指针状态为 “unlocked” （即鼠标不再被捕获）时触发。
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															 		<h3>[property:HTMLDOMElement domElement]</h3>
														
 
															 		<p>
														
 
															-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
														
 
															-			not set up new event listeners.
														
 
															+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean isLocked]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the controls are locked.
														
 
															+			控制器是否被锁定。
														
 
															 		</p>
														
 
															 		<h3>[property:Float maxPolarAngle]</h3>
														
@@ -99,59 +98,59 @@
 
															 		<h2>Methods</h2>
														
 
															-		<p>See the base [page:EventDispatcher] class for common methods.</p>
														
 
															+		<p>共有方法请参见其基类[page:EventDispatcher]。</p>
														
 
															 		<h3>[method:null connect] ()</h3>
														
 
															 		<p>
														
 
															-			Adds the event listeners of the controls.
														
 
															+			添加控制器的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[method:null disconnect] ()</h3>
														
 
															 		<p>
														
 
															-			Removes the event listeners of the controls.
														
 
															+			移除控制器的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[method:Vector3 getDirection] ( [param:Vector3 target] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Vector3 target]: The target vector.
														
 
															+				[page:Vector3 target]: 目标向量。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Returns the look direction of the camera.
														
 
															+				返回摄像机的观看方向。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:null lock] ()</h3>
														
 
															 		<p>
														
 
															-			Activates the pointer lock.
														
 
															+			激活指针锁定。
														
 
															 		</p>
														
 
															 		<h3>[method:null moveForward] ( [param:Number distance] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Number distance]: The signed distance.
														
 
															+				[page:Number distance]: 距离（区分正负）。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Moves the camera forward parallel to the xz-plane. Assumes camera.up is y-up.
														
 
															+				平行于xz平面，向前移动摄像机。假定camera.up是y朝上。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:null moveRight] ( [param:Number distance] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Number distance]: The signed distance.
														
 
															+				[page:Number distance]: 距离（区分正负）。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Moves the camera sidewards parallel to the xz-plane.
														
 
															+				平行于xz平面，向侧面移动摄像机。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:null unlock] ()</h3>
														
 
															 		<p>
														
 
															-			Exits the pointer lock.
														
 
															+			退出指针锁定。
														
 
															 		</p>
														
 
															-		<h2>Source</h2>
														
 
															+		<h2>源代码</h2>
														
 
															 		<p>
														
 
															 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/PointerLockControls.js examples/jsm/controls/PointerLockControls.js]
														
--- a/docs/examples/zh/controls/TrackballControls.html
+++ b/docs/examples/zh/controls/TrackballControls.html
@@ -10,12 +10,12 @@
 
															 	<body>
														
 
															 		[page:EventDispatcher] &rarr;
														
 
															-		<h1>[name]</h1>
														
 
															+		<h1>轨迹球控制器（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															 			<p>
														
 
															-				[name] is similar to [page:OrbitControls]. However, it does not maintain a constant camera [page:Object3D.up up] vector.
														
 
															-				That means if the camera orbits over the “north” and “south” poles, it does not flip to stay "right side up".
														
 
															+				[name] 与 [page:OrbitControls] 相类似。然而，它不能恒定保持摄像机的[page:Object3D.up up]向量。
														
 
															+				这意味着，如果摄像机绕过“北极”和“南极”，则不会翻转以保持“右侧朝上”。
														
 
															 			</p>
														
 
															 		</p>
														
@@ -23,182 +23,181 @@
 
															 		<p>[example:misc_controls_trackball misc / controls / trackball ]</p>
														
 
															-		<h2>Constructor</h2>
														
 
															+		<h2>构造函数</h2>
														
 
															 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Camera camera]: The camera of the rendered scene.
														
 
															+				[page:Camera camera]: 渲染场景的摄像机。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
														
 
															+				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Creates a new instance of [name].
														
 
															+				创建一个新的 [name] 实例。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Events</h2>
														
 
															+		<h2>事件</h2>
														
 
															 		<h3>change</h3>
														
 
															 		<p>
														
 
															-			Fires when the camera has been transformed by the controls.
														
 
															+			当摄像机被控制器变换后触发。
														
 
															 		</p>
														
 
															 		<h3>start</h3>
														
 
															 		<p>
														
 
															-			Fires when an interaction (e.g. touch) was initiated.
														
 
															+			当交互（例如触摸）被初始化后触发。
														
 
															 		</p>
														
 
															 		<h3>end</h3>
														
 
															 		<p>
														
 
															-			Fires when an interaction has finished.
														
 
															+			当交互完成后触发。
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															 		<h3>[property:HTMLDOMElement domElement]</h3>
														
 
															 		<p>
														
 
															-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
														
 
															-			not set up new event listeners.
														
 
															+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[property:Number dynamicDampingFactor]</h3>
														
 
															 		<p>
														
 
															-			Defines the intensity of damping. Only considered if [page:.staticMoving staticMoving] is set to *false*. Default is *0.2*.
														
 
															+			设置阻尼的强度。仅在[page:.staticMoving staticMoving]设为*false*时考虑。默认为*0.2*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean enabled]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the controls are enabled.
														
 
															+			是否启用控制器。
														
 
															 		</p>
														
 
															 		<h3>[property:Array keys]</h3>
														
 
															 		<p>
														
 
															-			This array holds keycodes for controlling interactions.
														
 
															+			该数组包含用于控制交互的按键代码。
														
 
															 			<ul>
														
 
															-				<li>When the first defined key is pressed, all mouse interactions (left, middle, right) performs orbiting.</li>
														
 
															-				<li>When the second defined key is pressed, all mouse interactions (left, middle, right) performs zooming.</li>
														
 
															-				<li>When the third defined key is pressed, all mouse interactions (left, middle, right) performs panning.</li>
														
 
															+				<li>当定义的第一个按键按下后，所有的鼠标交互（左/中/右键）表现为环绕。</li>
														
 
															+				<li>当定义的第二个按键按下后，所有的鼠标交互（左/中/右键）表现为缩放。</li>
														
 
															+				<li>当定义的第一个按键按下后，所有的鼠标交互（左/中/右键）表现为平移。</li>
														
 
															 			</ul>
														
 
															-			Default is *65, 83, 68* which represents A, S, D.
														
 
															+			默认为*65, 83, 68*，分别表示A, S, D。
														
 
															 		</p>
														
 
															 		<h3>[property:Number maxDistance]</h3>
														
 
															 		<p>
														
 
															-			 How far you can zoom in. Default is *Infinity*.
														
 
															+			你能够将相机向外移动多少，其默认值为*Infinity*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number minDistance]</h3>
														
 
															 		<p>
														
 
															-			 How far you can zoom in. Default is *0*.
														
 
															+			你能够将相机向内移动多少，其默认值为*0*。
														
 
															 		</p>
														
 
															 		<h3>
														
 
															 			[property:Object mouseButtons]</h3>
														
 
															 		<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 指定给 *THREE.MOUSE.ROTATE*</li>
														
 
															+				<li>.MIDDLE 指定给 *THREE.MOUSE.ZOOM*</li>
														
 
															+				<li>.RIGHT 指定给 *THREE.MOUSE.PAN*</li>
														
 
															 			</ul>
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean noPan]</h3>
														
 
															 		<p>
														
 
															-			Whether or not panning is disabled. Default is *false*.
														
 
															+			是否禁用平移，默认为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean noRotate]</h3>
														
 
															 		<p>
														
 
															-			Whether or not rotation is disabled. Default is *false*.
														
 
															+			是否禁用旋转，默认为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean noZoom]</h3>
														
 
															 		<p>
														
 
															-			Whether or not zooming is disabled. Default is *false*.
														
 
															+			是否禁用缩放，默认为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:Camera object]</h3>
														
 
															 		<p>
														
 
															-			The camera being controlled.
														
 
															+			正被控制的摄像机。
														
 
															 		</p>
														
 
															 		<h3>[property:Number panSpeed]</h3>
														
 
															 		<p>
														
 
															-			The zoom speed. Default is *0.3*.
														
 
															+			平移的速度，其默认值为*0.3*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number rotateSpeed]</h3>
														
 
															 		<p>
														
 
															-			The rotation speed. Default is *1.0*.
														
 
															+			旋转的速度，其默认值为*1.0*。
														
 
															 		</p>
														
 
															 		<h3>[property:Object screen]</h3>
														
 
															 		<p>
														
 
															-			Represents the properties of the screen. Automatically set when [page:.handleResize handleResize]() is called.
														
 
															+			表示屏幕的属性。在[page:.handleResize handleResize]()被调用时会自动设置。
														
 
															 			<ul>
														
 
															-				<li>left: Represents the offset in pixels to the screen's left boundary.</li>
														
 
															-				<li>top: Represents the offset in pixels to the screen's top boundary.</li>
														
 
															-				<li>width: Represents the screen width in pixels.</li>
														
 
															-				<li>height: Represents the screen height in pixels.</li>
														
 
															+				<li>left: 表示到屏幕左侧边界的偏移量（单位为像素）。</li>
														
 
															+				<li>top: 表示到屏幕顶部边界的偏移量（单位为像素）。</li>
														
 
															+				<li>width: 表示屏幕的宽度（单位为像素）。</li>
														
 
															+				<li>height: 表示屏幕的高度（单位为像素）。</li>
														
 
															 			</ul>
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean staticMoving]</h3>
														
 
															 		<p>
														
 
															-			Whether or not damping is disabled. Default is *false*.
														
 
															+			阻尼是否被禁用。默认为*false*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number zoomSpeed]</h3>
														
 
															 		<p>
														
 
															-			The zoom speed. Default is *1.2*.
														
 
															+			缩放的速度，其默认值为*1.2*。
														
 
															 		</p>
														
 
															-		<h2>Methods</h2>
														
 
															+		<h2>方法</h2>
														
 
															 		<h3>[method:null checkDistances] ()</h3>
														
 
															 		<p>
														
 
															-			Ensures the controls stay in the range [minDistance, maxDistance]. Called by [page:.update update]().
														
 
															+			确保控制器位于 [minDistance, maxDistance] 范围内。由[page:.update update]()调用。
														
 
															 		</p>
														
 
															 		<h3>[method:null dispose] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the controls is no longer required.
														
 
															+			若不再需要该控制器，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:null handleResize] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the application window is resized.
														
 
															+			若应用程序窗口大小发生改变，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:null panCamera] ()</h3>
														
 
															 		<p>
														
 
															-			Performs panning if necessary. Called by [page:.update update]().
														
 
															+			如有必要，执行平移。由[page:.update update]()调用。
														
 
															 		</p>
														
 
															 		<h3>[method:null reset] ()</h3>
														
 
															 		<p>
														
 
															-			Resets the controls to its initial state.
														
 
															+			重置控制器到初始状态。
														
 
															 		</p>
														
 
															 		<h3>[method:null rotateCamera] ()</h3>
														
 
															 		<p>
														
 
															-			Rotates the camera if necessary. Called by [page:.update update]().
														
 
															+			如有必要，旋转相机。由[page:.update update]()调用。
														
 
															 		</p>
														
 
															 		<h3>[method:null update] ()</h3>
														
 
															 		<p>
														
 
															-			Updates the controls. Usually called in the animation loop.
														
 
															+			更新控制器，常被用在动画循环中。
														
 
															 		</p>
														
 
															 		<h3>[method:null zoomCamera] ()</h3>
														
 
															 		<p>
														
 
															-			Performs zooming if necessary. Called by [page:.update update]().
														
 
															+			如有必要，执行缩放。由[page:.update update]()调用。
														
 
															 		</p>
														
 
															-		<h2>Source</h2>
														
 
															+		<h2>源代码</h2>
														
 
															 		<p>
														
 
															 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/TrackballControls.js examples/jsm/controls/TrackballControls.js]
														
--- a/docs/examples/zh/controls/TransformControls.html
+++ b/docs/examples/zh/controls/TransformControls.html
@@ -10,214 +10,213 @@
 
															 	<body>
														
 
															 		[page:Object3D] &rarr;
														
 
															-		<h1>[name]</h1>
														
 
															+		<h1>变换控制器（[name]）</h1>
														
 
															 		<p class="desc">
														
 
															-			This class can be used to transform objects in 3D space by adapting a similar interaction model of DCC tools like Blender.
														
 
															-			Unlike other controls, it is not intended to transform the scene's camera.<br /><br />
														
 
															+			该类可提供一种类似于在数字内容创建工具（例如Blender）中对模型进行交互的方式，来在3D空间中变换物体。
														
 
															+			和其他控制器不同的是，变换控制器不倾向于对场景摄像机的变换进行改变。<br /><br />
														
 
															-			[name] expects that its attached 3D object is part of the scene graph.
														
 
															+			[name] 期望其所附加的3D对象是场景图的一部分。
														
 
															 		</p>
														
 
															 		<h2>例子</h2>
														
 
															 		<p>[example:misc_controls_transform misc / controls / transform ]</p>
														
 
															-		<h2>Constructor</h2>
														
 
															+		<h2>构造函数</h2>
														
 
															 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Camera camera]: The camera of the rendered scene.
														
 
															+				[page:Camera camera]: 被控制的摄像机。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
														
 
															+				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Creates a new instance of [name].
														
 
															+				创建一个新的 [name] 实例。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Events</h2>
														
 
															+		<h2>事件</h2>
														
 
															 		<h3>change</h3>
														
 
															 		<p>
														
 
															-			Fires if any type of change (object or property change) is performed. Property changes
														
 
															-			are separate events you can add event listeners to. The event type is "propertyname-changed".
														
 
															+			如果发生了任何类型的改变（对象或属性的改变）则触发该事件。
														
 
															+			属性改变是单独的事件，你也可以为此添加单独的事件监听；该事件类型为"propertyname-changed"（“属性名称-changed”）。
														
 
															 		</p>
														
 
															 		<h3>mouseDown</h3>
														
 
															 		<p>
														
 
															-			Fires if a pointer (mouse/touch) becomes active.
														
 
															+			如果指针（鼠标/触摸）为活动状态则触发该事件。
														
 
															 		</p>
														
 
															 		<h3>mouseUp</h3>
														
 
															 		<p>
														
 
															-			Fires if a pointer (mouse/touch) is no longer active.
														
 
															+			如果指针（鼠标/触摸）不再为活动状态则触发该事件。
														
 
															 		</p>
														
 
															 		<h3>objectChange</h3>
														
 
															 		<p>
														
 
															-			Fires if the controlled 3D object is changed.
														
 
															+			如果被控制的3D对象发生改变则触发该事件。
														
 
															 		</p>
														
 
															-		<h2>Properties</h2>
														
 
															+		<h2>属性</h2>
														
 
															-		<p>See the base [page:Object3D] class for common properties.</p>
														
 
															+		<p>共有属性请参见其基类[page:Object3D]。</p>
														
 
															 		<h3>[property:String axis]</h3>
														
 
															 		<p>
														
 
															-			The current transformation axis.
														
 
															+			当前变换轴。
														
 
															 		</p>
														
 
															 		<h3>[property:Camera camera]</h3>
														
 
															 		<p>
														
 
															-			The camera of the rendered scene.
														
 
															+			渲染场景的摄像机。
														
 
															 		</p>
														
 
															 		<h3>[property:HTMLDOMElement domElement]</h3>
														
 
															 		<p>
														
 
															-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
														
 
															-			not set up new event listeners.
														
 
															+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean dragging]</h3>
														
 
															 		<p>
														
 
															-			Whether or not dragging is currently performed. Read-only property.
														
 
															+			当前是否正在拖动。只读属性。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean enabled]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the controls are enabled.
														
 
															+			是否启用控制器。默认为*true*。
														
 
															 		</p>
														
 
															 		<h3>[property:String mode]</h3>
														
 
															 		<p>
														
 
															-			The current transformation mode. Possible values are "translate", "rotate" and "scale". Default is *translate*.
														
 
															+			当前的变换模式。可能的值包括"translate"、"rotate" 和 "scale"。默认为*translate*。
														
 
															 		</p>
														
 
															 		<h3>[property:Object3D object]</h3>
														
 
															 		<p>
														
 
															-			The 3D object being controlled.
														
 
															+			正在被控制的3D对象。
														
 
															 		</p>
														
 
															 		<h3>[property:Number rotationSnap]</h3>
														
 
															 		<p>
														
 
															-			By default, 3D objects are continously rotated. If you set this property to a numeric value (radians), you can define in which
														
 
															-			steps the 3D object should be rotated. Deault is *null*.
														
 
															+			默认情况下，3D对象是可以被连续旋转的。如果你将该值设为一个数值（弧度），则你将可以定义每次旋转3D对象时的步幅。
														
 
															+			默认为*null*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean showX]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the x-axis helper should be visible. Default is *true*.
														
 
															+			x轴手柄是否显示。默认为*true*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean showY]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the y-axis helper should be visible. Default is *true*.
														
 
															+			y轴手柄是否显示。默认为*true*。
														
 
															 		</p>
														
 
															 		<h3>[property:Boolean showZ]</h3>
														
 
															 		<p>
														
 
															-			Whether or not the z-axis helper should be visible. Default is *true*.
														
 
															+			z轴手柄是否显示。默认为*true*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number size]</h3>
														
 
															 		<p>
														
 
															-			The size of the helper UI (axes/planes). Default is *1*.
														
 
															+			手柄UI（轴/平面）的大小。默认为*1*。
														
 
															 		</p>
														
 
															 		<h3>[property:String space]</h3>
														
 
															 		<p>
														
 
															-			Defines in which coordinate space transformations should be performed. Possible values are "world" and "local". Default is *world*.
														
 
															+			定义了在哪种坐标空间中进行变换。可能的值有"world" 和 "local"。默认为*world*。
														
 
															 		</p>
														
 
															 		<h3>[property:Number translationSnap]</h3>
														
 
															 		<p>
														
 
															-			By default, 3D objects are continously translated. If you set this property to a numeric value (world units), you can define in which
														
 
															-			steps the 3D object should be translated. Deault is *null*.
														
 
															+			默认情况下，3D对象是可以被连续平移的。如果你将该值设为一个数值（世界单位），则你将可以定义每次平移3D对象时的步幅。
														
 
															+			默认为*null*。
														
 
															 		</p>
														
 
															-		<h2>Methods</h2>
														
 
															+		<h2>方法</h2>
														
 
															-		<p>See the base [page:Object3D] class for common methods.</p>
														
 
															+		<p>共有方法请参见其基类[page:Object3D]。</p>
														
 
															 		<h3>[method:TransformControls attach] ( [param:Object3D object] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Object3D object]: The 3D object that should be transformed.
														
 
															+				[page:Object3D object]: 应当变换的3D对象。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Sets the 3D object that should be transformed and ensures the controls UI is visible.
														
 
															+				设置应当变换的3D对象，并确保控制器UI是可见的。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:TransformControls detach] ()</h3>
														
 
															 		<p>
														
 
															-			Removes the current 3D object from the controls and makes the helper UI is invisible.
														
 
															+			从控制器中移除当前3D对象，并确保控制器UI是不可见的。
														
 
															 		</p>
														
 
															 		<h3>[method:null dispose] ()</h3>
														
 
															 		<p>
														
 
															-			Should be called if the controls is no longer required.
														
 
															+			若不再需要该控制器，则应当调用此函数。
														
 
															 		</p>
														
 
															 		<h3>[method:String getMode] ()</h3>
														
 
															 		<p>
														
 
															-			Returns the transformation mode.
														
 
															+			返回变换模式。
														
 
															 		</p>
														
 
															 		<h3>[method:null setMode] ( [param:String mode] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:String mode]: The transformation mode.
														
 
															+				[page:String mode]: 变换模式。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Sets the transformation mode.
														
 
															+				设置变换模式。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:null setRotationSnap] ( [param:Number rotationSnap] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Number rotationSnap]: The rotation snap.
														
 
															+				[page:Number rotationSnap]: 旋转捕捉步幅。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Sets the rotation snap.
														
 
															+				设置旋转捕捉。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:null setSize] ( [param:Number size] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Number size]: The size of the helper UI.
														
 
															+				[page:Number size]: 手柄UI的大小。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Sets the size of the helper UI.
														
 
															+				设置手柄UI的大小。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:null setSpace] ( [param:String space] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:String space]: The coordinate space in which transformations are applied.
														
 
															+				[page:String space]: 应用变换的坐标空间。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Sets the coordinate space in which transformations are applied.
														
 
															+				设置应用变换的坐标空间。
														
 
															 			</p>
														
 
															 		</p>
														
 
															 		<h3>[method:null setTranslationSnap] ( [param:Number translationSnap] )</h3>
														
 
															 		<p>
														
 
															 			<p>
														
 
															-				[page:Number translationSnap]: The translation snap.
														
 
															+				[page:Number translationSnap]: 平移捕捉步幅。
														
 
															 			</p>
														
 
															 			<p>
														
 
															-				Sets the translation snap.
														
 
															+				设置平移捕捉。
														
 
															 			</p>
														
 
															 		</p>
														
 
															-		<h2>Source</h2>
														
 
															+		<h2>源代码</h2>
														
 
															 		<p>
														
 
															 			[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/TransformControls.js examples/jsm/controls/TransformControls.js]