Merge remote-tracking branch 'origin/translation-zh' into translation-zh

docs/api/zh/animation/AnimationAction.html

@@ -11,103 +11,89 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			AnimationActions schedule the performance of the animations which are stored in
-			[page:AnimationClip AnimationClips].<br /><br />
+			AnimationActions 用来调度存储在[page:AnimationClip AnimationClips]中的动画。<br /><br />
 
-			Note: Most of AnimationAction's methods can be chained.<br /><br />
+			说明: AnimationAction的大多数方法都可以链式调用<br /><br />
 
-			For an overview of the different elements of the three.js animation system see the
-			"Animation System" article in the "Next Steps" section of the manual.
+			在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:AnimationMixer mixer], [param:AnimationClip clip], [param:Object3D localRoot] )</h3>
 		<p>
-			[page:AnimationMixer mixer] - the *AnimationMixer* that is controlled by this action.<br />
-			[page:AnimationClip clip] - the *AnimationClip* that holds the animation data for this action.<br />
-			[page:Object3D localRoot] - the root object on which this action is performed.<br /><br />
+			[page:AnimationMixer mixer] - 被此动作控制的 *动画混合器* <br />
+			[page:AnimationClip clip] - *动画剪辑* 保存了此动作当中的动画数据 <br />
+			[page:Object3D localRoot] - 动作执行的根对象 <br /><br />
 
-			Note: Instead of calling this constructor directly you should instantiate an AnimationAction with
-			[page:AnimationMixer.clipAction] since this method provides caching for better performance.
+			说明: 不要直接调用这个构造函数，而应该先用[page:AnimationMixer.clipAction]实例化一个AnimationAction，因为这个方法提供了缓存以提高性能。
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 		<h3>[property:Boolean clampWhenFinished]</h3>
 		<p>
-			If *clampWhenFinished* is set to true the animation will automatically be [page:.paused paused]
-			on its last frame.<br /><br />
+			如果 *clampWhenFinished* 值设为true, 那么动画将在最后一帧之后自动暂停（[page:.paused paused]）<br /><br />
 
-			If *clampWhenFinished* is set to false, [page:.enabled enabled] will automatically be switched
-			to false when the last loop of the action has finished, so that this action has no further
-			impact.<br /><br />
+			如果 *clampWhenFinished* 值为false, [page:.enabled enabled] 属性值将在动作的最后一次循环完成之后自动改为false, 那么这个动作以后就不会再执行。 <br /><br />
 
-			Default is false.<br /><br />
+			默认值为false <br /><br />
 
-			Note: *clampWhenFinished* has no impact if the action is interrupted (it has only an effect if
-			its last loop has really finished).
+			说明: 动作如果被中断了，*clampWhenFinished*将无效 (只有当最后一次循环执行完毕之后才能起效）
 		</p>
 
 		<h3>[property:Boolean enabled]</h3>
 		<p>
-			Setting *enabled* to *false* disables this action, so that it has no impact. Default is *true*.<br /><br />
+			*enabled* 值设为*false*会禁用动作, 也就是无效.默认值是*true* <br /><br />
 
-			When the action is re-enabled, the animation continues from its current [page:.time time]
-			(setting *enabled* to *false* doesn't reset the action).<br /><br />
+			当*enabled*被重新置为*true*, 动画将从当前时间（[page:.time time]）继续
+			(将 *enabled* 置为 *false* 不会重置此次动作) <br /><br />
+
+			说明: 将*enabled*置为*true*不会让动画自动重新开始。只有满足以下条件时才会马上重新开始:
+            暂停（[page:.paused paused]）值为*false*, 同时动作没有失效 (执行停止([page:.stop stop])命令或重置([page:.reset reset])命令，
+            且权重([page:.weight weight])和时间比例([page:.timeScale timeScale])都不能为0
 
-			Note: Setting *enabled* to *true* doesn’t automatically restart the animation. Setting *enabled*
-			to *true* will only restart the animation immediately if the following condition is fulfilled:
-			[page:.paused paused] is *false*, this action has not been deactivated in the meantime (by
-			executing a [page:.stop stop] or [page:.reset reset] command), and neither [page:.weight weight]
-			nor [page:.timeScale timeScale] is 0.
 		</p>
 
 		<h3>[property:Number loop]</h3>
 		<p>
-			The looping mode (can be changed with [page:.setLoop setLoop]). Default is
-			[page:Animation THREE.LoopRepeat] (with an infinite number of [page:.repetitions repetitions])<br /><br />
+			循环模式 (可以通过[page:.setLoop setLoop]改变)。默认值是
+			[page:Animation THREE.LoopRepeat] (重复[page:.repetitions repetitions]次数无穷)<br /><br />
 
-			Must be one of these constants:<br /><br />
-			[page:Animation THREE.LoopOnce] - playing the clip once,<br />
-			[page:Animation THREE.LoopRepeat] - playing the clip with the choosen number of *repetitions*,
-			each time jumping from the end of the clip directly to its beginning,<br />
-			[page:Animation THREE.LoopPingPong] - playing the clip with the choosen number of *repetitions*,
-			alternately playing forward and backward.
+		    必须是以下值之一：<br /><br />
+			[page:Animation THREE.LoopOnce] - 只执行一次 <br />
+			[page:Animation THREE.LoopRepeat] - 重复次数为*repetitions*的值, 且每次循环结束时候将回到起始动作开始下一次循环。 <br />
+			[page:Animation THREE.LoopPingPong] - 重复次数为*repetitions*的值, 且像乒乓球一样在起始点与结束点之间来回循环。
 		</p>
 
 		<h3>[property:Boolean paused]</h3>
 		<p>
-			Setting *paused* to *true* pauses the execution of the action by setting the effective time scale
-			to 0. Default is *false*.<br /><br />
+			*paused*置为*true*会通过将动作的有效时间比例改为0来使动作暂停执行。默认值是*false*<br /><br />
 		</p>
 
 		<h3>[property:Number repetitions]</h3>
 		<p>
-			The number of repetitions of the performed [page:AnimationClip] over the course of this action.
-			Can be set via [page:.setLoop setLoop]. Default is *Infinity*.<br /><br />
-			Setting this number has no effect, if the [page:.loop loop mode] is set to
-			[page:Animation THREE.LoopOnce].
+			整个动作过程动画剪辑（[page:AnimationClip]）执行的次数，可以通过[page:.setLoop setLoop]修改。默认值是*Infinity*<br /><br />
+			如果循环模式（[page:.loop loop mode]）值被设置为[page:Animation THREE.LoopOnce]，repetitions值将会无效。
+
 		</p>
 
 		<h3>[property:Number time]</h3>
 		<p>
-			The local time of this action (in seconds, starting with 0).<br /><br />
+			动作开始的时间点 (单位是秒, 从0开始计时).<br /><br />
 
-			The value gets clamped or wrapped to 0...clip.duration (according to the loop state). It can be
-			scaled relativly to the global mixer time by changing [page:.timeScale timeScale] (using
-			[page:.setEffectiveTimeScale setEffectiveTimeScale] or [page:.setDuration setDuration]).<br />
+			这个值被限定在 0到clip.duration(根据循环状态)范围之内. 可以通过改变时间比例（[page:.timeScale timeScale]) (使用
+			[page:.setEffectiveTimeScale setEffectiveTimeScale] 或者 [page:.setDuration setDuration])来将它相对于全局的混合器缩放.<br />
 		</p>
 
 		<h3>[property:Number timeScale]</h3>
 		<p>
-			Scaling factor for the [page:.time time]. A value of 0 causes the animation to pause. Negative
-			values cause the animation to play backwards. Default is 1.<br /><br />
-			Properties/methods concerning *timeScale* (respectively *time*) are:
+			时间([page:.time time])的比例因子. 值为0时会使动画暂停。值为负数时动画会反向执行。默认值是1。<br /><br />
+			关于*timeScale*属性/方法 (不同于 *time*) 有:
 			[page:.getEffectiveTimeScale getEffectiveTimeScale],
 			[page:.halt halt],
 			[page:.paused paused],
@@ -120,9 +106,8 @@
 
 		<h3>[property:Number weight]</h3>
 		<p>
-			The degree of influence of this action (in the interval [0, 1]). Values between 0 (no impact)
-			and 1 (full impact) can be used to blend between several actions. Default is 1. <br /><br />
-			Properties/methods concerning  *weight* are:
+			动作的影响程度 (取值范围[0, 1]). 0 (无影响)到1（完全影响）之间的值可以用来混合多个动作。默认值是1<br /><br />
+			关于*weight*的属性/方法有:
 			[page:.crossFadeFrom crossFadeFrom],
 			[page:.crossFadeTo crossFadeTo],
 			[page:.enabled enabled],
@@ -135,227 +120,197 @@
 
 		<h3>[property:Boolean zeroSlopeAtEnd]</h3>
 		<p>
-			Enables smooth interpolation without separate clips for start, loop and end. Default is *true*.
+            启用平滑插值，无须单独剪辑开始、循环和结束。默认值是*true*
 		</p>
 
 		<h3>[property:Boolean zeroSlopeAtStart]</h3>
 		<p>
-			Enables smooth interpolation without separate clips for start, loop and end. Default is *true*.
+            启用平滑插值，无须单独剪辑开始、循环和结束。默认值是*true*
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:AnimationAction crossFadeFrom]( [param:AnimationAction fadeOutAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3>
 		<p>
-			Causes this action to [page:.fadeIn fade in], fading out another action simultaneously, within
-			the passed time interval. This method can be chained.<br /><br />
+			在传入的时间段内，让此动作淡入([page:.fadeIn fade in]),同时让另一个动作淡出。此方法可链式调用。<br /><br />
 
-			If warpBoolean is true, additional [page:.warp warping] (gradually changes of the time scales)
-			will be applied.<br /><br />
+			如果warpBoolean值是true, 额外的 [page:.warp warping] (时间比例的渐变)将会被应用。 <br /><br />
 
-			Note: Like with *fadeIn*/*fadeOut*, the fading starts/ends with a weight of 1.
+			说明: 与 *fadeIn*/*fadeOut*一样, 淡入淡出动作开始/结束时的权重是1.
 
 		</p>
 
 		<h3>[method:AnimationAction crossFadeTo]( [param:AnimationAction fadeInAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3>
 		<p>
-			Causes this action to [page:.fadeOut fade out], fading in another action simultaneously, within
-			the passed time interval. This method can be chained.<br /><br />
-			If warpBoolean is true, additional [page:.warp warping] (gradually changes of the time scales)
-			will be applied.<br /><br />
+            在传入的时间段内, 让此动作淡出（[page:.fadeOut fade out]），同时让另一个动作淡入。此方法可链式调用。<br /><br />
+			如果warpBoolean值是true, 额外的 [page:.warp warping] (时间比例的渐变)将会被应用。<br /><br />
 
-			Note: Like with *fadeIn*/*fadeOut*, the fading starts/ends with a weight of 1.
+			说明: 与 *fadeIn*/*fadeOut*一样, 淡入淡出动作开始/结束时的权重是1.
 		</p>
 
 		<h3>[method:AnimationAction fadeIn]( [param:Number durationInSeconds] )</h3>
 		<p>
-			Increases the [page:.weight weight] of this action gradually from 0 to 1, within the passed time
-			interval. This method can be chained.
+            在传入的时间间隔内，逐渐将此动作的权重（[page:.weight weight]）由0升到1。此方法可链式调用。
 		</p>
 
 		<h3>[method:AnimationAction fadeOut]( [param:Number durationInSeconds] )</h3>
 		<p>
-			Decreases the [page:.weight weight] of this action gradually from 1 to 0, within the passed time
-			interval. This method can be chained.
+            在传入的时间间隔内，逐渐将此动作的权重（[page:.weight weight]）由1降至0。此方法可链式调用。
 		</p>
 
 		<h3>[method:Number getEffectiveTimeScale]()</h3>
 		<p>
-			Returns the effective time scale (considering the current states of warping and
-			[page:.paused paused]).
+			返回有效时间比例(考虑当前的变形状态和[page:.paused paused]值).
 		</p>
 
 		<h3>[method:number getEffectiveWeight]()</h3>
 		<p>
-			Returns the effective weight (considering the current states of fading and
-			[page:.enabled enabled]).
+			返回影响权重(考虑当前淡入淡出状态和[page:.enabled enabled]的值).
 		</p>
 
 		<h3>[method:AnimationClip getClip]()</h3>
 		<p>
-			Returns the clip which holds the animation data for this action.
+			返回存有此动作的动画数据的剪辑
 		</p>
 
 		<h3>[method:AnimationMixer getMixer]()</h3>
 		<p>
-			Returns the mixer which is responsible for playing this action.
+            返回负责完成此动作的混合器
 		</p>
 
 		<h3>[method:Object3D getRoot]()</h3>
 		<p>
-			Returns the root object on which this action is performed.
+			返回执行此动作的根对象
 		</p>
 
 		<h3>[method:AnimationAction halt]( [param:Number durationInSeconds] )</h3>
 		<p>
-			Decelerates this animation's speed to 0 by decreasing [page:.timeScale timeScale] gradually
-			(starting from its current value), within the passed time interval. This method can be chained.
+			在传入的时间间隔内，通过从当前值开始逐渐降低时间比例([page:.timeScale timeScale])使动画逐渐减速至0。此方法可链式调用。
 		</p>
 
 		<h3>[method:Boolean isRunning]()</h3>
 		<p>
-			Returns true if the action’s [page:.time time] is currently running.<br /><br />
+			返回当前此动作的时间([page:.time time])是否正在流逝 <br /><br />
 
-			In addition to being activated in the mixer (see [page:.isScheduled isScheduled]) the following conditions must be fulfilled:
-			[page:.paused paused] is equal to false, [page:.enabled enabled] is equal to true,
-			[page:.timeScale timeScale] is different from 0, and there is no scheduling for a delayed start
-			([page:.startAt startAt]).<br /><br />
+			除了在混合器中被激活之外 (参见[page:.isScheduled isScheduled])必须满足以下条件才会返回true:
+			[page:.paused paused]值等于false, [page:.enabled enabled]值为true,
+			[page:.timeScale timeScale]值不为0, 而且没有安排延时启动([page:.startAt startAt]).<br /><br />
 
-			Note: *isRunning* being true doesn’t necessarily mean that the animation can actually be seen.
-			This is only the case, if [page:.weight weight] is additionally set to a non-zero value.
+			说明 *isRunning* 为true并不意味着此动画一定会切实地被看到。仅当权重([page:.weight weight])被设置为非零值时才是这种情况。
 		</p>
 
 		<h3>[method:Boolean isScheduled]()</h3>
 		<p>
-			Returns true, if this action is activated in the mixer.<br /><br />
-			Note: This doesn’t necessarily mean that the animation is actually running (compare the additional
-			conditions for [page:.isRunning isRunning]).
+			如果动作是在混合器中被激活的，返回true。<br /><br />
+			说明: 这并不意味着动画正在执行中 (需要额外判断[page:.isRunning isRunning]值)
 		</p>
 
 		<h3>[method:AnimationAction play]()</h3>
 		<p>
-			Tells the mixer to activate the action. This method can be chained.<br /><br />
+			让混合器激活动作。此方法可链式调用。<br /><br />
 
-			Note: Activating this action doesn’t necessarily mean that the animation starts immediately:
-			If the action had already finished before (by reaching the end of its last loop), or if a time
-			for a delayed start has been set (via [page:.startAt startAt]), a [page:.reset reset] must be
-			executed first. Some other settings ([page:.paused paused]=true, [page:.enabled enabled]=false,
-			[page:.weight weight]=0, [page:.timeScale timeScale]=0) can prevent the animation from playing,
-			too.
+			说明: 激活动作并不意味着动画会立刻开始: 如果动作在此之前已经完成（到达最后一次循环的结尾），或者如果已经设置了延时
+			启动(通过 [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>
-			Resets the action. This method can be chained.<br /><br />
+			重置动作。此方法可链式调用。<br /><br />
 
-			This method sets [page:.paused paused] to false, [page:.enabled enabled] to true,
-			[page:.time time] to 0, interrupts any scheduled fading and warping, and removes the internal
-			loop count and scheduling for delayed starting.<br /><br />
+			该方法会将暂停值 [page:.paused paused] 设为false, 启用值[page:.enabled enabled] 设为true,时间值
+			[page:.time time]设为0, 中断任何预定的淡入淡出和变形, 以及移除内部循环次数以及延迟启动。<br /><br />
 
-			Note: .*reset* is always called by [page:.stop stop], but .*reset* doesn’t call .*stop* itself.
-			This means: If you want both, resetting and stopping, don’t call .*reset*; call .*stop* instead.
+			说明: 停止方法[page:.stop stop]内调用了重置方法（reset）, 但是 .*reset*不会调用 .*stop*。
+            这就表示: 如果你想要这两者, 重置并且停止, 不要调用*reset*; 而应该调用*stop*。
 		</p>
 
 		<h3>[method:AnimationAction setDuration]( [param:Number durationInSeconds] )</h3>
 		<p>
-			Sets the duration for a single loop of this action (by adjusting [page:.timeScale timeScale]
-			and stopping any scheduled warping). This method can be chained.
+			设置单此循环的持续时间(通过调整时间比例（[page:.timeScale timeScale]）以及停用所有的变形)。此方法可以链式调用。
 		</p>
 
 		<h3>[method:AnimationAction setEffectiveTimeScale]( [param:Number timeScale] )</h3>
 		<p>
-			Sets the [page:.timeScale timeScale] and stops any scheduled warping. This method can be chained.<br /><br />
+			设置时间比例（[page:.timeScale timeScale]）以及停用所有的变形)。 此方法可以链式调用。<br /><br />
 
-			If [page:.paused paused] is false, the effective time scale (an internal property) will also be set
-			to this value; otherwise the effective time scale (directly affecting the animation at
-			this moment) will be set to 0.<br /><br />
+			如果暂停 （[page:.paused paused]）值为false, 有效的时间比例(一个内部属性) 也会被设为该值; 否则有效时间比例 (直接影响当前动画
+			将会被设为0.<br /><br />
 
-			Note: .*paused* will not be switched to *true* automatically, if .*timeScale* is set to 0 by
-			this method.
+			说明: 如果时间比例.*timeScale* 被此方法设为0，暂停值*paused*不会被自动改为*true*。
 		</p>
 
 		<h3>[method:AnimationAction setEffectiveWeight]( [param:Number weight] )</h3>
 		<p>
-			Sets the [page:.weight weight] and stops any scheduled fading. This method can be chained.<br /><br />
+			设置权重（[page:.weight weight]）以及停止所有淡入淡出。该方法可以链式调用。<br /><br />
 
-			If [page:.enabled enabled] is true, the effective weight (an internal property) will also be set
-			to this value; otherwise the effective weight (directly affecting the animation at this moment)
-			will be set to 0.<br /><br />
+			如果启用属性（[page:.enabled enabled]）为true, 那么有效权重(一个内部属性) 也会被设为该值; 否则有效权重 (直接影响当前动画)将会被设为0.<br /><br />
 
-			Note: .*enabled* will not be switched to *false* automatically, if .*weight* is set to 0 by
-			this method.
+			说明: 如果该方法将权重*weight*值设为0，启用值*enabled*不会被自动改为*false*。
 		</p>
 
 		<h3>[method:AnimationAction setLoop]( [param:Number loopMode], [param:Number repetitions] )</h3>
 		<p>
-			Sets the [page:.loop loop mode] and the number of [page:.repetitions repetitions]. This method
-			can be chained.
+			设置循环（[page:.loop loop mode]）及循环重复次数（[page:.repetitions repetitions]）。改方法可被链式调用。
 		</p>
 
 		<h3>[method:AnimationAction startAt]( [param:Number startTimeInSeconds] )</h3>
 		<p>
-			Defines the time for a delayed start (usually passed as [page:AnimationMixer.time] +
-			deltaTimeInSeconds). This method can be chained.<br /><br />
+			定义延时启动的事件 (通常会传入[page:AnimationMixer.time] +
+			deltaTimeInSeconds)。 该方法可以链式调用。<br /><br />
 
-			Note: The animation will only start at the given time, if .*startAt* is chained with
-			[page:.play play], or if the action has already been activated in the mixer (by a previous
-			call of .*play*, without stopping or resetting it in the meantime).
+			说明: 如果 *startAt*方法是和[page:.play play]方法一起链式调用, 或者动画已经在混合器中被激活 (通过先行调用*play*, 同时没有停止或重置)，动画将仅在给定时间开始.
 		</p>
 
 		<h3>[method:AnimationAction stop]()</h3>
 		<p>
-			Tells the mixer to deactivate this action. This method can be chained.<br /><br />
+			让混合器停止动作。该方法可以被链式调用。<br /><br />
 
-			The action will be immediately stopped and completely [page:.reset reset].<br /><br />
+			动作会马上停止以及完全[page:.reset 重置].<br /><br />
 
-			Note: You can stop all active actions on the same mixer in one go via
-			[page:AnimationMixer.stopAllAction mixer.stopAllAction].
+			说明: 你可以通过[page:AnimationMixer.stopAllAction mixer.stopAllAction]在一个混合器中一举停止所有处于激活态的动作。
 		</p>
 
 		<h3>[method:AnimationAction stopFading]()</h3>
 		<p>
-			Stops any scheduled [page:.fadeIn fading] which is applied to this action. This method can be
-			chained.
+			停止动作中所有预定的淡入淡出（[page:.fadeIn fading]）。该方法可以被链式调用。
 		</p>
 
 		<h3>[method:AnimationAction stopWarping]()</h3>
 		<p>
-			Stops any scheduled [page:.warp warping] which is applied to this action. This method can be
-			chained.
+			停用动作中所有预定的变形[page:.warp warping]。该方法可被链式调用。
 		</p>
 
 		<h3>[method:AnimationAction syncWith]( [param:AnimationAction otherAction] )</h3>
 		<p>
-			Synchronizes this action with the passed other action. This method can be chained.<br /><br />
+			将此动作与传入的其它动作同步。此方法可被链式调用。<br /><br />
 
-			Synchronizing is done by setting this action’s [page:.time time] and [page:.timeScale timeScale] values
-			to the corresponding values of the other action (stopping any scheduled warping).<br /><br />
+			同步是通过将动作的时间([page:.time time])或时间比例([page:.timeScale timeScale])与另一动作设置一致来实现的
+			(停用所有预定的变形)。<br /><br />
 
-			Note: Future changes of the other action's *time* and *timeScale* will not be detected.
+			说明: 另一动作的 *time* 和 *timeScale*未来变化将不会被检测到.
 		</p>
 
 		<h3>[method:AnimationAction warp]( [param:Number startTimeScale], [param:Number endTimeScale], [param:Number durationInSeconds] )</h3>
 		<p>
-			Changes the playback speed, within the passed time interval, by modifying
-			[page:.timeScale timeScale] gradually from *startTimeScale* to *endTimeScale*. This method can
-			be chained.
+            在传入的事件间隔内，通过逐渐将时间比例[page:.timeScale timeScale]由*startTimeScale*修改至*endTimeScale*来改变回放速度。该方法可被链式调用。
 		</p>
 
 
-		<h2>Events</h2>
+		<h2>事件</h2>
 
 
 		<p class="desc">
-			There are two events indicating when a single loop of the action respectively the entire action has finished. You can react to them with:
+			有两个事件分别表示了单次循环的结束和全部动作的结束，你可以这样对它们做出响应:
 		</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>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/animation/AnimationClip.html

@@ -11,129 +11,122 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			An AnimationClip is a reusable set of keyframe tracks which represent an animation.<br /><br />
+			动画剪辑（AnimationClip）是一个可重用的关键帧轨道集，它代表动画。<br /><br />
 
-			For an overview of the different elements of the three.js animation system see the
-			"Animation System" article in the "Next Steps" section of the manual.
+			在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:String name], [param:Number duration], [param:Array tracks] )</h3>
 		<p>
-			[page:String name] - a name for this clip.<br />
-			[page:Number duration] - the duration of this clip (in seconds). If a negative value is passed,
-			the duration will be calculated from the passed *tracks* array.<br />
-			[page:Array tracks] - an array of [page:KeyframeTrack KeyframeTracks].<br /><br />
+			[page:String name] - 此剪辑的名称<br />
+			[page:Number duration] - 持续时间 (单位秒). 如果传入负数, 持续时间将会从传入的数组中计算得到。<br />
+			[page:Array tracks] - 一个由关键帧轨道（[page:KeyframeTrack KeyframeTracks]）组成的数组。<br /><br />
+
+			说明: 与其直接调用构造函数实例化一个动画剪辑, 不如使用其静态方法中的一个来创建：
+			用JSON ([page:.parse parse]), 用变形目标序列([page:.CreateFromMorphTargetSequence CreateFromMorphTargetSequence],
+			[page:.CreateClipsFromMorphTargetSequences CreateClipsFromMorphTargetSequences])或者用动画层级 ([page:.parseAnimation parseAnimation])来创建 - 如果你的模型中几何体的动画数组中还没有保存动画剪辑的话。
 
-			Note: Instead of instantiating an AnimationClip directly with the constructor, you can use one
-			of its static methods to create AnimationClips: from JSON ([page:.parse parse]), from morph
-			target sequences ([page:.CreateFromMorphTargetSequence CreateFromMorphTargetSequence],
-			[page:.CreateClipsFromMorphTargetSequences CreateClipsFromMorphTargetSequences]) or from
-			animation hierarchies ([page:.parseAnimation parseAnimation]) - if your model doesn't already
-			hold AnimationClips in its geometry's animations array.
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 		<h3>[property:Number duration]</h3>
 		<p>
-			The duration of this clip (in seconds). This can be calculated from the [page:.tracks tracks]
-			array via [page:.resetDuration resetDuration].
+			剪辑的持续时间 (单位秒). 可以通过[page:.resetDuration resetDuration]从轨道数组（[page:.tracks tracks]）计算出来。
+
 		</p>
 
 		<h3>[property:String name]</h3>
 		<p>
-			A name for this clip. A certain clip can be searched via [page:.findByName findByName].
+			剪辑的名称. 调用[page:.findByName findByName]根据名称搜索某个剪辑
 		</p>
 
 		<h3>[property:Array tracks]</h3>
 		<p>
-			An array containing a [page:KeyframeTrack] for each property that are animated by this clip.
+            一个包含该剪辑中有动画的所有属性的关键帧轨道（[page:KeyframeTrack]）的数组。
 		</p>
 
 		<h3>[property:String uuid]</h3>
 		<p>
-			The [link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] of this clip instance.
-			It gets automatically assigned and shouldn't be edited.
+			剪辑实例的[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID]，自动分配且不可编辑。
+
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:this optimize]()</h3>
 		<p>
-			Optimizes each track by removing equivalent sequential keys (which are common in morph target
-			sequences).
+            通过移除等效的顺序键（在变形目标序列中很常见）来优化每一个轨道
+
 		</p>
 
 		<h3>[method:this resetDuration]()</h3>
 		<p>
-			Sets the [page:.duration duration] of the clip to the duration of its longest
-			[page:KeyframeTrack].
+			将剪辑的持续时间（[page:.duration duration]）设为最长的关键帧轨道([page:KeyframeTrack])的持续时间。
+			.
 		</p>
 
 		<h3>[method:this trim]()</h3>
 		<p>
-			Trims all tracks to the clip's duration.
+			修剪所有的轨道到该剪辑的持续时间。
 		</p>
 
 		<h3>[method:Boolean validate]()</h3>
 		<p>
-			Performs minimal validation on each track in the clip. Returns true if all tracks are valid.
+            对剪辑中的每个轨道执行最小验证。如果所有轨道都有效，返回true。
 		</p>
 
 
-		<h2>Static Methods</h2>
+		<h2>静态方法</h2>
 
 
 		<h3>[method:Array CreateClipsFromMorphTargetSequences]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
 		<p>
-			Returns an array of new AnimationClips created from the [page:Geometry.morphTargets morph
-			target sequences] of a geometry, trying to sort morph target names into animation-group-based
-			patterns like "Walk_001, Walk_002, Run_001, Run_002 ..."<br /><br />
+			返回从几何体的变形目标序列([page:Geometry.morphTargets morph
+			target sequences])创建的新动画剪辑(AnimationClip)数组，并尝试将变形目标名称分类为基于动画组的模式，如“Walk_001、Walk_002、Run_001、Run_002……”。<br /><br />
 
-			This method is called by the [page:JSONLoader] internally, and it uses
+			该方法被[page:JSONLoader]内部调用, 并且它使用了
 			[page:.CreateFromMorphTargetSequence CreateFromMorphTargetSequence].
 		</p>
 
 		<h3>[method:AnimationClip CreateFromMorphTargetSequence]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
 		<p>
-			Returns a new AnimationClip from the passed [page:Geometry.morphTargets morph targets array]
-			of a geometry, taking a name and the number of frames per second.<br /><br />
+            返回一个由几何体变形目标数组([page:Geometry.morphTargets morph targets array])得到的新动画剪辑，接收名称和帧率参数。<br /><br />
+
+			说明: 帧率是必须参数, 但是动画速度可能会在*AnimationAction*中被[page:AnimationAction.setDuration animationAction.setDuration]方法重写。
 
-			Note: The fps parameter is required, but the animation speed can be overridden in an
-			*AnimationAction* via [page:AnimationAction.setDuration animationAction.setDuration].
 		</p>
 
 		<h3>[method:AnimationClip findByName]( [param:Object objectOrClipArray], [param:String name] )</h3>
 		<p>
-			Searches for an AnimationClip by name, taking as its first parameter either an array of
-			AnimationClips, or a mesh or geometry that contains an array named "animations".
+			根据名称搜索动画剪辑(AnimationClip), 接收一个动画剪辑数组或者一个包含名为"animation"的数组的网格（或几何体）作为第一个参数。
 		</p>
 
 		<h3>[method:AnimationClip parse]( [param:Object json] )</h3>
 		<p>
-			Parses a JSON representation of a clip and returns an AnimationClip.
+			解析剪辑的JSON表示，并返回一个动画剪辑(AnimationClip)。
 		</p>
 
 		<h3>[method:AnimationClip parseAnimation]( [param:Object animation], [param:Array bones] )</h3>
 		<p>
-			Parses the animation.hierarchy format and returns an AnimationClip.
+            解析动画层级格式并返回动画剪辑。
 		</p>
 
 		<h3>[method:Object toJSON]( [param:AnimationClip clip] )</h3>
 		<p>
-			Takes an AnimationClip and returns a JSON object.
+			接收一个动画剪辑为参数并返回一个JSON对象.
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/animation/AnimationMixer.html

@@ -11,98 +11,89 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			The AnimationMixer is a player for animations on a particular object in the scene. When
-			multiple objects in the scene are animated independently, one AnimationMixer may be used for
-			each object.<br /><br />
+            动画混合器是用于场景中特定对象的动画的播放器。当场景中的多个对象独立动画时，每个对象都可以使用同一个动画混合器。<br /><br />
 
-			For an overview of the different elements of the three.js animation system see the
-			"Animation System" article in the "Next Steps" section of the manual.
+			在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:Object3D rootObject] )</h3>
 		<p>
-			[page:Object3D rootObject] - the object whose animations shall be played by this mixer.<br />
+			[page:Object3D rootObject] - 混合器播放的动画所属的对象<br />
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 		<h3>[property:Number time]</h3>
 		<p>
-			The global mixer time (in seconds; starting with 0 on the mixer's creation).
+			全局的混合器时间(单位秒; 混合器创建的时刻记作0时刻)
 		</p>
 
 		<h3>[property:Number timeScale]</h3>
 		<p>
-			A scaling factor for the global [page:.time mixer time].<br /><br />
+			全局时间([page:.time mixer time])的比例因子<br /><br />
 
-			Note: Setting the mixer's timeScale to 0 and later back to 1 is a possibility to pause/unpause
-			all actions that are controlled by this mixer.
+			说明: 将混合器的时间比例设为0, 稍后再设置为1，可以暂停/取消暂停由该混合器控制的所有动作。
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:AnimationAction clipAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
 		<p>
-			Returns an [page:AnimationAction] for the passed clip, optionally using a root object different
-			from the mixer's default root. The first parameter can be either an [page:AnimationClip] object
-			or the name of an AnimationClip.<br /><br />
+			返回所传入的剪辑参数的[page:AnimationAction], 根对象参数可选，默认值为混合器的默认根对象。第一个参数可以是动画剪辑([page:AnimationClip])对象或者动画剪辑的名称。<br /><br />
 
-			If an action fitting the clip and root parameters doesn't yet exist, it will be created by
-			this method. Calling this method several times with the same clip and root parameters always
-			returns the same clip instance.
+			如果不存在符合传入的剪辑和根对象这两个参数的动作, 该方法将会创建一个。传入相同的参数多次调用将会返回同一个剪辑实例。
 		</p>
 
 		<h3>[method:AnimationAction existingAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
 		<p>
-			Returns an existing [page:AnimationAction] for the passed clip, optionally using a root object
-			different from the mixer's default root.<br /><br />
+			返回传入剪辑的已有[page:AnimationAction], 根对象参数可选，默认值为混合器的默认根对象。<br /><br />
 
-			The first parameter can be either an [page:AnimationClip] object or the name of an AnimationClip.
+			第一个参数可以是动画剪辑([page:AnimationClip])对象或者动画剪辑的名称。
 		</p>
 
 		<h3>[method:Object3D getRoot]()</h3>
 		<p>
-			Returns this mixer's root object.
+			返回混合器的根对象
 		</p>
 
 		<h3>[method:AnimationMixer stopAllAction]()</h3>
 		<p>
-			Deactivates all previously scheduled actions on this mixer.
+			停用混合器上所有预定的动作
 		</p>
 
 		<h3>[method:AnimationMixer update]([param:Number deltaTimeInSeconds]) </h3>
 		<p>
-			Advances the global mixer time and updates the animation.<br /><br />
+			推进混合器时间并更新动画 <br /><br />
 
-			This is usually done in the render loop, passing [page:Clock.getDelta clock.getDelta] scaled by the mixer's [page:.timeScale timeScale]).
+			通常在渲染循环中完成, 传入按照混合器的时间比例([page:.timeScale timeScale])缩放过的[page:Clock.getDelta clock.getDelta]
 		</p>
 
 		<h3>[method:null uncacheClip]([param:AnimationClip clip])</h3>
 
 		<p>
-			Deallocates all memory resources for a clip.
+			释放剪辑的所有内存资源
 		</p>
 
 		<h3>[method:null uncacheRoot]([param:Object3D root]) </h3>
 		<p>
-			Deallocates all memory resources for a root object.
+			释放根对象的所有内存资源
 		</p>
 
 		<h3>[method:null uncacheAction]([param:AnimationClip clip], [param:Object3D optionalRoot])</h3>
 		<p>
-			Deallocates all memory resources for an action.
+			释放动作的所有内存资源
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/animation/AnimationObjectGroup.html

@@ -10,74 +10,71 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">A group of objects that receives a shared animation state.<br /><br />
+		<p class="desc">接收共享动画状态的一组对象。<br /><br />
 
-			For an overview of the different elements of the three.js animation system see the
-			"Animation System" article in the "Next Steps" section of the manual.
+			在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述
 		</p>
 
-		<h2>Usage:</h2>
+		<h2>用法:</h2>
 
 		<p class="desc">
-			Add objects you would otherwise pass as 'root' to the constructor or the [page:AnimationMixer.clipAction clipAction]
-			method of [page:AnimationMixer AnimationMixer] and instead pass this object as 'root'.<br /><br />
+            将本来要作为根对象传入构造器或者动画混合器([page:AnimationMixer AnimationMixer])的[page:AnimationMixer.clipAction clipAction]方法中的对象加入组中，并将这个组对象作为根对象传递。
+			<br /><br />
 
-			Note that objects of this class appear as one object to the mixer,
-			so cache control of the individual objects must be done	on the group.
+		    注意，这个类的实例作为混合器中的一个对象，因此，必须对组内的单个对象做缓存控制。
 		</p>
 
 
-		<h2>Limitations</h2>
+		<h2>限制</h2>
 		<p class="desc">
-			The animated properties must be compatible among all objects in the group.<br /><br />
+			动画属性必须在组中的所有对象之间兼容。<br /><br />
 
-			A single property can either be controlled through a target group or directly, but not both.
+			单个属性可以通过目标组控制或者直接控制，但不能两者同时。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
-		[page:object obj] - an abitrary number of meshes that share the same animation state.<br />
+		[page:object obj] - 共享同一动画状态的任意数量的网格<br />
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 		<h3>[property:object stats]</h3>
 		<p>
-			An object that contains some informations of this *AnimationObjectGroup* (total number, number
-			in use, number of bindings per object)
+			一个包含此动画对象组(AnimationObjectGroup)的一些信息的对象 (总数, 使用中的数量，绑定到每个对象上的数量）
+
 		</p>
 
 		<h3>[property:String uuid]</h3>
 		<p>
-			The [link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] of this
-			*AnimationObjectGroup*. It gets automatically assigned and shouldn't be edited.
+			这个动画对象组(AnimationObjectGroup)的[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID]。它是自动分配的，不可被编辑。
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:null add]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
 		<p>
-			Adds an arbitrary number of objects to this *AnimationObjectGroup*.
+			将任意数量的对象添加到这个动画对象组(AnimationObjectGroup)。
 		</p>
 
 		<h3>[method:null remove]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
 		<p>
-			Removes an arbitrary number of objects from this *AnimationObjectGroup*.
+			将任意数量的对象从这个动画对象组(AnimationObjectGroup)中删除。
 		</p>
 
 		<h3>[method:null uncache]( [param:object obj1], [param:object obj2], [param:object obj3], ... )</h3>
 		<p>
-			Deallocates all memory resources for the passed objects of this *AnimationObjectGroup*.
+			释放此动画对象组(AnimationObjectGroup)传递的对象的所有内存资源
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/animation/AnimationUtils.html

@@ -11,45 +11,47 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		An object with various functions to assist with animations, used internally.
+            一个提供各种动画辅助方法的对象，内部使用。
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:Array arraySlice]( array, from, to )</h3>
 		<p>
-		This is the same as  Array.prototype.slice, but also works on typed arrays.
+		和Array.prototype.slice作用一样, 但也适用于类型化数组.
 		</p>
 
 		<h3>[method:Array convertArray]( array, type, forceClone )</h3>
 		<p>
-		Converts an array to a specific type.
+            将数组转换为某种特定类型。
 		</p>
 
 		<h3>[method:Array flattenJSON]( jsonKeys, times, values, valuePropertyName  )</h3>
 		<p>
-		Used for parsing AOS keyframe formats.
+            用于解析AOS关键帧格式。
 		</p>
 
 		<h3>[method:Array getKeyframeOrder]( times )</h3>
 		<p>
-		Returns an array by which times and values can be sorted.
+            返回一个数组，时间和值可以根据此数组排序。
 		</p>
 
 		<h3>[method:Boolean isTypedArray]( object )</h3>
 		<p>
-		Returns *true* if the object is a typed array.
+            如果该对象是类型化数组，返回*true*
+
 		</p>
 
 		<h3>[method:Array sortedArray]( values, stride, order )</h3>
 		<p>
-		Sorts the array previously returned by [page:AnimationUtils.getKeyframeOrder getKeyframeOrder].
+            将[page:AnimationUtils.getKeyframeOrder getKeyframeOrder]方法返回的数组排序。
+
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/animation/KeyframeTrack.html

@@ -12,39 +12,31 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A KeyframeTrack is a timed sequence of [link:https://en.wikipedia.org/wiki/Key_frame keyframes],
-			which are composed of lists of times and related values, and which are used to animate a
-			specific property of an object.
+			关键帧轨道(KeyframeTrack)是关键帧([link:https://en.wikipedia.org/wiki/Key_frame keyframes])的定时序列,
+			它由时间和相关值的列表组成, 用来让一个对象的某个特定属性动起来。
 		</p>
 
 		<p>
-			For an overview of the different elements of the three.js animation system see the
-			"Animation System" article in the "Next Steps" section of the manual.
+            在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述
 		</p>
 
 		<p>
-			In contrast to the animation hierarchy of the
-			[link:https://github.com/mrdoob/three.js/wiki/JSON-Model-format-3 JSON model format] a
-			*KeyframeTrack* doesn't store its single keyframes as objects in a "keys" array (holding the
-			times and the values for each frame together in one place).
+            和[link:https://github.com/mrdoob/three.js/wiki/JSON-Model-format-3 JSON model format]的动画层级相反，
+            关键帧轨道（KeyframeTrack）不会将单帧作为对象存储在“key”数组(一个存有每一帧的时间和值的地方)中。
+
 		</p>
 
 		<p>
-			Instead of this there are always two arrays in a *KeyframeTrack*: the [page:.times times] array
-			stores the time values for all keyframes of this track in sequential order, and the
-			[page:.values values] array contains the corresponding changing values of the animated property.
+            关键帧轨道(KeyframeTrack)中总是存在两个数组：[page:.times times]数组按顺序存储该轨道的所有关键帧的时间值，而[page:.values values]数组包含动画属性的相应更改值。
 		</p>
 
 		<p>
-			A single value, belonging to a certain point of time, can not only be a simple number, but (for
-			example) a vector (if a position is animated) or a quaternion (if a rotation is animated). For
-			this reason the values array (which is a flat array, too) might be three or four times as long as the
-			times array.
+            值数组中的每一个成员，属于某一特定时间点，不仅可以是一个简单的数字，还可以是（比如）一个向量（如果是位置动画）或者是一个四元数（如果是旋转动画）。
+            因此，值数组（也是一个平面阵列）的长度可能是时间数组的三四倍。
 		</p>
 
 		<p>
-			Corresponding to the different possible types of animated values there are several subclasses of
-			*KeyframeTrack*, inheriting the most properties and methods:
+            与不同类型的动画值对应，存在若干关键帧轨道(KeyframeTrack)的子类，继承了它大多数属性和方法：
 		</p>
 
 		<ul>
@@ -57,206 +49,181 @@
 		</ul>
 
 		<p>
-			Some examples of how to manually create [page:AnimationClip AnimationClips] with different sorts
-			of KeyframeTracks can be found in the [link:https://threejs.org/examples/js/AnimationClipCreator.js]
-			file.
+            可以在[link:https://threejs.org/examples/js/AnimationClipCreator.js]文件中找到用不同类型的关键帧轨道创建动画剪辑([page:AnimationClip AnimationClips])的示例。
 		</p>
 
 		<p>
-			Since explicit values are only specified for the discrete points of time stored in the times array,
-			all values in between have to be interpolated.
+            由于显式值仅针对存储在时间数组中的离散时间点指定，因此必须在两个时间点之间进行插值
 		</p>
 
 		<p>
-			The track's name is important for the connection of this track with a specific property of the
-			animated node (done by [page:PropertyBinding]).
+            轨道的名称对于这个轨道与动画节点的特定属性的连接(由[page:PropertyBinding]完成)很重要。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:String name], [param:Array times], [param:Array values], [param:Constant interpolation] )</h3>
 		<p>
-			[page:String name] - the identifier for the *KeyframeTrack*.<br />
-			[page:Array times] - an array of keyframe times, converted internally to a
+			[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] - an array with the values related to the times array, converted internally to a
+			[page:Array values] - 与时间数组中的时间点相关的值组成的数组, 被内部转化为
 			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array].<br />
-			[page:Constant interpolation] - the type of interpolation to use. See
+			[page:Constant interpolation] - 使用的插值类型。 参见
 			[page:Animation Animation Constants] for possible values. Default is [page:Animation InterpolateLinear].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 		<h3>[property:String name]</h3>
 		<p>
-			The track's name can refer to [page:Geometry.morphTargets morph targets] or
-			[page:SkinnedMesh bones] or possibly other values within an animated object. See
-			[page:PropertyBinding.parseTrackName] for the forms of strings that can be parsed for property
-			binding:
+            轨道的名称可以指动画对象中的变形目标([page:Geometry.morphTargets morph targets])、骨骼([page:SkinnedMesh bones])或可能的其他值
+			查看[page:PropertyBinding.parseTrackName]可获知哪些形式的字符串可以解析出绑定的属性:
 		</p>
-
 		<p>
-			The name can specify the node either using its name or its uuid (although it needs to be in the
-			subtree of the scene graph node passed into the mixer). Or, if the track name starts with a dot,
-			the track applies to the root node that was passed into the mixer.
+            可以使用节点名称或uuid（尽管它需要位于传递到混合器的场景图节点的子树中）引用到某节点。或者， 如果轨道名称的首字符是点,
+			该轨道会应用到传入到混合器的根节点上。
 		</p>
 
 		<p>
-			Usually after the node a property will be specified directly. But you can also specify a
-			subproperty, such as .rotation[x], if you just want to drive the X component of the rotation
-			via a float track.
+			通常，在该节点之后会直接指定一个属性。 但是也可以再指定一个子属性， 例如 如果只是想通过浮动轨道使X组件旋转，可使用 .rotation[x]。
 		</p>
 
 		<p>
-			You can also specify bones or multimaterials by using an object name, for example:
-			.bones[R_hand].scale; the red channel of the diffuse color of the fourth material in a
-			materials array - as a further example - can be accessed with .materials[3].diffuse[r].
+            还可以使用对象名称来指定骨骼或多材质，例如：.bones[R_hand].scale；再比如，材料数组中的第四个材料的漫反射颜色的红通道可以通过 .materials[3].diffuse[r]访问到。
 		</p>
 
 		<p>
-			PropertyBinding will also resolve morph target names, for example: .morphTargetInfluences[run].
+			属性绑定也会解析变形目标名称, 例如: .morphTargetInfluences[run]
 		</p>
 
 		<p>
-			Note: The track's name does not necessarily have to be unique. Multiple tracks can drive the same
-			property. The result should be based on a weighted blend between the multiple tracks according to
-			the weights of their respective actions.
+			说明: 轨道名称不一定得唯一。 多个轨道可驱动统一属性， 此时结果应该基于多个轨道之间根据其各自动作的权重的加权混合。
 		</p>
 
 		<h3>[property:Float32Array times]</h3>
 		<p>
-			A [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array],
-			converted from the times array which is passed in the constructor.
+			一个[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array]类型的值，由传入构造器中时间数组参数转化而来。
 		</p>
 
 		<h3>[property:Float32Array values]</h3>
 		<p>
-			A [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array],
-			converted from the values array which is passed in the constructor.
+			一个[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array]类型的值，
+			由传入构造器中值数组参数转化而来
 		</p>
 
 		<h3>[property:Constant DefaultInterpolation]</h3>
 		<p>
-			The default interpolation type: [page:Animation InterpolateLinear].
+			默认的参数插值类型： [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],
-			the type of the buffer internally used for the times.
+			内部用于时间数组的缓冲区的类型
 		</p>
 
 		<h3>[property:Constant ValueBufferType ]</h3>
 		<p>
 			[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array Float32Array],
-			the type of the buffer internally used for the values.
+			内部用于值数组的缓冲区的类型
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:null createInterpolant]()</h3>
 		<p>
-			Creates a [page:LinearInterpolant LinearInterpolant], [page:CubicInterpolant CubicInterpolant]
-			or [page:DiscreteInterpolant DiscreteInterpolant], depending on the value of the interpolation
-			parameter passed in the constructor.
+			根据传入构造器中的插值类型参数，创建线性插值([page:LinearInterpolant LinearInterpolant])，立方插值([page:CubicInterpolant CubicInterpolant])或离散插值
+			([page:DiscreteInterpolant DiscreteInterpolant])
 		</p>
 
 		<h3>[method:null getInterpolation]()</h3>
 		<p>
-			Returns the interpolation type.
+			返回插值类型
 		</p>
 
 		<h3>[method:Number getValueSize]()</h3>
 		<p>
-			Returns the size of each value (that is the length of the [page:.values values] array divided
-			by the length of the [page:.times times] array).
+			返回每个值的大小(即[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>
-			Creates a new [page:DiscreteInterpolant DiscreteInterpolant] from the
-			[page:KeyframeTrack.times times] and [page:KeyframeTrack.times values]. A Float32Array can be
-			passed which will receive the results. Otherwise a new array with the appropriate size will be
-			created automatically.
+            根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的离散插值([page:DiscreteInterpolant DiscreteInterpolant])。
+            可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
 		</p>
 
 		<h3>[method:null InterpolantFactoryMethodLinear]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
 		<p>
-			Creates a new [page:LinearInterpolant LinearInterpolant] from the
-			[page:KeyframeTrack.times times] and [page:KeyframeTrack.times values]. A Float32Array can be
-			passed which will receive the results. Otherwise a new array with the appropriate size will be
-			created automatically.
+            根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的线性插值([page:LinearInterpolant LinearInterpolant])。
+            可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
 		</p>
 
 		<h3>[method:null InterpolantFactoryMethodSmooth]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
 		<p>
-			Create a new [page:CubicInterpolant CubicInterpolant] from the
-			[page:KeyframeTrack.times times] and [page:KeyframeTrack.times values]. A Float32Array can be
-			passed which will receive the results. Otherwise a new array with the appropriate size will be
-			created automatically.
+            根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的立方插值([page:CubicInterpolant CubicInterpolant])。
+            可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
 		</p>
 
 		<h3>[method:this optimize]()</h3>
 		<p>
-			Removes equivalent sequential keys, which are common in morph target sequences.
+            删除等效的顺序键，这些键在变形目标序列中很常见。
 		</p>
 
 		<h3>[method:this scale]()</h3>
 		<p>
-			Scales all keyframe times by a factor.<br /><br />
+            缩放所有关键帧的时间。<br /><br />
 
-			Note: This is useful, for example, for conversions to a certain rate of frames per seconds (as it
-			is done internally by
-			[page:AnimationClip.CreateFromMorphTargetSequence animationClip.CreateFromMorphTargetSequence]).
+			说明: 这个方法很有用，例如， 可用于转化为某一特定帧率(正如[page:AnimationClip.CreateFromMorphTargetSequence animationClip.CreateFromMorphTargetSequence]内部所做的一样)。
 		</p>
 
 		<h3>[method:this setInterpolation]( [param:Constant interpolationType] )</h3>
 		<p>
-			Sets the interpolation type. See [page:Animation Animation Constants] for choices.
+			设置插值类型。 参阅[page:Animation Animation Constants]以供选择。
 		</p>
 
 		<h3>[method:this shift]( [param:Number timeOffsetInSeconds] )</h3>
 		<p>
-			Moves all keyframes either forward or backward in time.
+            及时删除之前或之后的所有关键帧。
 		</p>
 
 
 		<h3>[method:this trim]( [param:Number startTimeInSeconds], [param:Number endTimeInSeconds] )</h3>
 		<p>
-			Removes keyframes before *startTime* and after *endTime*,
-			without changing any values within the range [*startTime*, *endTime*].
+			删除开始时间(startTime)之前以及结束时间(endTime)之后的关键帧，不改变[*startTime*, *endTime*]范围内的任何值。
 		</p>
 
 		<h3>[method:Boolean validate]()</h3>
 		<p>
-			Performs minimal validation on the tracks. Returns true if valid.
+            在轨道上执行最小验证，有效则返回true
 		</p>
 
 		<p>
-			This method logs errors to the console, if a track is empty, if the [page:.valueSize value size] is not valid, if an item
-			in the [page:.times times] or [page:.values values] array is not a valid number or if the items in the *times* array are out of order.
+			如果出现以下情况，该方法会在控制台输出错误日志: 轨道为空; [page:.valueSize value size]值不可靠；
+			[page:.times times]数组或[page:.values values]数组中的元素不是数字；*times*数组中的元素乱序。
 		</p>
 
-		<h2>Static Methods</h2>
+		<h2>静态方法</h2>
 
 		<h3>[method:KeyframeTrack parse]( [param:JSON json] )</h3>
 		<p>
-		Parses a JSON object and returns a new keyframe track of the correct type.
+            解析JSON对象并返回一个正确类型的新关键帧轨道。
 		</p>
 
 		<h3>[method:JSON toJSON]( [param:KeyframeTrack track] )</h3>
 		<p>
-		Converts the track to JSON.
+		    将该轨道转化为JSON
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/animation/PropertyBinding.html

@@ -11,22 +11,22 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			This holds a reference to a real property in the scene graph; used internally.
+            对场景图中某一真实属性的引用，内部使用。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:Object3D rootNode], path, parsedPath )</h3>
 		<p>
 			-- [page:Object3D rootNode]:
 			-- path
-			-- parsedPath (optional)
+			-- parsedPath (可选)
 
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Number path]</h3>
 		<p>
@@ -70,7 +70,7 @@
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null getValue]( [param:Array targetArray], [param:Number offset] )</h3>
 		<p>
@@ -82,28 +82,27 @@
 
 		<h3>[method:null bind]( )</h3>
 		<p>
-			Create getter / setter pair for a property in the scene graph. Used internally by
-			[page:PropertyBinding.getValue getValue] and [page:PropertyBinding.setValue setValue].
+			为场景图中的属性创建 getter / setter对。 被[page:PropertyBinding.getValue getValue]和[page:PropertyBinding.setValue setValue]方法内部使用。
 		</p>
 
 		<h3>[method:null unbind]( )</h3>
 		<p>
-			Unbind getter / setter pair for a property in the scene graph.
+			解绑场景图中某属性的getter / setter对。
 		</p>
 
 		<h3>[method:Constructor Composite]( targetGroup, path, optionalParsedPath )</h3>
 		<p>
-			Create a new Composite PropertyBinding.
+			创建一个新的复合属性绑定(Composite PropertyBinding)
 		</p>
 
 		<h3>[method:Constructor create]( root, path, parsedPath )</h3>
 		<p>
-			Create a new Composite PropertyBinding (if root is an [page:AnimationObjectGroup]) or PropertyBinding.
+            创建一个新的复合属性绑定(Composite PropertyBinding) (如果根对象是[page:AnimationObjectGroup])或普通属性绑定
 		</p>
 
 		<h3>[method:Constructor parseTrackName]( trackName )</h3>
 		<p>
-			Matches strings in the following forms:<br />
+			匹配以下形式的字符串：<br />
 			-- nodeName.property<br />
 			-- nodeName.property[accessor]<br />
 			-- nodeName.material.property[accessor]<br />
@@ -117,13 +116,13 @@
 
 		<h3>[method:Constructor findNode]( root, nodeName )</h3>
 		<p>
-			Find a node in a node tree or [page:Skeleton Skeleton].
+            从节点树或骨骼([page:Skeleton Skeleton])中找出某节点
 		</p>
 
 
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/animation/PropertyMixer.html

@@ -11,11 +11,11 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		Buffered scene graph property that allows weighted accumulation; used internally.
+        允许加权累加的缓冲场景图属性，内部使用
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:PropertyBinding binding], [param:String typeName], [param:Number valueSize] )</h3>
@@ -26,7 +26,7 @@
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 		<h3>[property:PropertyBinding binding]</h3>
@@ -36,16 +36,15 @@
 
 		<h3>[property:TypedArray buffer]</h3>
 		<p>
-			Buffer with size [page:PropertyMixer valueSize] * 4. <br /><br />
-			This has the layout: [ incoming | accu0 | accu1 | orig ]<br /><br />
-			Interpolators can use .buffer as their .result and the data then goes to 'incoming'.
-			'accu0' and 'accu1' are used frame-interleaved for the cumulative result and
-			are compared to detect changes. 'orig' stores the original state of the property.
+			大小为 4 * [page:PropertyMixer valueSize] 的缓冲区 <br /><br />
+			布局为: [ incoming | accu0 | accu1 | orig ]<br /><br />
+			插值器可使用 .buffer 作为 .result 且数据会进入'incoming'区.
+			'accu0'和'accu1'用于按帧交错累加‘incoming’中的数据并进行比较以侦测变化。'orig'存储着属性的原始状态。
 		</p>
 
 		<h3>[property:Number cumulativeWeight]</h3>
 		<p>
-			Default is *0*.
+			默认值是0
 		</p>
 
 		<h3>[property:Number valueSize]</h3>
@@ -55,42 +54,42 @@
 
 		<h3>[property:Number referenceCount]</h3>
 		<p>
-			Default is *0*.
+            默认值是0
 		</p>
 
 		<h3>[property:Number useCount]</h3>
 		<p>
-			Default is *0*.
+           默认值是0
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:null accumulate]( [param:Number accuIndex], [param:Number weight] )</h3>
 		<p>
-			Accumulate data in [page:PropertyMixer.buffer buffer][accuIndex] 'incoming' region into 'accu[i]'.<br />
+			将[page:PropertyMixer.buffer buffer][accuIndex]中'incoming'区的数据累加到'accu[i]'区中。<br />
 
-			If weight is *0* this does nothing.
+			如果权值为0，则什么都不做。
 		</p>
 
 		<h3>[method:null apply]( [param:Number accuIndex] )</h3>
 		<p>
-			Apply the state of [page:PropertyMixer.buffer buffer] 'accu[i]' to the binding when accus differ.
+			当累加值不同时，将[page:PropertyMixer.buffer buffer] 'accu[i]区的状态应用于绑定.
 		</p>
 
 		<h3>[method:null saveOriginalState]( )</h3>
 		<p>
-			Remember the state of the bound property and copy it to both accus.
+			记住绑定属性的状态并复制到两个'accu'区中.
 		</p>
 
 		<h3>[method:null restoreOriginalState](  )</h3>
 		<p>
-			Apply the state previously taken via 'saveOriginalState' to the binding.
+            将预先通过'saveOriginalState'方法取得的状态应用于绑定。
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>方法</h2>
 
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/audio/Audio.html

@@ -13,13 +13,13 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Create a non-positional ( global ) audio object.<br /><br />
+			创建一个（ 全局 ) audio对象.<br /><br />
 
-			This uses the [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
+			使用 [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
 			[example:webaudio_sandbox webaudio / sandbox ]</br>
@@ -45,171 +45,167 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 
 		<h3>[name]( [param:AudioListener listener] )</h3>
 		<p>
-		listener — (required) [page:AudioListener AudioListener] instance.
+		listener — (必须) [page:AudioListener AudioListener] 的实例.
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Boolean autoplay]</h3>
-		<p>Whether to start playback automatically. Default is *false*.</p>
+		<p>是否自动开始播放. 默认为 *false*.</p>
 
 		<h3>[property:AudioContext context]</h3>
-		<p>The [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] of the [page:AudioListener listener] given in the constructor.</p>
+		<p>构造函数中传入[page:AudioListener listener]的[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].</p>
 
 		<h3>[property:Array filters]</h3>
-		<p>Represents an array of [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes]. Can be used to apply a variety of low-order filters to create more complex sound effects. Filters are set via [page:Audio.setFilter] or [page:Audio.setFilters].</p>
+		<p>表示[link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes]的数组. 可以使用多种不同的低阶filters去创建复杂的音效. filters可以通过 [page:Audio.setFilter] 或者 [page:Audio.setFilters]设置.</p>
 
 		<h3>[property:GainNode gain]</h3>
-		<p>A [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] created
-		using [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().</p>
+		<p>使用[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]()创建的[link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode].</p>
 
 		<h3>[property:Boolean hasPlaybackControl]</h3>
-		<p>Whether playback can be controlled using the [page:Audio.play play](),
-			[page:Audio.pause pause]() etc. methods. Default is *true*.</p>
+		<p>是否可以使用 [page:Audio.play play](),
+			[page:Audio.pause pause]()等方法控制播放. 默认为 *true*.</p>
 
 		<h3>[property:Number playbackRate]</h3>
-		<p>Speed of playback. Default is *1*.</p>
+		<p>播放速率. 默认为 *1*.</p>
 
 		<h3>[property:Boolean isPlaying]</h3>
-		<p>Whether the audio is currently playing.</p>
+		<p>是否正在播放</p>
 
 		<h3>[property:Number startTime]</h3>
-		<p>The time at which the sound should begin to play. Same as the *when* paramter of [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). Default is *0*.</p>
+		<p>开始播放的时间. 和[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start]()的*when*参数一样. 默认为 *0*.</p>
 
 		<h3>[property:Number offset]</h3>
-		<p>An offset to the time within the audio buffer that playback should begin. Same as the *offset* paramter of [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). Default is *0*.</p>
+		<p>音频开始播放的偏移时间. 和[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start]()的*offset*参数一样. 默认为 *0*.</p>
 
 		<h3>[property:String source]</h3>
-		<p>An [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode] created
-		using [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource]().</p>
+		<p>使用 [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource]()创建的[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode].</p>
 
 		<h3>[property:String sourceType]</h3>
-		<p>Type of the audio source. Default is string 'empty'.</p>
+		<p>音源的类型. 默认为 'empty'.</p>
 
 		<h3>[property:String type]</h3>
-		<p>String denoting the type, set to 'Audio'.</p>
+		<p>表示类型的字符串, 设置为'Audio'.</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:Audio connect]()</h3>
 		<p>
-		Connect to the [page:Audio.source]. This is used internally on initialisation and when
-		setting / removing filters.
+		连接[page:Audio.source]. 在初始化和设置/删除filters时使用.
 		</p>
 
 		<h3>[method:Audio disconnect]()</h3>
 		<p>
-		Disconnect from the [page:Audio.source]. This is used internally when
-		setting / removing filters.
+		断开连接[page:Audio.source]. 在设置/删除filters时使用.
 		</p>
 
 		<h3>[method:BiquadFilterNode getFilter]()</h3>
 		<p>
-		Returns the first element of the [page:Audio.filters filters] array.
+		返回 [page:Audio.filters filters] 数组的第一个元素.
 		</p>
 
 		<h3>[method:Array getFilters]()</h3>
 		<p>
-		Returns the [page:Audio.filters filters] array.
+		返回[page:Audio.filters filters] 数组.
 		</p>
 
 		<h3>[method:Boolean getLoop]()</h3>
 		<p>
-		Return the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop]
-		 (whether playback should loop).
+		返回[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop]
+		 (是否循环播放)的值.
 		</p>
 
 		<h3>[method:GainNode getOutput]()</h3>
 		<p>
-		Return the [page:Audio.gain gainNode].
+		返回[page:Audio.gain gainNode].
 		</p>
 
 		<h3>[method:Float getPlaybackRate]()</h3>
 		<p>
-		Return the value of [page:Audio.playbackRate playbackRate].
+		返回[page:Audio.playbackRate playbackRate]的值.
 		</p>
 
 		<h3>[method:Float getVolume]( value )</h3>
 		<p>
-		Return the current volume.
+		返回音量.
 		</p>
 
 		<h3>[method:Audio play]()</h3>
 		<p>
-		If [page:Audio.hasPlaybackControl hasPlaybackControl] is true, starts playback.
+		如果[page:Audio.hasPlaybackControl hasPlaybackControl]是true, 开始播放.
 		</p>
 
 		<h3>[method:Audio pause]()</h3>
 		<p>
-		If [page:Audio.hasPlaybackControl hasPlaybackControl] is true, pauses playback.
+		如果[page:Audio.hasPlaybackControl hasPlaybackControl]是true, 暂停播放.
 		</p>
 
 		<h3>[method:null onEnded]()</h3>
 		<p>
-		Called automatically when playback finished. Sets If [page:Audio.isPlaying isPlaying] to false.
+		播放完成后自动调用. 如果[page:Audio.isPlaying isPlaying]设置为false.
 		</p>
 
 		<h3>[method:Audio setBuffer]( audioBuffer )</h3>
 		<p>
-		Setup the [page:Audio.source source] to the audioBuffer, and sets [page:Audio.sourceType sourceType] to 'buffer'.<br />
-		If [page:Audio.autoplay autoplay], also starts playback.
+		设置[page:Audio.source source]给audioBuffer, 和设置[page:Audio.sourceType sourceType]给'buffer'.<br />
+		如果[page:Audio.autoplay autoplay]为true, 也开始播放.
 		</p>
 
 		<h3>[method:Audio setFilter]( filter )</h3>
 		<p>
-		Applies a single [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNode] to the audio.
+		设置一个[link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNode]给Audio.
 		</p>
 
 		<h3>[method:Audio setFilters]( [param:Array value] )</h3>
 		<p>
-		value - arrays of filters.<br />
-		Applies an array of [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes] to the audio.
+		value--filters数组.<br />
+		应用[link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes]数组给Audio.
 		</p>
 
 		<h3>[method:Audio setLoop]( [param:Boolean value] )</h3>
 		<p>
-		Set [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] to *value*
-		(whether playback should loop).
+		设置[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] 的值
+		(是否循环播放).
 		</p>
 
 		<h3>[method:Audio setMediaElementSource]( mediaElement )</h3>
 		<p>
-		Applies the given object of type [link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement] as the source of this audio.<br />
-		Also sets [page:Audio.hasPlaybackControl hasPlaybackControl] to false.
+		应用[link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement]类型对象作为音源.<br />
+		并且设置[page:Audio.hasPlaybackControl hasPlaybackControl]为false.
 
 		</p>
 
 		<h3>[method:Audio setNodeSource]( audioNode )</h3>
 		<p>
-		Setup the [page:Audio.source source] to the audioBuffer, and sets [page:Audio.sourceType sourceType] to 'audioNode'.<br />
-		Also sets [page:Audio.hasPlaybackControl hasPlaybackControl] to false.
+		设置[page:Audio.source source]给audioBuffer, 和设置[page:Audio.sourceType sourceType]给 'audioNode'.<br />
+		并且设置[page:Audio.hasPlaybackControl hasPlaybackControl]为false.
 
 		</p>
 
 		<h3>[method:Audio setPlaybackRate]( [param:Float value] )</h3>
 		<p>
-		If [page:Audio.hasPlaybackControl hasPlaybackControl] is enabled, set the [page:Audio.playbackRate playbackRate] to *value*.
+		如果[page:Audio.hasPlaybackControl hasPlaybackControl]是true, 设置[page:Audio.playbackRate playbackRate]（播放速率） 的值.
 		</p>
 
 		<h3>[method:Audio setVolume]( [param:Float value] )</h3>
 		<p>
-		Set the volume.
+		设置音量.
 		</p>
 
 		<h3>[method:Audio stop]()</h3>
 		<p>
-		If [page:Audio.hasPlaybackControl hasPlaybackControl] is enabled, stops playback,
-		resets [page:Audio.startTime startTime] to *0* and sets [page:Audio.isPlaying isPlaying] to false.
+		如果[page:Audio.hasPlaybackControl hasPlaybackControl]是true, 停止播放,
+		重新设置[page:Audio.startTime startTime]为 *0* 和 设置 [page:Audio.isPlaying isPlaying]为false.
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/audio/AudioAnalyser.html

@@ -11,15 +11,15 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Create a AudioAnalyser object, which uses an [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode]
-			to analyse audio data.<br /><br />
+			创建AudioAnalyser对象, 使用[link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode]
+			去分析音频数据.<br /><br />
 
-			This uses the [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
+			使用了 [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
 
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 
 		<p>
 			[example:webaudio_sandbox webaudio / sandbox ]</br>
@@ -51,48 +51,48 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 
 		<h3>[name]( audio, [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize fftSize] )</h3>
 		<p>
-		Create a new [page:AudioAnalyser AudioAnalyser].
+		创建[page:AudioAnalyser AudioAnalyser].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:AnalyserNode analyser]</h3>
-		<p>An [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] used to analyze audio.</p>
+		<p>[link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode]用来分析音频数据.</p>
 
 		<h3>[property:Integer fftSize]</h3>
 		<p>
-		A non-zero power of two up to 2048, representing the size of the FFT (Fast Fourier Transform) to be used to determine the frequency domain.
-		See [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize this page] for details.
+		2的幂次方最高为2048, 用来表示确定频域的FFT (傅立叶变换)大小.
+		这个[link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize page]有详细信息.
 		</p>
 
 		<h3>[property:Uint8Array data]</h3>
 		<p>
-		A Uint8Array with size determined by [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount]
-		used to hold analysis data.
+		用来分析数据的Uint8Array的大小由[link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount]
+		确定.
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:Uint8Array getFrequencyData]()</h3>
 		<p>
-		Uses the Web Audio's [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] method.
-		See that page.
+		使用网络音频的[link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] 方法.
+		看这个页面.
 		</p>
 
 		<h3>[method:Number getAverageFrequency]()</h3>
 		<p>
-		Get the average of the frequencies returned by the [page:AudioAnalyser.getFrequencyData getFrequencyData] method.
+		通过方法[page:AudioAnalyser.getFrequencyData getFrequencyData]获取平均频率.
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/audio/AudioContext.html

@@ -12,30 +12,30 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		This contains methods for setting up an [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].<br /><br />
+		包含用来设置[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext]的方法.<br /><br />
 
-		Used internally by the [page:AudioListener AudioListener] and [page:AudioLoader AudioLoader] classes.<br /><br />
+		在[page:AudioListener AudioListener]和[page:AudioLoader AudioLoader] 类中被使用.<br /><br />
 
-		This uses the [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
+		使用了 [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
 		</p>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:AudioContext getContext]()</h3>
 		<p>
-		Return the value of the variable *context* in the outer scope, if defined,
-		otherwise set it to a new [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].
+		如果定义了，返回给外部*context*的值,
+		否则创建一个新的[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].
 		</p>
 
 		<h3>[method:AudioContext setContext]( [param:AudioConetxt value] )</h3>
 		<p>
-		 Set the variable *context* in the outer scope to *value*.
+		 外部用来设置 *context* 的值.
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/audio/AudioListener.html

@@ -13,13 +13,13 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			The [name] represents a virtual [link:https://developer.mozilla.org/de/docs/Web/API/AudioListener listener] of the all positional and non-positional audio effects in the scene.</br>
-			A three.js application usually creates a single instance of [name]. It is a mandatory construtor parameter for audios entities like [page:Audio Audio] and [page:PositionalAudio PositionalAudio].</br>
-			In most cases, the listener object is a child of the camera. So the 3D transformation of the camera represents the 3D transformation of the listener.
+			[name] 用一个虚拟的[link:https://developer.mozilla.org/de/docs/Web/API/AudioListener listener]表示在场景中所有的位置和非位置相关的音效.</br>
+			一个three.js程序通常创建一个[name]. 它是音频实体构造函数的必须参数，比如 [page:Audio Audio] and [page:PositionalAudio PositionalAudio].</br>
+			大多数情况下, listener对象是camera的子对象. Camera的3D变换表示了listener的3D变换.
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 
 		<p>
 			[example:webaudio_sandbox webaudio / sandbox ]</br>
@@ -46,63 +46,62 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 
 		<h3>[name](  )</h3>
 		<p>
-		Create a new AudioListener.
+		创建一个新的AudioListener.
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:AudioContext context]</h3>
-		<p>The [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] of the [page:AudioListener listener] given in the constructor.</p>
+		<p>[page:AudioListener listener]构造函数中的[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].</p>
 
 		<h3>[property:GainNode gain]</h3>
-		<p>A [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] created
-		using [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().</p>
+		<p>使用[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]()创建 [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode].</p>
 
 		<h3>[property:AudioNode filter]</h3>
-		<p>Default is *null*.</p>
+		<p>默认为*null*.</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 		<h3>[method:GainNode getInput]()</h3>
 		<p>
-		Return the [page:AudioListener.gain gainNode].
+		返回[page:AudioListener.gain gainNode].
 		</p>
 
 		<h3>[method:AudioListener removeFilter]()</h3>
 		<p>
-		Set the [page:AudioListener.filter filter] property to *null*.
+		设置[page:AudioListener.filter filter]属性为*null*.
 		</p>
 
 		<h3>[method:AudioNode getFilter]()</h3>
 		<p>
-		Returns the value of the [page:AudioListener.filter filter] property.
+		返回[page:AudioListener.filter filter]属性的值.
 		</p>
 
 		<h3>[method:AudioListener setFilter]( [param:AudioNode value] )</h3>
 		<p>
-		Set the [page:AudioListener.filter filter] property to *value*.
+		设置[page:AudioListener.filter filter] 属性的值.
 		</p>
 
 		<h3>[method:Float getMasterVolume]()</h3>
 		<p>
-		Return the volume.
+		返回音量.
 		</p>
 
 		<h3>[method:AudioListener setMasterVolume]( [param:Number value] )</h3>
 		<p>
-		Set the volume.
+		设置音量.
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/audio/PositionalAudio.html

@@ -13,13 +13,13 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Create a positional audio object.<br /><br />
+			创建一个位置相关的音频对象.<br /><br />
 
-			This uses the [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
+			使用了[link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 
 		<p>
 			[example:webaudio_orientation webaudio / orientation ]</br>
@@ -54,78 +54,78 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:AudioListener listener] )</h3>
 		<p>
-		listener — (required) [page:AudioListener AudioListener] instance.
+		listener — (必须) [page:AudioListener AudioListener] 实例.
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<p>
-			See the [page:Audio Audio] class for inherited properties.
+			[page:Audio Audio]类的继承属性.
 		</p>
 
 		<h3>[property:PannerNode panner]</h3>
-		<p>The PositionalAudio's [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode PannerNode].</p>
+		<p>位置相关音频的[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode PannerNode].</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<p>
-			See the [page:Audio Audio] class for inherited methods.
+			[page:Audio Audio]类的继承方法.
 		</p>
 
 		<h3>[method:PannerNode getOutput]()</h3>
 		<p>
-		Returns the [page:PositionalAudio.panner panner].
+		返回[page:PositionalAudio.panner panner].
 		</p>
 
 		<h3>[method:Float getRefDistance]()</h3>
 		<p>
-		Returns the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance].
+		返回[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance]的值.
 		</p>
 
 		<h3>[method:PositionalAudio setRefDistance]( [param:Float value] )</h3>
 		<p>
-		Sets the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance].
+		设置[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance]的值.
 		</p>
 
 		<h3>[method:Float getRolloffFactor]()</h3>
 		<p>
-		Returns the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor].
+		返回[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor]的值.
 		</p>
 
 		<h3>[method:PositionalAudio setRolloffFactor]( [param:Float value] )</h3>
 		<p>
-		Sets the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor].
+		设置[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor]的值.
 		</p>
 
 		<h3>[method:String getDistanceModel]()</h3>
 		<p>
-		Returns the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel].
+		返回[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel]的值.
 		</p>
 
 		<h3>[method:PositionalAudio setDistanceModel]( [param:String value] )</h3>
 		<p>
-		Sets the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel].
+		设置[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel]的值.
 		</p>
 
 		<h3>[method:Float getMaxDistance]()</h3>
 		<p>
-		Returns the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance].
+		返回[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance]的值.
 		</p>
 
 		<h3>[method:PositionalAudio setMaxDistance]( [param:Float value] )</h3>
 		<p>
-		Sets the value of [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance].
+		设置[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance]的值.
 		</p>
 
 		<h3>[method:PositionalAudio setDirectionalCone]( [param:Float coneInnerAngle], [param:Float coneOuterAngle], [param:Float coneOuterGain] )</h3>
 		<p>
-		This method can be used in order to transform an omnidirectional sound into a [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode directional sound].
+		这个方法用来把环绕声音转换为定向声音[link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode directional sound].
 		</p>
 
 		<h2>Source</h2>

docs/api/zh/cameras/ArrayCamera.html

@@ -13,34 +13,34 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			[name] can be used in order to efficiently render a scene with a predefined set of cameras. This is an important performance aspect for rendering VR scenes.<br />
-			An instance of [name] always has an array of sub cameras. It's mandatory to define for each sub camera the *bounds* property which determines the part of the viewport that is rendered with this camera.
+			可以使用[name]以使用预定义的一组摄像机有效地渲染场景。这是渲染VR场景的重要性能方面。<br />
+			[name]的实例总是有一组子摄像机。必须为每个子摄像机定义bounds属性，该属性确定使用此摄像机渲染的视口部分。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>[example:webgl_camera_array camera / array ]</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:Array array] )</h3>
 		<p>
-			An array of cameras.
+			摄像机组。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:PerspectiveCamera] class for common properties.</p>
+		<h2>属性</h2>
+		<p>请参阅基类[page:PerspectiveCamera]的公共属性。</p>
 
 		<h3>[property:Array cameras]</h3>
 		<p>
-			An array of cameras.
+			摄像机组。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:PerspectiveCamera] class for common methods.</p>
+		<h2>方法</h2>
+		<p>请参阅基类[page:PerspectiveCamera]的公共方法。</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/cameras/Camera.html

@@ -13,74 +13,71 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Abstract base class for cameras. This class should always be inherited when you build a new camera.
+			摄像机的抽象基类。在构建新摄像机时，应始终继承此类。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 
 		<h3>[name]()</h3>
 		<p>
-			Creates a new [name]. Note that this class is not intended to be called directly;
-			you probably want a [page:PerspectiveCamera] or [page:OrthographicCamera] instead.
+			创建一个新的[name]。请注意，此类不应直接调用；
+			你可能需要一个[page:PerspectiveCamera]或者[page:OrthographicCamera]。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Object3D] class for common properties.</p>
+		<h2>属性</h2>
+		<p>请参阅基类[page:Object3D]的公共属性。</p>
 
 		<h3>[property:Boolean isCamera]</h3>
 		<p>
-			Used to check whether this or derived classes are cameras. Default is *true*.<br /><br />
+			用于检查此类或派生类是否为摄像机。默认为true。<br /><br />
 
-			You should not change this, as it used internally by the renderer for optimisation.
+			你不应该更改此内容，因为渲染器在内部使用它进行优化。
 		</p>
 
 		<h3>[property:Layers layers]</h3>
 		<p>
-		The [page:Layers layers] that the camera is a member of. This is an inherited
-		property from [page:Object3D].<br /><br />
+		摄像机所属的[page:Layers layers]。 这是[page:Object3D]的继承属性。<br /><br />
 
-		Objects must share at least one layer with the camera to be seen
-		when the camera's viewpoint is rendered.
+		在渲染摄像机的视点时，对象必须与摄像机共享至少一个层。
 		</p>
 
 		<h3>[property:Matrix4 matrixWorldInverse]</h3>
 		<p>
-			This is the inverse of matrixWorld. MatrixWorld contains the Matrix which has
-			the world transform of the Camera.
+			这是matrixWorld的逆矩阵。MatrixWorld包含摄像机的世界变换矩阵。
 		</p>
 
 		<h3>[property:Matrix4 projectionMatrix]</h3>
-		<p>This is the matrix which contains the projection.</p>
+		<p>这是包含投影的矩阵。</p>
 
 		<h3>[property:Matrix4 projectionMatrixInverse]</h3>
-		<p>The inverse of projectionMatrix.</p>
+		<p>projectionMatrix的逆矩阵</p>
 
 
-		<h2>Methods</h2>
-		<p>See the base [page:Object3D] class for common methods.</p>
+		<h2>方法</h2>
+		<p>请参阅基类[page:Object3D]的公共方法。</p>
 
 		<h3>[method:Camera clone]( )</h3>
 		<p>
-			Return a new camera with the same properties as this one.
+			返回具有与此相同属性的新摄像机。
 		</p>
 
 		<h3>[method:Camera copy]( [param:Camera source], [param:Boolean recursive] )</h3>
 		<p>
-		Copy the properties from the source camera into this one.
+		将源摄像机中的属性复制到此摄像机中。
 		</p>
 
 		<h3>[method:Vector3 getWorldDirection]( [param:Vector3 target] )</h3>
 		<p>
-		[page:Vector3 target] — the result will be copied into this Vector3. <br /><br />
+		[page:Vector3 target] — 结果将被复制到此Vector3中。 <br /><br />
 
-		Returns a [page:Vector3] representing the world space direction in which the camera is looking.
-		(Note: A camera looks down its local, negative z-axis).<br /><br />
+		返回表示摄像机正在查看的世界空间方向的[page:Vector3]。
+		（注意：摄像机向下看其局部的负z轴）。<br /><br />
 		</p>
 
-		<h2>Source</h2>
+		<h2>源代码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/cameras/CubeCamera.html

@@ -12,9 +12,9 @@
 
 		<h1>[name]</h1>
 
-		<p class="desc">Creates 6 cameras that render to a [page:WebGLRenderTargetCube].</p>
+		<p class="desc">创建6个渲染到[page:WebGLRenderTargetCube]的摄像机</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 
 		<p>[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic ]</p>
 		<p>[example:webgl_materials_cubemap_dynamic2 materials / cubemap / dynamic2 ]</p>
@@ -40,49 +40,48 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 
 		<h3>[name]( [param:Number near], [param:Number far], [param:Number cubeResolution] )</h3>
 		<p>
-		near -- The near clipping distance. <br />
-		far -- The far clipping distance <br />
-		cubeResolution -- Sets the length of the cube's edges.
+		near -- 近剪裁面距离<br />
+		far -- 远剪裁面距离<br />
+		cubeResolution -- 设置立方体边缘的长度。
 		</p>
 		<p>
-		Constructs a CubeCamera that contains 6 [page:PerspectiveCamera PerspectiveCameras] that
-		render to a [page:WebGLRenderTargetCube].
+		构造一个包含6个[page:PerspectiveCamera PerspectiveCameras]的CubeCamera，渲染到[page:WebGLRenderTargetCube]。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Object3D] class for common properties.</p>
+		<h2>属性</h2>
+		<p>参阅基类[page:Object3D]的公共属性。</p>
 
 		<h3>[property:WebGLRenderTargetCube renderTarget]</h3>
 		<p>
-		The cube texture that gets generated.
+		生成的立方体纹理。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Object3D] class for common methods.</p>
+		<h2>方法</h2>
+		<p>参阅基类[page:Object3D]的公共方法。</p>
 
 
 		<h3>[method:null update]( [param:WebGLRenderer renderer], [param:Scene scene] )</h3>
 		<p>
-		renderer -- The current WebGL renderer <br />
-		scene -- The current scene
+		renderer -- 当前WebGL渲染器 <br />
+		scene -- 当前场景
 		</p>
 		<p>
-		Call this to update the [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>
-		Call this to clear the [page:CubeCamera.renderTarget renderTarget] color, depth, and/or stencil buffers.
-		The color buffer is set to the renderer's current clear color. Arguments default to *true*.
+		调用此方法以清除[page:CubeCamera.renderTarget renderTarget] 颜色，深度，和/或者模板缓冲区。
+		颜色缓冲区设置为渲染器的当前清除颜色。默认参数为*true*。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源代码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/cameras/OrthographicCamera.html

@@ -13,16 +13,15 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Camera that uses [link:https://en.wikipedia.org/wiki/Orthographic_projection orthographic projection].<br /><br />
+			使用[link:https://en.wikipedia.org/wiki/Orthographic_projection orthographic projection]的摄像机。<br /><br />
 
-			In this projection mode, an object's size in the rendered image stays constant
-			regardless of its distance from the camera.<br /><br />
+			在此投影模式下，无论距离摄像机的距离如何，渲染图像中的对象大小都保持不变。<br /><br />
 
-			This can be useful for rendering 2D scenes and UI elements, amongst other things.
+			这对于渲染2D场景和UI元素等非常有用。
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>[example:canvas_camera_orthographic camera / orthographic ]</p>
 		<p>[example:webgl_camera camera ]</p>
@@ -40,104 +39,102 @@
 scene.add( camera );</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 
 		<h3>[name]( [param:Number left], [param:Number right], [param:Number top], [param:Number bottom], [param:Number near], [param:Number far] )</h3>
 		<p>
-		left — Camera frustum left plane.<br />
-		right — Camera frustum right plane.<br />
-		top — Camera frustum top plane.<br />
-		bottom — Camera frustum bottom plane.<br />
-		near — Camera frustum near plane.<br />
-		far — Camera frustum far plane.<br /><br />
-
-		Together these define the camera's [link:https://en.wikipedia.org/wiki/Viewing_frustum viewing frustum].
+		left — 摄像机视锥体左平面。<br />
+		right — 摄像机视锥体右平面。<br />
+		top — 摄像机视锥体顶部平面。<br />
+		bottom — 摄像机视锥体底部平面。<br />
+		near — 摄像机视锥体近平面。<br />
+		far — 摄像机视锥体远平面。<br /><br />
+
+		这些一起定义了摄像机的[link:https://en.wikipedia.org/wiki/Viewing_frustum viewing frustum]。
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 		<p>
-			See the base [page:Camera] class for common properties.<br>
- 			Note that after making changes to most of these properties you will have to call
- 			[page:OrthographicCamera.updateProjectionMatrix .updateProjectionMatrix] for the changes to take effect.
+			参阅基类[page:Camera]的公共属性。<br>
+ 			请注意，在对大多数这些属性进行更改后，必须调用 [page:OrthographicCamera.updateProjectionMatrix .updateProjectionMatrix]才能使更改生效。
 		</p>
 
 		<h3>[property:Float bottom]</h3>
-		<p>Camera frustum bottom plane.</p>
+		<p>摄像机视锥体底部平面。</p>
 
 		<h3>[property:Float far]</h3>
 		<p>
-		Camera frustum far plane. Default is *2000*.<br /><br />
+		摄像机视锥体远平面。 默认值是*2000*。<br /><br />
 
-		The valid range is between the current value of the [page:.near near] plane and infinity.
+		有效范围介于[page:.near]平面的当前值和无穷远之间。
 		</p>
 
 		<h3>[property:Boolean isOrthographicCamera]</h3>
 		<p>
-			Used to test whether this or derived classes are OrthographicCameras. Default is *true*.<br /><br />
+			用于测试此类或派生类是否为正交摄像机。 默认值为*true*。<br /><br />
 
-			This should not be changed as it is used internally by the renderer for optimisation.
+			这不应该更改，因为渲染器在内部使用它进行优化。
 		</p>
 
 		<h3>[property:Float left]</h3>
-		<p>Camera frustum left plane.</p>
+		<p>摄像机视锥体左平面。</p>
 
 		<h3>[property:Float near]</h3>
 		<p>
-			Camera frustum near plane. Default is *0.1*.<br /><br />
+			摄像机视锥体近平面。默认值为*0.1*。<br /><br />
 
-			The valid range is between 0 and the current value of the [page:.far far] plane.
-			Note that, unlike for the [page:PerspectiveCamera], *0* is a valid value for an
-			OrthographicCamera's near plane.
+			有效范围介于0和[page:.far]平面的当前值之间。
+			请注意，与[page:PerspectiveCamera]不同，*0*是正交摄像机近平面的有效值。
 		</p>
 
 		<h3>[property:Float right]</h3>
-		<p>Camera frustum right plane.</p>
+		<p>摄像机视锥体右平面。</p>
 
 		<h3>[property:Float top]</h3>
-		<p>Camera frustum top plane.</p>
+		<p>摄像机视锥体顶部平面。</p>
 
 		<h3>[property:Object view]</h3>
-		<p>Set by [page:OrthographicCamera.setViewOffset setViewOffset]. Default is *null*.</p>
+		<p>由[page:OrthographicCamera.setViewOffset setViewOffset]设置。默认值为*null*。</p>
 
 		<h3>[property:number zoom]</h3>
-		<p>Gets or sets the zoom factor of the camera. Default is *1*.</p>
+		<p>获取和设置摄像机的缩放系数。默认值为*1*。</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Camera] class for common methods.</p>
+		<h2>方法</h2>
+		<p>参阅基类[page:Camera]的公共方法。</p>
 
 		<h3>[method:null setViewOffset]( [param:Float fullWidth], [param:Float fullHeight], [param:Float x], [param:Float y], [param:Float width], [param:Float height] )</h3>
 		<p>
-		fullWidth — full width of multiview setup<br />
-		fullHeight — full height of multiview setup<br />
-		x — horizontal offset of subcamera<br />
-		y — vertical offset of subcamera<br />
-		width — width of subcamera<br />
-		height — height of subcamera<br /><br />
-
-			Sets an offset in a larger [link:https://en.wikipedia.org/wiki/Viewing_frustum viewing frustum].
-			This is useful for multi-window or multi-monitor/multi-machine setups.
-			For an example on how to use it see [page:PerspectiveCamera.setViewOffset PerspectiveCamera].
+		fullWidth — 多视图设置的全宽度<br />
+		fullHeight — 多视图设置的全高度<br />
+		x — 子摄像机的水平偏移<br />
+		y — 子摄像机的竖直偏移<br />
+		width — 子摄像机宽度<br />
+		height — 子摄像机高度<br /><br />
+
+			在较大的[link:https://en.wikipedia.org/wiki/Viewing_frustum viewing frustum]中设置偏移。
+			这对于多窗口或多显示器/多机器设置很有用。
+			有关如何使用它的示例，请参阅[page:PerspectiveCamera.setViewOffset PerspectiveCamera]。
 		</p>
 
 		<h3>[method:null clearViewOffset]()</h3>
 		<p>
-		Removes any offset set by the .setViewOffset method.
+		删除[page:PerspectiveCamera.setViewOffset .setViewOffset] 方法设置的任何偏移量。
 		</p>
 
 		<h3>[method:null updateProjectionMatrix]()</h3>
 		<p>
-		Updates the camera projection matrix. Must be called after any change of parameters.
+		更新摄像机的投影矩阵。必须在更改参数后调用。
 		</p>
 
 		<h3>[method:JSON toJSON]()</h3>
 		<p>
-		Return the camera's data in JSON format.
+		以JSON格式返回摄像机的数据。
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源代码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/cameras/PerspectiveCamera.html

@@ -13,14 +13,13 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Camera that uses [link:https://en.wikipedia.org/wiki/Perspective_(graphical) perspective projection].<br /><br />
+		使用[link:https://en.wikipedia.org/wiki/Perspective_(graphical) perspective projection]的摄像机。<br /><br />
 
-			This projection mode is designed to mimic the way the human eye sees. It is the most
-			common projection mode used for rendering a 3D scene.
+		这种投影模式旨在模仿人眼看到的方式。它是用于渲染3D场景的最常见投影模式。
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>[example:canvas_geometry_birds geometry / birds ]</p>
 		<p>[example:canvas_geometry_cube geometry / cube ]</p>
@@ -34,126 +33,119 @@
 scene.add( camera );</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:Number fov], [param:Number aspect], [param:Number near], [param:Number far] )</h3>
 		<p>
-		fov — Camera frustum vertical field of view.<br />
-		aspect — Camera frustum aspect ratio.<br />
-		near — Camera frustum near plane.<br />
-		far — Camera frustum far plane.<br /><br />
+		fov — 摄像机视锥体垂直视野。<br />
+		aspect — 摄像机视锥体宽高比。<br />
+		near — 摄像机视锥体近平面。<br />
+		far — 摄像机视锥体远平面。<br /><br />
 
-			Together these define the camera's [link:https://en.wikipedia.org/wiki/Viewing_frustum viewing frustum].
+		这些一起定义了摄像机的[link:https://en.wikipedia.org/wiki/Viewing_frustum viewing frustum]。
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 		<p>
-			See the base [page:Camera] class for common properties.<br>
-			Note that after making changes to most of these properties you will have to call
-			[page:PerspectiveCamera.updateProjectionMatrix .updateProjectionMatrix] for the changes to take effect.
+			参阅基类[page:Camera]的公共属性。<br>
+			请注意，在对大多数这些属性进行更改后，必须调用[page:PerspectiveCamera.updateProjectionMatrix .updateProjectionMatrix]才能使更改生效。.
 		</p>
 
 		<h3>[property:Float aspect]</h3>
-		<p>Camera frustum aspect ratio, usually the canvas width / canvas height. Default is *1* (square canvas).</p>
+		<p>摄像机视锥体宽高比。默认是画布宽度/画布高度。默认值为*1*(方形画布)。</p>
 
 		<h3>[property:Float far]</h3>
 		<p>
-			Camera frustum far plane. Default is *2000*.<br /><br />
+		摄像机视锥体远平面。 默认值为*2000*。<br /><br />
 
-			The valid range is between the current value of the [page:.near near] plane and infinity.
+		有效范围介于[page:.near]平面的当前值和无穷远之间。
 		</p>
 
 		<h3>[property:Float filmGauge]</h3>
-		<p>Film size used for the larger axis. Default is 35 (millimeters). This parameter does not influence the projection matrix unless .filmOffset is set to a nonzero value.</p>
+		<p>用于较大轴的胶片尺寸。默认值为35 (毫米)。 除非.filmOffset设置为非零值，否则此参数不会影响投影矩阵。</p>
 
 		<h3>[property:Float filmOffset]</h3>
-		<p>Horizontal off-center offset in the same unit as .filmGauge. Default is *0*.</p>
+		<p>与.filmGauge相同单位的水平偏中心偏移。默认值为0。</p>
 
 		<h3>[property:Float focus]</h3>
-		<p>Object distance used for stereoscopy and depth-of-field effects.
-			This parameter does not influence the projection matrix unless a [page:StereoCamera] is being used.
-			Default is *10*.
+		<p>用于立体视觉和景深效果的物距。
+			除非使用[page:StereoCamera]，否则此参数不会影响投影矩阵。默认值为*10*。
 		</p>
 
 		<h3>[property:Float fov]</h3>
-		<p>Camera frustum vertical field of view, from bottom to top of view, in degrees. Default is *50*.</p>
+		<p>摄像机视锥体垂直视野，从底部到顶部，以度为单位。默认值为*50*。</p>
 
 		<h3>[property:Boolean isPerspectiveCamera]</h3>
 		<p>
-			Used to test whether this or derived classes are PerspectiveCameras. Default is *true*.<br /><br />
+		用于测试此类或派生类是否为透视摄像机。默认为*true*。<br /><br />
 
-			This should not be changed as it is used internally by the renderer for optimisation.
+		这不应该更改，因为渲染器在内部使用它进行优化。
 		</p>
 
 
 		<h3>[property:Float near]</h3>
 		<p>
-			Camera frustum near plane. Default is *0.1*.<br /><br />
+		摄像机视锥体的近平面，默认值为*0.1*。<br /><br />
 
-			The valid range is greater than 0 and less than the current value of the [page:.far far] plane.
-			Note that, unlike for the [page:OrthographicCamera], *0* is <em>not</em> a valid value
-			for a PerspectiveCamera's near plane.
+		有效范围大于0且小于远平面的当前值。需要注意的是，与正交摄像机不同，对于透视摄像机的近平面，0不是一个有效值。
 		</p>
 
 		<h3>[property:Object view]</h3>
 		<p>
-			Frustum window specification or null.
-			This is set using the [page:PerspectiveCamera.setViewOffset .setViewOffset] method
-			and cleared using [page:PerspectiveCamera.clearViewOffset .clearViewOffset].
+			视锥体窗口规范或null。这是使用[page:PerspectiveCamera.setViewOffset .setViewOffset]方法设置，
+			并使用[page:PerspectiveCamera.clearViewOffset .clearViewOffset]清除。
 		</p>
 
 		<h3>[property:number zoom]</h3>
-		<p>Gets or sets the zoom factor of the camera. Default is *1*.</p>
+		<p>获取或设置摄像机的缩放系数。默认值为*1*。</p>
 
 
-		<h2>Methods</h2>
-		<p>See the base [page:Camera] class for common methods.</p>
+		<h2>方法</h2>
+		<p>参阅基类[page:Camera]的公共方法。</p>
 
 		<h3>[method:null clearViewOffset]()</h3>
-		<p>Removes any offset set by the [page:PerspectiveCamera.setViewOffset .setViewOffset] method.</p>
+		<p>删除[page:PerspectiveCamera.setViewOffset .setViewOffset]方法设置的任何偏移量。</p>
 
 		<h3>[method:Float getEffectiveFOV]()</h3>
-		<p>Returns the current vertical field of view angle in degrees considering .zoom.</p>
+		<p>考虑.zoom，返回当前垂直视角范围(以度为单位)。</p>
 
 		<h3>[method:Float getFilmHeight]()</h3>
 		<p>
-		Returns the height of the image on the film. If .aspect is less than or equal to one
-		(portrait format), the result equals .filmGauge.
+		返回胶片上图像的高度。如果.aspect小于或等于1（纵向格式），则结果等于.filmGauge。
 		</p>
 
 		<h3>[method:Float getFilmWidth]()</h3>
 		<p>
-		Returns the width of the image on the film. If .aspect is greater than or equal to one
-		(landscape format), the result equals .filmGauge.
+		返回胶片上图像的宽度。如果.aspect大于或等于1（横向格式），则结果等于.filmGauge。
 		</p>
 
 		<h3>[method:Float getFocalLength]()</h3>
-		<p>Returns the focal length of the current .fov in respect to .filmGauge.</p>
+		<p>返回.filmGauge当前.fov的焦距。</p>
 
 		<h3>[method:null setFocalLength]( [param:Float focalLength] )</h3>
 		<p>
-		Sets the FOV by focal length in respect to the current [page:PerspectiveCamera.filmGauge .filmGauge].<br /><br />
-
-		By default, the focal length is specified for a 35mm (full frame) camera.
+		根据当前[page:PerspectiveCamera.filmGauge .filmGauge]的焦距设置FOV。<br /><br />
+		默认情况下，焦距是为35mm（全画幅）摄像机指定的。
 		</p>
 
 		<h3>[method:null setViewOffset]( [param:Float fullWidth], [param:Float fullHeight], [param:Float x], [param:Float y], [param:Float width], [param:Float height] )</h3>
 		<p>
-		fullWidth — full width of multiview setup<br />
-		fullHeight — full height of multiview setup<br />
-		x — horizontal offset of subcamera<br />
-		y — vertical offset of subcamera<br />
-		width — width of subcamera<br />
-		height — height of subcamera
+			fullWidth — 多视图设置的全宽度<br />
+			fullHeight — 多视图设置的全高度<br />
+			x — 子摄像机的水平偏移<br />
+			y — 子摄像机的竖直偏移<br />
+			width — 子摄像机宽度<br />
+			height — 子摄像机高度
 		</p>
 
 		<p>
-		Sets an offset in a larger frustum. This is useful for multi-window or multi-monitor/multi-machine setups.
+		在较大的视锥体中设置偏移。
+		这对于多窗口或多显示器/多机器设置很有用。
 		</p>
 
 		<p>
-		For example, if you have 3x2 monitors and each monitor is 1920x1080 and the monitors are in grid like this:<br />
+		例如，如果你有3x2显示器，每个显示器是1920x1080，显示器是这样的网格：<br />
 
 		<pre>
 +---+---+---+
@@ -163,7 +155,7 @@ scene.add( camera );</code>
 +---+---+---+
 		</pre>
 
-		then for each monitor you would call it like this:<br />
+		然后对于每个监视器，你会这样调用它： <br />
 
 		<code>var w = 1920;
 var h = 1080;
@@ -184,20 +176,20 @@ camera.setViewOffset( fullWidth, fullHeight, w * 1, h * 1, w, h );
 camera.setViewOffset( fullWidth, fullHeight, w * 2, h * 1, w, h );
 </code>
 
-		Note there is no reason monitors have to be the same size or in a grid.
+		注意监视器没有理由必须是相同的大小或在一个网格中。
 		</p>
 
 		<h3>[method:null updateProjectionMatrix]()</h3>
 		<p>
-		Updates the camera projection matrix. Must be called after any change of parameters.
+		更新摄像机的投影矩阵。必须在更改参数后调用。
 		</p>
 
 		<h3>[method:JSON toJSON]()</h3>
 		<p>
-		Return camera data in JSON format.
+		以JSON格式返回摄像机的数据。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源代码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/cameras/StereoCamera.html

@@ -12,55 +12,53 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		Dual [page:PerspectiveCamera PerspectiveCamera]s used for effects such as
-		[link:https://en.wikipedia.org/wiki/Anaglyph_3D 3D Anaglyph] or [link:https://en.wikipedia.org/wiki/parallax_barrier Parallax Barrier].
+		双[page:PerspectiveCamera PerspectiveCamera]（透视摄像机）用于
+		[link:https://en.wikipedia.org/wiki/Anaglyph_3D 3D Anaglyph]（立体影像）or [link:https://en.wikipedia.org/wiki/parallax_barrier Parallax Barrier]（视差屏障）等效果。
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>[example:webgl_effects_anaglyph effects / anaglyph ]</p>
 		<p>[example:webgl_effects_parallaxbarrier effects / parallaxbarrier ]</p>
 		<p>[example:webgl_effects_stereo effects / stereo ]</p>
 
 		<p>
-		This class is used internally in the files<br /><br />
+		这个类在内部使用的文件<br /><br />
 		[link:https://github.com/mrdoob/three.js/blob/master/examples/js/effects/AnaglyphEffect.js examples/js/effects/AnaglyphEffect.js]<br /><br />
 		[link:https://github.com/mrdoob/three.js/blob/master/examples/js/effects/ParallaxBarrierEffect.js examples/js/effects/ParallaxBarrierEffect.js]<br /><br />
 		[link:https://github.com/mrdoob/three.js/blob/master/examples/js/effects/StereoEffect.js examples/js/effects/StereoEffect.js]<br /><br />
-		used in the above examples.
+		在上面的例子中使用。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( )</h3>
 
 		<h2>Properties</h2>
 
 		<h3>[property:Float aspect]</h3>
-		<p>Default is *1*.</p>
+		<p>默认值为*1*。</p>
 
 		<h3>[property:Float eyeSep]</h3>
-		<p>Default is *0.064*.</p>
+		<p>默认值为*0.064*。</p>
 
 		<h3>[property:PerspectiveCamera cameraL]</h3>
-		<p>Left camera. This is added to [page:Layers layer 1] - objects to be rendered
-		by the left camera must also be added to this layer.</p>
+		<p>左摄像机。这将添加到[page:Layers layer 1] - 要被左摄像机渲染的对象也必须添加到此层。</p>
 
 		<h3>[property:PerspectiveCamera cameraR]</h3>
-		<p>Right camera.This is added to [page:Layers layer 2] - objects to be rendered
-		by the right camera must also be added to this layer.</p>
+		<p>右摄像机。这被添加到[page:Layers layer 2] - 要被右摄像机渲染的对象也必须添加到该层。</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null update]( [param:PerspectiveCamera camera] )</h3>
 		<p>
-		Update the stereo cameras based on the camera passed in.
+		根据传入的摄像机更新立体摄像机。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源代码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/extras/objects/ImmediateRenderObject.html

@@ -10,32 +10,32 @@
 	<body>
 		[page:Object3D] &rarr;
 
-		<h1>[name]</h1>
+		<h1>及时渲染对象([name])</h1>
 
-		<p class="desc">base class for immediate rendering objects.</p>
+		<p class="desc">及时渲染对象的基类。</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 
 		<h3>[name]()</h3>
 		<p>
-		This creates a new [name].
+			这会创建一个新的 [name]。
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法(Methods)</h2>
 
 
 		<h3>[method:null render]([param:Function renderCallback])</h3>
 		<p>
-		renderCallback -- A function to render the generated object.
+		renderCallback -- 生成对象的渲染函数。
 		</p>
 		<p>
-		This function needs to be overridden to start the creation of the object and should call renderCallback when finished.
+		需要重写此函数以开始创建对象，并在完成时调用renderCallback。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/lights/AmbientLight.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="zh">
 	<head>
 		<meta charset="utf-8" />
 		<base href="../../../" />
@@ -13,13 +13,13 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			This light globally illuminates all objects in the scene equally.<br /><br />
+			环境光会均匀的照亮场景中的所有物体。<br /><br />
 
-			This light cannot be used to cast shadows as it does not have a direction.
+			环境光不能用来投射阴影，因为它没有方向。
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 		<p>
 			[example:canvas_camera_orthographic camera / orthographic ]<br />
 		  [example:canvas_interactive_voxelpainter interactive / voxelpainter ]<br />
@@ -32,41 +32,41 @@
 <code>var light = new THREE.AmbientLight( 0x404040 ); // soft white light
 scene.add( light );</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:Integer color], [param:Float intensity] )</h3>
 		<p>
-		[page:Integer color] - (optional) Numeric value of the RGB component of the color. Default is 0xffffff.<br />
-		[page:Float intensity] - (optional) Numeric value of the light's strength/intensity. Default is 1.<br /><br />
+		[page:Integer color] - (参数可选）颜色的rgb数值。缺省值为 0xffffff。<br />
+		[page:Float intensity] - (参数可选)光照的强度。缺省值为 1。<br /><br />
 
-		Creates a new [name].
+		创建一个环境光对象。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 		<p>
-				See the base [page:Light Light] class for common properties.
+			公共属性请查看基类 [page:Light Light]。
 		</p>
 
 		<h3>[property:Boolean castShadow]</h3>
 		<p>
-			This is set to *undefined* in the constructor as ambient lights cannot cast shadows.
+			这个参数在对象构造的时候就被设置成了 *undefined* 。因为环境光不能投射阴影。
 		</p>
 
 
 		<h3>[property:Boolean isAmbientLight]</h3>
 		<p>
-			Used to check whether this or derived classes are ambient lights. Default is *true*.<br /><br />
+			用来校验这个类或者派生类是不是环境光.默认是 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			不应该去改变这个变量,因为内部使用这个变量做了些优化的工作。
 		</p>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 		<p>
-				See the base [page:Light Light] class for common methods.
+			公共方法请查看基类[page:Light Light]。
 		</p>
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/lights/DirectionalLight.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="zh">
 	<head>
 		<meta charset="utf-8" />
 		<base href="../../../" />
@@ -10,35 +10,31 @@
 	<body>
 		[page:Object3D] &rarr; [page:Light] &rarr;
 
-		<h1>[name]</h1>
+		<h1>平行光（[name]）</h1>
 
 		<p class="desc">
-			A light that gets emitted in a specific direction. This light will behave as though it is
-			infinitely far away and the rays produced from it are all parallel. The common use case
-			for this is to simulate daylight; the sun is far enough away that its position can be
-			considered to be infinite, and all light rays coming from it are parallel.<br /><br />
+			平行光是沿着特定方向发射的光。这种光的表现像是无限远,从它发出的光线都是平行的。常常用平行光来模拟太阳光
+			的效果; 太阳足够远，因此我们可以认为太阳的位置是无限远，所以我们认为从太阳发出的光线也都是平行的。<br /><br />
 
-			This light can cast shadows - see the [page:DirectionalLightShadow] page for details.
+			平行光可以投射阴影 - 跳转至 [page:DirectionalLightShadow] 查看更多细节。
 		</p>
 
-		<h2>A Note about Position, Target and rotation</h2>
+		<h2>关于位置、目标和旋转说明</h2>
 		<p>
-			A common point of confusion for directional lights is that setting the rotation has no effect.
-			This is because three.js's DirectionalLight is the equivalent to what is often called a 'Target
-			Direct Light' in other applications.<br /><br />
+			Three.js 的平行光常见的困惑是设置旋转没有效果。这是因为 three.js 的平行光类似与其他引擎的"目标平行光"。
+			<br /><br />
 
-			This means that its direction is calculated as pointing
-			from the light's [page:Object3D.position position] to	the [page:.target target]'s position
-			(as opposed to a 'Free Direct Light' that just has a rotation component).<br /><br />
+			这意味着它的方向是从一个平行光的位置 [page:Object3D.position position] 到 [page:.target target]的位置。
+			(而不是一个只有旋转分量的'自由平行光')。<br /><br />
 
-			The reason for this is to allow the light to cast shadows - the [page:.shadow shadow]
-			camera needs a position to calculate shadows from.<br /><br />
+			这样做的原因是为了让光线投射阴影。 - the [page:.shadow shadow]
+			摄像机需要一个位置来计算阴影。<br /><br />
 
-			See the [page:.target target] property below for details on updating the target.
+			有关更新目标的详细信息，请参阅 [page:.target target] 下面的目标属性。
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 		<p>
 			[example:canvas_morphtargets_horse morphtargets / horse ]<br />
 			[example:misc_controls_fly controls / fly ]<br />
@@ -58,62 +54,58 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 		<h3>[name]( [param:Integer color], [param:Float intensity] )</h3>
 		<p>
-			[page:Integer color] - (optional) hexadecimal color of the light. Default is 0xffffff (white).<br />
-			[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br /><br />
+			[page:Integer color] - (可选参数) 16进制表示光的颜色。 缺省值为 0xffffff (白色)。<br />
+			[page:Float intensity] - (可选参数) 光照的强度。缺省值为1。<br /><br />
 
-			Creates a new [name].
+			创建一个新的 [name]。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
-		See the base [page:Light Light] class for common properties.
+		公共属性请查看基类 [page:Light Light]。
 
 		<h3>[property:Boolean castShadow]</h3>
 		<p>
-			If set to *true* light will cast dynamic shadows. *Warning*: This is expensive and
-			requires tweaking to get shadows looking right. See the [page:DirectionalLightShadow] for details.
-			The default is *false*.
+			如果设置为 *true* 该平行光会产生动态阴影。 警告: 这样做的代价比较高而且需要一直调整到阴影看起来正确.
+			查看 [page:DirectionalLightShadow] 了解详细信息。该属性默认为 *false*。
 		</p>
 
 		<h3>[property:Boolean isDirectionalLight]</h3>
 		<p>
-			Used to check whether this or derived classes are directional lights. Default is *true*.<br /><br />
+			用来校验这个类或者派生类是不是平行光.默认是 *true*。<br /><br />
 
-			You should not change this, as it is used internally for optimisation.
+			不应该去改变这个变量,因为内部使用这个变量做了些优化的工作。
 		</p>
 
 
 		<h3>[property:Vector3 position]</h3>
 		<p>
-			This is set equal to [page:Object3D.DefaultUp] (0, 1, 0), so that the light shines from the top down.
+			假如这个值设置等于 [page:Object3D.DefaultUp] (0, 1, 0),那么光线将会从上往下照射。
 		</p>
 
 		<h3>[property:DirectionalLightShadow shadow]</h3>
 		<p>
-			A [page:DirectionalLightShadow] used to calculate shadows for this light.
+			这个 [page:DirectionalLightShadow] 对象用来计算该平行光产生的阴影。
 		</p>
 
 		<h3>[property:Object3D target]</h3>
 		<p>
-			The DirectionalLight points from its [page:.position position] to target.position. The default
-			position of the target is *(0, 0, 0)*.<br />
+			平行光的方向是从它的位置到目标位置。默认的目标位置为原点 *(0,0,0)*。<br />
 
-			*Note*: For the target's position to be changed to anything other than the default,
-			it must be added to the [page:Scene scene] using
+			注意: 对于目标的位置，要将其更改为除缺省值之外的任何位置,它必须被添加到 [page:Scene scene]
+			场景中去。
 		</p>
 		<code>
 		scene.add( light.target );
 		</code>
 		<p>
-			This is so that the target's [page:Object3D.matrixWorld matrixWorld] gets automatically
-			updated each frame.<br /><br />
-
-			It is also possible to set the target to be another object in the scene (anything with a
-			[page:Object3D.position position] property), like so:
+			这使得属性target中的 [page:Object3D.matrixWorld matrixWorld] 会每帧自动更新。
+			<br /><br />
+			它也可以设置target为场景中的其他对象(任意拥有 [page:Object3D.position position] 属性的对象), 示例如下:
 		</p>
 		<code>
 		var targetObject = new THREE.Object3D();
@@ -122,21 +114,20 @@
 		light.target = targetObject;
 		</code>
 		<p>
-			The directionalLight will now track the target object.
+			完成上述操作后，平行光现在就可以追踪到目标对像了。
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
-		See the base [page:Light Light] class for common methods.
+		公共方法请查看基类 [page:Light Light]。
 
 		<h3>[method:DirectionalLight copy]( [param:DirectionalLight source] )</h3>
 		<p>
-		Copies value of all the properties from the [page:DirectionalLight source] to this
-		DirectionalLight.
+			复制 source 的值到这个平行光源对象。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/lights/HemisphereLight.html

@@ -10,16 +10,16 @@
 	<body>
         [page:Object3D] &rarr; [page:Light] &rarr;
 
-		<h1>[name]</h1>
+		<h1>半球光（[name]）</h1>
 
 		<p class="desc">
-			A light source positioned directly above the scene, with color fading from the
-			sky color to the ground color. <br /><br />
+			光源直接放置于场景之上，光照颜色从天空光线颜色颜色渐变到地面光线颜色。
+			<br /><br />
 
-			This light cannot be used to cast shadows.
+			半球光不能投射阴影。
 		</p>
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 
 		<div>
 			[example:webgl_lights_hemisphere lights / hemisphere ]<br />
@@ -35,64 +35,64 @@ var light = new THREE.HemisphereLight( 0xffffbb, 0x080820, 1 );
 scene.add( light );
 </code>
 
-		<h2>Constructor</h2>
+		<h2>构造器（Constructor）</h2>
 		<h3>[name]( [param:Integer skyColor], [param:Integer groundColor], [param:Float intensity] )</h3>
     <p>
-		[page:Integer skyColor] - (optional) hexadecimal color of the sky. Default is 0xffffff.<br />
-		[page:Integer groundColor] - (optional) hexadecimal color of the ground. Default is 0xffffff.<br />
-		[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br /><br />
+		[page:Integer skyColor] - (可选参数) 天空中发出光线的颜色。 缺省值 0xffffff。<br />
+		[page:Integer groundColor] - (可选参数) 地面发出光线的颜色。 缺省值 0xffffff。<br />
+		[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。<br /><br />
 
-		Creates a new [name].
+		创建一个半球光。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性（Properties）</h2>
 		<p>
-			See the base [page:Light Light] class for common properties.
+			公共属性请查看基类[page:Light Light]。
 		</p>
 
 		<h3>[property:Boolean castShadow]</h3>
 		<p>
-			This is set to *undefined* in the constructor as hemisphere lights cannot cast shadows.
+			该参数在构造时被设置为 *undefined* 因为半球光不能投射阴影。
 		</p>
 
 
 		<h3>[property:Float color]</h3>
 		<p>
-			The light's sky color, as passed in the constructor.
-			Default is a new [page:Color] set to white (0xffffff).
+			在构造时传递的天空发出光线的颜色。
+			默认会创建 [page:Color] 并设置为白色（0xffffff）。
 		</p>
 
 		<h3>[property:Float groundColor]</h3>
 		<p>
-			The light's ground color, as passed in the constructor.
-			Default is a new [page:Color] set to white (0xffffff).
+			在构造时传递的地面发出光线的颜色。
+			默认会创建 [page:Color] 并设置为白色（0xffffff）。
 		</p>
 
 		<h3>[property:Boolean isHemisphereLight]</h3>
 		<p>
-			Used to check whether this or derived classes are hemisphere lights. Default is *true*.<br /><br />
+				用来校验这个类或者派生类是不是半球光。缺省值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+				不应该去改变这个变量,因为内部使用这个变量做了些优化的工作。
 		</p>
 
 		<h3>[property:Vector3 position]</h3>
 		<p>
-			This is set equal to [page:Object3D.DefaultUp] (0, 1, 0), so that the light shines from the top down.
+			假如这个值设置等于 [page:Object3D.DefaultUp] (0, 1, 0),那么光线将会从上往下照射。
 		</p>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法（Methods）</h2>
 
-		See the base [page:Light Light] class for common methods.
+		公共方法请查看基类 [page:Light Light]。
 
 		<h3>[method:HemisphereLight copy]( [param:HemisphereLight source] )</h3>
 		<p>
-			Copies the value of [page:.color color], [page:.intensity intensity] and
-			[page:.groundColor groundColor] from the [page:Light source] light into this one.
+			从[page:Light source]复制 [page:.color color], [page:.intensity intensity] 和
+			[page:.groundColor groundColor] 的值到当前半球光对象中。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/lights/Light.html

@@ -13,66 +13,66 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Abstract base class for lights - all other light types inherit the properties and methods
-			described here.
+			光源的基类 - 所有其他的光类型都继承了该类描述的属性和方法。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器（Constructor）</h2>
 
 
 		<h3>[name]( [param:Integer color], [param:float intensity] )</h3>
 		<p>
-		[page:Integer color] - (optional) hexadecimal color of the light. Default is 0xffffff (white).<br />
-		[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br /><br />
+		[page:Integer color] - (可选参数) 16进制表示光的颜色。 缺省值 0xffffff (白色)。<br />
+		[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。<br /><br />
 
-		Creates a new [name]. Note that this is not intended to be called directly (use one of derived classes instead).
+		创造一个新的光源。注意，这并不是直接调用的（而是使用派生类之一）。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性（Properties）</h2>
 		<p>
-			See the base [page:Object3D Object3D] class for common properties.
+			公共属性请查看基类[page:Object3D Object3D]。
 		</p>
 
 		<h3>[property:Color color]</h3>
 		<p>
-			Color of the light. Defaults to a new [page:Color] set to white, if not passed in the constructor.<br />
+			光源的颜色。如果构造的时候没有传递，默认会创建一个新的 [page:Color] 并设置为白色。
 		</p>
 
 		<h3>[property:Float intensity]</h3>
 		<p>
-			The light's intensity, or strength.<br />
-			In [page:WebGLRenderer.physicallyCorrectLights physically correct] mode, the product of
-			[page:.color color] * intensity is interpreted as luminous intensity measured in candela.<br />
-			Default - *1.0*.
+			光照的强度，或者说能量。
+			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式下, [page:.color color] 和强度
+			的乘积被解析为以坎德拉（candela）为单位的发光强度。
+			默认值 - *1.0*
+		<br />
 		</p>
 
 		<h3>[property:Boolean isLight]</h3>
 		<p>
-			Used to check whether this or derived classes are lights. Default is *true*.<br /><br />
+			用来校验这个类或者派生类是不是平行光。默认是 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			不应该去改变这个变量，因为内部使用这个变量做了些优化的工作。
 		</p>
 
 
 		<h2>Methods</h2>
 		<p>
-			See the base [page:Object3D Object3D] class for common methods.
+			公共方法请查看基类 [page:Object3D Object3D]。
 		</p>
 
 
 		<h3>[method:Light copy]( [param:Light source] )</h3>
 		<p>
-		Copies the value of [page:.color color] and [page:.intensity intensity] from the
-		[page:Light source] light into this one.
+		从[page:Light source]复制 [page:.color color], [page:.intensity intensity] 
+		的值到当前光源对象中。
 		</p>
 
 		<h3>[method:JSON toJSON]( [param:String meta] )</h3>
 		<p>
-		Return Light data in JSON format.
+			以JSON格式返回光数据。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/lights/PointLight.html

@@ -10,17 +10,16 @@
 	<body>
 		[page:Object3D] &rarr; [page:Light] &rarr;
 
-		<h1>[name]</h1>
+		<h1>点光源（[name]）</h1>
 
 		<p class="desc">
-			A light that gets emitted from a single point in all directions. A common use case for this
-			is to replicate the light emitted from a bare lightbulb.<br /><br />
-
-			 This light can cast shadows - see [page:LightShadow] page for details.
+			从一个点向各个方向发射的光源。一个常见的例子是模拟一个灯泡发出的光。
+			<br /><br />
+			该光源可以投射阴影 - 跳转至 [page:LightShadow] 查看更多细节。
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 
 		<p>
 			[example:canvas_lights_pointlights lights / pointlights ]<br />
@@ -39,77 +38,76 @@ scene.add( light );
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器（Constructor）</h2>
 
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Number distance], [param:Float decay] )</h3>
 		<p>
-			[page:Integer color] - (optional) hexadecimal color of the light. Default is 0xffffff (white).<br />
-			[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br /><br />
-			[page:Number distance] - The distance from the light where the intensity is 0.
-			When set to 0, then the light never stops. Default is 0.<br />
-			[page:Float decay] - The amount the light dims along the distance of the light. Default is 1.
-			For [page:WebGLRenderer.physicallyCorrectLights physically correct] lighting, set this to 2.<br /><br />
-
-			Creates a new [name].
+			[page:Integer color] - (可选参数)) 十六进制光照颜色。 缺省值 0xffffff (白色)。<br />
+			[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。 <br /><br />
+			[page:Number distance] - 这个距离表示从光源到光照强度为0的位置。
+			当设置为0时，光永远不会消失(距离无穷大)。缺省值 0.<br />
+			[page:Float decay] - 沿着光照距离的衰退量。缺省值 1。
+			
+			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式中，decay = 2。<br /><br />
+
+			创建一个新的点光源（PointLight）。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性（Properties）</h2>
 		<p>
-			See the base [page:Light Light] class for common properties.
+			公共属性请查看基类[page:Light Light]。
 		</p>
 
 		<h3>[property:Float decay]</h3>
 		<p>
-			The amount the light dims along the distance of the light<br />
-			In [page:WebGLRenderer.physicallyCorrectLights physically correct] mode, decay = 2 leads to physically realistic light falloff.<br/>
-			Default is *1*.
+			沿着光照距离的衰减量<br />
+			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式下，decay 设置为等于2将实现现实世界的光衰减。<br/>
+			缺省值为 *1*。
 		</p>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-			If non-zero, light will attenuate linearly from maximum intensity at the light's
-			position down to zero at this distance from the light. Default is *0.0*.
+			如果非零，那么光强度将会从最大值当前灯光位置处按照距离线性衰减到0。
+			缺省值为 *0.0*。
 		</p>
 
 		<h3>[property:Boolean isPointLight]</h3>
 		<p>
-			Used to check whether this or derived classes are point lights. Default is *true*.<br /><br />
+				用来校验这个类或者派生类是不是点光源。默认是 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+				不应该去改变这个变量，因为内部使用这个变量做了些优化的工作。
 		</p>
 
 		<h3>[property:Float power]</h3>
 		<p>
-			The light's power.<br />
-			In [page:WebGLRenderer.physicallyCorrectLights physically correct] mode, the luminous
-			power of the light measured in lumens. Default is *4Math.PI*. <br /><br />
-
-			This is directly related to the [page:.intensity intensity] in the ratio
-			<code>
+			光功率<br />
+			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式中,
+			表示以"流明（光通量单位）"为单位的光功率。 缺省值 - *4Math.PI*。 <br /><br />
+			
+			该值与 [page:.intensity intensity] 直接关联
+  			<code>
 				power = intensity * 4&pi;
 			</code>
-			and changing this will also change the intensity.
+			修改该值也会导致光强度的改变。
 		</p>
 
 		<h3>[property:LightShadow shadow]</h3>
 		<p>
-			A [page:LightShadow] used to calculate shadows for this light.<br /><br />
-
-			 The lightShadow's [page:LightShadow.camera camera]
-			is set to a  [page:PerspectiveCamera] with [page:PerspectiveCamera.fov fov] of 90,
-			[page:PerspectiveCamera.aspect aspect] of 1, [page:PerspectiveCamera.near near]
-			clipping plane at 0.5 and	[page:PerspectiveCamera.far far] clipping plane at 500.
+			[page:LightShadow]用与计算此光照的阴影。<br /><br />
+			
+			此对象的摄像机被设置为 [page:PerspectiveCamera.fov fov] 为90度，[page:PerspectiveCamera.aspect aspect]为1
+			,近裁剪面  [page:PerspectiveCamera.near near] 为0，远裁剪面[page:PerspectiveCamera.far far] 
+			为500的透视摄像机 [page:PerspectiveCamera]。
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法（Methods）</h2>
 		<p>
-			See the base [page:Light Light] class for common methods.
+			公共方法请查看基类 [page:Light Light]。
 		</p>
 
 		<h3>[method:PointLight copy]( [param:PointLight source] )</h3>
 		<p>
-		Copies value of all the properties from the [page:PointLight source] to this
-		PointLight.
+			将所有属性的值从源 [page:PointLight source] 复制到此点光源对象。
 		</p>
 
 		<h2>Source</h2>

docs/api/zh/lights/RectAreaLight.html

@@ -10,23 +10,22 @@
 	<body>
 		[page:Object3D] &rarr; [page:Light] &rarr;
 
-		<h1>[name]</h1>
+		<h1>平面光光源（[name]）</h1>
 
 		<p class="desc">
-			RectAreaLight emits light uniformly across the face a rectangular plane. This light type can be
-			used to simulate light sources such as bright windows or strip lighting.<br /><br />
+			平面光光源从一个矩形平面上均匀地发射光线。这种光源可以用来模拟像明亮的窗户或者条状灯光光源。<br /><br />
 
-			Important Notes:
+			注意事项:
 			<ul>
-				<li>There is no shadow support.</li>
-				<li>Only [page:MeshStandardMaterial MeshStandardMaterial] and [page:MeshPhysicalMaterial MeshPhysicalMaterial] are supported.</li>
-				<li>You have to include [link:https://threejs.org/examples/js/lights/RectAreaLightUniformsLib.js RectAreaLightUniformsLib] into your scene.</li>
+				<li>不支持阴影。</li>
+				<li>只支持 [page:MeshStandardMaterial MeshStandardMaterial] 和 [page:MeshPhysicalMaterial MeshPhysicalMaterial] 两种材质。</li>
+				<li>你必须在你的场景中加入 [link:https://threejs.org/examples/js/lights/RectAreaLightUniformsLib.js RectAreaLightUniformsLib] 。</li>
 			</ul>
 		</p>
 
 
 
-		<h2>Examples</h2>
+		<h2>示例</h2>
 
 		<p>
 			[example:webgl_lights_rectarealight WebGL / rectarealight ]
@@ -47,41 +46,40 @@ scene.add( rectLightHelper );
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器（Constructor）</h2>
 
 
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Float width], [param:Float height] )</h3>
 		<p>
-			[page:Integer color] - (optional) hexadecimal color of the light. Default is 0xffffff (white).<br />
-			[page:Float intensity] - (optional) the light's intensity, or brightness. Default is 1.<br />
-			[page:Float width] - (optional) width of the light. Default is 10.<br />
-			[page:Float height] - (optional) height of the light. Default is 10.<br /><br />
+			[page:Integer color] -  (可选参数) 十六进制数字表示的光照颜色。缺省值为 0xffffff (白色)<br />
+			[page:Float intensity] - (可选参数) 光源强度／亮度 。缺省值为 1。<br />
+			[page:Float width] - (可选参数) 光源宽度。缺省值为 10。<br />
+			[page:Float height] - (可选参数) 光源高度。缺省值为 10。<br /><br />
 
-			Creates a new [name].
+			创建一个新的平行光。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性（Properties）</h2>
 		<p>
-			See the base [page:Light Light] class for common properties.
+			公共属性请查看基类[page:Light Light]。
 		</p>
 
 		<h3>[property:Boolean isRectAreaLight]</h3>
 		<p>
-			Used to check whether this or derived classes are RectAreaLights. Default is *true*.<br /><br />
+			用来校验这个类或者它的派生类是不是平面光光源。缺省值是 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			不应该去改变这个变量,因为内部使用这个变量做了些优化的工作。
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法（Methods）</h2>
 		<p>
-			See the base [page:Light Light] class for common methods.
+			公共方法请查看基类 [page:Light Light]。
 		</p>
 
 
 		<h3>[method:RectAreaLight copy]( [param:RectAreaLight source] )</h3>
 		<p>
-		Copies value of all the properties from the [page:RectAreaLight source] to this
-		RectAreaLight.
+			将所有属性的值从源 [page:RectAreaLight source] 复制到此平面光光源对象。
 		</p>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/lights/SpotLight.html

@@ -10,26 +10,25 @@
 	<body>
 		[page:Object3D] &rarr; [page:Light] &rarr;
 
-		<h1>[name]</h1>
+		<h1>聚光灯（[name]）</h1>
 
 		<p class="desc">
-			This light gets emitted from a single point in one direction, along a cone that increases in size
-			the further from the light it gets. <br /><br />
+			聚光灯是从一个方向上的一个点发出，沿着一个圆锥体，它离光越远，它的尺寸就越大。 <br /><br />
 
-			This light can cast shadows - see the [page:SpotLightShadow] page for details.
+			该光源可以投射阴影 - 跳转至 [page:SpotLightShadow] 查看更多细节。
 		</p>
 
 
 
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 
 		<iframe src='../examples/webgl_lights_spotlight.html'></iframe>
 		<p>
 			[example:webgl_lights_spotlight View in Examples ]
 		</p>
 
-		<h2>Other Examples</h2>
+		<h2>其他例子</h2>
 
 		<p>
 			[example:webgl_interactive_cubes_gpu interactive / cubes / gpu ]<br />
@@ -45,7 +44,7 @@
 			[example:webgl_shadowmap_viewer shadowmap / viewer]
 		</p>
 
-		<h2>Code Example</h2>
+		<h2>代码示例</h2>
 		<code>
 		// white spotlight shining from the side, casting a shadow
 
@@ -64,126 +63,117 @@
 		scene.add( spotLight );
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造器（Constructor）</h2>
 
 
 		<h3>[name]( [param:Integer color], [param:Float intensity], [param:Float distance], [param:Radians angle], [param:Float penumbra], [param:Float decay] )</h3>
 		<p>
-			[page:Integer color] - (optional) hexadecimal color of the light. Default is 0xffffff (white).<br />
-			[page:Float intensity] - (optional) numeric value of the light's strength/intensity. Default is 1.<br /><br />
-			[page:Float distance] - Maximum distance from origin where light will shine whose intensity
-			is attenuated linearly based on distance from origin. <br />
-			[page:Radians angle] - Maximum angle of light dispersion from its direction whose upper
-			bound is Math.PI/2.<br />
-			[page:Float penumbra] - Percent of the spotlight cone that is attenuated due to penumbra.
-			Takes values between zero and 1. Default is zero.<br />
-			[page:Float decay] - The amount the light dims along the distance of the light.<br /><br />
-
-			Creates a new [name].
+			[page:Integer color] - (可选参数) 十六进制光照颜色。 缺省值 0xffffff (白色)。<br />
+			[page:Float intensity] - (可选参数) 光照强度。 缺省值 1。<br /><br />
+			[page:Float distance] - 从光源发出光的最大距离，其强度根据光源的距离线性衰减。 <br />
+			[page:Radians angle] - 光线散射角度，最大为Math.PI/2。<br />
+			[page:Float penumbra] - 聚光锥的半影衰减百分比。在0和1之间的值。默认为0。<br />
+			[page:Float decay] - 沿着光照距离的衰减量。<br /><br />
+
+			创建一个新的聚光灯。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性（Properties）</h2>
 
-		See the base [page:Light Light] class for common properties.
+		公共属性请查看基类[page:Light Light]。
 
 		<h3>[property:Float angle]</h3>
 		<p>
-			Maximum extent of the spotlight, in radians, from its direction. Should be no more than
-			*Math.PI/2*. The default is *Math.PI/3*.
+			从聚光灯的位置以弧度表示聚光灯的最大范围。应该不超过 *Math.PI/2*。默认值为 *Math.PI/3*。
 		</p>
 
 
 		<h3>[property:Boolean castShadow]</h3>
 		<p>
-			If set to *true* light will cast dynamic shadows. *Warning*: This is expensive and
-			requires tweaking to get shadows looking right. See the [page:SpotLightShadow] for details.
-			The default is *false*.
+			此属性设置为 *true* 聚光灯将投射阴影。警告: 这样做的代价比较高而且需要一直调整到阴影看起来正确。
+			查看 [page:SpotLightShadow] 了解详细信息。
+			默认值为 *false*
 		</p>
 
 		<h3>[property:Float decay]</h3>
 		<p>
-			The amount the light dims along the distance of the light.<br />
-			In [page:WebGLRenderer.physicallyCorrectLights physically correct] mode, decay = 2 leads to
-			physically realistic light falloff. The default is *1*.
+			沿着光照距离的衰减量<br />
+			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式下，decay 设置为等于2将实现现实世界的光衰减。<br/>
+			缺省值为 *1*。
 		</p>
 
 		<h3>[property:Float distance]</h3>
 		<p>
-			If non-zero, light will attenuate linearly from maximum intensity at the light's
-			position down to zero at this distance from the light. Default is *0.0*.
+			如果非零，那么光强度将会从最大值当前灯光位置处按照距离线性衰减到0。
+			缺省值为 *0.0*。
 		</p>
 
 		<h3>[property:Boolean isSpotLight]</h3>
 		<p>
-			Used to check whether this or derived classes are spot lights. Default is *true*.<br /><br />
+				用来校验这个类或者它的派生类是不是聚光灯光源。缺省值是 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+				不应该去改变这个变量,因为内部使用这个变量做了些优化的工作。
 		</p>
 
 		<h3>[property:Float penumbra]</h3>
 		<p>
-			Percent of the spotlight cone that is attenuated due to penumbra. Takes values between
-			zero and 1. The default is *0.0*.
+				聚光锥的半影衰减百分比。在0和1之间的值。
+				默认值 — 0.0。
 		</p>
 
 		<h3>[property:Vector3 position]</h3>
 		<p>
-			This is set equal to [page:Object3D.DefaultUp] (0, 1, 0), so that the light shines from the top down.
+			假如这个值设置等于 [page:Object3D.DefaultUp] (0, 1, 0)，那么光线将会从上往下照射。
 		</p>
 
 		<h3>[property:Float power]</h3>
 		<p>
-			The light's power.<br />
-			In [page:WebGLRenderer.physicallyCorrectLights physically correct] mode, the luminous
-			power of the light measured in lumens. Default is *4Math.PI*. <br /><br />
-
-			This is directly related to the [page:.intensity intensity] in the ratio
-			<code>
-				power = intensity * &pi;
+			光功率<br />
+			在 [page:WebGLRenderer.physicallyCorrectLights physically correct] 模式中，
+			表示以"流明（光通量单位）"为单位的光功率。 缺省值 - *4Math.PI*。 <br /><br />
+			
+			该值与 [page:.intensity intensity] 直接关联
+				<code>
+				power = intensity * 4&pi;
 			</code>
-			and changing this will also change the intensity.
+			修改该值也会导致光强度的改变。
 		</p>
 
 		<h3>[property:SpotLightShadow shadow]</h3>
 		<p>
-			A [page:SpotLightShadow] used to calculate shadows for this light.
+			[page:SpotLightShadow]用与计算此光照的阴影。
 		</p>
 
 
 		<h3>[property:Object3D target]</h3>
 		<p>
-			The Spotlight points from its [page:.position position] to target.position. The default
-			position of the target is *(0, 0, 0)*.<br />
-
-			*Note*: For the target's position to be changed to anything other than the default,
-			it must be added to the [page:Scene scene] using
+				平行光的方向是从它的位置到目标位置.默认的目标位置为原点 *(0,0,0)*。<br />
+				注意: 对于目标的位置，要将其更改为除缺省值之外的任何位置，它必须被添加到 [page:Scene scene]
+				场景中去。
 			<code>
 				scene.add( light.target );
 			</code>
 
-			This is so that the target's [page:Object3D.matrixWorld matrixWorld] gets automatically
-			updated each frame.<br /><br />
+			这使得属性target中的 [page:Object3D.matrixWorld matrixWorld] 会每帧自动更新。<br /><br />
 
-			It is also possible to set the target to be another object in the scene (anything with a
-			[page:Object3D.position position] property), like so:
+			它也可以设置target为场景中的其他对象(任意拥有 [page:Object3D.position position] 属性的对象), 示例如下:
 			<code>
 var targetObject = new THREE.Object3D();
 scene.add(targetObject);
 
 light.target = targetObject;
 			</code>
-			The spotlight will now track the target object.
+			完成上述操作后，聚光灯现在就可以追踪到目标对像了。
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法（Methods）</h2>
 
-		See the base [page:Light Light] class for common methods.
+		公共方法请查看基类 [page:Light Light]。
 
 		<h3>[method:SpotLight copy]( [param:SpotLight source] )</h3>
 		<p>
-		Copies value of all the properties from the [page:SpotLight source] to this
-		SpotLight.
+			将所有属性的值从源 [page:SpotLight source] 复制到此聚光灯光源对象。
 		</p>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]

docs/api/zh/lights/shadows/DirectionalLightShadow.html

@@ -13,14 +13,12 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			This is used internally by [page:DirectionalLight DirectionalLights] for calculating shadows.<br /><br />
+			这是用于在[page:DirectionalLight DirectionalLights]内部计算阴影<br /><br />
 
-			Unlike the other shadow classes, this uses an [page:OrthographicCamera] to calculate the shadows,
-			rather than a [page:PerspectiveCamera]. This is because light rays from a [page:DirectionalLight]
-			are parallel.
+			与其他阴影类不同，它是使用OrthographicCamera来计算阴影，而不是PerspectiveCamera。这是因为来自DirectionalLight的光线是平行的。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 		<p>
 			<code>
 //Create a WebGLRenderer and turn on shadows in the renderer
@@ -61,36 +59,30 @@ scene.add( helper );
 			</code>
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 		<h3>[name]( )</h3>
 		<p>
-			Creates a new [name]. This is not intended to be called directly - it is called
-			internally by [page:DirectionalLight].
+			创建一个新的[name]，不能直接调用-它是在[page:DirectionalLight DirectionalLights]内部调用使用
+
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 		<p>
-			See the base [page:LightShadow LightShadow] class for common properties.
+			参阅[page:LightShadow LightShadow]类来了解常用的基本属性
 		</p>
 
 		<h3>[property:Camera camera]</h3>
 		<p>
-			The light's view of the world. This is used to generate a depth map of the scene; objects behind
-			other objects from the light's perspective will be in shadow.<br /><br />
-
-			The default is an [page:OrthographicCamera] with [page:OrthographicCamera.left left] and
-			[page:OrthographicCamera.bottom bottom] set to -5,  [page:OrthographicCamera.right right]
-			and  [page:OrthographicCamera.top top] set to 5, the [page:OrthographicCamera.near near]
-			clipping plane at 0.5 and the [page:OrthographicCamera.far far] clipping plane at 500.
+			在光的世界里。这用于生成场景的深度图;从光的角度来看，其他物体背后的物体将处于阴影中。<br /><br />
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 		<p>
-			See the base [page:LightShadow LightShadow] class for common methods.
+			有关常用方法，请参阅基础[page：LightShadow LightShadow]类。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/lights/[name].js src/lights/[name].js]
 	</body>

docs/api/zh/lights/shadows/LightShadow.html

@@ -12,12 +12,11 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			This is used internally by [page:PointLight PointLights] for calculating shadows, and also serves as
-			a base class for the other shadow classes.
+			这在 [page:PointLight PointLights] 内部用于计算阴影，也可用作其他阴影类的基类。
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 		<p>
 			<code>
 //Create a WebGLRenderer and turn on shadows in the renderer
@@ -58,83 +57,78 @@ scene.add( helper );
 			</code>
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:Camera camera] )</h3>
 		<p>
-		[page:Camera camera] - the light's view of the world.<br /><br />
+		[page:Camera camera] - 在光的世界里<br /><br />
 
-		Create a new [name]. This is not intended to be called directly - it is called
-		internally by [page:PointLight] or used as a base class by other light shadows.
+			创建一个新的[name]。这不能直接调用的 - 它由[page:PointLight]在内部调用，或者由其他阴影用作基类。
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Camera camera]</h3>
 		<p>
-			The light's view of the world. This is used to generate a depth map of the scene; objects behind
-			other objects from the light's perspective will be in shadow.
+			光的世界里。这用于生成场景的深度图;从光的角度来看，其他物体背后的物体将处于阴影中。
 		</p>
 
 		<h3>[property:Float bias]</h3>
 		<p>
-			Shadow map bias, how much to add or subtract from the normalized depth when deciding whether a surface is in shadow.<br />
-			The default is 0. Very tiny adjustments here (in the order of 0.0001) may help reduce artefacts in shadows
+			阴影贴图偏差，在确定曲面是否在阴影中时，从标准化深度添加或减去多少。<br />
+			默认值为0.此处非常小的调整（大约0.0001）可能有助于减少阴影中的伪影
 		</p>
 
 		<h3>[property:WebGLRenderTarget map]</h3>
 		<p>
-			The depth map generated using the internal camera; a location beyond a pixel's depth is
-			in shadow. Computed internally during rendering.
+			使用内置摄像头生成的深度图;超出像素深度的位置在阴影中。在渲染期间内部计算。
 		</p>
 
 
 		<h3>[property:Vector2 mapSize]</h3>
 		<p>
-			A [Page:Vector2] defining the width and height of the shadow map.<br /><br />
+			一个[Page:Vector2]定义阴影贴图的宽度和高度。<br /><br />
 
-			Higher values give better quality shadows at the cost of computation time. Values must be
-			powers of 2, up to the [page:WebGLRenderer.capabilities].maxTextureSize for a given device,
-			although the width and height don't have to be the same (so, for example, (512, 1024) is valid).
-			The default is *( 512, 512 )*.
+			较高的值会以计算时间为代价提供更好的阴影质量。值必须是2的幂，直到给定设备的[page:WebGLRenderer.capabilities].maxTextureSize，
+			虽然宽度和高度不必相同（例如，（512,1024）有效）。
+			默认值为*（512,512）*。
 		</p>
 
 
 		<h3>[property:Matrix4 matrix]</h3>
 		<p>
-			Model to shadow camera space, to compute location and depth in shadow map. Stored
-			in a [page:Matrix4 Matrix4]. This is computed internally during rendering.
+			模拟阴影相机空间，计算阴影贴图中的位置和深度。存储在[page:Matrix4 Matrix4]中。这是在渲染期间内部计算的。
 		</p>
 
 		<h3>[property:Float radius]</h3>
 		<p>
-			Setting this to values greater than 1 will blur the edges of the shadow.<br />
+			将此值设置为大于1的值将模糊阴影的边缘。<br />
 
-			High values will cause unwanted banding effects in the shadows - a greater [page:.mapSize mapSize]
-			will allow for a higher value to be used here before these effects become visible.<br /><br />
 
-			Note that this has no effect if the [page:WebGLRenderer.shadowMap.type] is set to [page:Renderer BasicShadowMap].
+			较高的值会在阴影中产生不必要的条带效果 - 更大的[page:.mapSize mapSize]将允许在这些效果变得可见之前使用更高的值。<br /><br />
+
+			请注意，如果[page：WebGLRenderer.shadowMap.type]设置为[page:Renderer BasicShadowMap]，将会无效。
+
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 		<h3>[method:LightShadow copy]( [param:LightShadow source] )</h3>
 		<p>
-		Copies value of all the properties from the [page:LightShadow source] to this
-		SpotLight.
+			将[page:LightShadow]中的所有属性的值复制到 SpotLight。
 		</p>
 
 		<h3>[method:LightShadow clone]()</h3>
 		<p>
-		Creates a new LightShadow with the same properties as this one.
+			克隆与此相同属性的新LightShadow。
 		</p>
 
 		<h3>[method:Object toJSON]()</h3>
 		<p>
-		Serialize this LightShadow.
+			序列化这个LightShadow。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/lights/[name].js src/lights/[name].js]
 	</body>

docs/api/zh/lights/shadows/SpotLightShadow.html

@@ -13,10 +13,10 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			This is used internally by [page:SpotLight SpotLights] for calculating shadows.
+			这在SpotLights内部用于计算阴影。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 		<p>
 			<code>
 //Create a WebGLRenderer and turn on shadows in the renderer
@@ -57,41 +57,30 @@ scene.add( helper );
 		</p>
 
 
-		<h2>Constructor</h2>
-
-		The constructor creates a [param:PerspectiveCamera PerspectiveCamera] to manage the shadow's view of the world.
-
-		<h2>Properties</h2>
-		See the base [page:LightShadow LightShadow] class for common properties.
-
-
+		<h2>构造函数</h2>
+	        	构造函数创建一个 [param:PerspectiveCamera PerspectiveCamera] 来管理阴影的世界视图
+		<h2>属性</h2>
+		有关常用属性，请参阅基础LightShadow类。
 	 <h3>[property:Camera camera]</h3>
 	 <p>
-		 The light's view of the world. This is used to generate a depth map of the scene; objects behind
-		 other objects from the light's perspective will be in shadow.<br /><br />
+		 在光的世界里。这用于生成场景的深度图;从光的角度来看，其他物体背后的物体将处于阴影中。<br /><br />
 
-		 The default is a  [page:PerspectiveCamera] with [page:PerspectiveCamera.near near] clipping plane at 0.5.
-		 The [page:PerspectiveCamera.fov fov] will track the [page:SpotLight.angle angle] property of the owning
-		 [page:SpotLight SpotLight] via the [page:SpotLightShadow.update update] method. Similarly, the
-		 [page:PerspectiveCamera.aspect aspect] property will track the aspect of the
-		 [page:LightShadow.mapSize mapSize]. If the [page:SpotLight.distance distance] property of the light is
-		 set, the [page:PerspectiveCamera.far far] clipping plane will track that, otherwise it defaults to 500.
+		 默认值为PerspectiveCamera，近剪裁平面为0.5。 fov将通过更新方法跟踪拥有SpotLight的角度属性。同样，aspect属性将跟踪mapSize的方面。如果设置了灯光的距离属性，则远剪裁平面将跟踪该值，否则默认为500。
 
 	 </p>
 
 	 <h3>[property:Boolean isSpotLightShadow]</h3>
 	 <p>
-		 Used to check whether this or derived classes are spot light shadows. Default is *true*.<br /><br />
 
-		 You should not change this, as it used internally for optimisation.
+		 用于检查此类或派生类是否为聚光灯阴影。默认为true。<br /><br />
+		 您不应该更改它，因为它在内部用于优化。
 	 </p>
 
-		<h2>Methods</h2>
-		See the base [page:LightShadow LightShadow] class for common methods.
-
+		<h2>方法</h2>
+		有关常用方法，请参阅基础LightShadow类。
 		<h3>[method:SpotLightShadow update]( [param:SpotLight light] )</h3>
 		<p>
-		Updates the internal perspective [page:.camera camera] based on the passed in [page:SpotLight light].
+			根据传入的[page:SpotLight light]更新内部透视[page:.camera camera]。
 		</p>
 
 		<h2>Source</h2>

docs/api/zh/loaders/AnimationLoader.html

@@ -11,77 +11,77 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Class for loading [page:AnimationClip AnimationClips] in JSON format.
-			This uses the [page:FileLoader] internally for loading files.
+			以JSON格式来加载 [page:AnimationClip AnimationClips] 的一个类。
+			内部使用 [page:FileLoader] 来加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<code>
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.AnimationLoader();
 
-		// load a resource
+		// 加载资源
 		loader.load(
-			// resource URL
+			// 资源URL
 			'animations/animation.js',
 
-			// onLoad callback
+			// onLoad回调
 			function ( animations ) {
-				// animations is an array of AnimationClips
+				// animations时一个AnimationClips组数
 			},
 
-			// onProgress callback
+			// onProgress回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.log( 'An error happened' );
 			}
 		);
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器所使用的[page:LoadingManager loadingManager]。 默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:LoadingManager manager]</h3>
 		<p>
-			The [page:LoadingManager loadingManager]  the loader is using. Default is [page:DefaultLoadingManager].
+			加载器正在使用的[page:LoadingManager loadingManager]。默认为[page:DefaultLoadingManager].
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Animation animation].<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called if load errors.<br /><br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的[page:Animation animation].<br />
+		[page:Function onProgress] —  将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
+		[page:Function onError] — 在加载错误时被调用。<br /><br />
 
-		Begin loading from url and pass the loaded animation to onLoad.
+            从URL中进行加载并将动画传递给onLoad。
 		</p>
 
 		<h3>[method:null parse]( [param:JSON json], [param:Function onLoad] )</h3>
 		<p>
-		[page:JSON json] — required<br />
-		[page:Function onLoad] — Will be called when parsing completes. <br /><br />
+		[page:JSON json] — 请求<br />
+		[page:Function onLoad] — 当解析完成时，将被调用 <br /><br />
 
-		Parse the JSON object and pass the result to onLoad. Individual clips in the object will
-		be parsed with [page:AnimationClip.parse].
+            解析JSON对象并将结果传递给onLoad。对象中的单个片段将
+            用[page [page:AnimationClip.parse]进行解析。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/AudioLoader.html

@@ -11,88 +11,88 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Class for loading an
-			[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer AudioBuffer].
-			This uses the [page:FileLoader] internally for loading files.
+			用来加载
+			[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer AudioBuffer]的一个类。
+			内部默认使用[page:FileLoader]来加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<code>
-		// instantiate a listener
+		// 初始化一个监听
 		var audioListener = new THREE.AudioListener();
 
-		// add the listener to the camera
+		// 把监听添加到camera
 		camera.add( audioListener );
 
-		// instantiate audio object
+		// 初始化音频对象
 		var oceanAmbientSound = new THREE.Audio( audioListener );
 
-		// add the audio object to the scene
+		// 添加一个音频对象到场景中
 		scene.add( oceanAmbientSound );
 
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.AudioLoader();
 
-		// load a resource
+		// 加载资源
 		loader.load(
-			// resource URL
+			// 资源URL
 			'audio/ambient_ocean.ogg',
 
-			// onLoad callback
+			// onLoad回调
 			function ( audioBuffer ) {
-				// set the audio object buffer to the loaded object
+				// 给一个加载器对象设置音频对象的缓存
 				oceanAmbientSound.setBuffer( audioBuffer );
 
-				// play the audio
+				// 播放音频
 				oceanAmbientSound.play();
 			},
 
-			// onProgress callback
+			// onProgress回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.log( 'An error happened' );
 			}
 		);
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name]( [param:String context], [param:LoadingManager manager] )</h3>
 		<p>
-		[page:String context] — The [page:String AudioContext] for the loader to use. Default is [page:String window.AudioContext].<br />
-		[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use. Default is [page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
+		[page:String context] — 加载器使用的[page:String AudioContext]。 默认为[page:String window.AudioContext].<br />
+		[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]。默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:LoadingManager manager]</h3>
 		<p>
-			The [page:LoadingManager loadingManager] the loader is using. Default is [page:DefaultLoadingManager].
+			加载器正在使用的[page:LoadingManager loadingManager]。默认为[page:DefaultLoadingManager].
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded text response.<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的响应文本。<br />
+		[page:Function onProgress] —   将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节.<br />
+		[page:Function onError] — 在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and pass the loaded [page:String AudioBuffer] to onLoad.
+            从URL中进行加载并将已经加载的[page:String AudioBuffer]传递给onLoad。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/BufferGeometryLoader.html

@@ -11,81 +11,81 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A loader for loading a [page:BufferGeometry].
-			This uses the [page:FileLoader] internally for loading files.
+			用来加载[page:BufferGeometry]的加载器。
+			内部使用[page:FileLoader]来加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		[example:webgl_geometry_colors_lookuptable WebGL / geometry / colors / lookuptable]
 
 		<code>
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.BufferGeometryLoader();
 
-		// load a resource
+		// 加载资源
 		loader.load(
-			// resource URL
+			// 资源URL
 			'models/json/pressure.json',
 
-			// onLoad callback
+			// onLoad回调
 			function ( geometry ) {
 				var material = new THREE.MeshLambertMaterial( { color: 0xF5F5F5 } );
 				var object = new THREE.Mesh( geometry, material );
 				scene.add( object );
 			},
 
-			// onProgress callback
+			// onProgress回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.log( 'An error happened' );
 			}
 		);
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:LoadingManager manager]</h3>
 		<p>
-			The [page:LoadingManager loadingManager] the loader is using. Default is [page:DefaultLoadingManager].
+            正在使用的[page:LoadingManager loadingManager]。默认为[page:DefaultLoadingManager].
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].d<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:BufferGeometry].<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] —  加载完成时将调用。回调参数为将要加载的[page:BufferGeometry].<br />
+		[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
+		[page:Function onError] —在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and call onLoad with the parsed response content.
+            从URL中进行加载，并将已经以解析的响应内容传递给onLoad。
 		</p>
 
 		<h3>[method:BufferGeometry parse]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — The <em>JSON</em> structure to parse.<br /><br />
-		Parse a <em>JSON</em> structure and return a [page:BufferGeometry].
+		[page:Object json] — 所需要解析的<em>JSON</em>结构。<br /><br />
+		解析一个<em>JSON</em>结构，并返回[page:BufferGeometry].
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/Cache.html

@@ -11,10 +11,10 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A simple caching system, used internally by [page:FileLoader].
+            一个简单的缓存系统，内部使用[page:FileLoader]。
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 
 		<p>
 			[example:webgl_geometry_text WebGL / geometry / text ]<br />
@@ -24,51 +24,51 @@
 
 		<h2>Usage</h2>
 
-		<p>To enable caching across all loaders	that use [page:FileLoader], set</p>
+		<p>
+            要在所有使用[page:FileLoader]的加载器上启用缓存， 需设置</p>
 		<code>
 THREE.Cache.enabled = true.
 		</code>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Boolean enabled]</h3>
-		<p>Whether caching is enabled. Default is *false*.</p>
+		<p>是否启用缓存，默认为*false*.</p>
 
 		<h3>[property:Object files]</h3>
-		<p>An [page:Object object] that holds cached files.</p>
+		<p>一个[page:Object object]所持有的缓存文件。</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null add]( [param:String key], file )</h3>
 		<p>
-		[page:String key] — the [page:String key] to reference the cached file by.<br />
-		[page:Object file] — The file to be cached.<br /><br />
+		[page:String key] — 通过引用缓存文件的[page:String key]。<br />
+		[page:Object file] — 所被缓存的文件<br /><br />
 
-		Adds a cache entry with a key to reference the file. If this key already holds a file,
-		it is overwritten.
+           使用key为引用文件增加一个缓存入口。如果该key已持有一个文件，则会被覆盖。
 		</p>
 
 		<h3>[method:null get]( [param:String key] )</h3>
 		<p>
-		[page:String key] — A string key <br /><br />
+		[page:String key] — 一个字符串key <br /><br />
 
-		Get the value of [page:String key]. If the key does not exist *undefined* is returned.
+		获得该[page:String key]的值。 如果该key不存在，则以*undefined*被返回。
 		</p>
 
 		<h3>[method:null remove]( [param:String key] )</h3>
 		<p>
-		[page:String key] — A string key that references a cached file.<br /><br />
+		[page:String key] — 引用缓存文件的一个字符串key<br /><br />
 
-		Remove the cached file associated with the key.
+		使用key来删除相应的缓存文件。
 		</p>
 
 		<h3>[method:null clear]()</h3>
-		<p>Remove all values from the cache.</p>
+		<p>清除所有缓存中的值。</p>
 
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/CompressedTextureLoader.html

@@ -11,62 +11,61 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		Abstract base class for block based textures loader (dds, pvr, ...).
-		This uses the [page:FileLoader] internally for loading files.
+            基于块的纹理加载器 (dds, pvr, ...)的抽象类。
+		内部使用[page:FileLoader]来加载文件。
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 
 		<p>
-			See the [link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/DDSLoader.js DDSLoader]
-			and [link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/PVRLoader.js PVRLoader]
-			for examples of derived classes.
+			请参考[link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/DDSLoader.js DDSLoader]
+			和[link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/PVRLoader.js PVRLoader]
+			子类的例子
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]。
+		默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<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 files will be loaded. See [page:.setPath]. Default is *undefined*.</p>
+		<p>加载的基本路径。请参考[page:.setPath]。默认为*undefined*.</p>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded texture.<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的纹理。<br />
+		[page:Function onProgress] —  将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
+		[page:Function onError] — 在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and pass the loaded texture to onLoad.
+            从URL中进行加载，并将被加载的纹理传递给onLoad。
 		</p>
 
 		<h3>[method:FileLoader setPath]( [param:String path] )</h3>
 		<p>
-			Set the base path or URL from which to load files. This can be useful if
-			you are loading many textures from the same directory.
+            设置加载文件的基本路径或URL。当加载同一目录中的许多模型，此方法将很有用。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/CubeTextureLoader.html

@@ -11,11 +11,11 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Class for loading a [page:CubeTexture CubeTexture].
-			This uses the [page:ImageLoader] internally for loading files.
+			加载[page:CubeTexture CubeTexture]的一个类。
+			内部使用[page:ImageLoader]来加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
 			[example:webgl_materials_cubemap materials / cubemap]<br />
@@ -40,63 +40,62 @@ scene.background = new THREE.CubeTextureLoader()
 			] );
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]。默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:String crossOrigin]</h3>
 		<p>
-		If set, assigns the [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
-	 attribute of the image to the value of *crossOrigin*,
-		prior to starting the load. Default is *"anonymous"*.
+            如果设置了，在开始加载前， 将为图片分配 [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
+            属性，其值为 *crossOrigin*， 默认为"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 files will be loaded. See [page:.setPath]. Default is *undefined*.</p>
+		<p>加载加载的文件的基本路径。 请参考[page:.setPath]。默认为*undefined*.</p>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String urls], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String urls] — array of 6 urls to images, one for each side of the CubeTexture.
-		The urls should be specified in the following order: pos-x, neg-x, pos-y, neg-y, pos-z, neg-z.
-		They can also be [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URIs].<br />
-		Note that, by convention, cube maps are specified in a coordinate system in which positive-x is to the right
-		when looking up the positive-z axis -- in other words, using a left-handed coordinate system.
-		Since three.js uses a right-handed coordinate system, environment maps used in three.js will have pos-x and neg-x swapped.<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Texture texture].<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:String urls] — 数组长度为6的图像数组，数组内容为URL，每一个URL用于CubeTexture的每一侧。
+		这些URL将被指定顺序: pos-x, neg-x, pos-y, neg-y, pos-z, neg-z.
+		数组内容也可以为 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URIs].<br />
+            请注意，一般来说，在立方体贴图坐标系中，当查找positive-z轴时，positive-x表示右侧
+             - 换句话说，此坐标系使用左手坐标系。
+		由于three.js使用右手坐标系， 环境贴图将在three.js进行pos-x和neg-x进行交互.<br />
+		[page:Function onLoad] —  加载完成时将调用。回调参数是已被加载的[page:Texture texture].<br />
+		[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例，
+            其中包含 [page:Integer total] 和 [page:Integer loaded] 字节。<br />
+		[page:Function onError] — 在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and pass the loaded [page:Texture texture] to onLoad.
+            从URL中进行加载，并将被加载的[page:Texture texture]传递给onLoad。
 		</p>
 
 		<h3>[method:null setCrossOrigin]( [param:String value] )</h3>
-		<p>		Set the [page:.crossOrigin] attribute.</p>
+		<p>		设置[page:.crossOrigin]的属性。</p>
 
 		<h3>[method:FileLoader setPath]( [param:String path] )</h3>
 		<p>
-			Set the base path or URL from which to load files. This can be useful if
-			you are loading many textures from the same directory.
+            设置加载文件的基本路径或URL。当加载同一目录中的许多模型，此方法将很有用。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/DataTextureLoader.html

@@ -11,52 +11,52 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		Abstract base class to load generic binary textures formats (rgbe, hdr, ...).
-		This uses the [page:FileLoader] internally for loading files, and creates a new
+            用于加载二进制文件格式的(rgbe, hdr, ...)的抽象类。
+		内部使用[page:FileLoader]来加载文件， 和创建一个新的
 		[page:DataTexture].
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 
 		<p>
-			See the [link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/RGBELoader.js RGBELoader]
-			for an example of a derived class.
+			请参考[link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/RGBELoader.js RGBELoader]
+			这个子类的例子。
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器所使用的[page:LoadingManager loadingManager]。
+		默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:LoadingManager manager]</h3>
 		<p>
-		The [page:LoadingManager loadingManager] the loader is using. Default is [page:DefaultLoadingManager].
+		加载器正在使用的[page:LoadingManager loadingManager]。默认为[page:DefaultLoadingManager].
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded texture.<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的纹理。<br />
+		[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
+		[page:Function onError] —在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and pass the loaded texture to onLoad.
+            从URL中进行加载，并将被加载的纹理传递给onLoad。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/FileLoader.html

@@ -12,11 +12,11 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A low level class for loading resources with XMLHttpRequest, used internaly by most loaders.
-			It can also be used directly to load any file type that does not have a loader.
+            使用XMLHttpRequest来加载资源的低级类，并由大多数加载器内部使用。
+            它也可以直接用于加载任何没有对应加载器的文件类型。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 		<p>
 			[example:webgl_loader_msgpack WebGL / loader / msgpack]<br />
 			[example:webgl_morphtargets_human WebGL / morphtargets / human]<br />
@@ -24,23 +24,23 @@
 		<code>
 		var loader = new THREE.FileLoader();
 
-		//load a text file and output the result to the console
+		//加载一个文本文件，并把结果输出到控制台上
 		loader.load(
 			// resource URL
 			'example.txt',
 
-			// onLoad callback
+			// onLoad回调
 			function ( data ) {
 				// output the text to the console
 				console.log( data )
 			},
 
-			// onProgress callback
+			// onProgress回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.error( 'An error happened' );
 			}
@@ -48,103 +48,102 @@
 		</code>
 
 		<p>
-			<em>Note:</em> The cache must be enabled using
+			<em>注意:</em>
+            必须启用缓存
 			<code>THREE.Cache.enabled = true;</code>
-			This is a global property and only needs to be set once to be used by all loaders that use FileLoader internally.
-			[page:Cache Cache] is a cache module that holds the response from each request made through this loader, so each file is requested once.
+            这是一个全局属性，只需要设置一次，供内部使用FileLoader的所有加载器使用。
+			[page:Cache Cache] 是​​一个缓存模块，用于保存通过此加载器发出的每个请求的响应，因此每个文件都会被请求一次。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<h3>[name] ( [param:LoadingManager manager] )</h3>
 		<p>
-			[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use.
-			Default is [page:DefaultLoadingManager].
+			[page:LoadingManager manager] — [page:LoadingManager loadingManager] 是加载器所使用的加载管理器。
+			默认为 [page:DefaultLoadingManager].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<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 mimeType]</h3>
 		<p>
-			The expected [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType].
-			See [page:.setMimeType]. Default is *undefined*.
+			详情 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType].
+			请参考 [page:.setMimeType]。默认为 *undefined*。
 		</p>
 
 		<h3>[property:String path]</h3>
-		<p>The base path from which files will be loaded. See [page:.setPath]. Default is *undefined*.</p>
+		<p>将要加载的文件的基本路径。请参考 [page:.setPath]。 默认为 *undefined*.</p>
 
 		<h3>[property:object requestHeader]</h3>
-		<p>The [link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header] used in HTTP request. See [page:.setRequestHeader]. Default is *undefined*.</p>
+		<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>The expected response type. See [page:.setResponseType]. Default is *undefined*.</p>
+		<p>请求的响应类型。 请参考 [page:.setResponseType]. 默认为 *undefined*.</p>
 
 		<h3>[property:String withCredentials]</h3>
 		<p>
-			Whether the XMLHttpRequest uses credentials. See [page:.setWithCredentials].
-			Default is *undefined*.
+            XMLHttpRequest是否使用证书。 请参考 [page:.setWithCredentials].
+            默认为 *undefined*.
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-			[page:String url] — the path or URL to the file. This can also be a
+			[page:String url] — 文件的URL或者路径，也可以为
 				[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-			[page:Function onLoad] (optional) — Will be called when loading completes. The argument will be the loaded response.<br />
-			[page:Function onProgress] (optional) — Will be called while load progresses. The argument will be the XMLHttpRequest instance,
-				which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-			[page:Function onError] (optional) — Will be called if an error occurs.<br /><br />
+			[page:Function onLoad] (可选) — 加载完成时将调用。回调参数将是加载的响应。<br />
+			[page:Function onProgress] (可选) — 将在加载过程中进行调用。参数将是XMLHttpRequest实例，
+            其中包含 [page:Integer total] 和 [page:Integer loaded] 字节<br />
+			[page:Function onError] (可选) — 在加载错误时被调用。<br /><br />
 
-			Load the URL and pass the response to the onLoad function.
+            加载URL并将响应传递给onLoad函数。
 		</p>
 
 		<h3>[method:FileLoader setMimeType]( [param:String mimeType] )</h3>
 		<p>
-			Set the expected [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType]
-			of the file being loaded. Note that in many cases this will be determined automatically, so by default it is *undefined*.
+            设置正在加载的文件预期类型 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType]
+            。请注意，在许多情况下，这将自动确定，因此默认情况下它是 *undefined* 。
 		</p>
 
 		<h3>[method:FileLoader setPath]( [param:String path] )</h3>
 		<p>
-			Set the base path or URL from which to load files. This can be useful if
-			you are loading many models from the same directory.
+            设置加载文件的基本路径或URL。当加载同一目录中的许多模型，此方法将很有用。
 		</p>
 
 		<h3>[method:FileLoader setRequestHeader]( [param:object requestHeader] )</h3>
 		<p>
-			[page:object requestHeader] - key: The name of the header whose value is to be set. value: The value to set as the body of the header.<br /><br />
+			[page:object requestHeader] - key: 要设置header的名称。 value：要设置header的值。<br /><br />
 
-			Set the [link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header] used in HTTP request.
+			请参考在HTTP 请求中的 [link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header]。
 		</p>
 
 		<h3>[method:FileLoader setResponseType]( [param:String responseType] )</h3>
 		<p>
-			Change the response type. Valid values are:<br />
-			[page:String text] or empty string (default) - returns the data as [page:String string].<br />
-			[page:String arraybuffer] - loads the data into a [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer ArrayBuffer] and returns that.<br />
-			[page:String blob] - returns the data as a [link:https://developer.mozilla.org/en/docs/Web/API/Blob Blob].<br />
-			[page:String document] - parses the file using the [link:https://developer.mozilla.org/en-US/docs/Web/API/DOMParser DOMParser].<br />
-			[page:String json] - parses the file using [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse JSON.parse].<br />
+			改变响应的类型，其类型有效值如下:<br />
+			[page:String text] 或者空 string (默认) - 返回的数据类型为 [page:String string].<br />
+			[page:String arraybuffer] - 加载的数据类型到一个数组buffer中 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer ArrayBuffer] 并进行返回。<br />
+			[page:String blob] - 返回的数据为 [link:https://developer.mozilla.org/en/docs/Web/API/Blob Blob]。<br />
+			[page:String document] - 使用 [link:https://developer.mozilla.org/en-US/docs/Web/API/DOMParser DOMParser] 解析文件。<br />
+			[page:String json] - 将文件解析为 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse JSON.parse].<br />
 		</p>
 
 		<h3>[method:FileLoader setWithCredentials]( [param:Boolean value] )</h3>
 		<p>
-			Whether the XMLHttpRequest uses credentials such as cookies, authorization headers or
-			TLS client certificates. See [link:https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials XMLHttpRequest.withCredentials].<br />
-			Note that this has no effect if you are loading files locally or from the same domain.
+            XMLHttpRequest是否使用cookie、授权头或TLS客户端证书等凭据。 请参考 [link:https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials XMLHttpRequest.withCredentials].<br />
+            请注意，当您在本地或从同一域加载文件，则该方法无效。
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/FontLoader.html

@@ -11,14 +11,13 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-		Class for loading a font in JSON format. Returns a [page:Font Font], which is an
-		array of [page:Shape Shape]s representing the font.
-		This uses the [page:FileLoader] internally for loading files. <br /><br />
+		使用JSON格式中加载字体的一个类。返回[page:Font Font], 返回值是表示字体的[page:Shape Shape]类型的数组。
+		其内部使用[page:FileLoader]来加载文件。 <br /><br />
 
-		You can convert fonts online using [link:https://gero3.github.io/facetype.js/ facetype.js]
+		你可以使用[link:https://gero3.github.io/facetype.js/ facetype.js]在线转换字体。
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 
 		<p>
 		[example:webgl_geometry_text_shapes geometry / text / shapes ]<br/>
@@ -28,71 +27,70 @@
 		<code>
 		var loader = new THREE.FontLoader();
 		var font = loader.load(
-			// resource URL
+			// 资源URL
 			'fonts/helvetiker_bold.typeface.json',
 
-			// onLoad callback
+			// onLoad回调
 			function ( font ) {
 				// do something with the font
 				scene.add( font );
 			},
 
-			// onProgress callback
+			// onProgress回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.log( 'An error happened' );
 			}
 		);
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
-		Creates a new [name].
+		[page:LoadingManager manager] — 加载器所使用的[page:LoadingManager loadingManager]。默认值为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
+		创建一个新的[name].
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<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 fonts will be loaded. See [page:.setPath]. Default is *undefined*.</p>
+		<p>所要加载字体的基本路径。 具体参考[page:.setPath]。 默认为*undefined*.</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Texture texture].<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br /><br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数是将要被加载的[page:Texture texture].<br />
+		[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
+		[page:Function onError] — 在加载错误时被调用。<br /><br />
 
-		Begin loading from url and pass the loaded [page:Texture texture] to onLoad.
+            从URL中进行加载，并将被加载的[page:Texture texture]传递给onLoad。
 		</p>
 
 		<h3>[method:Font parse]( [param:Object json] )</h3>
 		<p>
 		[page:Object json] — The <em>JSON</em> structure to parse.<br /><br />
-		Parse a <em>JSON</em> structure and return a [page:Font].
+		以<em>JSON</em>格式进行解析，并返回一个[page:Font].
 		</p>
 
 		<h3>[method:FontLoader setPath]( [param:String path] )</h3>
 		<p>
-			Set the base path or URL from which to load fonts. This can be useful if
-			you are loading many fonts from the same directory.
+            设置加载字体的基本路径或URL。当加载同一目录中下的许多字体时，此方法将很有用。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/ImageBitmapLoader.html

@@ -11,36 +11,36 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A loader for loading an [page:Image] as an [link:https://developer.mozilla.org/de/docs/Web/API/ImageBitmap ImageBitmap].
-			An ImageBitmap provides an asynchronous and resource efficient pathway to prepare textures for rendering in WebGL.<br/>
-			Unlike [page:FileLoader], [name] does not avoid multiple concurrent requests to the same URL.
+			一个把[page:Image]加载为[link:https://developer.mozilla.org/de/docs/Web/API/ImageBitmap ImageBitmap]的加载器。
+            ImageBitmap提供了一种异步且有效的资源的途径，用于在WebGL中渲染的纹理。<br/>
+			不像[page:FileLoader], [name]无需避免对同一的URL进行多次请求。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
 			[example:webgl_loader_imagebitmap WebGL / loader / ImageBitmap]
 		</p>
 
 		<code>
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.ImageBitmapLoader();
 
-		// load a image resource
+		// 加载一个图片资源
 		loader.load(
-			// resource URL
+			// 资源的URL
 			'textures/skyboxsun25degtest.png',
 
-			// onLoad callback
+			// onLoad回调
 			function ( imageBitmap ) {
 				var texture = new THREE.CanvasTexture( imageBitmap );
 				var material = new THREE.MeshBasicMaterial( { map: texture } );
 			},
 
-			// onProgress callback currently not supported
+			// 目前暂不支持onProgress的回调
 			undefined,
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.log( 'An error happened' );
 			}
@@ -48,58 +48,58 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]，默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<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 options]</h3>
-		<p>An optional object that sets options for the internally used [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap] factory method. Default is *undefined*.</p>
+		<p>一个可选对象，用来设置内部使用的[link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap]工厂方法，
+            默认为*undefined*.</p>
 
 		<h3>[property:String path]</h3>
-		<p>The base path from which files will be loaded. See [page:.setPath]. Default is *undefined*.</p>
+		<p>所要加载文件的基本路径。 请参考[page:.setPath]，默认为*undefined*。</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Image image].<br />
-		[page:Function onProgress] — This callback function is currently not supported.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的[page:Image image].<br />
+		[page:Function onProgress] — 此回调函数暂时不支持<br />
+		[page:Function onError] —  在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and return the [page:ImageBitmap image] object that will contain the data.
+            从URL中进行加载，并返回将包含数据的[page:ImageBitmap image]对象。
 		</p>
 
 		<h3>[method:ImageBitmapLoader setCrossOrigin]()</h3>
-		<p>This method exists for compatibility reasons and implements no logic. It ensures that [name] has a similar interface like [page:ImageLoader].</p>
+		<p>此方法出于兼容性原因而存在，并且不实现逻辑。它确保[name]具有[page:ImageLoader]的类似接口。</p>
 
 		<h3>[method:ImageBitmapLoader setOptions]( [param:Object options] )</h3>
 		<p>
-			Sets the options object for [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap].
+			设置[link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap]的选项对象。
 		</p>
 
 		<h3>[method:ImageBitmapLoader setPath]( [param:String path] )</h3>
 		<p>
-			Sets the base path or URL from which to load files. This can be useful if
-			you are loading many images from the same directory.
+            设置加载文件的基本路径或URL。当加载同一目录中下的许多图片时，此方法将很有用。
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/ImageLoader.html

@@ -11,12 +11,12 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A loader for loading an [page:Image].
-			This uses the [page:FileLoader] internally for loading files, and is used internally by the
-			[page:CubeTextureLoader], [page:ObjectLoader] and [page:TextureLoader].
+			用来加载一个[page:Image]的加载器。
+			内部使用[page:FileLoader]来加载文件，并被
+			[page:CubeTextureLoader]、[page:ObjectLoader]、[page:TextureLoader]所使用。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
 			[example:webgl_loader_obj WebGL / loader / obj]<br />
@@ -24,15 +24,15 @@
 		</p>
 
 		<code>
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.ImageLoader();
 
-		// load a image resource
+		// 加载一个图片资源
 		loader.load(
-			// resource URL
+			// 资源URL
 			'textures/skyboxsun25degtest.png',
 
-			// onLoad callback
+			// onLoad回调
 			function ( image ) {
 				// use the image, e.g. draw part of it on a canvas
 				var canvas = document.createElement( 'canvas' );
@@ -40,10 +40,10 @@
 				context.drawImage( image, 100, 100 );
 			},
 
-			// onProgress callback currently not supported
+			// 目前暂不支持onProgress的回调
 			undefined,
 
-			// onError callback
+			// onError回调
 			function () {
 				console.error( 'An error happened.' );
 			}
@@ -51,59 +51,58 @@
 		</code>
 
 		<p>
-		Please note three.js r84 dropped support for ImageLoader progress events. For an ImageLoader
-		that supports progress events, see [link:https://github.com/mrdoob/three.js/issues/10439#issuecomment-275785639 this thread].
+		请注意three.js r84遗弃了ImageLoader进度事件. 对于支持进度事件的ImageLoader
+		请参考[link:https://github.com/mrdoob/three.js/issues/10439#issuecomment-275785639 this thread].
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造方法</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]，默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:String crossOrigin]</h3>
 		<p>
-		If set, assigns the [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
-	 attribute of the image to the value of *crossOrigin*, prior to starting the load. Default is *"anonymous"*.
+            如果设置了，在开始加载前， 将为图片分配 [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
+            属性，其值为 *crossOrigin*, 默认为"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 files will be loaded. See [page:.setPath]. Default is *undefined*.</p>
+		<p>所要加载文件的基本路径。 请参考[page:.setPath]，默认为*undefined*。</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Image image].<br />
-		[page:Function onProgress] — This callback function is currently not supported.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] —加载完成时将调用。回调参数为将要加载的[page:Image image]。<br />
+		[page:Function onProgress] — 此回调函数暂时不支持。<br />
+		[page:Function onError] — 在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and return the [page:Image image] object that will contain the data.
+            从URL中进行加载，并返回将包含数据的[page:Image image]对象。
 		</p>
 
 		<h3>[method:null setCrossOrigin]( [param:String value] )</h3>
-		<p>Set the [page:.crossOrigin] attribute.</p>
+		<p>设置[page:.crossOrigin]的属性。</p>
 
 		<h3>[method:FileLoader setPath]( [param:String path] )</h3>
 		<p>
-			Set the base path or URL from which to load files. This can be useful if
-			you are loading many images from the same directory.
+            设置加载文件的基本路径或URL。当加载同一目录中下的许多图片时，此方法将很有用。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/JSONLoader.html

@@ -11,11 +11,11 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A loader for loading objects in JSON format.
-			This uses the [page:FileLoader] internally for loading files.
+            以JSON格式来加载对象的加载器。
+			此加载器内部用 [page:FileLoader] 来加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
 		[example:webgl_loader_json WebGL / loader / json]<br />
@@ -23,96 +23,96 @@
 		</p>
 
 		<code>
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.JSONLoader();
 
-		// load a resource
+		// 加载一个资源
 		loader.load(
-			// resource URL
+			// 资源URL
 			'models/animated/monster/monster.js',
 
-			// onLoad callback
+			// onLoad的回调
 			function ( geometry, materials ) {
 				var material = materials[ 0 ];
 				var object = new THREE.Mesh( geometry, material );
 				scene.add( object );
 			},
 
-			// onProgress callback
+			// onProgress的回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError的回调
 			function( err ) {
 				console.log( 'An error happened' );
 			}
 		);
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:String crossOrigin]</h3>
 		<p>
-		If set, assigns the [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
-	 attribute of the image to the value of *crossOrigin*, prior to starting the load. Default is *"anonymous"*.
+		如果设置了，在开始加载前， 将为图片分配 [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
+	 属性，其值为 *crossOrigin*，默认为"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 withCredentials]</h3>
 		<p>
-			Whether the XMLHttpRequest uses credentials.
-			Default is *false*.
+            XMLHttpRequest请求是否使用了证书。
+			默认为 *false*.
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI]..<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded text response.<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数将是加载的响应。<br />
+		[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例，
+            其中包含 [page:Integer total] 和 [page:Integer loaded] 字节。<br />
+		[page:Function onError] — 在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and pass the <em>JSON</em> to onLoad.
+		从URL中进行加载并将 <em>JSON</em> 传递给 onLoad。
 		</p>
 
 		<h3>[method:JSONLoader setCrossOrigin]( [param:String value] )</h3>
 		<p>
-			Set the [page:.crossOrigin] attribute.
+			设置 [page:.crossOrigin] 的属性。
 		</p>
 
 		<h3>[method:JSONLoader setTexturePath]( [param:String texturePath] )</h3>
 		<p>
-			Set the base path or URL from which to load files. This can be useful if
-			you are loading many files from the same directory.
+            设置加载文件的基本路径或URL。当加载同一目录中的许多模型，此方法将很有用。
 		</p>
 
 		<h3>[method:Object3D parse]( [param:Object json], [param:String texturePath] )</h3>
 		<p>
-		[page:String json] — JSON object to parse.<br />
-		[page:String texturePath] — Base path for textures.<br /><br />
+		[page:String json] — 需要解析的JSON对象。<br />
+		[page:String texturePath] — 纹理的基本路径。<br /><br />
 
-		Parse a <em>JSON</em> structure and return an [page:object] containing the parsed [page:Geometry geometry] and [page:Array materials].
+		解析要给 <em>JSON</em> 结构并返回 [page:object] 包含 [page:Geometry geometry] 和 [page:Array materials] 的对象.
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/Loader.html

@@ -10,56 +10,55 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">Base class for implementing loaders.</p>
+		<p class="desc">所有加载器的基类</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造方法</h2>
 
 
 		<h3>[name]()</h3>
 		<p>
-		Creates a new [name]. This should be called as base class.
+		当创建一个新的 [name]， 将调用此基类。
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Function onLoadStart]</h3>
-		<p>Will be called when load starts.</p>
-		<p>The default is a function with empty body.</p>
+		<p>当加载开始时，将被调用。</p>
+		<p>默认实现是一个空函数体。</p>
 
 		<h3>[property:Function onLoadProgress]</h3>
-		<p>Will be called while load progresses.</p>
-		<p>The default is a function with empty body.</p>
+		<p>当进入加载流程中，将被调用。</p>
+		<p>默认实现是一个空函数体。</p>
 
 		<h3>[property:Function onLoadComplete]</h3>
-		<p>Will be called when load completes.</p>
-		<p>The default is a function with empty body.</p>
+		<p>当加载完成时，将被调用。</p>
+		<p>默认实现是一个空函数体。</p>
 
 		<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"*.
+            跨域字符串，用于实现跨域，以便从允许CORS从其他域加载url。默认为"anonymous"。
 		</p>
 
 		<h2>Methods</h2>
 
 		<h3>[method:Material createMaterial]( [param:object m], [param:string texturePath] )</h3>
 		<p>
-		[page:Object m] — The parameters to create the material. <br />
-		[page:String texturePath] — The base path of the textures.
+		[page:Object m] — 所要创建的材质的参数。 <br />
+		[page:String texturePath] — 纹理加载路径。
 		</p>
 		<p>
-		Creates the Material based on the parameters m.
+		基于参数m来创建材质。
 		</p>
 
 		<h3>[method:Array initMaterials]( [param:Array materials], [param:string texturePath] )</h3>
 		<p>
-		[page:Array materials] — an array of parameters to create materials. <br />
-		[page:String texturePath] —  The base path of the textures.
+		[page:Array materials] — 用于创建材质的参数数组。 <br />
+		[page:String texturePath] —  纹理加载路径。
 		</p>
 		<p>
-		Creates an array of [page:Material] based on the array of parameters m. The index of the parameters decide the correct index of the materials.
+		基于参数数组m,来创建 [page:Material] 数组. 参数索引与材质的索引一致。
 		</p>
 
 

docs/api/zh/loaders/LoaderUtils.html

@@ -10,28 +10,28 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">An object with several loader utility functions.</p>
+		<p class="desc">具有多个实用的加载器函数功能的对象</p>
 
-		<h2>Functions</h2>
+		<h2>函数</h2>
 
 		<h3>[method:String decodeText]( [param:TypedArray array] )</h3>
 		<p>
-		[page:TypedArray array] —  A stream of bytes as a typed array.
+		[page:TypedArray array] — 作为类型化数组的字节流
 		</p>
 		<p>
-		The function takes a stream of bytes as input and returns a string representation.
+            该函数将字节流作为输入并返回字符串作为表示。
 		</p>
 
 		<h3>[method:String extractUrlBase]( [param:string url] )</h3>
 		<p>
-		[page:String url] —  The url to extract the base url from.
+		[page:String url] — 从基本URL中，进行提取的URL。
 		</p>
 		<p>
-		Extract the base from the URL.
+		从URL中提取基本信息。
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/MaterialLoader.html

@@ -11,33 +11,33 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A loader for loading a [page:Material] in JSON format.
-			This uses the [page:FileLoader] internally for loading files.
+			以JSON格式来加载[page:Material]的加载器。
+			默认使用[page:FileLoader]进行加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 
 		<code>
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.MaterialLoader();
 
-		// load a resource
+		// 加载资源
 		loader.load(
-			// resource URL
+			// 资源URL
 			'path/to/material.json',
 
-			// onLoad callback
+			// onLoad回调
 			function ( material ) {
 				object.material = material;
 			},
 
-			// onProgress callback
+			// onProgress回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.log( 'An error happened' );
 			}
@@ -45,53 +45,53 @@
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
-		Creates a new [name].
+		[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]，默认为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
+		创建要给新的[name].
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<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:Object textures]</h3>
-		<p>Object holding any textures used by the material. See [page:.setTextures].</p>
+		<p>持有材质的任何纹理的对象，请参考 [page:.setTextures].</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Material].<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the progress event.<br />
-		[page:Function onError] — Will be called when load errors.<br /><br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的[page:Material]。<br />
+		[page:Function onProgress] — 将在加载过程中进行调用，参数为进度事件。<br />
+		[page:Function onError] — 在加载错误时被调用。<br /><br />
 
-		Begin loading from url and return the [page:Material] object that will contain the data.
+            从URL中进行加载，并返回将包含数据的[page:Material]对象。
 		</p>
 
 		<h3>[method:Material parse]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — The json object containing the parameters of the Material.<br /><br />
+		[page:Object json] — JSON对象包含材质参数。<br /><br />
 
-		Parse a <em>JSON</em> structure and create a new [page:Material] of the type [page:String json.type] with parameters defined in the json object.
+		解析<em>JSON</em>结构，以json对象的参数中的[page:String json.type]类型，创建一个新的[page:Material]。
 		</p>
 
 		<h3>[method:null setTextures]( [param:Object textures] )</h3>
 		<p>
-		[page:Object textures] — object containing any textures used by the material.
+		[page:Object textures] — 对象包含任何被材质所使用的纹理。
 		</p>
 
 
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/ObjectLoader.html

@@ -11,15 +11,15 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A loader for loading a JSON resource. Unlike the [page:JSONLoader], this one make use of the
-			<em>.type</em> attributes of objects to map them to their original classes.<br /><br />
+			一个用来加载JSON资源的加载器。 不像[page:JSONLoader]，这个加载器使用
+			<em>.type</em>对象属性，来映射它自己到源类。<br /><br />
 
-			Note that this loader can't load [page:Geometries]. Use [page:JSONLoader] instead for that.<br /><br />
+			请注意这个加载器不能用来加载[page:Geometries]，而是用[page:JSONLoader]进行加载。<br /><br />
 
-			This uses the [page:FileLoader] internally for loading files.
+			此加载器内部使用[page:FileLoader]进行加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
 
@@ -32,29 +32,29 @@
 		var loader = new THREE.ObjectLoader();
 
 		loader.load(
-			// resource URL
+			// 资源的URL
 			"models/json/example.json",
 
-			// onLoad callback
+			// onLoad回调
 			// Here the loaded data is assumed to be an object
 			function ( obj ) {
 				// Add the loaded object to the scene
 				scene.add( obj );
 			},
 
-			// onProgress callback
+			// onProgress回调
 			function ( xhr ) {
 				console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
 			},
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.error( 'An error happened' );
 			}
 		);
 
 
-		// Alternatively, to parse a previously loaded JSON structure
+		// 或者，解析先前加载的JSON结构
 		var object = loader.parse( a_json_object );
 
 		scene.add( object );
@@ -62,102 +62,100 @@
 
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器所使用的[page:LoadingManager loadingManager]，默认值为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:String crossOrigin]</h3>
 		<p>
-		If set, assigns the [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
-	 attribute of the image to the value of *crossOrigin*, prior to starting the load. Default is *"anonymous"*.
+            如果设置了，在开始加载前， 将为图片分配 [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
+            属性，其值为 *crossOrigin*, 默认为"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 texturePath]</h3>
 		<p>
-			The base path or URL from which textures will be loaded. See [page:.setTexturePath].
-			Default is the empty string.
+			将要被加载的纹理的路径或者URL，详情请参考[page:.setTexturePath]。
+			默认值为空字符串。
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Object3D object].<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的[page:Object3D object].<br />
+		[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
+		[page:Function onError] — 在加载错误时被调用。<br />
 		</p>
 		<p>
-		Begin loading from url and call onLoad with the parsed response content.
+            从URL中进行加载，并将被解析的响应内容传递给onLoad。
 		</p>
 
 
 		<h3>[method:Object3D parse]( [param:Object json], [param:Function onLoad]  )</h3>
 		<p>
-		[page:Object json] — required. The JSON source to parse.<br /><br />
-		[page:Function onLoad] — Will be called when parsed completes. The argument will be the parsed [page:Object3D object].<br /><br />
+		[page:Object json] — 必选参数，需要被解析的JSON源。<br /><br />
+		[page:Function onLoad] — 当解析完成时被调用，其中参数被解析为[page:Object3D object].<br /><br />
 
-		Parse a <em>JSON</em> structure and return a threejs object.
-		This is used internally by [page:.load], but can also be used directly to parse
-		a previously loaded JSON structure.
+            解析一个<em>JSON</em>结构，并返回一个threejs对象.
+		内部使用[page:.load]进行加载, 但也可以直接用于解析先前加载的JSON结构。
 		</p>
 
 		<h3>[method:Object3D parseGeometries]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — required. The JSON source to parse.<br /><br />
+		[page:Object json] — 必选参数，需要被解析的JSON源。<br /><br />
 
-		This is used [page:.parse] to parse any [page:Geometry geometries] or [page:BufferGeometry buffer geometries]  in the JSON structure.
-		Internally it uses [page:JSONLoader] for geometries and [page:BufferGeometryLoader] for buffer geometries.
+            此函数以JSON结构，用[page:.parse]去解析[page:Geometry geometries]或[page:BufferGeometry buffer geometries]。
+            在内部，它使用JSONLoader作为几何加载器，使用BufferGeometryLoader作为几何缓冲区加载器。
 		</p>
 
 		<h3>[method:Object3D parseMaterials]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — required. The JSON source to parse.<br /><br />
+		[page:Object json] —  必选参数，需要被解析的JSON源。<br /><br />
 
-		This is used [page:.parse] to parse any materials in the JSON structure using [page:MaterialLoader].
+		此函数通过[page:.parse]来使用[page:MaterialLoader]，以解析JSON结构中任意材质。
 		</p>
 
 		<h3>[method:Object3D parseAnimations]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — required. The JSON source to parse.<br /><br />
+		[page:Object json] —  必选参数，需要被解析的JSON源。<br /><br />
 
-		This is used [page:.parse] to parse any animations in the JSON structure, using [page:AnimationClip.parse].
-		</p>
+		此函数通过[page:.parse]来使用[page:AnimationClip.parse]， 以解析JSON结构中任意动画。
+        </p>
 
 		<h3>[method:Object3D parseImages]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — required. The JSON source to parse.<br /><br />
+		[page:Object json] —  必选参数，需要被解析的JSON源。<br /><br />
 
-		This is used [page:.parse] to parse any images in the JSON structure, using [page:ImageLoader].
+            此函数通过[page:.parse]来使用[page:ImageLoader]， 以解析JSON结构中任意图片。
 		</p>
 
 		<h3>[method:Object3D parseTextures]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — required. The JSON source to parse.<br /><br />
-
-		This is used [page:.parse] to parse any textures in the JSON structure.
+		[page:Object json] —  必选参数，需要被解析的JSON源。<br /><br />
+            此函数通过[page:.parse]来解析JSON结构中任意纹理。
 		</p>
 
 		<h3>[method:Object3D parseObject]( [param:Object json] )</h3>
 		<p>
-		[page:Object json] — required. The JSON source to parse.<br /><br />
+		[page:Object json] —  必选参数，需要被解析的JSON源。<br /><br />
 
-		This is used [page:.parse] to parse any objects in the JSON structure.
-		Objects can be of the following types:
+            此函数通过[page:.parse]来解析JSON结构中任意对象。
+		对象可以为如下类型：
 
 		<ul>
 			<li>
@@ -214,17 +212,17 @@
 
 		<h3>[method:ObjectLoader setCrossOrigin]( [param:String value] )</h3>
 		<p>
-		[page:String value] — The crossOrigin string to implement CORS for loading the url from a different domain that allows CORS.
+		[page:String value] — 在允许CROS时，跨域字段通过实现CORS来加载不同域下的URL。
 		</p>
 
 		<h3>[method:ObjectLoader setTexturePath]( [param:String value] )</h3>
 		<p>
-		[page:String value] — The base path or URL from which textures will be loaded.<br /><br />
+		[page:String value] — 设置将要加载为纹理的路径或者URL<br /><br />
 
 
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/TextureLoader.html

@@ -11,16 +11,16 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Class for loading a [page:Texture texture].
-			This uses the [page:ImageLoader] internally for loading files.
+			加载[page:Texture texture]的一个类。
+			内部使用[page:ImageLoader]来加载文件。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<code>
 		var texture = new THREE.TextureLoader().load( 'textures/land_ocean_ice_cloud_2048.jpg' );
 
-		// immediately use the texture for material creation
+		// 立即使用纹理进行材质创建
 		var material = new THREE.MeshBasicMaterial( { map: texture } );
 		</code>
 
@@ -29,15 +29,15 @@
 		<h2>Example with Callbacks</h2>
 
 		<code>
-		// instantiate a loader
+		// 初始化一个加载器
 		var loader = new THREE.TextureLoader();
 
-		// load a resource
+		// 加载一个资源
 		loader.load(
-			// resource URL
+			// 资源URL
 			'textures/land_ocean_ice_cloud_2048.jpg',
 
-			// onLoad callback
+			// onLoad回调
 			function ( texture ) {
 				// in this example we create the material when the texture is loaded
 				var material = new THREE.MeshBasicMaterial( {
@@ -45,71 +45,70 @@
 				 } );
 			},
 
-			// onProgress callback currently not supported
+			// 目前暂不支持onProgress的回调
 			undefined,
 
-			// onError callback
+			// onError回调
 			function ( err ) {
 				console.error( 'An error happened.' );
 			}
 		);
 		</code>
+        请注意three.js r84遗弃了TextureLoader进度事件。对于支持进度事件的TextureLoader ，
+        请参考[link:https://github.com/mrdoob/three.js/issues/10439#issuecomment-293260145 this thread]。
 
-		Please note three.js r84 dropped support for TextureLoader progress events. For a TextureLoader that supports progress events, see [link:https://github.com/mrdoob/three.js/issues/10439#issuecomment-293260145 this thread].
-
-		<h2>Constructor</h2>
+		<h2>构造函数</h2>
 
 		<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].<br /><br />
+		[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]，默认值为[page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-		Creates a new [name].
+		创建一个新的[name].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:String crossOrigin]</h3>
 		<p>
-		If set, assigns the [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
-	 attribute of the image to the value of *crossOrigin*, prior to starting the load. Default is *"anonymous"*.
+            如果设置了，在开始加载前， 将为图片分配 [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin]
+            属性，其值为 *crossOrigin*, 默认为"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 files will be loaded. See [page:.setPath]. Default is *undefined*.</p>
+		<p>被加载文件的基本路径，请参考[page:.setPath]。默认值为*undefined*.</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:Texture load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:String url] — the path or URL to the file. This can also be a
+		[page:String url] — 文件的URL或者路径，也可以为
 			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Texture texture].<br />
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.<br />
-		[page:Function onError] — Will be called when load errors.<br /><br />
+		[page:Function onLoad] — 加载完成时将调用。回调参数为将要加载的[page:Texture texture].<br />
+		[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含[page:Integer total]和[page:Integer loaded]字节。<br />
+		[page:Function onError] — 在加载错误时被调用。<br /><br />
 
-		Begin loading from the given URL and pass the fully loaded [page:Texture texture] to onLoad. The method also returns a new texture object which can directly be used for material creation.
-		If you do it this way, the texture may pop up in your scene once the respective loading process is finished.
+            从给定的URL开始加载并将完全加载的[page:Texture texture]传递给onLoad。该方法还返回一个新的纹理对象，该纹理对象可以直接用于材质创建。
+            如果采用此方法，一旦相应的加载过程完成，纹理可能会在场景中出现。
 		</p>
 
 		<h3>[method:null setCrossOrigin]( [param:String value] )</h3>
-		<p>Set the [page:.crossOrigin] attribute.</p>
+		<p>设置[page:.crossOrigin]的属性。</p>
 
 		<h3>[method:FileLoader setPath]( [param:String path] )</h3>
 		<p>
-			Set the base path or URL from which to load files. This can be useful if
-			you are loading many models from the same directory.
+            设置加载文件的基本路径或URL。当加载同一目录中的许多模型，此方法将很有用。
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/loaders/managers/DefaultLoadingManager.html

@@ -10,23 +10,20 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">A global instance of the [page:LoadingManager LoadingManager], used by most loaders
-			when no custom manager has been specified.<br /><br />
+		<p class="desc">[page:LoadingManager LoadingManager]是一个全局实例, 当其他加载器没有指定加载管理器时，它将被其他大多数的加载器设为默认的加载管理器。<br /><br />
 
-		  This will be sufficient for most purposes, however there may be times when you desire seperate loading managers
-			for say, textures and models.
+
+            LoadingManager对于大多数加载器来说已经足够了，但有时您可能需要单独设置加载管理器，例如纹理、模型加载器。
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
-			You can optionally set the [page:LoadingManager.onStart onStart], [page:LoadingManager.onLoad onLoad],
-			[page:LoadingManager.onProgress onProgress], [page:LoadingManager.onStart onError] functions for the manager.
-			These will then apply to any loaders using the DefaultLoadingManager.<br /><br />
+			你可以选择性的为你的管理器设置 [page:LoadingManager.onStart onStart], [page:LoadingManager.onLoad onLoad],
+			[page:LoadingManager.onProgress onProgress], [page:LoadingManager.onStart onError] 这些方法。
+			当你的加载器使用默认加载管理器时，这些方法都将被应用到加载器上。<br /><br />
 
-			Note that these shouldn't be confused with the similarly named functions of individual loaders,
-			as they are intended for displaying information about the overall status of loading,
-			rather than dealing with the data that has been loaded.
+            请注意，个人的加载器的不应具有类似上面类似的命名函数，以避免混淆。因为这些函数时用于显示有关加载总体状态的信息，而不是处理已加载的数据。
 		</p>
 		<code>
 THREE.DefaultLoadingManager.onStart = function ( url, itemsLoaded, itemsTotal ) {
@@ -56,15 +53,15 @@ THREE.DefaultLoadingManager.onError = function ( url ) {
 		</code>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
-		<p>See the [page:LoadingManager LoadingManager] page for details of properties.</p>
+		<p>有关LoadingManager属性的详细信息，请查看[page:LoadingManager LoadingManager] 页面。</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
-		<p>See the [page:LoadingManager LoadingManager] page for details of methods.</p>
+		<p>有关LoadingManager方法的详细信息，请查看[page:LoadingManager LoadingManager] 页面。</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/loaders/LoadingManager.js src/loaders/LoadingManager.js]
 	</body>

docs/api/zh/loaders/managers/LoadingManager.html

@@ -11,16 +11,16 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Handles and keeps track of loaded and pending data. A default global instance of this class
-			is created and used by loaders if not supplied manually - see [page:DefaultLoadingManager].<br /><br />
 
-			In general that should be sufficient, however there are times when it can be useful to have seperate loaders -
-			for example if you want to show seperate loading bars for objects and textures.
+            其功能时处理并跟踪已加载和待处理的数据。如果未手动设置加强管理器，则会为加载器创建和使用默认全局实例加载器管理器
+            - 请参阅 [page:DefaultLoadingManager].<br /><br />
+
+            一般来说，默认的加载管理器已足够使用了，但有时候也需要设置单独的加载器 - 例如，如果你想为对象和纹理显示单独的加载条。
 
 		</p>
 
 
-		<h2>Example</h2>
+		<h2>例子</h2>
 
 		<p>
 			[example:webgl_loader_babylon WebGL / loader / babylon]<br />
@@ -32,8 +32,7 @@
 		</p>
 
 		<p>
-			This example shows how to use LoadingManager to track the progress of
-			[page:OBJLoader].
+			下面的例子将介绍，如何使用加载管理器来跟踪 [page:OBJLoader] 的加载进度流程。
 		</p>
 
 		<code>
@@ -72,19 +71,18 @@
 		</code>
 
 		<p>
-			In addition to observing progress, a LoadingManager can be used to
-			override resource URLs during loading. This may be helpful for assets
-			coming from drag-and-drop events, WebSockets, WebRTC, or other APIs. An
-			example showing how to load an in-memory model using Blob URLs is below.
+
+            除了观察进度流程之外，还可以使用LoadingManager在加载期间覆写资源URL。当某资源来自拖拽事件、
+            WebSockets、WebRTC或其他API时，此方法可以有所帮助。下面显示了如何使用Blob URL加载内存模型的示例。
 		</p>
 
 		<code>
-		// Blob or File objects created when dragging files into the webpage.
+		// 将文件拖入网页时创建的Blob或File对象。
 		var blobs = {'fish.gltf': blob1, 'diffuse.png': blob2, 'normal.png': blob3};
 
 		var manager = new THREE.LoadingManager();
 
-		// Initialize loading manager with URL callback.
+		// 使用URL回调初始化加载管理器。
 		var objectURLs = [];
 		manager.setURLModifier( ( url ) => {
 
@@ -96,7 +94,7 @@
 
 		} );
 
-		// Load as usual, then revoke the blob URLs.
+		// 像通常一样加载，然后撤消blob URL
 		var loader = new THREE.GLTFLoader( manager );
 		loader.load( 'fish.gltf', (gltf) => {
 
@@ -107,75 +105,73 @@
 		});
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造方法</h2>
 
 		<h3>[name]( [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
 		<p>
-		[page:Function onLoad] — (optional) this function will be called when all loaders are done.<br />
-		[page:Function onProgress] — (optional) this function will be called when an item is complete.<br />
-		[page:Function onError] — (optional) this function will be called a loader encounters errors. <br />
+		[page:Function onLoad] — (可选) 所有加载器加载完成后，将调用此函数。<br />
+		[page:Function onProgress] — (可选) 当每个项目完成后，将调用此函数。<br />
+		[page:Function onError] — (可选) 当一个加载器遇到错误时，将调用此函数。 <br />
 
-		Creates a new [name].
+		创建一个新的 [name].
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Function onStart]</h3>
 		<p>
-			This function will be called when loading starts.
-			The arguments are:<br />
-			[page:String url] — The url of the item just loaded.<br />
-			[page:Integer itemsLoaded] — the number  of items already loaded so far.<br />
-			[page:Iteger itemsTotal] — the total amount of items to be loaded.<br /><br />
+			此换上咋加载开始时，被调用.
+			有如下参数:<br />
+			[page:String url] — 被加载的项的url。<br />
+			[page:Integer itemsLoaded] — 目前已加载项的个数。<br />
+			[page:Iteger itemsTotal] — 总共所需要加载项的个数。<br /><br />
 
-			By default this is undefined.
+			此方法默认时未定义。
 		</p>
 
 		<h3>[property:Function onLoad]</h3>
 		<p>
-			This function will be called when all loading is completed. By default this is undefined,
-			unless passed in the constructor.
+            所有的项加载完成后将调用此函数。默认情况下，此方法时未定义的，除非在构造函数中进行传递。
 		</p>
 
 		<h3>[property:Function onProgress]</h3>
 		<p>
-		This function will be called when an item is complete.
-		The arguments are:<br />
-		[page:String url] — The url of the item just loaded.<br />
-		[page:Integer itemsLoaded] — the number  of items already loaded so far.<br />
-		[page:Iteger itemsTotal] — the total amount of items to be loaded.<br /><br />
+		    此方法加载每一个项，加载完成时进行调用。
+            有如下参数:<br />
+		[page:String url] — 被加载的项的url。<br />
+		[page:Integer itemsLoaded] — 目前已加载项的个数。<br />
+		[page:Iteger itemsTotal] — 总共所需要加载项的个数。<br /><br />
 
-		By default this is undefined, unless passed in the constructor.
+            默认情况下，此方法时未定义的，除非在构造函数中进行传递。
 		</p>
 
 		<h3>[property:Function onError]</h3>
 		<p>
-			This function will be called when any item errors, with the argument:<br />
-			[page:String url] — The url of the item that errored.<br /><br />
+            此方法将在任意项加载错误时，进行调用。
+            有如下参数:<br />
+			[page:String url] — 所加载出错误的项的url<br /><br />
 
-			By default this is undefined, unless passed in the constructor.
+            默认情况下，此方法时未定义的，除非在构造函数中进行传递。
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null setURLModifier]( [param:Function callback] )</h3>
 		<p>
-		[page:Function callback] — URL modifier callback. Called with [page:String url] argument, and
-		must return [page:String resolvedURL].<br /><br />
+		[page:Function callback] —
+            设置URL修饰符成功时回调。使用url参数进行回调，并且必须返回 [page:String resolvedURL] 。<br /><br />
 
-		If provided, the callback will be passed each resource URL before a request is sent. The
-		callback may return the original URL, or a new URL to override loading behavior. This
-		behavior can be used to load assets from .ZIP files, drag-and-drop APIs, and Data URIs.
+            如果设置了回调，则在发送请求之前将向每个资源URL传递回调。回调可以返回最初的URL，也可以返回新URL以覆盖加载行为。
+            此行为可用于从.ZIP、拖拽API和数据URI中加载资源文件。
 		</p>
 
 		<h3>[method:String resolveURL]( [param:String url] )</h3>
 		<p>
-		[page:String url] — the url to load<br /><br />
+		[page:String url] — 所要加载的url<br /><br />
 
-		Given a URL, uses the URL modifier callback (if any) and returns a resolved URL. If no
-		URL modifier is set, returns the original URL.
+            给定URL，使用URL修饰符回调（如果有）并返回已解析的URL。如果未设置URL修饰符，则返回原始URL。
 		</p>
 
 		<br /><br />
@@ -186,27 +182,27 @@
 
 		<h3>[method:null itemStart]( [param:String url] )</h3>
 		<p>
-		[page:String url] — the url to load<br /><br />
+		[page:String url] — 所要加载的url<br /><br />
 
-		This should be called by any loader using the manager when the loader starts loading an url.
+           任何使用管理器的加载器都会调用此方法， 当加载器需要开始加载URL时。
 		</p>
 
 		<h3>[method:null itemEnd]( [param:String url] )</h3>
 		<p>
-		[page:String url] — the loaded url<br /><br />
+		[page:String url] — 所要加载的url<br /><br />
 
-		This should be called by any loader using the manager when the loader ended loading an url.
+            任何使用管理器的加载器都会调用此方法， 当加载器需要加载URL结束时。
 		</p>
 
 
 		<h3>[method:null itemError]( [param:String url] )</h3>
 		<p>
-		[page:String url] — the loaded url<br /><br />
+		[page:String url] — 所要加载的url<br /><br />
 
-		This should be called by any loader using the manager when the loader errors loading an url.
+            任何使用管理器的加载器都会调用此方法， 当加载器出现加载错误时。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/loaders/LoadingManager.js src/loaders/LoadingManager.js]
 	</body>

docs/api/zh/materials/LineBasicMaterial.html

@@ -10,11 +10,11 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>基础线条材质（[name]）</h1>
 
-		<p class="desc">A material for drawing wireframe-style geometries.</p>
+			<p class="desc">一种用于绘制线框样式几何体的材质。</p>
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 
 		<p>
 			[example:webgl_buffergeometry_drawcalls WebGL / buffergeometry / drawcalls]<br />
@@ -43,65 +43,52 @@ var material = new THREE.LineBasicMaterial( {
 } );
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
 
 		<p>
-		[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-		Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
-
-		The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-		string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
+		属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff).</p>
+		<p>材质的颜色([page:Color])，默认值为白色 (0xffffff)。</p>
 
 		<h3>[property:Boolean isLineBasicMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are line basic materials. Default is *true*.<br /><br />
-
-			You should not change this, as it used internally for optimisation.
+		<p>用于检查此类或派生类是否为基础线条材质。默认值为 *true*。<br /><br />
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *false*.</p>
+		<p>材质是否受到光照的影响。默认值为 *false*。</p>
 
 		<h3>[property:Float linewidth]</h3>
-		<p>
-			Controls line thickness. Default is *1*.<br /><br />
-
-			Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-			with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-			always be 1 regardless of the set value.
+		<p> 控制线宽。默认值为 *1*。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与
+			大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
 		<h3>[property:String linecap]</h3>
-		<p>
-			Define appearance of line ends. Possible values are 'butt', 'round' and 'square'.
-			Default is 'round'.<br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineCap 2D Canvas lineCap]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+		<p> 定义线两端的样式。可选值为 'butt', 'round' 和 'square'。默认值为 'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineCap 2D Canvas lineCap]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:String linejoin]</h3>
-		<p>
-			Define appearance of line joints. Possible values are 'round', 'bevel' and 'miter'. Default is 'round'. <br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+		<p> 定义线连接节点的样式。可选值为 'round', 'bevel' 和 'miter'。默认值为 'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/LineDashedMaterial.html

@@ -10,11 +10,11 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>虚线材质([name])</h1>
 
-		<p class="desc">A material for drawing wireframe-style geometries with dashed lines.</p>
+		<p class="desc">一种用于绘制虚线样式几何体的材质。</p>
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 
 		<p>
 			[example:webgl_lines_dashed WebGL / lines / dashed]<br />
@@ -31,59 +31,54 @@ var material = new THREE.LineDashedMaterial( {
 } );
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 
 		<h3>[name]( [param:Object parameters] )</h3>
 		<p>
-		[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-		Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
-
-		The exception is the property [page:Hexadecimal color], which can be passed i	as a hexadecimal
-		string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
+		属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff).</p>
+		<p>材质的颜色([page:Color])，默认值为白色 (0xffffff)。</p>
 
 		<h3>[property:number dashSize]</h3>
-		<p>The size of the dash. This is both the gap with the stroke. Default is *3*.</p>
+		<p>虚线的大小，是指破折号和间隙之和。默认值为 *3*。</p>
 
 		<h3>[property:number gapSize]</h3>
-		<p>The size of the gap. Default is *1*.</p>
+		<p>间隙的大小，默认值为 *1*。</p>
 
 		<h3>[property:Boolean isLineDashedMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are line dashed materials. Default is *true*.<br /><br />
+		<p>用于检查此类或派生类是否为虚线材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *false*.</p>
+		<p>材质是否受到光照的影响。默认值为 *false*。</p>
 
 		<h3>[property:Float linewidth]</h3>
 		<p>
-			Controls line thickness. Default is *1*.<br /><br />
+			控制线宽。默认值为 *1*。<br /><br />
 
-			Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-			with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-			always be 1 regardless of the set value.
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与
+			大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
 		<h3>[property:number scale]</h3>
-		<p>The scale of the dashed part of a line. Default is *1*.</p>
+		<p>线条中虚线部分的占比。默认值为 *1*。</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/Material.html

@@ -1,333 +1,276 @@
 <!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">
-		Abstract base class for materials.<br /><br />
-
-		Materials describe the appearance of [page:Object objects].
-		They are defined in a (mostly) renderer-independent way, so you don't have to
-		rewrite materials if you decide to use a different renderer.<br /><br />
-
-		The following properties and methods are inherited by all other material types
-		(although they may have different defaults).
-		</p>
-
-		<h2>Constructor</h2>
-
-
-		<h3>[name]()</h3>
-		<p>This creates a generic material.</p>
-
-
-		<h2>Properties</h2>
-
-		<h3>[property:Float alphaTest]</h3>
-		<p>
-		Sets the alpha value to be used when running an alpha test.
-		The material will not be renderered if the opacity is lower than this value.
-		Default is *0*.
-		</p>
-
-		<h3>[property:Integer blendDst]</h3>
-		<p>
-		Blending destination. Default is [page:CustomBlendingEquation OneMinusSrcAlphaFactor].
-		See the destination factors [page:CustomBlendingEquation constants] for all possible values.<br />
-		The material's [page:Constant blending] must be set to [page:Materials CustomBlending] for this to have any effect.
-		</p>
-
-		<h3>[property:Integer blendDstAlpha]</h3>
-		<p>The transparency of the [page:.blendDst]. Default is *null*.</p>
-
-		<h3>[property:Integer blendEquation]</h3>
-		<p>
-		Blending equation to use when applying blending. Default is [page:CustomBlendingEquation AddEquation].
-		See the blending equation [page:CustomBlendingEquation constants] for all possible values.<br />
-		The material's [page:Constant blending] must be set to [page:Materials CustomBlending] for this to have any effect.
-		</p>
-
-		<h3>[property:Integer blendEquationAlpha]</h3>
-		<p>The tranparency of the [page:.blendEquation]. Default is *null*.</p>
-
-		<h3>[property:Blending blending]</h3>
-		<p>
-		Which blending to use when displaying objects with this material. <br />
-		This must be set to [page:Materials CustomBlending] to use custom [page:Constant blendSrc], [page:Constant blendDst] or [page:Constant blendEquation].<br />
-		See the blending mode [page:Materials constants] for all possible values. Default is [page:Materials NormalBlending].
-		</p>
-
-		<h3>[property:Integer blendSrc]</h3>
-		<p>
-		Blending source. Default is [page:CustomBlendingEquation SrcAlphaFactor].
-		See the source factors [page:CustomBlendingEquation constants] for all possible values.<br />
-		The material's [page:Constant blending] must be set to [page:Materials CustomBlending] for this to have any effect.
-		</p>
-
-		<h3>[property:Integer blendSrcAlpha]</h3>
-		<p>The tranparency of the [page:.blendSrc]. Default is *null*.</p>
-
-		<h3>[property:Boolean clipIntersection]</h3>
-		<p>
-		Changes the behavior of clipping planes so that only their intersection is clipped, rather than their union.
-		Default is *false*.
-		</p>
-
-		<h3>[property:Array clippingPlanes]</h3>
-		<p>
-		User-defined clipping planes specified as THREE.Plane objects in world space.
-		These planes apply to the objects this material is attached to.
-		Points in space whose signed distance to the plane is negative are clipped (not rendered).
-		This requires [page:WebGLRenderer.localClippingEnabled] to be *true*.
-		See the [example:webgl_clipping_intersection WebGL / clipping /intersection] example.
-		Default is *null*.
-		</p>
-
-		<h3>[property:Boolean clipShadows]</h3>
-		<p>
-		Defines whether to clip shadows according to the clipping planes specified on this material. Default is *false*.
-		</p>
-
-		<h3>[property:Boolean colorWrite]</h3>
-		<p>
-		Whether to render the material's color.
-		This can be used in conjunction with a mesh's [page:Integer renderOrder] property to create invisible objects that occlude other objects. Default is *true*.
-		</p>
-
-		<h3>[property:Material customDepthMaterial]</h3>
-		<p>
-		Custom depth material to be used by this material when rendering to the depth map.
-		When shadow-casting with a [page:DirectionalLight] or [page:SpotLight], if you are (a) modifying vertex positions in the vertex shader,
-		(b) using a displacement map, (c) using an alpha map with alphaTest, or (d) using a transparent texture with alphaTest,
-		you must specify a customDepthMaterial for proper shadows. Default is *undefined*.
-		</p>
-
-		<h3>[property:Material customDistanceMaterial]</h3>
-		<p>
-		Same as customDepthMaterial, but used with [page:PointLight]. Default is *undefined*.
-		</p>
-
-		<h3>[property:Object defines]</h3>
-		<p>
-		Custom defines to be injected into the shader. These are passed in form of an object literal, with key/value pairs. { MY_CUSTOM_DEFINE: '' , PI2: Math.PI * 2 }. The pairs are defined in both vertex and fragment shaders.  Default is *undefined*.
-		</p>
-
-		<h3>[property:Integer depthFunc]</h3>
-		<p>
-		Which depth function to use. Default is [page:Materials LessEqualDepth]. See the depth mode [page:Materials constants] for all possible values.
-		</p>
-
-		<h3>[property:Boolean depthTest]</h3>
-		<p>
-		Whether to have depth test enabled when rendering this material. Default is *true*.
-		</p>
-
-		<h3>[property:Boolean depthWrite]</h3>
-		<p>
-		Whether rendering this material has any effect on the depth buffer. Default is *true*.<br /><br />
-
-		When drawing 2D overlays it can be useful to disable the depth writing in order to layer several things together without creating z-index artifacts.
-		</p>
-
-		<h3>[property:Boolean flatShading]</h3>
-		<p>
-		Define whether the material is rendered with flat shading. Default is false.
-		</p>
-
-		<h3>[property:Boolean fog]</h3>
-		<p>Whether the material is affected by fog. Default is *true*.</p>
-
-		<h3>[property:Integer id]</h3>
-		<p>Unique number for this material instance.</p>
-
-		<h3>[property:Boolean isMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are materials. Default is *true*.<br /><br />
-
-			You should not change this, as it used internally for optimisation.
-		</p>
-
-		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *true*.</p>
-
-		<h3>[property:String name]</h3>
-		<p>Optional name of the object (doesn't need to be unique). Default is an empty string.</p>
-
-		<h3>[property:Boolean needsUpdate]</h3>
-		<p>
-		Specifies that the material needs to be recompiled.<br />
-		This property is automatically set to *true* when instancing a new material.
-		</p>
-
-		<h3>[property:Float opacity]</h3>
-		<p>
-		Float in the range of *0.0* - *1.0* indicating how transparent the material is.
-		A value of *0.0* indicates fully transparent, *1.0* is fully opaque.<br />
-		If the material's [page:Boolean transparent] property is not set to *true*, the material will remain
-		fully opaque and this value will only affect its color. <br />
-		Default is *1.0*.
-		</p>
-
-		<h3>[property:Float overdraw]</h3>
-		<p>
-		Amount of triangle expansion at draw time.
-		This is a workaround for cases when gaps appear between triangles when using [page:CanvasRenderer].
-		*0.5* tends to give good results across browsers. Default is *0*.
-		</p>
-
-		<h3>[property:Boolean polygonOffset]</h3>
-		<p>
-		Whether to use polygon offset. Default is *false*. This corresponds to the *GL_POLYGON_OFFSET_FILL* WebGL feature.
-		</p>
-
-		<h3>[property:Integer polygonOffsetFactor]</h3>
-		<p>Sets the polygon offset factor. Default is *0*.</p>
-
-		<h3>[property:Integer polygonOffsetUnits]</h3>
-		<p>Sets the polygon offset units. Default is *0*.</p>
-
-		<h3>[property:String precision]</h3>
-		<p>
-		Override the renderer's default precision for this material. Can be "*highp*", "*mediump*" or "*lowp*".
-		Default is *null*.
-		</p>
-
-		<h3>[property:Boolean premultipliedAlpha]</h3>
-		<p>
-		Whether to premultiply the alpha (transparency) value.
-		See [Example:webgl_materials_transparency WebGL / Materials / Transparency] for an example of the difference.
-		Default is *false*.
-		</p>
-
-		<h3>[property:Boolean dithering]</h3>
-		<p>
-		Whether to apply dithering to the color to remove the appearance of banding.
-		Default is *false*.
-		</p>
-
-		<h3>[property:Integer shadowSide]</h3>
-		<p>
-		Defines which side of faces cast shadows.
-		When set, can be [page:Materials THREE.FrontSide], [page:Materials THREE.BackSide], or [page:Materials THREE.DoubleSide]. Default is *null*. <br />
-		If *null*, the side casting shadows is determined as follows: <br />
-
-		<table>
-			<thead>
-				<tr>
-					<th>[page:Material.side]</th>
-					<th>Side casting shadows</th>
-				</tr>
-			</thead>
-			<tbody>
-
-				<tr>
-					<td>THREE.FrontSide</td>
-					<td>back side</td>
-				</tr>
-				<tr>
-					<td>THREE.BackSide</td>
-					<td>front side</td>
-				</tr>
-				<tr>
-					<td>THREE.DoubleSide</td>
-					<td>both sides</td>
-				</tr>
-			</tbody>
-		</table>
-
-
-		</p>
-
-		<h3>[property:Integer side]</h3>
-		<p>
-		Defines which side of faces will be rendered - front, back or both.
-		Default is [page:Materials THREE.FrontSide].
-		Other options are [page:Materials THREE.BackSide] and [page:Materials THREE.DoubleSide].
-		</p>
-
-		<h3>[property:Boolean transparent]</h3>
-		<p>
-		Defines whether this material is transparent. This has an effect on rendering
-		as transparent objects need special treatment and are rendered after
-		non-transparent objects. <br />
-		When set to true, the extent to which the material is transparent is
-		controlled by setting it's [page:Float opacity] property. <br />
-		Default is *false*.
-		</p>
-
-		<h3>[property:String type]</h3>
-		<p>
-		Value is the string 'Material'. This shouldn't be changed, and can be used to
-		find all objects of this type in a scene.
-		</p>
-
-		<h3>[property:String uuid]</h3>
-		<p>
-		[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] of this material instance.
-		This gets automatically assigned, so this shouldn't be edited.
-		</p>
-
-		<h3>[property:Integer vertexColors]</h3>
-		<p>
-		Defines whether vertex coloring is used.
-		Default is [page:Materials THREE.NoColors].
-		Other options are [page:Materials THREE.VertexColors] and [page:Materials THREE.FaceColors].
-		</p>
-
-		<h3>[property:Boolean visible]</h3>
-		<p>
-		Defines whether this material is visible. Default is *true*.
-		</p>
-
-		<h3>[property:object userData]</h3>
-		<p>
-		An object that can be used to store custom data about the Material. It should not hold
-		references to functions as these will not be cloned.
-		</p>
-
-		<h2>Methods</h2>
-
-		<h3>[page:EventDispatcher EventDispatcher] methods are available on this class.</h3>
-
-		<h3>[method:Material clone]( )</h3>
-		<p>Return a new material with the same parameters as this material.</p>
-
-		<h3>[method:Material copy]( [param:material material] )</h3>
-		<p>Copy the parameters from the passed material into this material.</p>
-
-		<h3>[method:null dispose]()</h3>
-		<p>
-		This disposes the material. Textures of a material don't get disposed.
-		These needs to be disposed by [page:Texture Texture].
-		</p>
-
-		<h3>[method:null onBeforeCompile]( [param:Object shader], [param:WebGLRenderer renderer] )</h3>
-		<p>
-		An optional callback that is executed immediately before the shader program is compiled.
-		This function is called with the shader source code as a parameter. Useful for the modification of built-in materials.
-		</p>
-
-		<h3>[method:null setValues]( [param:object values] )</h3>
-		<p>
-		values -- a container with parameters.<br />
-		Sets the properties based on the *values*.
-		</p>
-
-		<h3>[method:null toJSON]( [param:object meta] )</h3>
-		<p>
-		meta -- object containing metadata such as textures or images for the material.<br />
-		Convert the material to three.js JSON format.
-		</p>
-
-		<h2>Source</h2>
-
-		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
-	</body>
+<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">材质的抽象基类。<br/><br/>
+    材质描述了对象[page:Object objects]的外观。它们的定义方式与渲染器无关，
+    因此，如果您决定使用不同的渲染器，不必重写材质。<br/><br/>
+    所有其他材质类型都继承了以下属性和方法（尽管它们可能具有不同的默认值）。
+</p>
+
+<h2>构造函数(Constructor)</h2>
+
+
+<h3>[name]()</h3>
+<p>该方法创建一个通用材质。</p>
+
+
+<h2>属性(Properties)</h2>
+
+<h3>[property:Float alphaTest]</h3>
+<p>设置运行alphaTest时要使用的alpha值。如果不透明度低于此值，则不会渲染材质。默认值为*0*。
+</p>
+
+<h3>[property:Integer blendDst]</h3>
+<p> 混合目标。默认值为[page:CustomBlendingEquation OneMinusSrcAlphaFactor]。
+    目标因子所有可能的取值请参阅[page:CustomBlendingEquation constants]。
+    必须将材质的[page:Constant blending]设置为[page:Materials CustomBlending]才能生效。<br/>
+</p>
+
+<h3>[property:Integer blendDstAlpha]</h3>
+<p> [page:.blendDst]的透明度。 默认值为 *null*.</p>
+
+<h3>[property:Integer blendEquation]</h3>
+<p> 使用混合时所采用的混合方程式。默认值为[page:CustomBlendingEquation AddEquation]。
+    混合方程式所有可能的取值请参阅[page:CustomBlendingEquation constants]。
+    必须将材质的[page:Constant blending]设置为[page:Materials CustomBlending]才能生效。<br/>
+</p>
+
+<h3>[property:Integer blendEquationAlpha]</h3>
+<p>[page:.blendEquation] 的透明度. 默认值为 *null*.</p>
+
+<h3>[property:Blending blending]</h3>
+<p> 在使用此材质显示对象时要使用何种混合。<br/>
+    必须将其设置为[page:Materials CustomBlending]才能使用自定义[page:Constant blendSrc], [page:Constant blendDst] 或者 [page:Constant
+    blendEquation]。
+    混合模式所有可能的取值请参阅[page:Materials constants]。默认值为[page:Materials NormalBlending]。
+</p>
+
+<h3>[property:Integer blendSrc]</h3>
+<p> 混合源。默认值为[page:CustomBlendingEquation SrcAlphaFactor]。
+    源因子所有可能的取值请参阅[page:CustomBlendingEquation constants]。<br/>
+    必须将材质的[page:Constant blending]设置为[page:Materials CustomBlending]才能生效。
+</p>
+
+<h3>[property:Integer blendSrcAlpha]</h3>
+<p> [page:.blendSrc]的透明度。 默认值为 *null*.</p>
+
+<h3>[property:Boolean clipIntersection]</h3>
+<p>更改剪裁平面的行为，以便仅剪切其交叉点，而不是它们的并集。默认值为 *false*。
+</p>
+
+<h3>[property:Array clippingPlanes]</h3>
+<p>
+    用户定义的剪裁平面，在世界空间中指定为THREE.Plane对象。这些平面适用于所有使用此材质的对象。空间中与平面的有符号距离为负的点被剪裁（未渲染）。
+    这需要[page:WebGLRenderer.localClippingEnabled]为*true*。
+    示例请参阅[example:webgl_clipping_intersection WebGL / clipping /intersection]。默认值为 *null*。
+</p>
+
+<h3>[property:Boolean clipShadows]</h3>
+<p>定义是否根据此材质上指定的剪裁平面剪切阴影。默认值为 *false*。
+</p>
+
+<h3>[property:Boolean colorWrite]</h3>
+<p> 是否渲染材质的颜色。
+    这可以与网格的[page:Integer renderOrder]属性结合使用，以创建遮挡其他对象的不可见对象。默认值为*true*。
+</p>
+
+<h3>[property:Material customDepthMaterial]</h3>
+<p>渲染到深度贴图时此材质要使用的自定义深度材质。
+    当使用[page:DirectionalLight]或[page:SpotLight]进行阴影投射时，如果您正在（a）修改顶点着色器中的顶点位置，
+    （b）使用位移贴图，（c）alphaTest中使用alpha贴图，或（d）alphaTest中使用透明纹理，
+    您必须指定customDepthMaterial以得到合适的阴影。默认值*undefined*。
+</p>
+
+<h3>[property:Material customDistanceMaterial]</h3>
+<p>与customDepthMaterial相同，但与[page:PointLight]一起使用。默认值为*undefined*。
+</p>
+
+<h3>[property:Object defines]</h3>
+<p> 注入shader的自定义对象。 以键值对形式的对象传递，{ MY_CUSTOM_DEFINE: '' , PI2: Math.PI * 2 }。
+    这些键值对在顶点和片元着色器中定义。默认值为*undefined*。
+</p>
+
+<h3>[property:Integer depthFunc]</h3>
+<p> 使用何种深度函数。默认为[page:Materials LessEqualDepth]。
+    深度模式所有可能的取值请查阅[page:Materials constants]。
+</p>
+
+<h3>[property:Boolean depthTest]</h3>
+<p>是否在渲染此材质时启用深度测试。默认为 *true*。
+</p>
+
+<h3>[property:Boolean depthWrite]</h3>
+<p>渲染此材质是否对深度缓冲区有任何影响。默认为*true*。<br/><br/>
+    在绘制2D叠加时，将多个事物分层在一起而不创建z-index时，禁用深度写入会很有用。
+</p>
+
+<h3>[property:Boolean flatShading]</h3>
+<p> 定义材质是否使用平面着色进行渲染。默认值为false。
+</p>
+
+<h3>[property:Boolean fog]</h3>
+<p>材质是否受雾影响。默认为*true*。</p>
+
+<h3>[property:Integer id]</h3>
+<p>此材质实例的唯一编号。</p>
+
+<h3>[property:Boolean isMaterial]</h3>
+<p>用于检查此类或派生类是否为材质。默认值为 *true*。<br/><br/>
+
+    因为其通常用在内部优化，所以不应该更改该属性值。
+</p>
+
+<h3>[property:Boolean lights]</h3>
+<p>材质是否受到光照的影响。默认为*true*。</p>
+
+<h3>[property:String name]</h3>
+<p>对象的可选名称（不必是唯一的）。默认值为空字符串。</p>
+
+<h3>[property:Boolean needsUpdate]</h3>
+<p>指定需要重新编译材质。<br/>
+    实例化新材质时，此属性自动设置为true。
+</p>
+
+<h3>[property:Float opacity]</h3>
+<p> 在0.0 - 1.0的范围内的浮点数，表明材质的透明度。值*0.0*表示完全透明，*1.0*表示完全不透明。<br/>
+    如果材质的[page:Boolean transparent]属性未设置为*true*，则材质将保持完全不透明，此值仅影响其颜色。
+    默认值为*1.0*。 <br/>
+
+</p>
+
+<h3>[property:Float overdraw]</h3>
+<p>绘制时的三角形扩展量。对于使用[page:CanvasRenderer]时三角形之间出现间隙的情况，这是一种解决方法。
+    *0.5*往往会在浏览器中有良好的结果。默认值为*0*。
+</p>
+
+<h3>[property:Boolean polygonOffset]</h3>
+<p> 是否使用多边形偏移。默认值为*false*。这对应于WebGL的*GL_POLYGON_OFFSET_FILL*功能。
+</p>
+
+<h3>[property:Integer polygonOffsetFactor]</h3>
+<p>设置多边形偏移系数。默认值为*0*。</p>
+
+<h3>[property:Integer polygonOffsetUnits]</h3>
+<p>设置多边形偏移单位。默认值为*0*。</p>
+
+<h3>[property:String precision]</h3>
+<p> 重写此材质渲染器的默认精度。可以是"*highp*", "*mediump*" 或 "*lowp*"。默认值为*null*。
+</p>
+
+<h3>[property:Boolean premultipliedAlpha]</h3>
+<p> 是否预乘alpha（透明度）值。有关差异的示例，请参阅[Example:webgl_materials_transparency WebGL / Materials / Transparency]。
+    默认值为*false*。
+</p>
+
+<h3>[property:Boolean dithering]</h3>
+<p> 是否对颜色应用抖动以消除条带的外观。默认值为 *false*。
+</p>
+
+<h3>[property:Integer shadowSide]</h3>
+<p> 定义投影的面。设置时，可以是[page:Materials THREE.FrontSide], [page:Materials THREE.BackSide], 或[page:Materials]。默认值为 *null*。
+     <br/>
+    如果为*null*， 则面投射阴影确定如下： <br/>
+
+<table>
+    <thead>
+    <tr>
+        <th>[page:Material.side]</th>
+        <th>Side casting shadows</th>
+    </tr>
+    </thead>
+    <tbody>
+
+    <tr>
+        <td>THREE.FrontSide</td>
+        <td>背面</td>
+    </tr>
+    <tr>
+        <td>THREE.BackSide</td>
+        <td>前面</td>
+    </tr>
+    <tr>
+        <td>THREE.DoubleSide</td>
+        <td>双面</td>
+    </tr>
+    </tbody>
+</table>
+
+
+</p>
+
+<h3>[property:Integer side]</h3>
+<p> 定义将要渲染哪一面 - 正面，背面或两者。
+    默认为[page:Materials THREE.FrontSide]。其他选项有[page:Materials THREE.BackSide]和[page:Materials THREE.DoubleSide]。
+</p>
+
+<h3>[property:Boolean transparent]</h3>
+<p>
+    定义此材质是否透明。这对渲染有影响，因为透明对象需要特殊处理，并在非透明对象之后渲染。
+    <br/>
+    设置为true时，通过设置材质的[page:Float opacity]属性来控制材质透明的程度。<br/>
+    默认值为*false*。
+</p>
+
+<h3>[property:String type]</h3>
+<p> 值是字符串'Material'。不应该被更改，并且可以用于在场景中查找此类型的所有对象。
+</p>
+
+<h3>[property:String uuid]</h3>
+<p> 此材质实例的[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID]，会自动分配，不应该被更改。
+</p>
+
+<h3>[property:Integer vertexColors]</h3>
+<p> 是否使用顶点着色。默认值为[page:Materials THREE.NoColors]。
+    其他选项有[page:Materials THREE.VertexColors] 和 [page:Materials THREE.FaceColors]。
+</p>
+
+<h3>[property:Boolean visible]</h3>
+<p> 此材质是否可见。默认为*true*。
+</p>
+
+<h3>[property:object userData]</h3>
+<p> 一个对象，可用于存储有关Material的自定义数据。它不应该包含对函数的引用，因为这些函数不会被克隆。
+</p>
+
+<h2>方法(Methods)</h2>
+
+<h3>[page:EventDispatcher EventDispatcher] 方法在此类中可用。</h3>
+
+<h3>[method:Material clone]( )</h3>
+<p> 返回与此材质具有相同参数的新材质。</p>
+
+<h3>[method:Material copy]( [param:material material] )</h3>
+<p> 将被传入材质中的参数复制到此材质中。</p>
+
+<h3>[method:null dispose]()</h3>
+<p> 处理材质。材质的纹理不会被处理。需要通过[page:Texture Texture]处理。
+</p>
+
+<h3>[method:null onBeforeCompile]( [param:Object shader], [param:WebGLRenderer renderer] )</h3>
+<p> 在编译shader程序之前立即执行的可选回调。此函数使用shader源码作为参数。用于修改内置材质。
+</p>
+
+<h3>[method:null setValues]( [param:object values] )</h3>
+<p> values -- 具有参数的容器。
+    根据*values*设置属性。<br/>
+</p>
+
+<h3>[method:null toJSON]( [param:object meta] )</h3>
+<p> meta -- 包含元素，例如材质的纹理或图像。
+    将材质转换为three.js JSON格式。<br/>
+</p>
+
+<h2>源码(Source)</h2>
+
+[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
+</body>
 </html>

docs/api/zh/materials/MeshBasicMaterial.html

@@ -10,12 +10,11 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>基础网格材质([name])</h1>
 
 		<p class="desc">
-			A material for drawing geometries in a simple shaded (flat or wireframe) way.<br /><br />
-
-			This material is not affected by lights.
+			一个以简单着色（平面或线框）方式来绘制几何体的材质。<br /><br />
+			这种材质不受光照的影响。
 		</p>
 
 
@@ -37,129 +36,104 @@
 
 		</script>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
-
-			The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-			string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		<p>[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Texture alphaMap]</h3>
-		<p>The alpha map is a grayscale texture that controls the opacity across the surface
-			(black: fully transparent; white: fully opaque). Default is null.<br /><br />
-
-			Only the color of the texture is used, ignoring the alpha channel if one exists.
-			For RGB and RGBA textures, the [page:WebGLRenderer WebGL] renderer will use the
-			green channel when sampling this texture due to the extra bit of precision provided
-			for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and
-			luminance/alpha textures will also still work as expected.
+		<p> alpha贴图是一种灰度纹理，用于控制整个表面的不透明度（黑色：完全透明;白色：完全不透明）。默认值为null。<br /><br />
+			仅使用纹理的颜色，忽略alpha通道（如果存在）。对于RGB和RGBA纹理，[page:WebGLRenderer WebGL]渲染器在采样此纹理时将使用绿色通道，
+			因为在DXT压缩和未压缩RGB 565格式中为绿色提供了额外的精度。Luminance-only以及luminance/alpha纹理也仍然有效。
 		</p>
 
 		<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>
+		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]属性。</p>
 
 		<h3>[property:Float aoMapIntensity]</h3>
-		<p>Intensity of the ambient occlusion effect. Default is 1. Zero is no occlusion effect.</p>
+		<p>环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff).</p>
+		<p>材质的颜色([page:Color])，默认值为白色 (0xffffff)。</p>
 
 		<h3>[property:Integer combine]</h3>
-		<p>
-			How to combine the result of the surface's color with the environment map, if any.<br /><br />
-
-			Options are [page:Materials THREE.Multiply] (default), [page:Materials THREE.MixOperation],
-			[page:Materials THREE.AddOperation]. If mix is chosen, the [page:.reflectivity] is used to
-			blend between the two colors.
+		<p> 如何将表面颜色的结果与环境贴图（如果有）结合起来。<br /><br />
+			选项为[page:Materials THREE.Multiply]（默认值），[page:Materials THREE.MixOperation]，
+			[page:Materials THREE.AddOperation]。如果选择多个，则使用[page:.reflectivity]在两种颜色之间进行混合。
 		</p>
 
 		<h3>[property:Boolean isMeshBasicMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh basic materials. Default is *true*.<br /><br />
+		<p>用于检查此类或派生类是否为网格基础材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:TextureCube envMap]</h3>
-		<p>The environment map. Default is null.</p>
+		<p>环境贴图。默认值为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>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
 
 		<h3>[property:Float lightMapIntensity]</h3>
-		<p>Intensity of the baked light. Default is 1.</p>
+		<p>烘焙光的强度。默认值为1。</p>
 
 		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *false*.</p>
+		<p>材质是否受到光照的影响。默认值为 *false*。</p>
 
 		<h3>[property:Texture map]</h3>
-		<p>The color map. Default is  null.</p>
+		<p> 颜色贴图。默认为null。</p>
 
 		<h3>[property:Boolean morphTargets]</h3>
-		<p>Define whether the material uses morphTargets. Default is false.</p>
+		<p>材质是否使用morphTargets。默认值为false。</p>
 
 
 		<h3>[property:Float reflectivity]</h3>
-		<p>
-			How much the environment map affects the surface; also see [page:.combine].
-			The default value is 1 and the valid range is between 0 (no reflections) and 1 (full reflections).
+		<p> 环境贴图对表面的影响程度; 见[page:.combine]。默认值为1，有效范围介于0（无反射）和1（完全反射）之间。
 		</p>
 
 		<h3>[property:Float refractionRatio]</h3>
-		<p>
-			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
-			It is used with environment mapping modes [page:Textures THREE.CubeRefractionMapping] and [page:Textures THREE.EquirectangularRefractionMapping].
-			The refraction ratio should not exceed 1. Default is *0.98*.
+		<p> 空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
+			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
+			折射率不应超过1。默认值为*0.98*。
 		</p>
 
 		<h3>[property:Boolean skinning]</h3>
-		<p>Define whether the material uses skinning. Default is false.</p>
+		<p> 材质是否使用蒙皮。默认值为false。</p>
 
 		<h3>[property:Texture specularMap]</h3>
-		<p>Specular map used by the material. Default is null.</p>
+		<p> 材质使用的高光贴图。默认值为null。</p>
 
 		<h3>[property:Boolean wireframe]</h3>
-		<p>Render geometry as wireframe. Default is *false* (i.e. render as flat polygons).</p>
+		<p> 将几何体渲染为线框。默认值为*false*（即渲染为平面多边形）。</p>
 
 		<h3>[property:String wireframeLinecap]</h3>
-		<p>
-			Define appearance of line ends. Possible values are "butt", "round" and "square". Default is 'round'.<br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineCap 2D Canvas lineCap]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+		<p> 定义线两端的外观。可选值为 'butt'，'round' 和 'square'。默认为'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:String wireframeLinejoin]</h3>
 		<p>
-			Define appearance of line joints. Possible values are "round", "bevel" and "miter". Default is 'round'.<br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+			定义线连接节点的样式。可选值为 'round', 'bevel' 和 'miter'。默认值为 'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:Float wireframeLinewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p>控制线框宽度。默认值为1。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，
+			无论如何设置该值，线宽始终为1。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/MeshDepthMaterial.html

@@ -10,9 +10,9 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>深度网格材质([name])</h1>
 
-		<p class="desc">A material for drawing geometry by depth. Depth is based off of the camera near and far plane. White is nearest, black is farthest.</p>
+		<p class="desc">一种按深度绘制几何体的材质。深度基于相机远近平面。白色最近，黑色最远。</p>
 
 		<iframe id="scene" src="scenes/material-browser.html#MeshDepthMaterial"></iframe>
 
@@ -32,91 +32,73 @@
 
 		</script>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.
+		<p>[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Texture alphaMap]</h3>
-		<p>The alpha map is a grayscale texture that controls the opacity across the surface
-			(black: fully transparent; white: fully opaque). Default is null.<br /><br />
-
-			Only the color of the texture is used, ignoring the alpha channel if one exists.
-			For RGB and RGBA textures, the [page:WebGLRenderer WebGL] renderer will use the
-			green channel when sampling this texture due to the extra bit of precision provided
-			for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and
-			luminance/alpha textures will also still work as expected.
+		<p>alpha贴图是一种灰度纹理，用于控制整个表面的不透明度（黑色：完全透明;白色：完全不透明）。默认值为null。<br /><br />
+			仅使用纹理的颜色，忽略alpha通道（如果存在）。对于RGB和RGBA纹理，[page:WebGLRenderer WebGL]渲染器在采样此纹理时将使用绿色通道，
+			因为在DXT压缩和未压缩RGB 565格式中为绿色提供了额外的精度。Luminance-only以及luminance/alpha纹理也仍然有效。
 		</p>
 
 		<h3>[property:Constant depthPacking]</h3>
-		<p>Encoding for depth packing. Default is [page:Textures BasicDepthPacking].</p>
+		<p> depth packing的编码。默认为[page:Textures BasicDepthPacking]。</p>
 
 		<h3>[property:Texture displacementMap]</h3>
-		<p>
-			The displacement map affects the position of the mesh's vertices. Unlike other maps
-			which only affect the light and shade of the material the displaced vertices can cast shadows,
-			block other objects, and otherwise act as real geometry. The displacement texture is
-			an image where the value of each pixel (white being the highest) is mapped against,
-			and repositions, the vertices of the mesh.
+		<p> 位移贴图会影响网格顶点的位置，与仅影响材质的光照和阴影的其他贴图不同，移位的顶点可以投射阴影，阻挡其他对象，以及充当真实的几何体。
+			位移纹理是指：网格的所有顶点被映射为图像中每个像素的值（白色是最高的），并且被重定位。
 		</p>
 
 		<h3>[property:Float displacementScale]</h3>
-		<p>
-			How much the displacement map affects the mesh (where black is no displacement,
-			and white is maximum displacement). Without a displacement map set, this value is not applied.
-			 Default is 1.
+		<p>位移贴图对网格的影响程度（黑色是无位移，白色是最大位移）。如果没有设置位移贴图，则不会应用此值。默认值为1。
 		</p>
 
 		<h3>[property:Float displacementBias]</h3>
-		<p>
-			The offset of the displacement map's values on the mesh's vertices.
-			Without a displacement map set, this value is not applied. Default is 0.
+		<p> 位移贴图在网格顶点上的偏移量。如果没有设置位移贴图，则不会应用此值。默认值为0。
 		</p>
 
 		<h3>[property:Boolean fog]</h3>
-		<p>Whether the material is affected by fog. Default is *false*.</p>
+		<p> 材质是否受雾影响。默认值为*false*。</p>
 
 		<h3>[property:Boolean isMeshDepthMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh depth materials. Default is *true*.<br /><br />
+		<p> 用于检查此类或派生类是否为深度网格材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *false*.</p>
+		<p>材质是否受到光照的影响。默认值为 *false*。</p>
 
 		<h3>[property:Texture map]</h3>
-		<p>The color map. Default is  null.</p>
+		<p>颜色贴图。默认为null。</p>
 
 		<h3>[property:boolean morphTargets]</h3>
-		<p>Define whether the material uses morphTargets. Default is false.</p>
+		<p>材质是否使用morphTargets。默认值为false。</p>
 
 		<h3>[property:Boolean skinning]</h3>
-		<p>Define whether the material uses skinning. Default is false.</p>
+		<p>材质是否使用蒙皮。默认值为false。</p>
 
 		<h3>[property:boolean wireframe]</h3>
-		<p>Render geometry as wireframe. Default is false (i.e. render as smooth shaded).</p>
+		<p> 将几何体渲染为线框。默认值为*false*（即渲染为平滑着色）。</p>
 
 		<h3>[property:Float wireframeLinewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p>控制线框宽度。默认值为1。<br /><br />
+		由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
+		与大多数平台上[page:WebGLRenderer WebGL]渲染器限制，无论如何设置该值，线宽始终为1。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/MeshLambertMaterial.html

@@ -10,24 +10,17 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>Lambert网格材质([name])</h1>
 
-		<p class="desc">
-			A material for non-shiny surfaces, without specular highlights.<br /><br />
+		<p class="desc"> 一种非光泽表面的材质，没有镜面高光。<br /><br />
+			该材质使用基于非物理的[link:https://en.wikipedia.org/wiki/Lambertian_reflectance Lambertian]模型来计算反射率。
+			这可以很好地模拟一些表面（例如未经处理的木材或石材），但不能模拟具有镜面高光的光泽表面（例如涂漆木材）。<br /><br />
 
-			The material uses a non-physically based [link:https://en.wikipedia.org/wiki/Lambertian_reflectance Lambertian]
-			model for calculating reflectance. This can simulate some surfaces (such as untreated wood or stone) well,
-			but cannot simulate shiny surfaces with specular highlights (such as varnished wood).<br /><br />
 
-
-
-			Shading is calculated using a [link:https://en.wikipedia.org/wiki/Gouraud_shading Gouraud] shading model.
-			This calculates shading per vertex (i.e. in the [link:https://en.wikipedia.org/wiki/Shader#Vertex_shaders vertex shader])
-			and interpolates the results over the polygon's faces.<br /><br />
-
-			Due to the simplicity of the reflectance and illumination models, performance will be greater
-			when using this material over the [page:MeshPhongMaterial],	[page:MeshStandardMaterial] or [page:MeshPhysicalMaterial],
-			at the cost of some graphical accuracy.
+			使用[link:https://en.wikipedia.org/wiki/Gouraud_shading Gouraud]着色模型计算着色。这将计算每个顶点的着色
+			（即在[link:https://en.wikipedia.org/wiki/Shader#Vertex_shaders vertex shader]中）并在多边形的面上插入结果。<br /><br />
+			由于反射率和光照模型的简单性，[page:MeshPhongMaterial]，[page:MeshStandardMaterial]或者[page:MeshPhysicalMaterial]
+			上使用这种材质时会以一些图形精度为代价，得到更高的性能。
 		</p>
 
 		<iframe id="scene" src="scenes/material-browser.html#MeshLambertMaterial"></iframe>
@@ -48,144 +41,118 @@
 
 		</script>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
-
-			The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-			string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		<p>[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Texture alphaMap]</h3>
-		<p>The alpha map is a grayscale texture that controls the opacity across the surface
-			(black: fully transparent; white: fully opaque). Default is null.<br /><br />
-
-			Only the color of the texture is used, ignoring the alpha channel if one exists.
-			For RGB and RGBA textures, the [page:WebGLRenderer WebGL] renderer will use the
-			green channel when sampling this texture due to the extra bit of precision provided
-			for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and
-			luminance/alpha textures will also still work as expected.
+		<p>alpha贴图是一种灰度纹理，用于控制整个表面的不透明度（黑色：完全透明;白色：完全不透明）。默认值为null。<br /><br />
+
+			仅使用纹理的颜色，忽略alpha通道（如果存在）。对于RGB和RGBA纹理，[page:WebGLRenderer WebGL]渲染器在采样此纹理时将使用绿色通道，
+			因为在DXT压缩和未压缩RGB 565格式中为绿色提供了额外的精度。Luminance-only以及luminance/alpha纹理也仍然有效。
 		</p>
 
 		<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>
+		<p> 该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
 
 		<h3>[property:Float aoMapIntensity]</h3>
-		<p>Intensity of the ambient occlusion effect. Default is 1. Zero is no occlusion effect.</p>
+		<p> 环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff).</p>
+		<p> 材质的颜色([page:Color])，默认值为白色 (0xffffff)。</p>
 
 		<h3>[property:Integer combine]</h3>
-		<p>
-			How to combine the result of the surface's color with the environment map, if any.<br /><br />
+		<p> 如何将表面颜色的结果与环境贴图（如果有）结合起来。<br /><br />
 
-			Options are [page:Materials THREE.Multiply] (default), [page:Materials THREE.MixOperation],
-			[page:Materials THREE.AddOperation]. If mix is chosen, the [page:.reflectivity] is used to
-			blend between the two colors.
+			选项为[page:Materials THREE.Multiply]（默认值），[page:Materials THREE.MixOperation]，
+			[page:Materials THREE.AddOperation]。如果选择多个，则使用[page:.reflectivity]在两种颜色之间进行混合。
 		</p>
 
 		<h3>[property:Color emissive]</h3>
-		<p>
-		Emissive (light) color of the material, essentially a solid color unaffected by other lighting.
-		Default is black.
+		<p> 材质的放射（光）颜色，基本上是不受其他光照影响的固有颜色。默认为黑色。
 		</p>
 
 		<h3>[property:Texture emissiveMap]</h3>
-		<p>
-		Set emissive (glow) map. Default is null. The emissive map color is modulated by
-		the emissive color and the emissive intensity. If you have an emissive map, be sure to
-		set the emissive color to something other than black.
+		<p> 设置放射（发光）贴图。默认值为null。放射贴图颜色由放射颜色和强度所调节。
+			如果你有一个放射贴图，请务必将放射颜色设置为黑色以外的其他颜色。
 		</p>
 
 		<h3>[property:Float emissiveIntensity]</h3>
-		<p>Intensity of the emissive light. Modulates the emissive color. Default is 1.</p>
+		<p> 放射光强度。调节发光颜色。默认为1。</p>
 
 		<h3>[property:TextureCube envMap]</h3>
-		<p>The environment map. Default is null.</p>
+		<p> 环境贴图。默认值为null。</p>
 
 		<h3>[property:Boolean isMeshLambertMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh Lambert materials. Default is *true*.<br /><br />
+		<p> 用于检查此类或派生类是否为Lambert网格材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</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>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
 
 		<h3>[property:Float lightMapIntensity]</h3>
-		<p>Intensity of the baked light. Default is 1.</p>
+		<p>烘焙光的强度。默认值为1。</p>
 
 		<h3>[property:Texture map]</h3>
-		<p>The color map. Default is  null.</p>
+		<p>颜色贴图。默认为null。</p>
 
 		<h3>[property:boolean morphNormals]</h3>
-		<p>
-			Defines whether the material uses morphNormals. Set as true to pass morphNormal
-			attributes from the [page:Geometry]	to the shader. Default is *false*.
+		<p> 定义是否使用morphNormals。设置为true可将morphNormal属性从[page:Geometry]传递到shader。默认值为*false*。
 		</p>
 
 		<h3>[property:Boolean morphTargets]</h3>
-		<p>Define whether the material uses morphTargets. Default is false.</p>
+		<p>定义材质是否使用morphTargets。默认值为false。</p>
 
 		<h3>[property:Float reflectivity]</h3>
-		<p>How much the environment map affects the surface; also see [page:.combine].</p>
+		<p> 环境贴图对表面的影响程度; 见[page:.combine]。默认值为1，有效范围介于0（无反射）和1（完全反射）之间。</p>
 
 		<h3>[property:Float refractionRatio]</h3>
-		<p>
-			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
-			It is used with environment mapping modes [page:Textures THREE.CubeRefractionMapping] and [page:Textures THREE.EquirectangularRefractionMapping].
-			The refraction ratio should not exceed 1. Default is *0.98*.
+		<p>空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
+			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
+			折射率不应超过1。默认值为*0.98*。
 		</p>
 
 		<h3>[property:Boolean skinning]</h3>
-		<p>Define whether the material uses skinning. Default is false.</p>
+		<p>材质是否使用蒙皮。默认值为false。</p>
 
 		<h3>[property:Texture specularMap]</h3>
-		<p>Specular map used by the material. Default is null.</p>
+		<p>材质使用的高光贴图。默认值为null。</p>
 
 		<h3>[property:Boolean wireframe]</h3>
-		<p>Render geometry as wireframe. Default is *false* (i.e. render as flat polygons).</p>
+		<p>将几何体渲染为线框。默认值为*false*（即渲染为平面多边形）。</p>
 
 		<h3>[property:String wireframeLinecap]</h3>
-		<p>
-			Define appearance of line ends. Possible values are "butt", "round" and "square". Default is 'round'.<br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineCap 2D Canvas lineCap]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+		<p>定义线两端的外观。可选值为 'butt'，'round' 和 'square'。默认为'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:String wireframeLinejoin]</h3>
 		<p>
-			Define appearance of line joints. Possible values are "round", "bevel" and "miter". Default is 'round'.<br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+			定义线连接节点的样式。可选值为 'round', 'bevel' 和 'miter'。默认值为 'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:Float wireframeLinewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p> 控制线框宽度。默认值为1。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与
+			大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/MeshNormalMaterial.html

@@ -10,9 +10,9 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>法线网格材质([name])</h1>
 
-		<p class="desc">A material that maps the normal vectors to RGB colors.</p>
+		<p class="desc">一种把法向量映射到RGB颜色的材质。</p>
 
 		<iframe id="scene" src="scenes/material-browser.html#MeshNormalMaterial"></iframe>
 
@@ -32,53 +32,47 @@
 
 		</script>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Boolean fog]</h3>
-		<p>Whether the material is affected by fog. Default is *false*.</p>
+		<p>材质是否受雾影响。默认值为*false*。</p>
 
 		<h3>[property:Boolean isMeshNormalMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh normal materials. Default is *true*.<br /><br />
+		<p> 用于检查此类或派生类是否为法线网格材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *false*.</p>
+		<p>材质是否受到光照的影响。默认值为 *false*。</p>
 
 		<h3>[property:boolean morphTargets]</h3>
-		<p>Define whether the material uses morphTargets. Default is false.</p>
+		<p>定义材质是否使用morphTargets。默认值为false。</p>
 
 		<h3>[property:boolean wireframe]</h3>
 		<p>
-			Render geometry as wireframe. Default is false (i.e. render as smooth shaded).
+			将几何体渲染为线框。默认值为*false*（即渲染为平滑着色）。
 		</p>
 
 		<h3>[property:Float wireframeLinewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p>控制线框宽度。默认值为1。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/MeshPhongMaterial.html

@@ -10,23 +10,15 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>Phong网格材质([name])</h1>
 
-		<p class="desc">
-			A material for shiny surfaces with specular highlights.<br /><br />
-
-			The material uses a non-physically based [link:https://en.wikipedia.org/wiki/Blinn-Phong_shading_model Blinn-Phong]
-			model for calculating reflectance. Unlike the Lambertian model used in the [page:MeshLambertMaterial]
-			this can simulate shiny surfaces with specular highlights (such as varnished wood).<br /><br />
-
-			Shading is calculated using a [link:https://en.wikipedia.org/wiki/Phong_shading Phong] shading model.
-			This calculates shading per pixel (i.e. in the [link:https://en.wikipedia.org/wiki/Shader#Pixel_shaders fragment shader],
-			AKA pixel shader)	which gives more accurate results than the Gouraud model used by [page:MeshLambertMaterial],
-			at the cost of some performance. The [page:MeshStandardMaterial] and [page:MeshPhysicalMaterial]
-			also use this shading model.<br /><br />
-
-			Performance will generally be greater when using this material over the	[page:MeshStandardMaterial]
-			or [page:MeshPhysicalMaterial], at the cost of some graphical accuracy.
+		<p class="desc"> 一种用于具有镜面高光的光泽表面的材质。<br /><br />
+			该材质使用非物理的[link:https://en.wikipedia.org/wiki/Blinn-Phong_shading_model Blinn-Phong]模型来计算反射率。
+			与[page:MeshLambertMaterial]中使用的Lambertian模型不同，该材质可以模拟具有镜面高光的光泽表面（例如涂漆木材）。<br /><br />
+			使用[link:https://en.wikipedia.org/wiki/Phong_shading Phong]着色模型计算着色时，会计算每个像素的阴影（在[link:https://en.wikipedia.org/wiki/Shader#Pixel_shaders fragment shader]，
+			AKA pixel shader中），与[page:MeshLambertMaterial]使用的Gouraud模型相比，该模型的结果更准确，但代价是牺牲一些性能。
+			[page:MeshStandardMaterial]和[page:MeshPhysicalMaterial]也使用这个着色模型。<br /><br />
+			在[page:MeshStandardMaterial]或[page:MeshPhysicalMaterial]上使用此材质时，性能通常会更高	，但会牺牲一些图形精度。
 		</p>
 
 		<iframe id="scene" src="scenes/material-browser.html#MeshPhongMaterial"></iframe>
@@ -47,215 +39,166 @@
 
 		</script>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
-
-			The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-			string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		<p>[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Texture alphaMap]</h3>
-		<p>The alpha map is a grayscale texture that controls the opacity across the surface
-			(black: fully transparent; white: fully opaque). Default is null.<br /><br />
-
-			Only the color of the texture is used, ignoring the alpha channel if one exists.
-			For RGB and RGBA textures, the [page:WebGLRenderer WebGL] renderer will use the
-			green channel when sampling this texture due to the extra bit of precision provided
-			for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and
-			luminance/alpha textures will also still work as expected.
+		<p>Talpha贴图是一种灰度纹理，用于控制整个表面的不透明度（黑色：完全透明;白色：完全不透明）。默认值为null。<br /><br />
+			仅使用纹理的颜色，忽略alpha通道（如果存在）。对于RGB和RGBA纹理，[page:WebGLRenderer WebGL]渲染器在采样此纹理时将使用绿色通道，
+			因为在DXT压缩和未压缩RGB 565格式中为绿色提供了额外的精度。Luminance-only以及luminance/alpha纹理也仍然有效。
 		</p>
 
 		<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>
+		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]属性。</p>
 
 		<h3>[property:Float aoMapIntensity]</h3>
-		<p>Intensity of the ambient occlusion effect. Default is 1. Zero is no occlusion effect.</p>
+		<p>环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
 
 		<h3>[property:Texture bumpMap]</h3>
-		<p>
-			The texture to create a bump map. The black and white values map to the perceived depth in relation to the lights.
-			Bump doesn't actually affect the geometry of the object, only the lighting. If a normal map is defined this will
-			be ignored.
+		<p> 用于创建凹凸贴图的纹理。黑色和白色值映射到与光照相关的感知深度。凹凸实际上不会影响对象的几何形状，只影响光照。如果定义了法线贴图，则将忽略该贴图。
 		</p>
 
 		<h3>[property:Float bumpScale]</h3>
-		<p>How much the bump map affects the material. Typical ranges are 0-1. Default is 1.</p>
+		<p> 凹凸贴图会对材质产生多大影响。典型范围是0-1。默认值为1。</p>
 
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff).</p>
+		<p>材质的颜色([page:Color])，默认值为白色 (0xffffff)。</p>
 
 		<h3>[property:Integer combine]</h3>
-		<p>
-			How to combine the result of the surface's color with the environment map, if any.<br /><br />
+		<p> 如何将表面颜色的结果与环境贴图（如果有）结合起来。<br /><br />
 
-			Options are [page:Materials THREE.Multiply] (default), [page:Materials THREE.MixOperation],
-			[page:Materials THREE.AddOperation]. If mix is chosen, the [page:.reflectivity] is used to
-			blend between the two colors.
+			选项为[page:Materials THREE.Multiply]（默认值），[page:Materials THREE.MixOperation]，
+			[page:Materials THREE.AddOperation]。如果选择多个，则使用[page:.reflectivity]在两种颜色之间进行混合。
 		</p>
 
 		<h3>[property:Texture displacementMap]</h3>
-		<p>
-			The displacement map affects the position of the mesh's vertices. Unlike other maps
-			which only affect the light and shade of the material the displaced vertices can cast shadows,
-			block other objects, and otherwise act as real geometry. The displacement texture is
-			an image where the value of each pixel (white being the highest) is mapped against,
-			and repositions, the vertices of the mesh.
+		<p> 位移贴图会影响网格顶点的位置，与仅影响材质的光照和阴影的其他贴图不同，移位的顶点可以投射阴影，阻挡其他对象，
+			以及充当真实的几何体。位移纹理是指：网格的所有顶点被映射为图像中每个像素的值（白色是最高的），并且被重定位。
 		</p>
 
 		<h3>[property:Float displacementScale]</h3>
-		<p>
-			How much the displacement map affects the mesh (where black is no displacement,
-			and white is maximum displacement). Without a displacement map set, this value is not applied.
-			 Default is 1.
+		<p> 位移贴图对网格的影响程度（黑色是无位移，白色是最大位移）。如果没有设置位移贴图，则不会应用此值。默认值为1。
 		</p>
 
 		<h3>[property:Float displacementBias]</h3>
 		<p>
-			The offset of the displacement map's values on the mesh's vertices.
-			Without a displacement map set, this value is not applied. Default is 0.
+			位移贴图在网格顶点上的偏移量。如果没有设置位移贴图，则不会应用此值。默认值为0。
 		</p>
 
 		<h3>[property:Color emissive]</h3>
-		<p>
-		Emissive (light) color of the material, essentially a solid color unaffected by other lighting.
-		Default is black.
+		<p> 材质的放射（光）颜色，基本上是不受其他光照影响的固有颜色。默认为黑色。
 		</p>
 
 		<h3>[property:Texture emissiveMap]</h3>
-		<p>
-		Set emisssive (glow) map. Default is null. The emissive map color is modulated by
-		the emissive color and the emissive intensity. If you have an emissive map, be sure to
-		set the emissive color to something other than black.
+		<p> 设置放射（发光）贴图。默认值为null。放射贴图颜色由放射颜色和强度所调节。
+			如果你有一个放射贴图，请务必将放射颜色设置为黑色以外的其他颜色。
 		</p>
 
 		<h3>[property:Float emissiveIntensity]</h3>
-		<p>Intensity of the emissive light. Modulates the emissive color. Default is 1.</p>
+		<p>放射光强度。调节发光颜色。默认为1。</p>
 
 		<h3>[property:TextureCube envMap]</h3>
-		<p>The environment map. Default is null.</p>
+		<p>环境贴图。默认值为null。</p>
 
 		<h3>[property:Boolean isMeshPhongMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh Phong materials. Default is *true*.<br /><br />
+		<p> 用于检查此类或派生类是否为Phong网格材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</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>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
 
 		<h3>[property:Float lightMapIntensity]</h3>
-		<p>Intensity of the baked light. Default is 1.</p>
+		<p>烘焙光的强度。默认值为1。</p>
 
 		<h3>[property:Texture map]</h3>
-		<p>The color map. Default is null. The texture map color is modulated by the diffuse [page:.color].</p>
+		<p>颜色贴图。默认为null。纹理贴图颜色由漫反射颜色[page:.color]调节。</p>
 
 		<h3>[property:boolean morphNormals]</h3>
-		<p>
-			Defines whether the material uses morphNormals. Set as true to pass morphNormal
-			attributes from the [page:Geometry]	to the shader. Default is *false*.
+		<p> 定义是否使用morphNormals。设置为true可将morphNormal属性从[page:Geometry]传递到shader。默认值为*false*。
 		</p>
 
 		<h3>[property:Boolean morphTargets]</h3>
-		<p>Define whether the material uses morphTargets. Default is false.</p>
+		<p>定义材质是否使用morphTargets。默认值为false。</p>
 
 		<h3>[property:Texture normalMap]</h3>
-		<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.
+		<p> 用于创建法线贴图的纹理。RGB值会影响每个像素片段的曲面法线，并更改颜色照亮的方式。法线贴图不会改变曲面的实际形状，只会改变光照。
 		</p>
 
 		<h3>[property:Integer normalMapType]</h3>
-		<p>
-			The type of normal map.<br /><br />
-
-			Options are [page:constant THREE.TangentSpaceNormalMap] (default), and [page:constant THREE.ObjectSpaceNormalMap].
+		<p> 法线贴图的类型。<br /><br />
+			选项为[page:constant THREE.TangentSpaceNormalMap]（默认）和[page:constant THREE.ObjectSpaceNormalMap]。
 		</p>
 
 		<h3>[property:Vector2 normalScale]</h3>
-		<p>
-			How much the normal map affects the material. Typical ranges are 0-1.
-			Default is a [page:Vector2] set to (1,1).
+		<p> 法线贴图对材质的影响程度。典型范围是0-1。默认值是[page:Vector2]设置为（1,1）。
 		</p>
 
 
 		<h3>[property:Float reflectivity]</h3>
-		<p>
-			How much the environment map affects the surface; also see [page:.combine].
-			The default value is 1 and the valid range is between 0 (no reflections) and 1 (full reflections).
+		<p> 环境贴图对表面的影响程度; 见[page:.combine]。默认值为1，有效范围介于0（无反射）和1（完全反射）之间。
 		</p>
 
 		<h3>[property:Float refractionRatio]</h3>
-		<p>
-			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
-			It is used with environment mapping modes [page:Textures THREE.CubeRefractionMapping] and [page:Textures THREE.EquirectangularRefractionMapping].
-			The refraction ratio should not exceed 1. Default is *0.98*.
+		<p> 空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
+			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
+			折射率不应超过1。默认值为*0.98*。
 		</p>
 
 		<h3>[property:Float shininess]</h3>
-		<p>How shiny the [page:.specular] highlight is; a higher value gives a sharper highlight. Default is *30*.</p>
+		<p> [page:.specular]高亮的程度，越高的值越闪亮。默认值为 *30*。</p>
 
 
 		<h3>[property:Boolean skinning]</h3>
-		<p>Define whether the material uses skinning. Default is false.</p>
+		<p>材质是否使用蒙皮。默认值为false。</p>
 
 		<h3>[property:Color specular]</h3>
-		<p>
-			Specular color of the material. Default is a [page:Color] set to *0x111111* (very dark grey).<br /><br />
-
-			This defines how shiny the material is and the color of its shine.
+		<p> 材质的高光颜色。默认值为*0x111111*（深灰色）的颜色[page:Color]。<br /><br />
+			这定义了材质的光泽度和光泽的颜色。
 		</p>
 
 		<h3>[property:Texture specularMap]</h3>
-		<p>
-			The specular map value affects both how much the specular surface highlight
-			contributes and how much of the environment map affects the surface. Default is null.
+		<p> 镜面反射贴图值会影响镜面高光以及环境贴图对表面的影响程度。默认值为null。
 		</p>
 
 		<h3>[property:Boolean wireframe]</h3>
-		<p>Render geometry as wireframe. Default is *false* (i.e. render as flat polygons).</p>
+		<p>将几何体渲染为线框。默认值为*false*（即渲染为平面多边形）。</p>
 
 		<h3>[property:String wireframeLinecap]</h3>
-		<p>
-			Define appearance of line ends. Possible values are "butt", "round" and "square". Default is 'round'.<br /><br />
+		<p> 定义线两端的外观。可选值为 'butt'，'round' 和 'square'。默认为'round'。<br /><br />
 
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineCap 2D Canvas lineCap]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:String wireframeLinejoin]</h3>
 		<p>
-			Define appearance of line joints. Possible values are "round", "bevel" and "miter". Default is 'round'.<br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+			定义线连接节点的样式。可选值为 'round', 'bevel' 和 'miter'。默认值为 'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:Float wireframeLinewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p>控制线框宽度。默认值为1。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与
+			大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/MeshPhysicalMaterial.html

@@ -10,12 +10,10 @@
 	<body>
 		[page:Material] &rarr; [page:MeshStandardMaterial] &rarr;
 
-		<h1>[name]</h1>
+		<h1>物理网格材质([name])</h1>
 
-		<p class="desc">
-			An extension of the [page:MeshStandardMaterial] that allows for greater control over reflectivity.<br /><br />
-
-			Note that for best results you should always specify an [page:.envMap environment map] when using this material.
+		<p class="desc"> [page:MeshStandardMaterial]的扩展，能够更好地控制反射率。<br /><br />
+			请注意，为了获得最佳效果，您在使用此材质时应始终指定环境贴图。
 		</p>
 
 		<iframe id="scene" src="scenes/material-browser.html#MeshPhysicalMaterial"></iframe>
@@ -36,61 +34,54 @@
 
 		</script>
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 		[example:webgl_materials_variations_physical materials / variations / physical]<br />
 		[example:webgl_materials_reflectivity materials / reflectivity]
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-		[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-		Any property of the material (including any property inherited from [page:Material] and [page:MeshStandardMaterial]) can be passed in here.<br /><br />
-
-		The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-		string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)<br /><br />
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] and [page:MeshStandardMaterial] classes for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Float clearCoat]</h3>
 		<p>
-		ClearCoat level, from *0.0* to *1.0*. Default is *0.0*.
+			ClearCoat级别，从*0.0*到*1.0*。默认值为*0.0*。
 		</p>
 
 		<h3>[property:Float clearCoatRoughness]</h3>
-		<p>How rough the clearCoat appears, from *0.0* to *1.0*. Default is *0.0*.</p>
+		<p> clearCoat看起来的粗糙程度，从*0.0*到*1.0*。默认值为*0.0*。</p>
 
 		<h3>[property:Boolean isMeshPhysicalMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh physical materials. Default is *true*.<br /><br />
+		<p> 用于检查此类或派生类是否为Lambert网格材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Object defines]</h3>
-		<p>An object of the form:
+		<p> 如下形式的对象:
 			<code>
 				{ 'PHYSICAL': '' };
 			</code>
-
-			This is used by the [page:WebGLRenderer] for selecting shaders.
+			[page:WebGLRenderer]使用它来选择shaders。
 		</p>
 
 		<h3>[property:Float reflectivity]</h3>
-		<p>
-		Degree of reflectivity, from *0.0* to *1.0*. Default is *0.5*.<br />
-
-		This models the reflectivity of non-metallic materials. It has no effect when [page:MeshStandardMaterial.metalness metalness] is *1.0*
+		<p> 反射度，从*0.0*到*1.0*。默认值为*0.5*。<br />
+			这模拟了非金属材质的反射率。当[page:MeshStandardMaterial]为*1.0*时，此属性无效。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] and [page:MeshStandardMaterial] classes for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material] 和[page:MeshStandardMaterial]。</p>
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/MeshStandardMaterial.html

@@ -10,35 +10,24 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>标准网格材质([name])</h1>
 
-		<p class="desc">
-			A standard physically based material, using Metallic-Roughness workflow.<br /><br />
+		<p class="desc"> 一种基于物理的标准材质，使用Metallic-Roughness工作流程。<br /><br />
+			基于物理的渲染（PBR）最近已成为许多3D应用程序的标准，例如[link:https://blogs.unity3d.com/2014/10/29/physically-based-shading-in-unity-5-a-primer/ Unity]，
+			[link:https://docs.unrealengine.com/latest/INT/Engine/Rendering/Materials/PhysicallyBased/ Unreal]和
+			[link:http://area.autodesk.com/blogs/the-3ds-max-blog/what039s-new-for-rendering-in-3ds-max-2017 3D Studio Max]。<br /><br />
+			这种方法与旧方法的不同之处在于，不使用近似值来表示光与表面的相互作用，而是使用物理上正确的模型。
+			我们的想法是，不是在特定照明下调整材质以使其看起来很好，而是可以创建一种材质，能够“正确”地应对所有光照场景。<br /><br />
 
-			Physically based rendering (PBR) has recently become the standard in many 3D applications, such as
-			[link:https://blogs.unity3d.com/2014/10/29/physically-based-shading-in-unity-5-a-primer/ Unity],
-			[link:https://docs.unrealengine.com/latest/INT/Engine/Rendering/Materials/PhysicallyBased/ Unreal] and
-			[link:http://area.autodesk.com/blogs/the-3ds-max-blog/what039s-new-for-rendering-in-3ds-max-2017 3D Studio Max].<br /><br />
+			在实践中，该材质提供了比[page:MeshLambertMaterial] 或[page:MeshPhongMaterial] 更精确和逼真的结果，代价是计算成本更高。<br /><br />
 
-			This approach differs from older approaches in that instead of using approximations for the way in which
-			light	interacts with a surface, a physically correct model is used. The idea is that, instead of
-			tweaking materials to look good under specific lighting, a material can	be created that
-			will react 'correctly' under all lighting scenarios.<br /><br />
 
-			In practice this gives a more	accurate and realistic looking result than the [page:MeshLambertMaterial]
-			or [page:MeshPhongMaterial], at the cost of being somewhat more computationally expensive.<br /><br />
+			计算着色的方式与[page:MeshPhongMaterial]相同，都使用[link:https://en.wikipedia.org/wiki/Phong_shading Phong]着色模型，
+			这会计算每个像素的阴影（即在[link:https://en.wikipedia.org/wiki/Shader#Pixel_shaders fragment shader]，
+			AKA pixel shader中）， 与[page:MeshLambertMaterial]使用的Gouraud模型相比，该模型的结果更准确，但代价是牺牲一些性能。<br /><br />
 
-			Shading is calculated in the same way as for the [page:MeshPhongMaterial], using a
-			[link:https://en.wikipedia.org/wiki/Phong_shading Phong] shading model.	This calculates shading
-			per pixel (i.e. in the [link:https://en.wikipedia.org/wiki/Shader#Pixel_shaders fragment shader],
-			AKA pixel shader) which gives more accurate results than the Gouraud model used by
-			[page:MeshLambertMaterial], at the cost of some performance.<br /><br />
-
-			Note that for best results you should always specify an [page:.envMap environment map] when using
-			this material.<br /><br />
-
-			For a non-technical introduction to the concept of PBR and how to set up a PBR material,
-			check out these articles by the people at [link:https://www.marmoset.co marmoset]:
+			请注意，为获得最佳效果，您在使用此材质时应始终指定[page:.envMap environment map]。<br /><br />
+			有关PBR概念的非技术性介绍以及如何设置PBR材质，请查看[link:https://www.marmoset.co marmoset]成员的这些文章：
 			<ul>
 				<li>
 					[link:https://www.marmoset.co/posts/basic-theory-of-physically-based-rendering/ Basic Theory of Physically Based Rendering]
@@ -48,10 +37,9 @@
 				</li>
 			</ul>
 		</p>
-		<p>
-			Technical details of the approach used in three.js (and most other PBR systems) can be found is this
-			[link:https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf paper from Disney] (pdf),
-			by Brent Burley.
+		<p>在 three.js（以及其他大多数PBR系统）中使用方法的技术细节，
+			可以在Brent Burley撰写的[link:https://disney-animation.s3.amazonaws.com/library/s2012_pbs_disney_brdf_notes_v2.pdf paper from Disney] (pdf)
+			中查看。
 		</p>
 
 		<iframe id="scene" src="scenes/material-browser.html#MeshStandardMaterial"></iframe>
@@ -72,224 +60,175 @@
 
 		</script>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
-
-			The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-			string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Texture alphaMap]</h3>
-		<p>The alpha map is a grayscale texture that controls the opacity across the surface
-			(black: fully transparent; white: fully opaque). Default is null.<br /><br />
-
-			Only the color of the texture is used, ignoring the alpha channel if one exists.
-			For RGB and RGBA textures, the [page:WebGLRenderer WebGL] renderer will use the
-			green channel when sampling this texture due to the extra bit of precision provided
-			for green in DXT-compressed and uncompressed RGB 565 formats. Luminance-only and
-			luminance/alpha textures will also still work as expected.
+		<p>alpha贴图是一种灰度纹理，用于控制整个表面的不透明度（黑色：完全透明;白色：完全不透明）。默认值为null。<br /><br />
+			仅使用纹理的颜色，忽略alpha通道（如果存在）。对于RGB和RGBA纹理，[page:WebGLRenderer WebGL]渲染器在采样此纹理时将使用绿色通道，
+			因为在DXT压缩和未压缩RGB 565格式中为绿色提供了额外的精度。Luminance-only以及luminance/alpha纹理也仍然有效。
 		</p>
 
 		<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>
+		<p>该纹理的红色通道用作环境遮挡贴图。默认值为null。aoMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]属性。</p>
 
 		<h3>[property:Float aoMapIntensity]</h3>
-		<p>Intensity of the ambient occlusion effect. Default is 1. Zero is no occlusion effect.</p>
+		<p>环境遮挡效果的强度。默认值为1。零是不遮挡效果。</p>
 
 		<h3>[property:Texture bumpMap]</h3>
-		<p>
-			The texture to create a bump map. The black and white values map to the perceived depth in relation to the lights.
-			Bump doesn't actually affect the geometry of the object, only the lighting. If a normal map is defined this will
-			be ignored.
+		<p> 用于创建凹凸贴图的纹理。黑色和白色值映射到与光照相关的感知深度。凹凸实际上不会影响对象的几何形状，只影响光照。如果定义了法线贴图，则将忽略该贴图。
 		</p>
 
 		<h3>[property:Float bumpScale]</h3>
-		<p>How much the bump map affects the material. Typical ranges are 0-1. Default is 1.</p>
+		<p>凹凸贴图会对材质产生多大影响。典型范围是0-1。默认值为1。</p>
 
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff).</p>
+		<p>材质的颜色([page:Color])，默认值为白色 (0xffffff)。</p>
 
 		<h3>[property:Object defines]</h3>
-		<p>An object of the form:
+		<p>如下形式的对象:
 			<code>
 				{ 'STANDARD': '' };
 			</code>
-
-			This is used by the [page:WebGLRenderer] for selecting shaders.
+			[page:WebGLRenderer]使用它来选择shaders。
 		</p>
 
 		<h3>[property:Texture displacementMap]</h3>
-		<p>
-			The displacement map affects the position of the mesh's vertices. Unlike other maps
-			which only affect the light and shade of the material the displaced vertices can cast shadows,
-			block other objects, and otherwise act as real geometry. The displacement texture is
-			an image where the value of each pixel (white being the highest) is mapped against,
-			and repositions, the vertices of the mesh.
+		<p> 位移贴图会影响网格顶点的位置，与仅影响材质的光照和阴影的其他贴图不同，移位的顶点可以投射阴影，阻挡其他对象，
+			以及充当真实的几何体。位移纹理是指：网格的所有顶点被映射为图像中每个像素的值（白色是最高的），并且被重定位。
 		</p>
 
 		<h3>[property:Float displacementScale]</h3>
 		<p>
-			How much the displacement map affects the mesh (where black is no displacement,
-			and white is maximum displacement). Without a displacement map set, this value is not applied.
-			 Default is 1.
+			位移贴图对网格的影响程度（黑色是无位移，白色是最大位移）。如果没有设置位移贴图，则不会应用此值。默认值为1。
 		</p>
 
 		<h3>[property:Float displacementBias]</h3>
 		<p>
-			The offset of the displacement map's values on the mesh's vertices.
-			Without a displacement map set, this value is not applied. Default is 0.
+			位移贴图在网格顶点上的偏移量。如果没有设置位移贴图，则不会应用此值。默认值为0。
 		</p>
 
 		<h3>[property:Color emissive]</h3>
-		<p>
-		Emissive (light) color of the material, essentially a solid color unaffected by other lighting.
-		Default is black.
+		<p>材质的放射（光）颜色，基本上是不受其他光照影响的固有颜色。默认为黑色。
 		</p>
 
 		<h3>[property:Texture emissiveMap]</h3>
-		<p>
-		Set emisssive (glow) map. Default is null. The emissive map color is modulated by
-		the emissive color and the emissive intensity. If you have an emissive map, be sure to
-		set the emissive color to something other than black.
+		<p>设置放射（发光）贴图。默认值为null。放射贴图颜色由放射颜色和强度所调节。
+			如果你有一个放射贴图，请务必将放射颜色设置为黑色以外的其他颜色。
 		</p>
 
 		<h3>[property:Float emissiveIntensity]</h3>
-		<p>Intensity of the emissive light. Modulates the emissive color. Default is 1.</p>
+		<p>放射光强度。调节发光颜色。默认为1。</p>
 
 		<h3>[property:TextureCube envMap]</h3>
-		<p>The environment map. Default is null.  Note that in order for the material roughness
-		property to correctly blur out the environment map, the shader must have access to mipmaps
-		of the env texture.  TextureCubes created with default settings are correctly configured;
-		if adjusting texture parameters manually, ensure minFilter is set to one of the MipMap options,
-		and that mip maps have not been otherwise forcibly disabled.</p>
+		<p> 环境贴图。默认值为null。
+			请注意，为了使材质粗糙度属性能够正确地模糊环境贴图，shader必须能够访问环境纹理的mipmaps。
+			使用默认设置创建的TextureCubes已正确配置; 如果手动调整纹理参数，
+			请确保将minFilter设置为其中一个MipMap选项，并且未强制禁用mip贴图。</p>
 		<p>
-		Note: only [link:https://threejs.org/docs/#api/textures/CubeTexture cube environment maps] are supported 
-		for MeshStandardMaterial. If you want to use an equirectangular map you will need to use the 
-		[link:https://github.com/mrdoob/three.js/blob/dev/examples/js/loaders/EquirectangularToCubeGenerator.js EquirectangularToCubeGenerator]. 
-		See this [link:https://threejs.org/examples/webgl_materials_envmaps_exr.html example] for details.
+			注意：MeshStandardMaterial 仅支持[link:https://threejs.org/docs/#api/textures/CubeTexture cube environment maps]。
+			如果要使用equirectangular贴图，则需要使用 [link:https://github.com/mrdoob/three.js/blob/dev/examples/js/loaders/EquirectangularToCubeGenerator.js EquirectangularToCubeGenerator]。
+			详细信息请参阅此示例[link:https://threejs.org/examples/webgl_materials_envmaps_exr.html example]。
 		</p>
 
 		<h3>[property:Float envMapIntensity]</h3>
-		<p>Scales the effect of the environment map by multiplying its color.</p>
+		<p> 通过乘以环境贴图的颜色来缩放环境贴图的效果。</p>
 
 		<h3>[property:Boolean isMeshStandardMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh standard materials. Default is *true*.<br /><br />
-
-			You should not change this, as it used internally for optimisation.
+		<p> 用于检查此类或派生类是否为标准网格材质。默认值为 *true*。<br /><br />
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</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>光照贴图。默认值为null。lightMap需要第二组UVs，因此将忽略[page:Texture repeat]和[page:Texture offset]纹理属性。</p>
 
 		<h3>[property:Float lightMapIntensity]</h3>
-		<p>Intensity of the baked light. Default is 1.</p>
+		<p>烘焙光的强度。默认值为1。</p>
 
 		<h3>[property:Texture map]</h3>
-		<p>The color map. Default is null. The texture map color is modulated by the diffuse [page:.color].</p>
+		<p>颜色贴图。默认为null。纹理贴图颜色由漫反射颜色[page:.color]调节。</p>
 
 		<h3>[property:Float metalness]</h3>
-		<p>
-			How much the material is like a metal. Non-metallic materials such as wood or stone use 0.0, metallic use 1.0, with nothing
-			(usually) in between. Default is 0.5. A value between 0.0 and 1.0 could be used for a rusty metal look. If metalnessMap is
-			also provided, both values are multiplied.
+		<p> 材质与金属的相似度。非金属材质，如木材或石材，使用0.0，金属使用1.0，通常没有中间值。
+			默认值为0.5。0.0到1.0之间的值可用于生锈金属的外观。如果还提供了metalnessMap，则两个值相乘。
 		</p>
 
 		<h3>[property:Texture metalnessMap]</h3>
-		<p>The blue channel of this texture is used to alter the metalness of the material.</p>
+		<p> 该纹理的蓝色通道用于改变材质的金属度。</p>
 
 		<h3>[property:boolean morphNormals]</h3>
-		<p>
-			Defines whether the material uses morphNormals. Set as true to pass morphNormal
-			attributes from the [page:Geometry]	to the shader. Default is *false*.
+		<p> 定义是否使用morphNormals。设置为true可将morphNormal属性从[page:Geometry]传递到shader。默认值为*false*。
 		</p>
 
 		<h3>[property:Boolean morphTargets]</h3>
-		<p>Define whether the material uses morphTargets. Default is false.</p>
+		<p>定义材质是否使用morphTargets。默认值为false。</p>
 
 		<h3>[property:Texture normalMap]</h3>
-		<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.
+		<p>用于创建法线贴图的纹理。RGB值会影响每个像素片段的曲面法线，并更改颜色照亮的方式。法线贴图不会改变曲面的实际形状，只会改变光照。
 		</p>
 
 		<h3>[property:Integer normalMapType]</h3>
-		<p>
-			The type of normal map.<br /><br />
-
-			Options are [page:constant THREE.TangentSpaceNormalMap] (default), and [page:constant THREE.ObjectSpaceNormalMap].
+		<p>法线贴图的类型。<br /><br />
+			选项为[page:constant THREE.TangentSpaceNormalMap]（默认）和[page:constant THREE.ObjectSpaceNormalMap]。
 		</p>
 
 		<h3>[property:Vector2 normalScale]</h3>
-		<p>
-			How much the normal map affects the material. Typical ranges are 0-1.
-			Default is a [page:Vector2] set to (1,1).
+		<p> 法线贴图对材质的影响程度。典型范围是0-1。默认值是[page:Vector2]设置为（1,1）。
 		</p>
 
 		<h3>[property:Float refractionRatio]</h3>
-		<p>
-			The index of refraction (IOR) of air (approximately 1) divided by the index of refraction of the material.
-			It is used with environment mapping modes [page:Textures THREE.CubeRefractionMapping] and [page:Textures THREE.EquirectangularRefractionMapping].
-			The refraction ratio should not exceed 1. Default is *0.98*.
+		<p> 空气的折射率（IOR）（约为1）除以材质的折射率。它与环境映射模式[page:Textures THREE.CubeRefractionMapping]
+			和[page:Textures THREE.EquirectangularRefractionMapping]一起使用。
+			折射率不应超过1。默认值为*0.98*。
 		</p>
 
 		<h3>[property:Float roughness]</h3>
-		<p>
-			How rough the material appears. 0.0 means a smooth mirror reflection, 1.0 means fully diffuse. Default is 0.5.
-			If roughnessMap is also provided, both values are multiplied.
+		<p> 材质的粗糙程度。0.0表示平滑的镜面反射，1.0表示完全漫反射。默认值为0.5。如果还提供roughnessMap，则两个值相乘。
 		</p>
 
 		<h3>[property:Texture roughnessMap]</h3>
-		<p>The green channel of this texture is used to alter the roughness of the material.</p>
+		<p>该纹理的绿色通道用于改变材质的粗糙度。</p>
 
 		<h3>[property:Boolean skinning]</h3>
-		<p>Define whether the material uses skinning. Default is false.</p>
+		<p>材质是否使用蒙皮。默认值为false。</p>
 
 		<h3>[property:Boolean wireframe]</h3>
-		<p>Render geometry as wireframe. Default is *false* (i.e. render as flat polygons).</p>
+		<p>将几何体渲染为线框。默认值为*false*（即渲染为平面多边形）。</p>
 
 		<h3>[property:String wireframeLinecap]</h3>
-		<p>
-			Define appearance of line ends. Possible values are "butt", "round" and "square". Default is 'round'.<br /><br />
-
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineCap 2D Canvas lineCap]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+		<p> 定义线两端的外观。可选值为 'butt'，'round' 和 'square'。默认为'round'。<br /><br />
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:String wireframeLinejoin]</h3>
 		<p>
-			Define appearance of line joints. Possible values are "round", "bevel" and "miter". Default is 'round'.<br /><br />
+			定义线连接节点的样式。可选值为 'round', 'bevel' 和 'miter'。默认值为 'round'。<br /><br />
 
-			This corresponds to the [link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]
-			property and it is ignored by the [page:WebGLRenderer WebGL] renderer.
+			该属性对应[link:https://developer.mozilla.org/en/docs/Web/API/CanvasRenderingContext2D/lineJoin 2D Canvas lineJoin]属性，
+			并且会被[page:WebGLRenderer WebGL]渲染器忽略。
 		</p>
 
 		<h3>[property:Float wireframeLinewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p>控制线框宽度。默认值为1。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/MeshToonMaterial.html

@@ -10,9 +10,9 @@
 	<body>
 		[page:Material] &rarr; [page:MeshPhongMaterial] &rarr;
 
-		<h1>[name]</h1>
+		<h1>卡通网格材质([name])</h1>
 
-		<div class="desc">An extension of the [page:MeshPhongMaterial] with toon shading.</div>
+		<div class="desc">[page:MeshPhongMaterial]卡通着色的扩展。</div>
 
 		<!-- <iframe id="scene" src="scenes/material-browser.html#MeshStandardMaterial"></iframe>
 
@@ -32,49 +32,45 @@
 
 		</script> -->
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 		[example:webgl_materials_variations_toon materials / variations / toon]<br />
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-		[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-		Any property of the material (including any property inherited from [page:Material] and [page:MeshStandardMaterial]) can be passed in here.<br /><br />
-
-		The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-		string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]和[page:MeshStandardMaterial]继承的任何属性)。<br /><br />
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] and [page:MeshPhongMaterial] classes for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]和[page:MeshPhongMaterial]。</p>
 
 		<h3>[property:Texture gradientMap]</h3>
-		<p>Gradient map for the toon shading. Default is *null*.</p>
+		<p> 卡通着色的渐变贴图，默认值为*null*。</p>
 
 		<h3>[property:Boolean isMeshToonMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are mesh toon materials. Default is *true*.<br /><br />
+		<p> 用于检查此类或派生类是否为卡通网格材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Object defines]</h3>
-		<p>An object of the form:
+		<p>如下形式的对象:
 			<code>
 				{ 'TOON': '' };
 			</code>
 
-			This is used by the [page:WebGLRenderer] for selecting shaders.
+			[page:WebGLRenderer]使用它来选择shaders。
 		</p>
 
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] and [page:MeshPhongMaterial] classes for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]和[page:MeshPhongMaterial]。</p>
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/PointsMaterial.html

@@ -10,11 +10,11 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>点材质([name])</h1>
 
-		<p class="desc">The default material used by [page:Points].</p>
+		<p class="desc">[page:Points]使用的默认材质。</p>
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 		<p>
 			[example:misc_controls_fly misc / controls / fly]<br />
 			[example:webgl_buffergeometry_drawcalls WebGL / BufferGeometry / drawcalls]<br />
@@ -56,44 +56,41 @@ scene.add( starField );
 		</code>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。<br /><br />
 
-			The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-			string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff).</p>
+		<p>材质的颜色([page:Color])，默认值为白色 (0xffffff)。</p>
 
 		<h3>[property:Boolean isPointsMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are points materials. Default is *true*.<br /><br />
+		<p> 用于检查此类或派生类是否为点材质。默认值为 *true*。<br /><br />
 
-			You should not change this, as it used internally for optimisation.
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Texture map]</h3>
 
-		<p>Sets the color of the points using data from a [page:Texture].</p>
+		<p>使用[page:Texture]中的数据设置点的颜色。</p>
 
 		<h3>[property:Boolean morphTargets]</h3>
-		<p>Define whether the material uses morphTargets. Default is false.</p>
+		<p>材质是否使用morphTargets。默认值为false。</p>
 
 		<h3>[property:Number size]</h3>
-		<p>Sets the size of the points. Default is 1.0.</p>
+		<p>设置点的大小。默认值为1.0。</p>
 
 		<h3>[property:Boolean sizeAttenuation]</h3>
-		<p>Specify whether points' size is attenuated by the camera depth. (Perspective camera only.) Default is true.</p>
+		<p>指定点的大小是否因相机深度而衰减。（仅限透视摄像头。）默认为true。 </p>
 
 
-		<h2>Methods</h2>
+		<h2>方法(Methods)</h2>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/RawShaderMaterial.html

@@ -10,14 +10,12 @@
 	<body>
 		[page:ShaderMaterial] &rarr;
 
-		<h1>[name]</h1>
+		<h1>原始着色器材质([name])</h1>
 
-		<p class="desc">
-			This class works just like [page:ShaderMaterial], except that definitions of
-			built-in uniforms and attributes are not automatically prepended to the GLSL shader code.
+		<p class="desc"> 此类的工作方式与[page:ShaderMaterial]类似，不同之处在于内置的uniforms和attributes的定义不会自动添加到GLSL shader代码中。
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 		<p>
 			[example:webgl_buffergeometry_rawshader WebGL / buffergeometry / rawshader]<br />
 			[example:webgl_buffergeometry_instancing_billboards WebGL / buffergeometry / instancing / billboards]<br />
@@ -40,31 +38,28 @@ var material = new THREE.RawShaderMaterial( {
 } );
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material] and [page:ShaderMaterial]) can be passed in here.<br /><br />
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material] 和 [page:ShaderMaterial]继承的任何属性)。<br /><br />
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] and [page:ShaderMaterial] classes for common methods.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]和[page:ShaderMaterial]。</p>
 
 		<h3>[property:Boolean isRawShaderMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are raw shader materials. Default is *true*.<br /><br />
-
-			You should not change this, as it used internally for optimisation.
+		<p> 用于检查此类或派生类是否为点材质。默认值为 *true*。<br /><br />
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] and [page:ShaderMaterial] classes for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]和[page:ShaderMaterial]。</p>
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/ShaderMaterial.html

@@ -10,52 +10,41 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>着色器材质([name])</h1>
 
-		<p class="desc">
-			A material rendered with custom shaders. A shader is a small program written in
-			[link:https://www.khronos.org/files/opengles_shading_language.pdf GLSL] that runs on the GPU.
-			You may want to use a custom shader if you need to:
+		<p class="desc"> 使用自定义shader渲染的材质。
+			shader是一个用[link:https://www.khronos.org/files/opengles_shading_language.pdf GLSL]编写的小程序 ，在GPU上运行。
+			您可能需要使用自定义shader，如果你要：
 		<ul>
-			<li>implement an effect not included with any of the built-in [page:Material materials]</li>
-			<li>combine many objects into a single [page:Geometry] or [page:BufferGeometry] in order to improve performance</li>
+			<li>要实现内置 [page:Material materials] 之外的效果。</li>
+			<li>将许多对象组合成单个[page:Geometry]或[page:BufferGeometry]以提高性能。</li>
 		</ul>
-		There are the following notes to bear in mind when using a *ShaderMaterial*:
-
+		使用*ShaderMaterial*时需要注意以下注意事项：
 		<ul>
-			<li>
-				A *ShaderMaterial* will only be rendered properly by [page:WebGLRenderer],
-				since the GLSL code in the [link:https://en.wikipedia.org/wiki/Shader#Vertex_shaders vertexShader]
-				and [link:https://en.wikipedia.org/wiki/Shader#Pixel_shaders fragmentShader] properties must
-				be compiled and run on the GPU using WebGL.
+			<li>*ShaderMaterial* 只有使用 [page:WebGLRenderer] 才可以绘制正常，
+				因为 [link:https://en.wikipedia.org/wiki/Shader#Vertex_shaders vertexShader]
+				和 [link:https://en.wikipedia.org/wiki/Shader#Pixel_shaders fragmentShader]
+				属性中GLSL代码必须使用WebGL来编译并运行在GPU中。
 			</li>
-			<li>
-				As of THREE r72, directly assigning attributes in a ShaderMaterial is no longer supported.
-				A [page:BufferGeometry] instance (instead of a [page:Geometry] instance) must be used instead,
-				using [page:BufferAttribute] instances to define custom attributes.
+			<li> 从 THREE r72开始，不再支持在ShaderMaterial中直接分配属性。
+				必须使用 [page:BufferGeometry]实例 (而不是 [page:Geometry] 实例)，使用[page:BufferAttribute]实例来定义自定义属性。
 			</li>
-			<li>
-				As of THREE r77, [page:WebGLRenderTarget] or [page:WebGLRenderTargetCube] instances
-				are no longer supposed to be used as uniforms. Their [page:Texture texture] property
-				must be used instead.
+			<li> 从 THREE r77开始，[page:WebGLRenderTarget] 或 [page:WebGLRenderTargetCube] 实例不再被用作uniforms。
+				必须使用它们的[page:Texture texture] 属性。
 			</li>
-			<li>
-				Built in attributes and uniforms are passed to the shaders along with your code.
-				If you don't want the [page:WebGLProgram] to add anything to your shader code, you can use
-				[page:RawShaderMaterial] instead of this class.
+			<li> 内置attributes和uniforms与代码一起传递到shaders。
+				如果您不希望[page:WebGLProgram]向shader代码添加任何内容，则可以使用[page:RawShaderMaterial]而不是此类。
 			</li>
-			<li>
-				You can use the directive #pragma unroll_loop in order to unroll a *for* loop in GLSL by the shader preprocessor.
-				The directive has to be placed right above the loop. The loop formatting has to correspond to a defined standard.
+			<li> 您可以使用指令#pragma unroll_loop，以便通过shader预处理器在GLSL中展开for循环。
+				该指令必须放在循环的正上方。循环格式必须与定义的标准相对应。
 				<ul>
-					<li>
-						The loop has to be [link:https://en.wikipedia.org/wiki/Normalized_loop normalized].
+					<li> 循环必须标准化[link:https://en.wikipedia.org/wiki/Normalized_loop normalized]。
 					</li>
 					<li>
-						The loop variable has to be *i*.
+						循环变量必须是*i*。
 					</li>
 					<li>
-						The loop has to use a certain whitespace formatting.
+						循环必须使用某种空格格式。
 					</li>
 				</ul>
 				<code>
@@ -70,7 +59,7 @@
 		</ul>
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 
 		<p>
 			[example:webgl_animation_cloth webgl / animation / cloth ]<br />
@@ -122,95 +111,80 @@
 		} );
 		</code>
 
-		<h2>Vertex shaders and fragment shaders</h2>
+		<h2>顶点着色器和片元着色器(Vertex shaders and fragment shaders)</h2>
 
 		<div>
-			<p>You can specify two different types of shaders for each material:</p>
+			<p>您可以为每种材质指定两种不同类型的shaders：:</p>
 			<ul>
-				<li>
-					The vertex shader runs first; it receives *attributes*, calculates / manipulates
-					the position of each individual vertex, and passes additional data (*varying*s) to the fragment shader.
+				<li> 顶点着色器首先运行; 它接收*attributes*，
+					计算/操纵每个单独顶点的位置，并将其他数据（*varying*s）传递给片元着色器。
 				</li>
 				<li>
-					The fragment ( or pixel ) shader runs second; it sets the color of each individual "fragment"
-					(pixel) rendered to the screen.
+					片元（或像素）着色器后运行; 它设置渲染到屏幕的每个单独的“片元”（像素）的颜色。
 				</li>
 			</ul>
-			<p>There are three types of variables in shaders: uniforms, attributes, and varyings:</p>
+			<p>shader中有三种类型的变量: uniforms, attributes, 和 varyings:</p>
 			<ul>
-				<li>
-					*Uniforms* are variables that have the same value for all vertices - lighting, fog,
-					and shadow maps are examples of data that would be stored in uniforms.
-					Uniforms can be accessed by both the vertex shader and the fragment shader.
+				<li>*Uniforms*是所有顶点都具有相同的值的变量。
+					比如灯光，雾，和阴影贴图就是被储存在uniforms中的数据。
+					uniforms可以通过顶点着色器和片元着色器来访问。
 				</li>
-				<li>
-					*Attributes* are variables associated with each vertex---for instance, the vertex position,
-					face normal, and vertex color are all examples of data that would be stored in attributes.
-					Attributes can <em>only</em> be accessed within the vertex shader.
+				<li> *Attributes* 与每个顶点关联的变量。例如，顶点位置，法线和顶点颜色都是存储在attributes中的数据。attributes <em>只</em>
+					可以在顶点着色器中访问。
 				</li>
-				<li>
-					*Varyings* are variables that are passed from the vertex shader to the fragment shader.
-					For each fragment, the value of each varying will be smoothly interpolated from the values of adjacent vertices.
+				<li> *Varyings* 是从顶点着色器传递到片元着色器的变量。对于每一个片元，每一个varying的值将是相邻顶点值的平滑插值。
 				</li>
 			</ul>
-			<p>
-				Note that <em>within</em> the shader itself, uniforms and attributes act like constants;
-				you can only modify their values by passing different values to the buffers from your JavaScript code.
+			<p> 注意：在shader <em>内部</em>，uniforms和attributes就像常量；你只能使用JavaScript代码通过缓冲区来修改它们的值。
 			</p>
 		</div>
 
 
-	<h2>Built-in attributes and uniforms</h2>
+	<h2>内置attributes 和 uniforms(Built-in attributes and uniforms)</h2>
 
 	<div>
 			<p>
-			The [page:WebGLRenderer] provides many attributes and uniforms to shaders by default;
-			definitions of these variables are prepended to your *fragmentShader* and *vertexShader*
-			code by the [page:WebGLProgram] when the shader is compiled; you don't need to declare them yourself.
-			See [page:WebGLProgram] for details of these variables.
+				[page:WebGLRenderer]默认情况下为shader提供了许多attributes和uniforms；
+				这些变量定义在shader程序编译时被自动添加到*片元着色器*和*顶点着色器*代码的前面，你不需要自己声明它们。
+				这些变量的描述请参见[page:WebGLProgram]。
 			</p>
 			<p>
-			Some of these uniforms or attributes (e.g. those pertaining lighting, fog, etc.)
-			require properties to be set on the material in order for [page:WebGLRenderer] to copy
-			the appropriate values to the GPU - make sure to set these flags if you want to use these
-			features in your own shader.
+				这些uniforms或attributes（例如，那些和照明，雾等相关的）要求属性设置在材质上，
+				以便 [page:WebGLRenderer]来拷贝合适的值到GPU中。
+				如果你想在自己的shader中使用这些功能，请确保设置这些标志。
 			</p>
 			<p>
-			If you don't want [page:WebGLProgram] to add anything to your shader code, you can use
-			[page:RawShaderMaterial] instead of this class.
+				如果你不希望[page:WebGLProgram] 向你的shader代码中添加任何东西，
+				你可以使用[page:RawShaderMaterial] 而不是这个类。
 			</p>
 		</div>
 
 
-		<h2>Custom attributes and uniforms</h2>
+		<h2>自定义 attributes 和 uniforms(Custom attributes and uniforms)</h2>
 
 		<div>
 			<p>
-				Both custom attributes and uniforms must be declared in your GLSL shader code
-				(within *vertexShader* and/or *fragmentShader*). Custom uniforms must be defined in <em>both</em>
-				the *uniforms* property of your *ShaderMaterial*, whereas any custom attributes must be
-				defined via [page:BufferAttribute] instances. Note that *varying*s only need to
-				be declared within the shader code (not within the material).
+				自定义attributes和uniforms必须在GLSL着色器代码中声明（在 *vertexShader* 和/或 *fragmentShader* 中)。
+				自定义uniforms必须定义为 *ShaderMaterial* 的  *uniforms* 属性，
+				而任何自定义attribtes必须通过[page:BufferAttribute]实例来定义。
+				注意 *varying*s 只需要在shader代码中声明（而不必在材质中）。
 			</p>
-			<p>
-				To declare a custom attribute, please reference the [page:BufferGeometry] page for an overview,
-				and the [page:BufferAttribute] page for a detailed look at the *BufferAttribute* API.
+			<p> 要声明一个自定义属性，更多细节请参考[page:BufferGeometry]页面，
+				以及 [page:BufferAttribute] 页面关于*BufferAttribute* 接口。
 			</p>
 			<p>
-				When creating your attributes, each typed array that you create to hold your
-				attribute's data must be a multiple of your data type's size. For example, if your
-				attribute is a [page:Vector3 THREE.Vector3] type, and you have 3000 vertices in your
-				[page:BufferGeometry], your typed array value must be created with a length of 3000 * 3,
-				or 9000 (one value per-component). A table of each data type's size is shown below for reference:
+				当创建attributes时，您创建的用来保存属性数据的每个类型化数组（typed array）必须是您的数据类型大小的倍数。
+				比如，如果你的属性是一个[page:Vector3 THREE.Vector3]类型，并且在你的缓存几何模型[page:BufferGeometry]中有3000个顶点，
+				那么你的类型化数组的长度必须是3000 * 3，或者9000（一个顶点一个值）。每个数据类型的尺寸如下表所示：
 			</p>
 
 			<table>
-				<caption><a id="attribute-sizes">Attribute sizes</a></caption>
+				<caption><a id="attribute-sizes">属性尺寸</a></caption>
 				<thead>
 					<tr>
-						<th>GLSL type</th>
-						<th>JavaScript type</th>
-						<th>Size</th>
+						<th>GLSL 类型</th>
+						<th>JavaScript 类型</th>
+						<th>尺寸</th>
 					</tr>
 				</thead>
 				<tbody>
@@ -243,13 +217,13 @@
 			</table>
 
 			<p>
-				Note that attribute buffers are <em>not</em> refreshed automatically when their values change. To update custom attributes,
-				set the *needsUpdate* flag to true on the [page:BufferAttribute] of the geometry (see [page:BufferGeometry]
-				for further details).
+				请注意，属性缓冲区 <em>不会</em> 在其值更改时自动刷新。要更新自定义属性，
+				需要在模型的[page:BufferAttribute]中设置*needsUpdate*为true。
+				（查看[page:BufferGeometry]了解细节）。
 			</p>
 
 			<p>
-			To declare a custom [page:Uniform], use the *uniforms* property:
+				要声明一个自定义的[page:Uniform]，使用*uniforms*属性：
 			<code>
 			uniforms: {
 				time: { value: 1.0 },
@@ -259,34 +233,29 @@
 			</p>
 
 			<p>
-			You're recommended to update custom [page:Uniform] values depending on [page:Object3D object] and [page:Camera camera]
-			in [page:Object3D.onBeforeRender] because [page:Material] can be shared among [page:Mesh meshes], [page:Matrix4 matrixWorld]
-			of [page:Scene] and [page:Camera] are updated in [page:WebGLRenderer.render], and some effects(ex:VREffect) render a [page:Scene scene]
-			with private their own [page:Camera cameras].
+				在[page:Object3D.onBeforeRender]中，建议根据[page:Object3D object]和[page:Camera camera]来更新自定义[page:Uniform]的值。
+				因为 [page:Material] 可以被[page:Mesh meshes]，[page:Scene]的[page:Matrix4 matrixWorld]以及[page:Camera]共享，
+				会在[page:WebGLRenderer.render]中更新，并会对拥有私有[page:Camera cameras]的[page:Scene scene]的渲染造成影响。
 			</p>
 
 		</div>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material]继承的任何属性)。
 		</p>
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Boolean clipping]</h3>
-		<p>
-		Defines whether this material supports clipping; true to let the renderer pass the clippingPlanes uniform. Default is false.
+		<p> 定义此材质是否支持剪裁; 如果渲染器传递clippingPlanes uniform，则为true。默认值为false。
 		</p>
 
 		<h3>[property:Object defaultAttributeValues]</h3>
-		<p>
-			When the rendered geometry doesn't include these attributes but the material does,
-			 these default values will be passed to the shaders. This avoids errors when buffer data is missing.
+		<p> 当渲染的几何体不包含这些属性但材质包含这些属性时，这些默认值将传递给shaders。这可以避免在缓冲区数据丢失时出错。
 
 			<code>
 this.defaultAttributeValues = {
@@ -300,26 +269,22 @@ this.defaultAttributeValues = {
 
 
 		<h3>[property:Object defines]</h3>
-		<p>
-		Defines custom constants using *#define* directives within the GLSL code for both the
-		vertex shader and the fragment shader; each key/value pair yields another directive:
+		<p> 使用 #define 指令在GLSL代码为顶点着色器和片段着色器定义自定义常量；每个键/值对产生一行定义语句：
 		<code>
 		defines: {
 			FOO: 15,
 			BAR: true
 		}
 		</code>
-		yields the lines
+		这将在GLSL代码中产生如下定义语句：
 		<code>
 		#define FOO 15
 		#define BAR true
 		</code>
-		in the GLSL code.
 		</p>
 
 		<h3>[property:Object extensions]</h3>
-		<p>
-		An object with the following properties:
+		<p> 一个有如下属性的对象：
 		<code>
 this.extensions = {
 	derivatives: false, // set to use derivatives
@@ -332,138 +297,111 @@ this.extensions = {
 
 
 		<h3>[property:Boolean fog]</h3>
-		<p>
-			Define whether the material color is affected by global fog settings; true to pass
-			fog uniforms to the shader. Default is false.
+		<p> 定义材质颜色是否受全局雾设置的影响; 如果将fog uniforms传递给shader，则为true。默认值为false。
 		</p>
 
 
 		<h3>[property:String fragmentShader]</h3>
 		<p>
-		Fragment shader GLSL code.  This is the actual code for the shader. In the example above,
-		the *vertexShader* and *fragmentShader* code is extracted from the DOM; it could be passed
-		as a string directly or loaded via AJAX instead.
+			片元着色器的GLSL代码。这是shader程序的实际代码。在上面的例子中，
+			*vertexShader*  和 *fragmentShader* 代码是从DOM（HTML文档）中获取的；
+			它也可以作为一个字符串直接传递或者通过AJAX加载。
 		</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]
-			to bind a generic vertex index to an attribute variable.
-			Default is undefined.
+		<p> 如果设置，则调用[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/bindAttribLocation gl.bindAttribLocation]
+			将通用顶点索引绑定到属性变量。默认值未定义。
 
 		</p>
 
 		<h3>[property:Boolean isShaderMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are shader materials. Default is *true*.<br /><br />
-
-			You should not change this, as it used internally for optimisation.
+		<p> 用于检查此类或派生类是否为着色器材质。默认值为 *true*。<br /><br />
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 
 
 
 		<h3>[property:Boolean lights]</h3>
-		<p>
-		Defines whether this material uses lighting; true to pass uniform data related to lighting to this shader. Default is false.
+		<p> 材质是否受到光照的影响。默认值为 *false*。如果传递与光照相关的uniform数据到这个材质，则为true。默认是false。
 		</p>
 
 		<h3>[property:Float linewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p>控制线框宽度。默认值为1。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
 
 		<h3>[property:Boolean morphTargets]</h3>
-		<p>
-		Defines whether the material uses morphTargets; true morphTarget attributes to this shader
+		<p> 定义材质是否使用 morphTargets。如果将morphTarget attributes传递到此shader，则为true。
 		</p>
 
 		<h3>[property:boolean morphNormals]</h3>
-		<p>
-			Defines whether the material uses morphNormals. Set as true to pass morphNormal attributes from the [page:Geometry]
-			to the shader. Default is *false*.
+		<p> 定义材质是否使用 morphNormals。设置为true，将从[page:Geometry]传递morphNormal属性给shader。默认值是*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> 与此材质相关联的编译后的shader程序，由[page:WebGLRenderer]生成。您应该不需要访问此属性。
 		</p>
 
 		<h3>[property:Boolean flatShading]</h3>
-		<p>
-		Define whether the material is rendered with flat shading. Default is false.
+		<p> 定义材质是否使用平面着色进行渲染。默认值为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.
+		<p> 定义材质是否使用蒙皮; 如果将蒙皮属性传递给shader，则为true。默认值为false。
 		</p>
 
 		<h3>[property:Object uniforms]</h3>
-		<p>
-			An object of the form:
+		<p> 如下形式的对象：
 			<code>
 { "uniform1": { value: 1.0 }, "uniform2": { value: 2 } }
 			</code>
-		specifying the uniforms to be passed to the shader code; keys are uniform names, values are definitions of the form
+			指定要传递给shader代码的uniforms；键为uniform的名称，值(value)是如下形式：
 		<code>
 		{ value: 1.0 }
 		</code>
-		where *value* is the value of the uniform. Names must match the name of the uniform,
-		as defined in the GLSL code. Note that uniforms are refreshed on every frame,
-		so updating the value of the uniform will immediately update the value available to the GLSL code.
+			这里 *value* 是uniform的值。名称必须匹配 uniform 的name，和GLSL代码中的定义一样。
+			注意，uniforms逐帧被刷新，所以更新uniform值将立即更新GLSL代码中的相应值。
 		</p>
 
 
 		<h3>[property:Number vertexColors]</h3>
-		<p>
-		Define how the vertices are colored, by defining how the *colors* attribute gets populated.
-		Possible values are [page:Materials THREE.NoColors], [page:Materials THREE.FaceColors] and
-		[page:Materials THREE.VertexColors]. Default is THREE.NoColors.
+		<p> 通过定义*colors*属性的生成方式来定义顶点是如何着色的。
+			可选值为[page:Materials THREE.NoColors], [page:Materials THREE.FaceColors] 和
+			[page:Materials THREE.VertexColors]。 缺省为 THREE.NoColors。
 		</p>
 
 		<h3>[property:String vertexShader]</h3>
-		<p>
-		Vertex shader GLSL code.  This is the actual code for the shader. In the example above,
-		the *vertexShader* and *fragmentShader* code is extracted from the DOM; it could be passed
-		as a string directly or loaded via AJAX instead.
+		<p> 顶点着色器的GLSL代码。这是shader程序的实际代码。
+			在上面的例子中，*vertexShader* 和 *fragmentShader* 代码是从DOM（HTML文档）中获取的；
+			它也可以作为一个字符串直接传递或者通过AJAX加载。
 		</p>
 
 		<h3>[property:Boolean wireframe]</h3>
-		<p>
-		Render geometry as wireframe (using GL_LINES instead of GL_TRIANGLES). Default is false (i.e. render as flat polygons).
+		<p> 将几何体渲染为线框(通过GL_LINES而不是GL_TRIANGLES)。默认值为*false*（即渲染为平面多边形）。
 		</p>
 
 		<h3>[property:Float wireframeLinewidth]</h3>
-		<p>Controls wireframe thickness. Default is 1.<br /><br />
-
-		Due to limitations of the [link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile)
-		with the [page:WebGLRenderer WebGL] renderer on most platforms linewidth will
-		always be 1 regardless of the set value.
+		<p>控制线框宽度。默认值为1。<br /><br />
+			由于[link:https://www.khronos.org/registry/OpenGL/specs/gl/glspec46.core.pdf OpenGL Core Profile]与大多数平台上[page:WebGLRenderer WebGL]渲染器的限制，无论如何设置该值，线宽始终为1。
 		</p>
 
 
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
 		<h3>[method:ShaderMaterial clone]() [param:ShaderMaterial this]</h3>
-		<p>
-		Generates a shallow copy of this material. Note that the vertexShader and fragmentShader
-		are copied <em>by reference</em>, as are the definitions of the *attributes*; this means
-		that clones of the material will share the same compiled [page:WebGLProgram]. However, the
-		*uniforms* are copied <em>by value</em>, which allows you to have different sets of uniforms
-		for different copies of the material.
+		<p> 创建该材质的一个浅拷贝。需要注意的是，vertexShader和fragmentShader使用<em>引用拷贝</em>；
+			*attributes*的定义也是如此;
+			这意味着，克隆的材质将共享相同的编译[page:WebGLProgram]；
+			但是，*uniforms* 是 <em>值拷贝</em>，这样对不同的材质我们可以有不同的uniforms变量。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/ShadowMaterial.html

@@ -10,13 +10,13 @@
 	<body>
 		[page:Material] &rarr; [page:ShaderMaterial] &rarr;
 
-		<h1>[name]</h1>
+		<h1>阴影材质([name])</h1>
 
 		<p class="desc">
-		This material can receive shadows, but otherwise is completely transparent.
+			此材质可以接收阴影，但在其他方面完全透明。
 		</p>
 
-		<h3>Example</h3>
+		<h3>例子(Example)</h3>
 		[example:webgl_geometry_spline_editor geometry / spline / editor]
 
 		<code>
@@ -32,35 +32,32 @@ plane.receiveShadow = true;
 scene.add( plane );
 		</code>
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
-		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material] and [page:ShaderMaterial]) can be passed in here.<br /><br />
+		<p> [page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material] 和 [page:ShaderMaterial]继承的任何属性)。<br /><br />
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] and [page:ShaderMaterial] classes for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]和[page:ShaderMaterial]。</p>
 
 		<h3>[property:Boolean isShadowMaterial]</h3>
-		<p>
-			Used to check whether this or derived classes are shadow materials. Default is *true*.<br /><br />
-
-			You should not change this, as it used internally for optimisation.
+		<p> 用于检查此类或派生类是否为阴影材质。默认值为 *true*。<br /><br />
+			因为其通常用在内部优化，所以不应该更改该属性值。
 		</p>
 
 		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *true*.</p>
+		<p> 材质是否受到光照的影响。默认值为 *true*。</p>
 
 		<h3>[property:Boolean transparent]</h3>
-		<p>Defines whether this material is transparent. Default is *true*.</p>
+		<p>定义此材质是否透明。默认值为 *true*。</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] and [page:ShaderMaterial] classes for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]和[page:ShaderMaterial]。</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/materials/SpriteMaterial.html

@@ -10,11 +10,11 @@
 	<body>
 		[page:Material] &rarr;
 
-		<h1>[name]</h1>
+		<h1>点精灵材质([name])</h1>
 
-		<p class="desc">A material for a use with a [page:Sprite].</p>
+		<p class="desc">一种使用[page:Sprite]的材质。</p>
 
-		<h2>Examples</h2>
+		<h2>例子(Examples)</h2>
 		<div>
 			[example:webgl_sprites WebGL / sprites]<br />
 			[example:misc_ubiquity_test misc / ubiquity / test]<br />
@@ -39,41 +39,40 @@ scene.add( sprite );
 
 		<h3>[name]( [param:Object parameters] )</h3>
 		<p>
-			[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance.
-			Any property of the material (including any property inherited from [page:Material]) can be passed in here.<br /><br />
+			[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。
+			材质的任何属性都可以从此处传入(包括从[page:Material] 和 [page:ShaderMaterial]继承的任何属性)。<br /><br />
 
-			The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal
-			string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.
-
-			SpriteMaterials are not clipped by using [page:Material.clippingPlanes].
+			属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），
+			内部调用[page:Color.set](color)。
+			SpriteMaterials不会被[page:Material.clippingPlanes]裁剪。
 		</p>
 
 
-		<h2>Properties</h2>
-		<p>See the base [page:Material] class for common properties.</p>
+		<h2>属性(Properties)</h2>
+		<p>常用属性请参见基类[page:Material]。</p>
 
 		<h3>[property:Color color]</h3>
-		<p>[page:Color] of the material, by default set to white (0xffffff). The [page:.map] is mutiplied by the color.</p>
+		<p>材质的颜色([page:Color])，默认值为白色 (0xffffff)。 [page:.map]会和 color 相乘。</p>
 
 		<h3>[property:boolean fog]</h3>
-		<p>Whether or not this material affected by the scene's fog. Default is false</p>
+		<p>材质是否受场景雾的影响。默认值为*false*。</p>
 
 		<h3>[property:Boolean lights]</h3>
-		<p>Whether the material is affected by lights. Default is *false*.</p>
+		<p>材质是否受到光照的影响。默认值为 *false*。</p>
 
 		<h3>[property:Texture map]</h3>
-		<p>The texture map. Default is null.</p>
+		<p>颜色贴图。默认为null。</p>
 
 		<h3>[property:Radians rotation]</h3>
-		<p>The rotation of the sprite in radians. Default is 0.</p>
+		<p> sprite的转动，以弧度为单位。默认值为0。</p>
 
 		<h3>[property:Boolean sizeAttenuation]</h3>
-		<p>Whether the size of the sprite is attenuated by the camera depth. (Perspective camera only.) Default is *true*.</p>
+		<p> 精灵的大小是否会被相机深度衰减。（仅限透视摄像头。）默认为*true*。</p>
 
-		<h2>Methods</h2>
-		<p>See the base [page:Material] class for common methods.</p>
+		<h2>方法(Methods)</h2>
+		<p>常用方法请参见基类[page:Material]。</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/math/Box2.html

@@ -11,208 +11,181 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Represents a box in 2D space.
+			表示二维空间中的一个包围盒。
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 
 		<h3>[name]( [param:Vector2 min], [param:Vector2 max] )</h3>
 		<p>
-		[page:Vector2 min] - (optional) [page:Vector2] representing the lower (x, y) boundary of the box.
-		Default is ( + Infinity, + Infinity ).<br>
+		[page:Vector2 min] - (可选) [page:Vector2] 表示该盒子的下边界(x, y)。默认值为( + Infinity, + Infinity )。<br>
 
-		[page:Vector2 max] - (optional) [page:Vector2] representing the upper (x, y) boundary of the box.
-		Default is ( - Infinity, - Infinity ).<br /><br />
-
-		Creates a [name] bounded by min and max.
+		[page:Vector2 max] - (可选) [page:Vector2] 表示该盒子的上边界(x, y)。默认值为( - Infinity, - Infinity )。<br /><br />
+		创建一个介于最小和最大值之间的[name]。
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性(Properties)</h2>
 
 
 
 		<h3>[property:Vector2 min]</h3>
 		<p>
-			[page:Vector2] representing the lower (x, y) boundary of the box.<br />
-			Default is ( + Infinity, + Infinity ).
+			[page:Vector2] 表示该盒子的下边界(x, y)。<br />
+			默认值为( + Infinity, + Infinity )。
 		</p>
 
 		<h3>[property:Vector2 max]</h3>
 		<p>
-			[page:Vector2] representing the lower upper (x, y) boundary of the box.<br />
-			Default is ( - Infinity, - Infinity ).
+			[page:Vector2] 表示该盒子的上边界(x, y)。<br />
+			默认值为( - Infinity, - Infinity )。
 		</p>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法(Methods)</h2>
 
 		<h3>[method:Vector2 clampPoint]( [param:Vector2 point], [param:Vector2 target] )</h3>
 		<p>
-		[page:Vector2 point] - [page:Vector2] to clamp. <br>
-		[page:Vector2 target] — the result will be copied into this Vector2.<br /><br />
-
-		[link:https://en.wikipedia.org/wiki/Clamping_(graphics) Clamps] the [page:Vector2 point] within the bounds of this box.<br />
+		[page:Vector2 point] - clamp 的位置 ([page:Vector2])  <br>
+		[page:Vector2 target] — 结果会被复制到该二维向量中。<br /><br />
+		在该盒子范围内夹紧（[link:https://en.wikipedia.org/wiki/Clamping_(graphics) Clamps]）[page:Vector2 point]。<br />
 		</p>
 
 		<h3>[method:Box2 clone]()</h3>
-		<p>Returns a new [page:Box2] with the same [page:.min min] and [page:.max max] as this one.</p>
+		<p>返回一个新的[page:Box2]，其[page:.min min]和[page:.max max]与此盒子相同。</p>
 
 		<h3>[method:Boolean containsBox]( [param:Box2 box] )</h3>
 		<p>
-		[page:Box2 box] - [page:Box2 Box2] to test for inclusion.<br /><br />
-
-		Returns true if this box includes the entirety of [page:Box2 box]. If this and [page:Box2 box] are identical, <br>
-		this function also returns true.
+		[page:Box2 box] - 要检查是否被包含的盒子。<br /><br />
+        如果盒子包含整个被检查盒子，则返回true。如果两者重叠，<br>
+		也会返回true。
 		</p>
 
 		<h3>[method:Boolean containsPoint]( [param:Vector2 point] )</h3>
 		<p>
-		[page:Vector2 point] - [page:Vector2] to check for inclusion.<br /><br />
-
-		Returns true if the specified [page:Vector2 point] lies within or on the boundaries of this box.
+		[page:Vector2 point] - 要检查是否被包含的点[page:Vector2]。<br /><br />
+		如果指定的点([page:Vector2 point])位于盒子的边界内或边界上，则返回true。
 		</p>
 
 		<h3>[method:Box2 copy]( [param:Box2 box] )</h3>
 		<p>
-		Copies the [page:.min min] and [page:.max max] from [page:Box2 box] to this box.
+			将[page:Box2 box]的[page:.min min] 和 [page:.max max]复制到此盒子中。
 		</p>
 
 		<h3>[method:Float distanceToPoint]( [param:Vector2 point] )</h3>
 		<p>
-		[page:Vector2 point] - [page:Vector2] to measure distance to.<br /><br />
-
-		Returns the distance from any edge of this box to the specified point.
-		If the [page:Vector2 point] lies inside of this box, the distance will be 0.
+		[page:Vector2 point] - 要测量距离的点([page:Vector2])。<br /><br />
+		返回这个盒子的任何边缘到指定点的距离。如果这个点([page:Vector2 point])位于这个盒子里，距离将是0。
 		</p>
 
 		<h3>[method:Boolean equals]( [param:Box2 box] )</h3>
 		<p>
-		[page:Box2 box] - Box to compare with this one.<br /><br />
-
-		Returns true if this box and [page:Box2 box] share the same lower and upper bounds.
+		[page:Box2 box] - 要对比的盒子<br /><br />
+		如果这个盒子和被对比盒子具有相同的上下边界，则返回true。
 		</p>
 
 		<h3>[method:Box2 expandByPoint]( [param:Vector2 point] )</h3>
 		<p>
-		[page:Vector2 point] - [page:Vector2] that should be included in the box.<br /><br />
-
-		Expands the boundaries of this box to include [page:Vector2 point].
+		[page:Vector2 point] - 应该被盒子包含的点。<br /><br />
+		扩展盒子的边界来包含该点。
 		</p>
 
 		<h3>[method:Box2 expandByScalar]( [param:float scalar] )</h3>
 		<p>
-		[page:float scalar] - Distance to expand the box by.<br /><br />
-
-		Expands each dimension of the box by [page:float scalar]. If negative, the dimensions of the box
-		will be contracted.
+		[page:float scalar] - 盒子扩展的距离。<br /><br />
+		在每个维度上扩展参数scalar所指定的距离，如果为负数，则盒子空间将收缩。
 		</p>
 
 		<h3>[method:Box2 expandByVector]( [param:Vector2 vector] )</h3>
 		<p>
-		[page:Vector2 vector] - [page:Vector2] to expand the box by.<br /><br />
-
-		Expands this box equilaterally by [page:Vector2 vector]. The width of this box will be
-		expanded by the x component of [page:Vector2 vector] in both directions. The height of
-		this box will be expanded by the y component of [page:Vector2 vector] in both directions.
+		[page:Vector2 vector] - 按照该向量扩展。<br /><br />
+		在每个维度中按vector的数值进行扩展。宽度在两个方向上的扩展将由vector的x分量确定，
+			高度在两个方向上的扩展则由y分量确定。
 		</p>
 
 		<h3>[method:Vector2 getCenter]( [param:Vector2 target] )</h3>
 		<p>
-		[page:Vector2 target] — the result will be copied into this Vector2.<br /><br />
-
-		Returns the center point of the box as a [page:Vector2].
+		[page:Vector2 target] — 结果将被复制到此二维向量中。<br /><br />
+		以二维向量形式返回盒子的中心点。
 		</p>
 
 		<h3>[method:Vector2 getParameter]( [param:Vector2 point], [param:Vector2 target] ) </h3>
 		<p>
-		[page:Vector2 point] - [page:Vector2].<br/>
-		[page:Vector2 target] — the result will be copied into this Vector2.<br /><br />
+		[page:Vector2 point] - 二维向量([page:Vector2]).<br/>
+		[page:Vector2 target] — 结果将被复制到此二维向量中。<br /><br />
 
-		Returns a point as a proportion of this box's width and height.
+			返回一个点作为此盒子的宽度和高度的比例。
 		</p>
 
 		<h3>[method:Vector2 getSize]( [param:Vector2 target] )</h3>
 		<p>
-		[page:Vector2 target] — the result will be copied into this Vector2.<br /><br />
+		[page:Vector2 target] — 结果将被复制到此二维向量中。<br /><br />
 
-		Returns the width and height of this box.
+			返回此盒子的宽度和高度。
 		</p>
 
 		<h3>[method:Box2 intersect]( [param:Box2 box] )</h3>
 		<p>
-		[page:Box2 box] - Box to intersect with.<br /><br />
-
-		Returns the intersection of this and [page:Box2 box], setting the upper bound of this box to the lesser
-		of the two boxes' upper bounds and the lower bound of this box to the greater of the two boxes'
-		lower bounds.
+		[page:Box2 box] - 要相交的盒子。<br /><br />
+		返回两者的相交后的盒子，并将相交后的盒子的上限设置为两者的上限中的较小者，将下限设置为两者的下限中的较大者。
 		</p>
 
 		<h3>[method:Boolean intersectsBox]( [param:Box2 box] )</h3>
 		<p>
-		[page:Box2 box] - Box to check for intersection against.<br /><br />
-
-		Determines whether or not this box intersects [page:Box2 box].
+		[page:Box2 box] - 用来检查相交的盒子。<br /><br />
+		确定该盒子是否和其相交。
 		</p>
 
 		<h3>[method:Boolean isEmpty]()</h3>
 		<p>
-		Returns true if this box includes zero points within its bounds.<br>
-		Note that a box with equal lower and upper bounds still includes one point, the
-		one both bounds share.
+			如果这个盒子包含0个顶点，则返回true。<br>
+			请注意，一个下上边界相等的的盒子仍然包括一个点，一个两个边界共享的点。
 		</p>
 
 		<h3>[method:Box2 makeEmpty]()</h3>
-		<p>Makes this box empty.</p>
+		<p>使此盒子为空。</p>
 
 
 		<h3>[method:Box2 set]( [param:Vector2 min], [param:Vector2 max] )</h3>
 		<p>
-			[page:Vector2 min] - (required ) [page:Vector2] representing the lower (x, y) boundary of the box. <br>
-			[page:Vector2 max]  - (required) [page:Vector2] representing the upper (x, y) boundary of the box. <br /><br />
+			[page:Vector2 min] - (必须 ) 表示该盒子的下边界(x, y)。 <br>
+			[page:Vector2 max]  - (必须) 表示该盒子的上边界(x, y)。 <br /><br />
 
-			Sets the lower and upper (x, y) boundaries of this box.
+			设置这个盒子的上下(x, y)的界限。
 		</p>
 
 		<h3>[method:Box2 setFromCenterAndSize]( [param:Vector2 center], [param:Vector2 size] )</h3>
 		<p>
-		[page:Vector2 center] - Desired center position of the box ([page:Vector2]). <br>
-		[page:Vector2 size] - Desired x and y dimensions of the box ([page:Vector2]).<br /><br />
+		[page:Vector2 center] - 盒子所要设置的中心位置。 ([page:Vector2]). <br>
+		[page:Vector2 size] - 盒子所要设置的x和y尺寸 ([page:Vector2]).<br /><br />
 
-		Centers this box on [page:Vector2 center] and sets this box's width and height to the values specified
-		in [page:Vector2 size].
+		使盒子的中心点位于[page:Vector2 center]，并设置宽高为[page:Vector2 size]中指定的值。
 		</p>
 
 		<h3>[method:Box2 setFromPoints]( [param:Array points] )</h3>
 		<p>
-		[page:Array points] - Array of [page:Vector2 Vector2s] that the resulting box will contain.<br /><br />
-
-		Sets the upper and lower bounds of this box to include all of the points in [page:Array points].
+		[page:Array points] - 点的集合，由这些点确定的空间将被盒子包围。<br /><br />
+		设置这个盒子的上下边界，来包含所有设置在[page:Array points]参数中的点。
 		</p>
 
 		<h3>[method:Box2 translate]( [param:Vector2 offset] )</h3>
 		<p>
-		[page:Vector2 offset] - Direction and distance of offset.<br /><br />
-
-		Adds [page:Vector2 offset] to both the upper and lower bounds of this box, effectively moving this box
-		[page:Vector2 offset] units in 2D space.
+		[page:Vector2 offset] - 偏移方向和距离。<br /><br />
+		添加 [page:Vector2 offset] 到这个盒子的上下边界，实际上在2D空间移动这个盒子[page:Vector2 offset]个单位。
 		</p>
 
 		<h3>[method:Box2 union]( [param:Box2 box] )</h3>
 		<p>
-		[page:Box2 box] - Box that will be unioned with this box.<br /><br />
-
-		Unions this box with [page:Box2 box], setting the upper bound of this box to the greater of the
-		two boxes' upper bounds and the lower bound of this box to the lesser of the two boxes'
-		lower bounds.
+		[page:Box2 box] - 将要与该盒子联合的盒子<br /><br />
+		在[page:Box2 box]参数的上边界和该盒子的上边界之间取较大者，而对两者的下边界取较小者，这样获得一个新的较大的联合盒子。
 		</p>
 
 
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/math/interpolants/CubicInterpolant.html

@@ -10,13 +10,13 @@
 	<body>
 		[page:Interpolant] &rarr;
 
-		<h1>[name]</h1>
+		<h1>三次插值([name])</h1>
 
 		<p class="desc">
 
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子(Example）</h2>
 
 		<code>
 var interpolant = new THREE.[name](
@@ -30,19 +30,19 @@ interpolant.evaluate( 0.5 );
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( parameterPositions, sampleValues, sampleSize, resultBuffer )</h3>
 		<p>
-		parameterPositions -- array of positions<br />
-		sampleValues -- array of samples<br />
-		sampleSize -- number of samples<br />
-		resultBuffer -- buffer to store the interpolation results.<br /><br />
+		parameterPositions -- 位置数组<br />
+		sampleValues -- 样本数组<br />
+		sampleSize -- 样本数量<br />
+		resultBuffer -- 用于存储插值结果的缓冲区。<br /><br />
 
 
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性(Properties)</h2>
 
 
 
@@ -71,14 +71,14 @@ interpolant.evaluate( 0.5 );
 
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法(Methods)</h2>
 
 		<h3>[method:null evaluate]( [param:Number t] )</h3>
 		<p>
-		Evaluate the interpolant at position *t*.
+			评估位置*t*处的插值。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/math/interpolants/DiscreteInterpolant.html

@@ -10,13 +10,13 @@
 	<body>
 		[page:Interpolant] &rarr;
 
-		<h1>[name]</h1>
+		<h1>离散插值([name])</h1>
 
 		<p class="desc">
 
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子(Example)</h2>
 
 		<code>
 var interpolant = new THREE.[name](
@@ -34,15 +34,15 @@ interpolant.evaluate( 0.5 );
 
 		<h3>[name]( parameterPositions, sampleValues, sampleSize, resultBuffer )</h3>
 		<p>
-		parameterPositions -- array of positions<br />
-		sampleValues -- array of samples<br />
-		sampleSize -- number of samples<br />
-		resultBuffer -- buffer to store the interpolation results.<br /><br />
+		parameterPositions -- 位置数组<br />
+		sampleValues -- 样本数组<br />
+		sampleSize -- 样本数量<br />
+		resultBuffer -- 用于存储插值结果的缓冲区。<br /><br />
 
 
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性(Properties)</h2>
 
 
 
@@ -75,10 +75,10 @@ interpolant.evaluate( 0.5 );
 
 		<h3>[method:null evaluate]( [param:Number t] )</h3>
 		<p>
-		Evaluate the interpolant at position *t*.
+			评估位置*t*处的插值。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/math/interpolants/LinearInterpolant.html

@@ -10,13 +10,13 @@
 	<body>
 		[page:Interpolant] &rarr;
 
-		<h1>[name]</h1>
+		<h1>线性插值([name])</h1>
 
 		<p class="desc">
 
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子(Example)</h2>
 
 		<code>
 var interpolant = new THREE.[name](
@@ -30,19 +30,19 @@ interpolant.evaluate( 0.5 );
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( parameterPositions, sampleValues, sampleSize, resultBuffer )</h3>
 		<p>
-		parameterPositions -- array of positions<br />
-		sampleValues -- array of samples<br />
-		sampleSize -- number of samples<br />
-		resultBuffer -- buffer to store the interpolation results.<br /><br />
+		parameterPositions -- 位置数组<br />
+		sampleValues -- 样本数组<br />
+		sampleSize -- 样本数量<br />
+		resultBuffer -- 用于存储插值结果的缓冲区。<br /><br />
 
 
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性(Properties)</h2>
 
 
 
@@ -71,14 +71,14 @@ interpolant.evaluate( 0.5 );
 
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法(Methods)</h2>
 
 		<h3>[method:null evaluate]( [param:Number t] )</h3>
 		<p>
-		Evaluate the interpolant at position *t*.
+			评估位置*t*处的插值。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/math/interpolants/QuaternionLinearInterpolant.html

@@ -10,13 +10,13 @@
 	<body>
 		[page:Interpolant] &rarr;
 
-		<h1>[name]</h1>
+		<h1>四元数线性插值([name])</h1>
 
 		<p class="desc">
 
 		</p>
 
-		<h2>Example</h2>
+		<h2>例子(Example)</h2>
 
 		<code>
 var interpolant = new THREE.[name](
@@ -30,19 +30,19 @@ interpolant.evaluate( 0.5 );
 		</code>
 
 
-		<h2>Constructor</h2>
+		<h2>构造函数(Constructor)</h2>
 
 		<h3>[name]( parameterPositions, sampleValues, sampleSize, resultBuffer )</h3>
 		<p>
-		parameterPositions -- array of positions<br />
-		sampleValues -- array of samples<br />
-		sampleSize -- number of samples<br />
-		resultBuffer -- buffer to store the interpolation results.<br /><br />
+		parameterPositions -- 位置数组<br />
+		sampleValues -- 样本数组<br />
+		sampleSize -- 样本数量<br />
+		resultBuffer -- 用于存储插值结果的缓冲区。<br /><br />
 
 
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性(Properties)</h2>
 
 
 
@@ -71,14 +71,14 @@ interpolant.evaluate( 0.5 );
 
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法(Methods)</h2>
 
 		<h3>[method:null evaluate]( [param:Number t] )</h3>
 		<p>
-		Evaluate the interpolant at position *t*.
+			评估位置*t*处的插值。
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码(Source)</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/WebGLRenderTarget.html

@@ -11,118 +11,109 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			A [link:https://msdn.microsoft.com/en-us/library/ff604997.aspx render target] is a buffer
-			where the video card draws pixels for a scene that	is being rendered in the background.
-			It is used in different effects, such as applying postprocessing to a rendered image
-			before displaying it on the screen.
+			[link:https://msdn.microsoft.com/en-us/library/ff604997.aspx render target]是一个缓冲，就是在这个缓冲中，视频卡为正在后台渲染的场景绘制像素。
+			它用于不同的效果，例如用于在一个图像显示在屏幕上之前先做一些处理。
+
 		</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]([param:Number width], [param:Number height], [param:Object options])</h3>
 
 		<p>
-		[page:Float width] - The width of the renderTarget. <br />
-		[page:Float height] - The height of the renderTarget.<br />
-		options - (optional object that holds texture parameters for an auto-generated target
-		texture and depthBuffer/stencilBuffer booleans.
-
-		For an explanation of the texture parameters see [page:Texture Texture]. The following are
-		valid options:<br /><br />
-
-		[page:Constant wrapS] - default is [page:Textures ClampToEdgeWrapping]. <br />
-		[page:Constant wrapT] - default is [page:Textures ClampToEdgeWrapping]. <br />
-		[page:Constant magFilter] - default is [page:Textures LinearFilter]. <br />
-		[page:Constant minFilter] - default is [page:Textures LinearFilter]. <br />
-		[page:Constant format] - default is [page:Textures RGBAFormat]. <br />
-		[page:Constant type] - default is [page:Textures UnsignedByteType]. <br />
-		[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 />
-
-		Creates a new [name]
+		[page:Float width] -renderTarget的宽度 <br />
+		[page:Float height] - renderTarget的高度 <br />
+		options - (可选)一个保存着自动生成的目标纹理的纹理参数以及表示是否使用深度缓存/模板缓存的布尔值的对象
+		以下是一些合法选项：<br /><br />
+
+		[page:Constant wrapS] - 默认是[page:Textures ClampToEdgeWrapping]. <br />
+		[page:Constant wrapT] - 默认是[page:Textures ClampToEdgeWrapping]. <br />
+		[page:Constant magFilter] - 默认是[page:Textures LinearFilter]. <br />
+		[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:Constant encoding] - 默认是[page:Textures LinearEncoding]. <br />
+		[page:Boolean depthBuffer] - 默认是*true*. 如果不需要就设为false <br />
+		[page:Boolean stencilBuffer] - 默认是*true*. 如果不需要就设为false <br /><br />
+
+		创建一个新[name]
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:number width]</h3>
 		<p>
-		The width of the render target.
+		渲染目标宽度
 		</p>
 
 		<h3>[property:number height]</h3>
 		<p>
-		The height of the render target.
+		渲染目标高度
 		</p>
 
 		<h3>[property:Vector4 scissor]</h3>
 		<p>
-		A rectangular area inside the render target's viewport. Fragments that are outside the area will be discarded.
+        渲染目标视口内的一个矩形区域，区域之外的片元将会被丢弃
 		</p>
 
 		<h3>[property:boolean scissorTest]</h3>
 		<p>
-		Indicates whether the scissor test is active or not.
+        表明是否激活了剪裁测试
 		</p>
 
 		<h3>[property:Vector4 viewport]</h3>
 		<p>
-		The viewport of this render target.
+		渲染目标的视口
 		</p>
 
 		<h3>[property:Texture texture]</h3>
 		<p>
-		This texture instance holds the rendered pixels. Use it as input for further processing.
+        纹理实例保存这渲染的像素，用作进一步处理的输入值
 		</p>
 
 		<h3>[property:boolean depthBuffer]</h3>
 		<p>
-		Renders to the depth buffer. Default is true.
+		渲染到深度缓冲区。默认true.
 		</p>
 
 		<h3>[property:boolean stencilBuffer]</h3>
 		<p>
-		Renders to the stencil buffer. Default is true.
+        渲染到模板缓冲区。默认true.
 		</p>
 
 		<h3>[property:DepthTexture depthTexture]</h3>
 		<p>
-		If set, the scene depth will be rendered to this texture. Default is null.
+        如果设置，那么场景的深度将会被渲染到慈纹理上。默认是null.
 		</p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null setSize]( [param:Number width], [param:Number height] )</h3>
 		<p>
-		Sets the size of the render target.
+		设置渲染目标的大小
 		</p>
 
 		<h3>[method:WebGLRenderTarget clone]()</h3>
 		<p>
-		Creates a copy of this render target.
+		创建一个渲染目标副本
 		</p>
 
 		<h3>[method:WebGLRenderTarget copy]( [param:WebGLRenderTarget source] )</h3>
 		<p>
-		Adopts the settings of the given render target.
+        采用传入的渲染目标的设置
 		</p>
 
 		<h3>[method:null dispose]()</h3>
 		<p>
-		Dispatches a dispose event.
+		发出一个处理事件
 		</p>
+		<h3>[page:EventDispatcher EventDispatcher]方法可从此类中获得</h3>
 
-
-
-
-
-		<h3>[page:EventDispatcher EventDispatcher] methods are available on this class.</h3>
-
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/WebGLRenderTargetCube.html

@@ -13,58 +13,54 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			Used by the [page:CubeCamera] as its [page:WebGLRenderTarget].
+		被[page:CubeCamera]作为它的[page:WebGLRenderTarget]使用
 		</p>
 
-		<h2>Examples</h2>
+		<h2>例子</h2>
 
-		<p>See [page:CubeCamera] for examples.</p>
+		<p>有关示例请参阅[page:CubeCamera]</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]([param:Number width], [param:Number height], [param:Object options])</h3>
 		<p>
-		[page:Float width] - The width of the renderTarget. <br />
-		[page:Float height] - The height of the renderTarget. <br />
-		options - (optional) object that holds texture parameters for an auto-generated target
-		texture and depthBuffer/stencilBuffer booleans.
-
-		For an explanation of the texture parameters see [page:Texture Texture]. The following are
-		valid options:<br /><br />
-
-		[page:Constant wrapS] - default is [page:Textures ClampToEdgeWrapping]. <br />
-		[page:Constant wrapT] - default is [page:Textures ClampToEdgeWrapping]. <br />
-		[page:Constant magFilter] - default is [page:Textures .LinearFilter]. <br />
-		[page:Constant minFilter] - default is [page:Textures LinearFilter]. <br />
-		[page:Constant format] - default is [page:Textures RGBAFormat]. <br />
-		[page:Constant type] - default is [page:Textures UnsignedByteType]. <br />
-		[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 />
-
-		Creates a new [name]
+		[page:Float width] - renderTarget的宽度 <br />
+		[page:Float height] - renderTarget的高度 <br />
+		options - (可选)一个保存着自动生成的目标纹理的纹理参数以及表示是否使用深度缓存/模板缓存的布尔值的对象。
+		有关纹理参数的说明，请参阅[page:Texture Texture]. 以下是合理选项：<br /><br />
+
+		[page:Constant wrapS] - 默认是[page:Textures ClampToEdgeWrapping]. <br />
+		[page:Constant wrapT] - 默认是[page:Textures ClampToEdgeWrapping]. <br />
+		[page:Constant magFilter] - 默认是[page:Textures .LinearFilter]. <br />
+		[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:Constant encoding] - 默认是[page:Textures LinearEncoding]. <br />
+		[page:Boolean depthBuffer] - 默认是*true*.如果不需要就设为false <br />
+		[page:Boolean stencilBuffer] - 默认是*true*.如果不需要就设为false<br /><br />
+
+		创建一个新[name]
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:integer activeCubeFace]</h3>
 		<p>
-		The activeCubeFace property corresponds to a cube side (PX 0, NX 1, PY 2, NY 3, PZ 4, NZ 5) and is
-		used and set internally by the [page:CubeCamera].
+		activeCubeFace属性对应立方体的面(PX 0, NX 1, PY 2, NY 3, PZ 4, NZ 5) 并由[page:CubeCamera]内部使用和设置
 		</p>
 
-		<h3>See [page:WebGLRenderTarget] for inherited properties</h3>
+		<h3>继承属性，请参阅[page:WebGLRenderTarget]</h3>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
-		<h3>See [page:WebGLRenderTarget] for inherited methods</h3>
+		<h3>继承方法，请参阅[page:WebGLRenderTarget]</h3>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/WebGLRenderer.html

@@ -11,140 +11,118 @@
 		<h1>[name]</h1>
 
 		<p class="desc">
-			The WebGL renderer displays your beautifully crafted scenes using
-			[link:https://en.wikipedia.org/wiki/WebGL WebGL].
+            WebGL Render 用[link:https://en.wikipedia.org/wiki/WebGL WebGL]渲染出你精心制作的场景。
 		</p>
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 		<h3>[name]( [param:Object parameters] )</h3>
 		<p>
-		[page:Object parameters] - (optional) object with properties defining the renderer's behaviour.
-			The constructor also accepts no parameters at all. In all cases, it will assume sane defaults
-			when parameters are missing. The following are valid parameters:<br /><br />
+        [page:Object parameters] - (可选) 该对象的属性定义了渲染器的行为。也可以完全不传参数。在所有情况下，当缺少参数时，它将采用合理的默认值。
+            以下是合法参数：<br /><br />
 
-		[page:DOMElement canvas] - A [link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/canvas canvas]
-		where the renderer draws its output.
-		This corresponds to the [page:WebGLRenderer.domElement domElement] property below.
-		If not passed in here, a new canvas element will be created.<br />
+		[page:DOMElement canvas] - 一个供渲染器绘制其输出的[link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/canvas canvas]
+		它和下面的[page:WebGLRenderer.domElement domElement]属性对应。
+		如果没有传这个参数，会创建一个新canvas<br />
 
 
-		[page:WebGLRenderingContext context] - This can be used to attach the renderer to an existing
-	  [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext RenderingContext].
-		Default is null.<br />
+		[page:WebGLRenderingContext context] - 可用于将渲染器附加到已有的渲染环境([link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext RenderingContext])中。默认值是null<br />
 
-		[page:String precision] - Shader precision. Can be *"highp"*, *"mediump"* or *"lowp"*.
-		Defaults to *"highp"* if supported by the device. See the note in "Things to Avoid"
-		[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices here].<br />
+		[page:String precision] - 着色器精度. 可以是 *"highp"*, *"mediump"* 或者 *"lowp"*.
+	    如果设备支持，默认为*"highp"* . 点击[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/WebGL_best_practices here] 查看"应该避免的事"<br />
 
-		[page:Boolean alpha] - whether the canvas contains an alpha (transparency) buffer or not.
-	  Default is *false*.<br />
+		[page:Boolean alpha] - canvas是否包含alpha (透明度)。默认为 *false*<br />
 
-		[page:Boolean premultipliedAlpha] - whether the renderer will assume that colors have
+		[page:Boolean premultipliedAlpha] - renderer是否假设颜色有
 		[link:https://en.wikipedia.org/wiki/Glossary_of_computer_graphics#Premultiplied_alpha premultiplied alpha].
-		Default is *true*.<br />
+		默认为*true* <br />
 
-		[page:Boolean antialias] - whether to perform antialiasing. Default is *false*.<br />
+		[page:Boolean antialias] - 是否执行抗锯齿。默认为*false*.<br />
 
-		[page:Boolean stencil] - whether the drawing buffer has a
-		[link:https://en.wikipedia.org/wiki/Stencil_buffer stencil buffer] of at least 8 bits.
-		Default is *true*.<br />
+		[page:Boolean stencil] - 绘图缓存是否有一个至少8位的模板缓存([link:https://en.wikipedia.org/wiki/Stencil_buffer stencil buffer])。默认为*true*<br />
 
-		[page:Boolean preserveDrawingBuffer] - whether to preserve the buffers until manually cleared
-		or overwritten. Default is *false*.<br />
+		[page:Boolean preserveDrawingBuffer] -是否保留缓直到手动清除或被覆盖。 默认*false*.<br />
 
-		[page:String powerPreference] - Provides a hint to the user agent indicating what configuration
-		of GPU is suitable for this WebGL context. Can be *"high-performance"*, *"low-power"* or *"default"*. Default is *"default"*.
-		See the [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.2 WebGL spec] for more information.<br />
+		[page:String powerPreference] - 提示用户代理怎样的配置更适用于当前WebGL环境。 可能是*"high-performance"*, *"low-power"* 或 *"default"*。默认是*"default"*.
+		详见[link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.2 WebGL spec]<br />
 
-		[page:Boolean depth] - whether the drawing buffer has a
-		[link:https://en.wikipedia.org/wiki/Z-buffering depth buffer] of at least 16 bits.
-		Default is *true*.<br />
+		[page:Boolean depth] - 绘图缓存是否有一个至少6位的深度缓存([link:https://en.wikipedia.org/wiki/Z-buffering depth buffer] )。
+		默认是*true*.<br />
 
-		[page:Boolean logarithmicDepthBuffer] -  whether to use a logarithmic depth buffer. It may
-		be neccesary to use this if dealing with huge differences in scale in a single scene.
-		Default is *false*. See the [example:webgl_camera_logarithmicdepthbuffer camera / logarithmicdepthbuffer] example.
+		[page:Boolean logarithmicDepthBuffer] -  是否使用对数深度缓存。如果要在单个场景中处理巨大的比例差异，就有必要使用。
+		默认是*false*。 示例：[example:webgl_camera_logarithmicdepthbuffer camera / logarithmicdepthbuffer]
 		</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Boolean autoClear]</h3>
-		<p>Defines whether the renderer should automatically clear its output before rendering a frame.</p>
+		<p>定义渲染器是否在渲染每一帧之前自动清除其输出。</p>
 
 
 		<h3>[property:Boolean autoClearColor]</h3>
 		<p>
-			If [page:.autoClear autoClear] is true, defines whether the renderer should clear the color buffer.
-			Default is *true*.
+			如果[page:.autoClear autoClear]为true, 定义renderer是否清除颜色缓存。
+			默认是*true*
 		</p>
 
 
 		<h3>[property:Boolean autoClearDepth]</h3>
 		<p>
-			If [page:.autoClear autoClear] is true, defines whether the renderer should clear the depth buffer.
-			Default is *true*.
+			如果[page:.autoClear autoClear]是true, 定义renderer是否清除深度缓存。
+			默认是*true*
 		</p>
 
 
 		<h3>[property:Boolean autoClearStencil]</h3>
 		<p>
-			If [page:.autoClear autoClear] is true, defines whether the renderer should clear the stencil buffer.
-			Default is *true*.
+			如果[page:.autoClear autoClear]是true, 定义renderer是否清除模板缓存.
+			默认是*true*
 		</p>
 
 		<h3>[property:Object capabilities]</h3>
 		<p>
-		An object containing details about the capabilities of the current [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext RenderingContext].<br />
-
-		- [page:Boolean floatFragmentTextures]: whether the context supports the [link:https://developer.mozilla.org/en-US/docs/Web/API/OES_texture_float OES_texture_float] extension.
-			According to [link:https://webglstats.com/ WebGLStats], as of February 2016 over 95% of WebGL enabled devices support this.<br />
-		- [page:Boolean floatVertexTextures]: *true* if [page:Boolean floatFragmentTextures] and [page:Boolean vertexTextures] are both true.<br />
-		- [page:Method getMaxAnisotropy](): Returns the maximum available anisotropy.<br />
-		- [page:Method getMaxPrecision](): Returns the maximum available precision for vertex and fragment shaders. <br />
-		- [page:Boolean logarithmicDepthBuffer]: *true* if the [page:parameter logarithmicDepthBuffer] was set to true in the constructor and
-		the context supports the [link:https://developer.mozilla.org/en-US/docs/Web/API/EXT_frag_depth EXT_frag_depth] extension.
-			According to [link:https://webglstats.com/ WebGLStats], as of February 2016 around 66% of WebGL enabled devices support this.<br />
-		- [page:Integer maxAttributes]: The value of *gl.MAX_VERTEX_ATTRIBS*.<br />
-		- [page:Integer maxCubemapSize]: The value of *gl.MAX_CUBE_MAP_TEXTURE_SIZE*.
-		Maximum height * width of cube map textures that a shader can use.<br />
-		- [page:Integer maxFragmentUniforms]: The value of *gl.MAX_FRAGMENT_UNIFORM_VECTORS*.
-		  The number of uniforms that can be used by a fragment shader.<br />
-		- [page:Integer maxTextureSize]: The value of *gl.MAX_TEXTURE_SIZE*.
-		Maximum height * width of a texture that a shader use.<br />
-		- [page:Integer maxTextures]: The value of *gl.MAX_TEXTURE_IMAGE_UNITS*.
-		  The maximum number of textures that can be used by a shader.<br />
-		- [page:Integer maxVaryings]: The value of *gl.MAX_VARYING_VECTORS*.
-		  The number of varying vectors that can used by shaders.<br />
-		- [page:Integer maxVertexTextures]: The value of *gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS*.
-		   The number of textures that can be used in a vertex shader.<br />
-		- [page:Integer maxVertexUniforms]: The value of *gl.MAX_VERTEX_UNIFORM_VECTORS*.
-		   The maximum number of uniforms that can be used in a vertex shader.<br />
-		- [page:String precision]: The shader precision currently being used by the renderer.<br />
-		- [page:Boolean vertexTextures]: *true* if [property:Integer maxVertexTextures] is greater than 0 (i.e. vertext textures can be used).<br />
+            一个包含当前渲染环境([link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext RenderingContext])的功能细节的对象。<br />
+
+		- [page:Boolean floatFragmentTextures]: 环境是否支持[link:https://developer.mozilla.org/en-US/docs/Web/API/OES_texture_float OES_texture_float]扩展。
+			根据[link:https://webglstats.com/ WebGLStats], 截至2016年2月，超过95％的支持WebGL的设备支持此功能<br />
+		- [page:Boolean floatVertexTextures]: 如果[page:Boolean floatFragmentTextures]和[page:Boolean vertexTextures]都是true， 则此值为*true* <br />
+		- [page:Method getMaxAnisotropy](): 返回最大可用各向异性。<br />
+		- [page:Method getMaxPrecision](): 返回顶点着色器和片元着色器的最大可用精度。 <br />
+		- [page:Boolean logarithmicDepthBuffer]: 如果[page:parameter logarithmicDepthBuffer]在构造器中被设为true且
+		环境支持[link:https://developer.mozilla.org/en-US/docs/Web/API/EXT_frag_depth EXT_frag_depth]扩展，则此值为*true*
+			根据[link:https://webglstats.com/ WebGLStats], 截至2016年2月， 约66%的支持WebGL的设备支持此功能<br />
+		- [page:Integer maxAttributes]: *gl.MAX_VERTEX_ATTRIBS*的值<br />
+		- [page:Integer maxCubemapSize]: *gl.MAX_CUBE_MAP_TEXTURE_SIZE* 的值，着色器可使用的立方体贴图纹理的最大宽度*高度<br />
+		- [page:Integer maxFragmentUniforms]: *gl.MAX_FRAGMENT_UNIFORM_VECTORS*的值，片元着色器可使用的全局变量(uniforms)数量<br />
+		- [page:Integer maxTextureSize]: *gl.MAX_TEXTURE_SIZE*的值，着色器可使用纹理的最大宽度*高度<br />
+		- [page:Integer maxTextures]: *gl.MAX_TEXTURE_IMAGE_UNITS的值，着色器可使用的纹理数量<br />
+		- [page:Integer maxVaryings]: *gl.MAX_VARYING_VECTORS*的值，着色器可使用矢量的数量<br />
+		- [page:Integer maxVertexTextures]: *gl.MAX_VERTEX_TEXTURE_IMAGE_UNITS*的值，顶点着色器可使用的纹理数量。<br />
+		- [page:Integer maxVertexUniforms]: *gl.MAX_VERTEX_UNIFORM_VECTORS*的值，顶点着色器可使用的全局变量(uniforms)数量<br />
+		- [page:String precision]: 渲染器当前使用的着色器的精度<br />
+		- [page:Boolean vertexTextures]: 如果[property:Integer maxVertexTextures]大于0，此值为*true* (即可以使用顶点纹理)<br />
 		</p>
 
 		<h3>[property:Array clippingPlanes]</h3>
 		<p>
-		User-defined clipping planes specified as THREE.Plane objects in world space.
-			These planes apply globally. Points in space whose dot product with the plane is negative are cut away.
-		 Default is [].
+            用户自定义的剪裁平面，在世界空间中被指定为THREE.Plane对象。
+            这些平面全局使用。空间中与该平面点积为负的点将被切掉。
+            默认值是[]
 		</p>
 
 		<h3>[property:WebGLRenderingContext context]</h3>
 		<p>
-		The renderer obtains a [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext RenderingContext] context
-		  from its [page:WebGLRenderer.domElement domElement] by default, using
-			[link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/getContext HTMLCanvasElement.getContext]().<br /><br />
+            渲染器默认使用[link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/getContext HTMLCanvasElement.getContext]()从其
+            [page:WebGLRenderer.domElement domElement]获取渲染环境([link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext RenderingContext]）<br /><br />
+
+		    你可以手动创建创建它，但它必须与[page:WebGLRenderer.domElement domElement]对应，才能呈现到屏幕上。
 
-		You can create this manually, however it must correspond to the
-		[page:WebGLRenderer.domElement domElement] in order to render to the screen.
 		</p>
 
 		<h3>[property:DOMElement domElement]</h3>
 		<p>
-		A [link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/canvas canvas] where the renderer draws its output.<br />
-			This is automatically created by the renderer in the constructor (if not provided already);
-			you just need to add it to your page like so:<br />
+		一个[link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/canvas canvas]，渲染器在其上绘制输出。<br />
+		渲染器的构造函数会自动创建(如果没有传入canvas参数);你需要做的仅仅是像下面这样将它加页面里去:<br />
 		<code>
 			document.body.appendChild( renderer.domElement );
 		</code>
@@ -152,23 +130,22 @@
 
 		<h3>[property:Object extensions]</h3>
 		<p>
-		A wrapper for the [page:WebGLRenderer.extensions.get .extensions.get] method, used to check whether
-		various WebGL extensions are supported.
+		[page:WebGLRenderer.extensions.get .extensions.get]方法的包装, 用于检查是否支持各种WebGL扩展
 		</p>
 
 		<h3>[property:Float gammaFactor]</h3>
-		<p>Default is *2*. </p>
+		<p>默认是 *2*. </p>
 
 
 		<h3>[property:Boolean gammaInput]</h3>
-		<p>If set, then it expects that all textures and colors are premultiplied gamma. Default is *false*.</p>
+		<p>如果设置，那么所有的纹理和颜色都会预乘gamma。 默认值是*false*.</p>
 
 
 		<h3>[property:Boolean gammaOutput]</h3>
-		<p>If set, then it expects that all textures and colors need to be outputted in premultiplied gamma. Default is *false*.</p>
+		<p>如果设置, 那么它期望所有纹理和颜色需要乘以gamma输出。 默认值*false*.</p>
 
 		<h3>[property:Object info]</h3>
-		<p>An object with a series of statistical information about the graphics board memory and the rendering process. Useful for debugging or just for the sake of curiosity. The object contains the following fields:</p>
+		<p>一个对象，包含有关图形板内存和渲染过程的一系列统计信息。这些信息可用于调试或仅仅满足下好奇心。改对象包含以下字段:</p>
 		<p>
 		<ul>
 			<li>memory:
@@ -189,7 +166,7 @@
 			</li>
 		</ul>
 		</p>
-		<p>By default these data are reset at each render calls, but when using the composer or mirrors it can be preferred to reset them with a custom pattern :
+		<p>默认情况下，每次调用渲染时这些数据都会重置。 但当时用一个或多个镜像时，最好使用自定义模式重置它们：
 		<code>
 		renderer.info.autoReset = false;
 		renderer.info.reset();
@@ -197,138 +174,134 @@
 		</p>
 
 		<h3>[property:Boolean localClippingEnabled]</h3>
-		<p>Defines whether the renderer respects object-level clipping planes. Default is *false*.</p>
+		<p>定义渲染器是否考虑对象级剪切平面。 默认为*false*.</p>
 
 		<h3>[property:Integer maxMorphTargets]</h3>
 		<p>
-		Default is 8. The maximum number of MorphTargets allowed in a shader.
-			Keep in mind that the standard materials only allow 8 MorphTargets.
+        默认是8。 一个着色器中允许的最大MorphTargets数。
+        切记标准材质只允许8个MorphTargets。
 		</p>
 
 		<h3>[property:Integer maxMorphNormals]</h3>
 		<p>
-		Default is 4. The maximum number of MorphNormals allowed in a shader.
-			Keep in mind that the standard materials only allow 4 MorphNormals.
+		默认是4。 色器中允许的最大MorphNormal数。
+		切记标准材质只允许4个MorphNormal。
 		</p>
 
 		<h3>[property:Boolean physicallyCorrectLights]</h3>
 		<p>
-		Whether to use physically correct lighting mode. Default is *false*.
-		See the [example:webgl_lights_physical lights / physical] example.
+		是否使用物理上正确的光照模式。 默认是*false*。
+		示例：[example:webgl_lights_physical lights / physical]
 		</p>
 
 		<h3>[property:Object properties]</h3>
 		<p>
-		Used internally by the renderer to keep track of various sub object properties.
+		渲染器内部使用，以跟踪各种子对象属性。
 		</p>
 
 		<h3>[property:WebGLRenderLists renderLists]</h3>
 		<p>
-		Used internally to handle ordering of scene object rendering.
+        在内部用于处理场景渲染对象的排序。
 		</p>
 
 		<h3>[property:WebGLShadowMap shadowMap]</h3>
 		<p>
-		This contains the reference to the shadow map, if used.
+        如果使用，它包含阴影贴图的引用。
 		</p>
 
 		<h3>[property:Boolean shadowMap.enabled]</h3>
-		<p>If set, use shadow maps in the scene. Default is *false*.</p>
+		<p>如果设置, 请在场景中使用阴影贴图。 默认是 *false*</p>
 
 		<h3>[property:Boolean shadowMap.autoUpdate]</h3>
-		<p>Enables automatic updates to the shadows in the scene. Default is *true*.</p>
-		<p>If you do not require dynamic lighting / shadows, you may set this to *false* when the renderer is instantiated.</p>
+		<p>启用场景中的阴影自动更新。默认是*true*</p>
+		<p>如果不需要动态光照/阴影, 则可以在实例化渲染器时将之设为false</p>
 
 		<h3>[property:Boolean shadowMap.needsUpdate]</h3>
-		<p>When set to *true*, shadow maps in the scene will be updated in the next *render* call. Default is *false*. </p>
-		<p>If you have disabled automatic updates to shadow maps (*shadowMap.autoUpdate = false*), you will need to set this to *true* and then make a render call to update the shadows in your scene.</p>
+		<p>当被设为*true*, 场景中的阴影贴图会在下次*render*调用时刷新。默认是*false* </p>
+		<p>如果你已经禁用了阴影贴图的自动更新(*shadowMap.autoUpdate = false*), 那么想要在下一次渲染时更新阴影的话就需要将此值设为*true*</p>
 
 		<h3>[property:Integer shadowMap.type]</h3>
-		<p>Defines shadow map type (unfiltered, percentage close filtering, percentage close filtering with bilinear filtering in shader)</p>
-		<p>Options are THREE.BasicShadowMap, THREE.PCFShadowMap (default), THREE.PCFSoftShadowMap. See [page:Renderer Renderer constants] for details.</p>
+		<p>定义阴影贴图类型 (未过滤, 关闭部分过滤, 关闭部分双线性过滤)</p>
+		<p>可选值有THREE.BasicShadowMap, THREE.PCFShadowMap (默认), THREE.PCFSoftShadowMap。 详见[page:Renderer Renderer constants]</p>
 
 		<h3>[property:Boolean sortObjects]</h3>
 		<p>
-		Defines whether the renderer should sort objects. Default is *true*.<br /><br />
+        定义渲染器是否应对对象进行排序。默认是*true*.<br /><br />
 
-		Note: Sorting is used to attempt to properly render objects that have some degree of transparency.
-		By definition, sorting objects may not work in all cases.  Depending on the needs of application,
-		it may be neccessary to turn off sorting and use other methods to deal with transparency
-		rendering e.g. manually determining each object's rendering order.
+        说明: 排序用于尝试正确渲染出具有一定透明度的对象。根据定义，排序可能不总是有用。根据应用的需求，可能需要关闭排序并使其他方法来处理透明度的渲染，例如，
+        手动确定每个对象的显然顺序。
 		</p>
 
 		<h3>[property:Object state]</h3>
 		<p>
-		Contains functions for setting various properties of the [page:WebGLRenderer.context] state.
+        包含设置[page:WebGLRenderer.context]状态的各种属性的函数。
 		</p>
 
 		<h3>[property:Constant toneMapping]</h3>
 		<p>
-		Default is [page:Renderer LinearToneMapping]. See the [page:Renderer Renderer constants] for other choices.
+		默认是[page:Renderer LinearToneMapping]。查看[page:Renderer Renderer constants]以获取其它备选项
 		</p>
 
 		<h3>[property:Number toneMappingExposure]</h3>
 		<p>
-		Exposure level of tone mapping. Default is *1*.
+		色调映射的曝光级别。默认是*1*
 		</p>
 
 		<h3>[property:Number toneMappingWhitePoint]</h3>
 		<p>
-		Tone mapping white point. Default is *1*.
+		色调映射的白点。默认是*1*
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:Integer allocTextureUnit]</h3>
 		<p>
-		Attempt to allocate a texture unit for use by a shader. Will warn if trying to allocate
-		more texture units than the GPU supports. This is mainly used internally.
-		See [page:WebGLRenderer.capabilities capabilities.maxTextures].
+		尝试分配纹理单元以供着色器使用。如果尝试分配超过GPU支持量的纹理单元，则会报警告。主要供内部使用。
+		请参阅[page:WebGLRenderer.capabilities capabilities.maxTextures]。
 		</p>
 
 		<h3>[method:null clear]( [param:Boolean color], [param:Boolean depth], [param:Boolean stencil] )</h3>
 		<p>
-		Tells the renderer to clear its color, depth or stencil drawing buffer(s).
-			This method initializes the color buffer to the current clear color value.<br />
-		Arguments default to *true*.
+		告诉渲染器清除颜色、深度或模板缓存.
+		此方法将颜色缓存初始化为当前颜色。参数们默认都是*true*
 		</p>
 
 		<h3>[method:null clearColor]( )</h3>
-		<p>Clear the color buffer. Equivalent to calling [page:WebGLRenderer.clear .clear]( true, false, false ).</p>
+		<p>清除颜色缓存。 相当于调用[page:WebGLRenderer.clear .clear]( true, false, false )</p>
 
 		<h3>[method:null clearDepth]( )</h3>
-		<p>Clear the depth buffer. Equivalent to calling [page:WebGLRenderer.clear .clear]( false, true, false ).</p>
+		<p>清除深度缓存。相当于调用[page:WebGLRenderer.clear .clear]( false, true, false )</p>
 
 		<h3>[method:null clearStencil]( )</h3>
-		<p>Clear the stencil buffers. Equivalent to calling [page:WebGLRenderer.clear .clear]( false, false, true ).</p>
+		<p>清除模板缓存。相当于调用[page:WebGLRenderer.clear .clear]( false, false, true )</p>
 
 		<h3>[method:null clearTarget]([param:WebGLRenderTarget renderTarget], [param:boolean color], [param:boolean depth], [param:boolean stencil])</h3>
 		<p>
-		renderTarget -- The [page:WebGLRenderTarget renderTarget] that needs to be cleared.<br />
-		color -- If set, then the color gets cleared. <br />
-		depth -- If set, then the depth gets cleared. <br />
-		stencil -- If set, then the stencil gets cleared.
+		renderTarget -- 需要被清除的[page:WebGLRenderTarget renderTarget]<br />
+		color -- 如果设置, 颜色会被清除 <br />
+		depth -- 如果设置, 深度缓存会被清除 <br />
+		stencil -- 如果设置, 模板缓存会被清除
 		</p>
 		<p>
-		This method clears a rendertarget. To do this, it activates the rendertarget.
+		该方法清楚了一个rendertarget。为此它会激活此endertarget
 		</p>
 
 		<h3>[method:null compile]( [param:Scene scene], [param:Camera camera] )</h3>
-		<p>Compiles all materials in the scene with the camera. This is useful to precompile shaders before the first rendering.</p>
+		<p>使用相机编译场景中的所有材质。这对于在首次渲染之前预编译着色器很有用。</p>
 
 		<h3>[method:null copyFramebufferToTexture]( [param:Vector2 position], [param:Texture texture], [param:Number level] )</h3>
-		<p>Copies pixels from the current WebGLFramebuffer into a 2D texture. Enables access to [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/copyTexImage2D WebGLRenderingContext.copyTexImage2D].</p>
+		<p>将当前WebGLFramebuffer中的像素复制到2D纹理中。可访问[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/copyTexImage2D WebGLRenderingContext.copyTexImage2D].</p>
 
 		<h3>[method:null copyTextureToTexture]( [param:Vector2 position], [param:Texture srcTexture], [param:Texture dstTexture], [param:Number level] )</h3>
-		<p>Copies all pixels of a texture to an existing texture starting from the given position. Enables access to [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/texSubImage2D WebGLRenderingContext.texSubImage2D].</p>
+		<p>将纹理的所有像素复制到一个已有的从给定位置开始的纹理中。可访问[link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/texSubImage2D WebGLRenderingContext.texSubImage2D].</p>
 
 		<h3>[method:null dispose]( )</h3>
-		<p>Dispose of the current rendering context.</p>
+		<p>处理当前的渲染环境</p>
 
 		<h3>[method:Object extensions.get]( [param:String extensionName] )</h3>
 		<p>
-		Used to check whether various extensions are supported and returns an object with details of the extension if available.
-		This method can check for the following extensions:<br /><br />
+        用于检查是否支持各种扩展，并返回一个对象，其中包含扩展的详细信息。
+        该方法检查以下扩展：<br /><br />
 
 		- *WEBGL_depth_texture*<br />
 		- *EXT_texture_filter_anisotropic*<br />
@@ -339,131 +312,125 @@
 
 		<h3>[method:null forceContextLoss]( )</h3>
 		<p>
-		Simulate loss of the WebGL context. This requires support for the
-			[link:https://developer.mozilla.org/en-US/docs/Web/API/WEBGL_lose_context WEBGL_lose_context] extensions.
-		According to [link:https://webglstats.com/ WebGLStats], as of February 2016 90% of WebGL enabled devices support this.
+        模拟WebGL环境的丢失。需要支持
+			[link:https://developer.mozilla.org/en-US/docs/Web/API/WEBGL_lose_context WEBGL_lose_context]扩展才能用。
+		根据[link:https://webglstats.com/ WebGLStats], as of February 2016 90% of WebGL enabled devices support this.
 		</p>
 
 		<h3>[method:Float getClearAlpha]()</h3>
-		<p>Returns a [page:Float float] with the current clear alpha. Ranges from 0 to 1.</p>
+		<p>返回一个表示当前alpha值的[page:Float float]，范围0到1</p>
 
 		<h3>[method:Color getClearColor]()</h3>
-		<p>Returns a [page:Color THREE.Color] instance with the current clear color.</p>
+		<p>返回一个表示当前颜色值的[page:Color THREE.Color]实例</p>
 
 		<h3>[method:WebGLRenderingContext getContext]()</h3>
-		<p>Return the current WebGL context.</p>
+		<p>返回当前WebGL环境</p>
 
 		<h3>[method:WebGLContextAttributes getContextAttributes]()</h3>
-		<p>Returns an object that describes the attributes set on the WebGL context when it was created.</p>
+		<p>返回一个对象，这个对象中存有在WebGL环境在创建的时候所设置的属性</p>
 
 		<h3>[method:RenderTarget getRenderTarget]()</h3>
-		<p>Returns the current RenderTarget, if any.</p>
+		<p>如果当前存在RenderTarget，返回当前它</p>
 
 		<h3>[method:RenderTarget getCurrentViewport]()</h3>
-		<p>Returns the current viewport.</p>
+		<p>返回当前视口</p>
 
 		<h3>[method:Object getDrawingBufferSize]()</h3>
-		<p>Returns an object containing the width and height of the renderer's drawing buffer, in pixels.</p>
+		<p>返回一个包含渲染器绘图缓存宽度和高度(单位像素)的对象。</p>
 
 		<h3>[method:number getPixelRatio]()</h3>
-		<p>Returns current device pixel ratio used.</p>
+		<p>返回当前使用设备像素比</p>
 
 		<h3>[method:Object getSize]()</h3>
-		<p>Returns an object containing the width and height of the renderer's output canvas, in pixels.</p>
+		<p>返回包含渲染器输出canvas的宽度和高度(单位像素)的对象。</p>
 
 		<h3>[method:null resetGLState]( )</h3>
-		<p>Reset the GL state to default. Called internally if the WebGL context is lost.</p>
+		<p>将GL状态重置为默认值。WebGL环境丢失时会内部调用</p>
 
 		<h3>[method:null readRenderTargetPixels]( [param:WebGLRenderTarget renderTarget], [param:Float x], [param:Float y], [param:Float width], [param:Float height], buffer )</h3>
-		<p>Reads the pixel data from the renderTarget into the buffer you pass in. This is a wrapper around [link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/readPixels WebGLRenderingContext.readPixels]().<br />
-		See the [example:webgl_interactive_cubes_gpu interactive / cubes / gpu] example.
+		<p>将enderTarget中的像素数据读取到传入的缓冲区中。这是link:https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/readPixels WebGLRenderingContext.readPixels]()的包装器<br />
+		示例：[example:webgl_interactive_cubes_gpu interactive / cubes / gpu]
 		</p>
 
 		<h3>[method:null render]( [param:Scene scene], [param:Camera camera], [param:WebGLRenderTarget renderTarget], [param:Boolean forceClear] )</h3>
 		<p>
-			Render a [page:Scene scene] using a [page:Camera camera].<br />
+			用相机([page:Camera camera])渲染一个场景([page:Scene scene])<br />
 
-			The render is done to the [page:WebGLRenderTarget renderTarget] (if specified) or to the canvas as usual.<br />
+			渲染一般是在canvas上完成的，或者是[page:WebGLRenderTarget renderTarget](如果有指定)<br />
 
-			If [page:Boolean forceClear] is *true*, the depth, stencil and color buffers will be cleared
-			before rendering even if the renderer's [page:WebGLRenderer.autoClear autoClear] property is false.<br />
+			如果[page:Boolean forceClear]值是*true*，那么颜色、深度及模板缓存将会在渲染之前清除，即使渲染器的[page:WebGLRenderer.autoClear autoClear]属性值是false<br />
 
-			Even with forceClear set to true you can prevent certain buffers being cleared by setting
-			either the [page:WebGLRenderer.autoClearColor autoClearColor], [page:WebGLRenderer.autoClearStencil autoClearStencil] or [page:WebGLRenderer.autoClearDepth autoClearDepth] properties to false.
+			即便forceClear设为true, 也可以通过将[page:WebGLRenderer.autoClearColor autoClearColor]、[page:WebGLRenderer.autoClearStencil autoClearStencil]或[page:WebGLRenderer.autoClearDepth autoClearDepth]属性的值设为false来阻止对应缓存被清除。
 		</p>
 
 		<h3>[method:null renderBufferDirect]( [param:Camera camera], [param:Fog fog], [param:Geometry geometry], [param:Material material], [param:Object3D object], [param:Object group] )</h3>
-		<p>Render a buffer geometry group using the camera and with the specified material.</p>
+		<p>使用相机和指定材质渲染缓冲几何组。</p>
 
 		<h3>[method:null renderBufferImmediate]( [param:Object3D object], [param:shaderprogram program], [param:Material shading] )</h3>
-		<p>object - an instance of [page:Object3D]<br />
-		program - an instance of shaderProgram<br />
-		shading - an instance of Material<br /><br />
+		<p>object - 一个[page:Object3D]实例<br />
+		program - 一个shaderProgram实例<br />
+		shading - 一个Material实例<br /><br />
 
-		Render an immediate buffer. Gets called by renderImmediateObject.
+		渲染即使缓冲，由enderImmediateObject对象调用
 		</p>
 
 		<h3>[method:null setAnimationLoop]( [param:Function callback] )</h3>
-		<p>[page:Function callback] — The function will be called every available frame. If `null` is passed it will stop any already ongoing animation.</p>
-		<p>A build in function that can be used instead of [link:https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame requestAnimationFrame]. For WebVR projects this function must be used.</p>
+		<p>[page:Function callback] — 每个可用帧都会调用的函数。 如果传入‘null’,所有正在进行的动画都会停止。</p>
+		<p>可用来代替[link:https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame requestAnimationFrame]的内置函数. 对于WebVR想谬，必须使用此功能</p>
 
 		<h3>[method:null setClearAlpha]( [param:Float alpha] )</h3>
-		<p>Sets the clear alpha. Valid input is a float between *0.0* and *1.0*.</p>
+		<p>设置alpha。合法参数是一个*0.0*到 *1.0*之间的浮点数</p>
 
 		<h3>[method:null setClearColor]( [param:Color color], [param:Float alpha] )</h3>
-		<p>Sets the clear color and opacity.</p>
+		<p>设置颜色及其透明度</p>
 
 		<h3>[method:null setPixelRatio]( [param:number value] )</h3>
-		<p>Sets device pixel ratio. This is usually used for HiDPI device to prevent bluring output canvas.</p>
+		<p>设置设备像素比。通常用于避免HiDPI设备上绘图模糊</p>
 
 		<h3>[method:null setRenderTarget]( [param:WebGLRenderTarget renderTarget] )</h3>
 		<p>
-		renderTarget -- The [page:WebGLRenderTarget renderTarget] that needs to be activated (optional).<br /><br />
-		This method sets the active rendertarget. If the parameter is omitted the canvas is set as the active rendertarget.
+		renderTarget -- 需要被激活的[page:WebGLRenderTarget renderTarget](可选).<br /><br />
+		该方法设置活跃rendertarget. 参数缺省则将canvas设置成活跃rendertarget
 		</p>
 
 		<h3>[method:null setScissor]( [param:Integer x], [param:Integer y], [param:Integer width], [param:Integer height] )</h3>
 		<p>
-		Sets the scissor area from (x, y) to (x + width, y + height)
+        将剪裁区域设为(x, y)到(x + width, y + height)
+		Sets the scissor area from
 		</p>
 
 		<h3>[method:null setScissorTest]( [param:Boolean boolean] )</h3>
 		<p>
-		Enable or disable the scissor test. When this is enabled, only the pixels within the defined
-			scissor area will be affected by further renderer actions.
+        启用或禁用剪裁检测. 若启用，则只有在所定义的裁剪区域内的像素才会受之后的渲染器影响。
 		</p>
 
 		<h3>[method:null setSize]( [param:Integer width], [param:Integer height], [param:Boolean updateStyle] )</h3>
 		<p>
-		Resizes the output canvas to (width, height) with device pixel ratio taken into account,
-			and also sets the viewport to fit that size, starting in (0, 0).
-			Setting [page:Boolean updateStyle] to false prevents any style changes to the output canvas.
+		将输出canvas的大小调整为(width, height)并考虑设备像素比，且将视口从(0, 0)开始调整到适合大小
+		将[page:Boolean updateStyle]设置为false以阻止对canvas的样式做任何改变。
 		</p>
 
 		<h3>[method:null setTexture2D]( [param:Texture texture], [param:number slot] )</h3>
 		<p>
-		texture -- The [page:Texture texture] that needs to be set.<br />
-		slot -- The number indicating which slot should be used by the texture.<br /><br />
-
-		This method sets the correct texture to the correct slot for the WebGL shader.
-		The slot number can be found as a value of the uniform of the sampler.<br /><br />
+		texture -- 需被设置的[page:Texture texture]<br />
+		slot -- 纹理应该使用的插槽号<br /><br />
+        该方法为WebGL着色器将正确的纹理设置到正确的插槽中。插槽号可作为取样器的全局变量（uniform）<br /><br />
 
-		Note: This method replaces the older [method:null setTexture] method.
+		说明: 该方法取代了旧的[method:null setTexture]方法
 		</p>
 
 		<h3>[method:null setTextureCube]( [param:CubeTexture cubeTexture], [param:Number slot] )</h3>
 		<p>
-		texture -- The [page:CubeTexture cubeTexture] that needs to be set.<br />
-		slot -- The number indicating which slot should be used by the texture.<br /><br />
+		texture -- 需要被设置的[page:CubeTexture cubeTexture]<br />
+		slot -- 纹理应该使用的插槽号<br /><br />
 
-		This method sets the correct texture to the correct slot for the WebGL shader.
-		The slot number can be found as a value of the uniform of the sampler.
+        该方法为WebGL着色器将正确的纹理设置到正确的插槽中。插槽号可作为取样器的全局变量（uniform）
 		</p>
 
 		<h3>[method:null setViewport]( [param:Integer x], [param:Integer y], [param:Integer width], [param:Integer height] )</h3>
-		<p>Sets the viewport to render from (x, y) to (x + width, y + height).</p>
+		<p>将视口大小设置为(x, y)到 (x + width, y + height).</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/shaders/ShaderChunk.html

@@ -10,19 +10,19 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">Shader chunks for WebGL Shader library</p>
+		<p class="desc">WebGL着色器库的着色器片段</p>
 
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/shaders/ShaderLib.html

@@ -10,18 +10,18 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">Webgl Shader Library for three.js</p>
+		<p class="desc">three.js的WebGL着色器库</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/shaders/UniformsLib.html

@@ -10,19 +10,19 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">Uniforms library for shared webgl shaders</p>
+		<p class="desc">为webgl着色器提供的Uniforms库</p>
 
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/shaders/UniformsUtils.html

@@ -10,17 +10,17 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">Uniform Utilities. Support merging and cloning of uniform variables</p>
+		<p class="desc">Uniform工具. 支持uniform变量的合并和克隆</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/webgl/WebGLProgram.html

@@ -10,11 +10,11 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">Constructor for the GLSL program sent to vertex and fragment shaders, including default uniforms and attributes.</p>
+		<p class="desc">发送到顶点着色器和片元着色器的GLSL程序的构造函数， 包含默认的变量(uniforms)和属性</p>
 
-		<h2>Built-in uniforms and attributes</h2>
+		<h2>内置的变量(uniforms)和属性</h2>
 
-		<h3>Vertex shader (unconditional):</h3>
+		<h3>顶点着色器(无条件的):</h3>
 		<div>
 		<code>
 		// = object.matrixWorld
@@ -42,18 +42,18 @@
 		attribute vec2 uv;
 		</code>
 		<p>
-		Note that you can therefore calculate the position of a vertex in the vertex shader by:
+        注意，可以通过以下方式计算顶点着色器中顶点的位置：
 		<code>
 		gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );
 		</code>
-		or alternatively
+		或者也可以这样：
 		<code>
 		gl_Position = projectionMatrix * viewMatrix * modelMatrix * vec4( position, 1.0 );
 		</code>
 		</p>
 		</div>
 
-		<h3>Vertex shader (conditional):</h3>
+		<h3>顶点着色器(有条件的):</h3>
 		<div>
 		<code>
 		#ifdef USE_COLOR
@@ -94,7 +94,7 @@
 		</code>
 		</div>
 
-		<h3>Fragment shader:</h3>
+		<h3>片元着色器:</h3>
 		<div>
 		<code>
 		uniform mat4 viewMatrix;
@@ -103,12 +103,12 @@
 		</div>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 		<h3>[name]( [param:WebGLRenderer renderer], [param:Object code], [param:Material material], [param:Object parameters] )</h3>
-		<p>For parameters see [page:WebGLRenderer WebGLRenderer]</p>
+		<p>参数详见[page:WebGLRenderer WebGLRenderer]</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:String id]</h3>
 		<p></p>
@@ -128,19 +128,19 @@
 		<h3>[property:WebGLShader fragmentShader]</h3>
 		<p></p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:Object getUniforms]()</h3>
 		<p>
-		Returns a name-value mapping of all active uniform locations.
+        返回所有活动态的变量(uniform)位置的name-value映射
 		</p>
 
 		<h3>[method:Object getAttributes]()</h3>
 		<p>
-		Returns a name-value mapping of all active vertex attribute locations.
+        返回所有活动态的顶点属性位置的name-value映射
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/webgl/WebGLShader.html

@@ -10,9 +10,9 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">A lower level function to compile either a vertex or fragment shader.</p>
+		<p class="desc">编译顶点或片元着色器的更底层的函数</p>
 
-		<h2>Example</h2>
+		<h2>示例</h2>
 
 		<code>
 		var gl = renderer.context;
@@ -28,21 +28,22 @@
 		gl.linkProgram( program );
 		</code>
 
-		<h2>Function</h2>
+		<h2>函数</h2>
 
 		<h3>[page:WebGLShader objects]([page:WebGLContext gl], [page:WebGLEnum type], [page:String source])</h3>
 
 		<p>
-		gl -- The current WebGL context
-		type -- The WebGL type, either gl.VERTEX_SHADER or gl.FRAGMENT_SHADER
-		source -- The source code for the shader
+		gl -- 当前的WebGL环境
+		type -- WebGL类型，值是gl.VERTEX_SHADER 或者 gl.FRAGMENT_SHADER
+		source -- 着色器源码
 		</p>
 		<p>
-		This will compile an individual shader, but won't link it to be a complete [page:WebGLProgram]. Note: this
-		is a function so the new operator should not be used.
+        此函数将编译一个独立的着色器，不会将它和一个完整的[page:WebGLProgram]链接起来。
+		说明: 这是一个函数，因此不应该使用新的操作符。
+
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/renderers/webgl/WebGLState.html

@@ -13,47 +13,47 @@
 		<p class="desc"></p>
 
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:null enable]( [param:integer id], [param:boolean boolean] )</h3>
 		<p>
-		TODO
+		未完成
 		</p>
 
 		<h3>[method:null disable]( [param:integer id], [param:boolean boolean] )</h3>
 		<p>
-		TODO
+		未完成
 		</p>
 
 		<h3>[method:null setDepthTest]( [param:boolean depthTest] )</h3>
 		<p>
-		depthTest -- The boolean to decide if depth of a fragment needs to be tested against the depth buffer . <br />
+		depthTest -- 决定是否需要基于深度缓存对片元进行深度测试的布尔值<br />
 		</p>
 		<p>
-		This sets, based on depthTest, whether or not the depth data needs to be tested against the depth buffer.
+		该方法设置了depthTest的值，故可决定是否需要基于深度缓存测试深度数据
 		</p>
 
 		<h3>[method:null setDepthWrite]( [param:boolean depthWrite] )</h3>
 		<p>
-		depthWrite -- The boolean to decide if depth of a fragment needs to be kept. <br />
+		depthWrite -- 决定是否需要保持片元深度的布尔值<br />
 		</p>
 		<p>
-		This sets, based on depthWrite, whether or not the depth data needs to be written in the depth buffer.
+		该方法设置depthWrite的值，故可决定是否要将深度数据写入深度缓存中
 		</p>
 
 		<h3>[method:null setBlending]( [param:number blending], [param:number blendEquation], [param:number blendSrc], [param:number blendDst] )</h3>
 		<p>
-		blending -- A number indicating the blending mode. Possible value are THREE.NoBlending, THREE.NormalBlending, THREE.AdditiveBlending, THREE.SubtractiveBlending, THREE.MultiplyBlending or THREE.CustomBlending <br />
-		blendEquation -- When blending is THREE.CustomBlending, then you can set the blendEquation. Possible values are THREE.AddEquation, THREE.SubtractEquation or THREE.ReverseSubtractEquation.<br />
-		blendSrc -- When blending is THREE.CustomBlending, then you can set the blendSrc. Possible values are THREE.ZeroFactor, THREE.OneFactor,THREE.SrcColorFactor, THREE.OneMinusSrcColorFactor, THREE.SrcAlphaFactor, THREE.OneMinusSrcAlphaFactor, THREE.DstAlphaFactor, THREE.OneMinusDstAlphaFactor, THREE.DstColorFactor,THREE.OneMinusDstColorFactor or THREE.SrcAlphaSaturateFactor<br />
-		blendDst -- When blending is THREE.CustomBlending, then you can set the blendDst. Possible values are THREE.ZeroFactor, THREE.OneFactor,THREE.SrcColorFactor, THREE.OneMinusSrcColorFactor, THREE.SrcAlphaFactor, THREE.OneMinusSrcAlphaFactor, THREE.DstAlphaFactor, THREE.OneMinusDstAlphaFactor, THREE.DstColorFactor,THREE.OneMinusDstColorFactor or THREE.SrcAlphaSaturateFactor
+		blending -- 一个表示混合模式的数字。可能的值有THREE.NoBlending, THREE.NormalBlending, THREE.AdditiveBlending, THREE.SubtractiveBlending, THREE.MultiplyBlending 和 THREE.CustomBlending <br />
+		blendEquation -- 如果blending的值是THREE.CustomBlending，那么你可以设置blendEquation. 可能的值有THREE.AddEquation, THREE.SubtractEquation 和 THREE.ReverseSubtractEquation.<br />
+		blendSrc -- 如果blending的值是THREE.CustomBlending, 那么你可以设置blendSrc.可能的值有THREE.ZeroFactor, THREE.OneFactor,THREE.SrcColorFactor, THREE.OneMinusSrcColorFactor, THREE.SrcAlphaFactor, THREE.OneMinusSrcAlphaFactor, THREE.DstAlphaFactor, THREE.OneMinusDstAlphaFactor, THREE.DstColorFactor,THREE.OneMinusDstColorFactor 和 THREE.SrcAlphaSaturateFactor<br />
+		blendDst -- 如果blending的值是THREE.CustomBlending, 那么你可以设置blendDst. 可能的值有THREE.ZeroFactor, THREE.OneFactor,THREE.SrcColorFactor, THREE.OneMinusSrcColorFactor, THREE.SrcAlphaFactor, THREE.OneMinusSrcAlphaFactor, THREE.DstAlphaFactor, THREE.OneMinusDstAlphaFactor, THREE.DstColorFactor,THREE.OneMinusDstColorFactor or THREE.SrcAlphaSaturateFactor
 		</p>
 		<p>
-		This method sets the correct blending.
+		该方法设置正确的混合
 		</p>
 
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/scenes/Fog.html

@@ -10,40 +10,40 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">This class contains the parameters that define linear fog, i.e., that grows linearly denser with the distance.</p>
+		<p class="desc">此类包含定义线性雾化的参数，即雾的浓度会随着距离线性增长</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:Integer color], [param:Float near], [param:Float far] )</h3>
-		<p>The color parameter is passed to the [page:Color] constructor to set the color property. Color can be a hexadecimal integer or a CSS-style string.</p>
+		<p>颜色参数会传入[page:Color]构造器以设置颜色属性. 颜色可以是十六进制的或者CSS风格的字符串</p>
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:String name]</h3>
-		<p>Optional name of the object (doesn't need to be unique). Default is an empty string.</p>
+		<p>对象的可选名称(不需要唯一)。 默认是一个空串</p>
 
 		<h3>[property:Color color]</h3>
-		<p>Fog color.  Example: If set to black, far away objects will be rendered black.</p>
+		<p>雾的颜色。  例如:如果是黑色, 远处的对象将会被渲染为黑色</p>
 
 		<h3>[property:Float near]</h3>
-		<p>The minimum distance to start applying fog. Objects that are less than 'near' units from the active camera won't be affected by fog.</p>
-		<p>Default is 1.</p>
+		<p>雾化开始运用的最小距离。到相机的距离小于'near'个单位的对象将不受雾化影响</p>
+		<p>默认是1</p>
 
 		<h3>[property:Float far]</h3>
-		<p>The maximum distance at which fog stops being calculated and applied. Objects that are more than 'far' units away from the active camera won't be affected by fog.</p>
-		<p>Default is 1000.</p>
+		<p>停止计算和应用雾化的最大距离。到相机的距离大于'far'个单位的对象将不受雾化影响</p>
+		<p>默认是1000</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:Fog clone]()</h3>
-		<p>Returns a new fog instance with the same parameters as this one.</p>
+		<p>返回一个新的雾化实例，它有着和传入雾化实例一样的参数</p>
 
 		<h3>[method:Fog toJSON]()</h3>
-		<p>Return fog data in JSON format.</p>
+		<p>返回JSON格式的雾化</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/scenes/FogExp2.html

@@ -10,36 +10,36 @@
 	<body>
 		<h1>[name]</h1>
 
-		<p class="desc">This class contains the parameters that define exponential fog, i.e., that grows exponentially denser with the distance.</p>
+		<p class="desc">此类包含定义指数雾化的参数，即雾的浓度会随着距离指数增长</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]( [param:Integer color], [param:Float density] )</h3>
 
-		<p>The color parameter is passed to the [page:Color] constructor to set the color property. Color can be a hexadecimal integer or a CSS-style string.</p>
-		<h2>Properties</h2>
+		<p>颜色参数会传入[page:Color]构造器以设置颜色属性. 颜色可以是十六进制的或者CSS风格的字符串</p>
+		<h2>属性</h2>
 
 		<h3>[property:String name]</h3>
-		<p>Optional name of the object (doesn't need to be unique). Default is an empty string.</p>
+		<p>对象的可选名称(不需要唯一)。 默认是一个空串</p>
 
 		<h3>[property:Color color]</h3>
-		<p>Fog color. Example: If set to black, far away objects will be rendered black.</p>
+		<p>雾的颜色。例如:如果是黑色, 远处的对象将会被渲染为黑色</p>
 
 		<h3>[property:Float density]</h3>
-		<p>Defines how fast the fog will grow dense.</p>
-		<p>Default is 0.00025.</p>
+		<p>定义雾的浓度增长多快</p>
+		<p>默认是0.00025.</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:FogExp2 clone]()</h3>
-		<p>Returns a new FogExp2 instance with the same parameters as this one.</p>
+		<p>返回一个新的FogExp2实例，他拥有和传入实例一样的参数</p>
 
 		<h3>[method:FogExp2 toJSON]()</h3>
-		<p>Return FogExp2 data in JSON format.</p>
+		<p>返回JSON格式的指数雾化数据</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/api/zh/scenes/Scene.html

@@ -11,47 +11,47 @@
 		[page:Object3D] →
 		<h1>[name]</h1>
 
-		<p class="desc">Scenes allow you to set up what and where is to be rendered by three.js. This is where you place objects, lights and cameras.</p>
+		<p class="desc">场景允许你设置threejs在哪里渲染什么内容。场景就是你放置对象、灯光和相机的地方</p>
 
 
-		<h2>Constructor</h2>
+		<h2>构造器</h2>
 
 
 		<h3>[name]()</h3>
 		<p>
-		Create a new scene object.
+		创建一个新的场景对象
 		</p>
 
 
-		<h2>Properties</h2>
+		<h2>属性</h2>
 
 		<h3>[property:Fog fog]</h3>
 
-		<p>A [page:Fog fog] instance defining the type of fog that affects everything rendered in the scene. Default is null.</p>
+		<p>一个[page:Fog fog]的实例，定义了一种影响场景中渲染出来的所有东西的雾。默认值是null.</p>
 
 		<h3>[property:Material overrideMaterial]</h3>
 
-		<p>If not null, it will force everything in the scene to be rendered with that material. Default is null.</p>
+		<p>如果不为null, 它会强制场景中的所有东西都用改材质渲染。 默认值是null</p>
 
 		<h3>[property:boolean autoUpdate]</h3>
 		<p>
-		Default is true. If set, then the renderer checks every frame if the scene and its objects needs matrix updates.
-		When it isn't, then you have to maintain all matrices in the scene yourself.
+		默认是true。如果设置，那么渲染器会检查检查每一帧确定场景及其中的对象是否需要矩阵更新。
+		否则，你必须自己维护场景中的所有矩阵。
 		</p>
 
 		<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 [page:CubeTexture]. Default is null.
+		如果不为null, 在渲染场景时设置下所用背景，它将总是最先被渲染. 可以被设置为[page:Color](它设置了清除颜色)， 一个覆盖了canvas的 [page:Texture]， 或者一个[page:CubeTexture]。默认是null
 		</p>
 
-		<h2>Methods</h2>
+		<h2>方法</h2>
 
 		<h3>[method:JSON toJSON]</h3>
 		<p>
-		Return the scene data in JSON format.
+        返回JSON格式的场景数据
 		</p>
 
-		<h2>Source</h2>
+		<h2>源码</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 	</body>

docs/manual/zh/introduction/Animation-system.html

@@ -10,100 +10,80 @@
 	<body>
 		<h1>[name]</h1>
 
-		<h2>Overview</h2>
+		<h2>Overview(概述)</h2>
 
 		<p class="desc">
-			Within the three.js animation system you can animate various properties of your models:
-			the bones of a [page:SkinnedMesh skinned and rigged model],
-			[page:Geometry.morphTargets morph targets], different material properties (colors,
-			opacity, booleans), visibility and transforms. The animated properties can be faded in,
-			faded out, crossfaded and warped. The weight and time scales of different simultaneous
-			animations on the same object as well as on different objects can be changed
-			independently. Various animations on the same and on different objects can be
-			synchronized.<br /><br />
-
-			To achieve all this in one homogeneous system, the three.js animation system
-			[link:https://github.com/mrdoob/three.js/issues/6881 has completely changed in 2015]
-			(be aware of outdated information!), and it has now an architecture similar to
-			Unity/Unreal Engine 4. This page gives a short overview of the main components of the
-			system and how they work together.
-
+			在three.js动画系统中，您可以为模型的各种属性设置动画：
+			[page：SkinnedMesh 蒙皮和装配模型]的骨头，[page：Geometry.morphTargets 变形目标]，不同的材料属性（颜色，
+			不透明度，布尔运算），可见性和变换。 动画属性可以淡入，淡出，交叉淡化和扭曲。 不同时间的重量和时间尺度
+			可以更改同一对象以及不同对象上的动画独立。 可以在相同和不同对象上进行各种动画同步。
+			<br /><br />
+			在一个同构系统中实现所有这一切，即three.js动画系统
+			[link：https：//github.com/mrdoob/three.js/issues/6881在2015年彻底改变]
+			（注意过时的信息！），它现在有一个与Unity /虚幻引擎4类似的架构.此页面简要概述了主要组件系统以及它们如何协同工作。
 		</p>
 
-		<h3>Animation Clips</h3>
+		<h3>Animation Clips(动画片段)</h3>
 
 		<p class="desc">
-
-			If you have successfully imported an animated 3D object (it doesn't matter if it has
-			bones or morph targets or both) — for example exporting it from Blender with the
-			[link:https://github.com/KhronosGroup/glTF-Blender-Exporter glTF Blender exporter] and
-			loading it into a three.js scene using [page:GLTFLoader] — one of the response fields
-			should be an array named "animations", containing the [page:AnimationClip AnimationClips]
-			for this model (see a list of possible loaders below).<br /><br />
-
-			Each *AnimationClip* usually holds the data for a certain activity of the object. If the
-			mesh is a character, for example, there may be one AnimationClip for a walkcycle, a second
-			for a jump, a third for sidestepping and so on.
-
+			如果您已成功导入动画3D对象（如果有，则无关紧要）
+			骨骼或变形目标或两者） - 例如使用[link：https：//github.com/KhronosGroup/glTF-Blender-Exporter glTF Blender导出器]从Blender导出它
+			使用[page：GLTFLoader]将其加载到three.js场景中 - 其中一个响应字段应该是一个名为“animations”的数组，其中包含此模型的[page：AnimationClip AnimationClips]（请参阅下面的可能加载器列表）。
+			<br /><br />
+			每个* AnimationClip *通常保存对象的某个活动的数据。 如果
+			mesh是一个字符，例如，可以有一个用于walkcycle的动画片段，第二个
+			跳跃，三分之一的回避等等。		
 		</p>
 
-		<h3>Keyframe Tracks</h3>
+		<h3>Keyframe Tracks(关键帧轨道)</h3>
 
 		<p class="desc">
-
-			Inside of such an *AnimationClip* the data for each animated property are stored in a
-			separate [page:KeyframeTrack]. Assumed a character object has a [page:Skeleton skeleton],
-			one keyframe track could store the data for the position changes of the lower arm bone
-			over time, a different track the data for the rotation changes of the same bone, a third
-			the track position, rotation or scaling of another bone, and so on. It should be clear,
-			that an AnimationClip can be composed of lots of such tracks.<br /><br />
-
-			Assumed the model has [page:Geometry.morphTargets morph targets] (for example one morph
-			target showing a friendly face and another showing an angry face), each track holds the
-			information as to how the [page:Mesh.morphTargetInfluences influence] of a certain morph
-			target changes during the performance of the clip.
-
+			在这样的* AnimationClip *里面，每个动画属性的数据都存储在一个
+			单独[page：KeyframeTrack]。 假设一个角色对象有一个[page：Skeleton skeleton]，
+			一个关键帧轨道可以存储下臂骨骼位置变化的数据
+			随着时间的推移，不同的轨道数据为同一骨骼的旋转变化，三分之一
+			轨道位置，旋转或缩放另一个骨骼，等等。 应该很清楚，
+			AnimationClip可以由许多这样的轨道组成。
+			.<br /><br />
+			假设模型具有[page：Geometry.morphTargets 变形目标]（例如一个变形
+			目标显示一个友好的面孔，另一个显示愤怒的脸），每个轨道持有
+			关于某个变形的[page：Mesh.morphTargetInfluences 影响]的信息
+			目标在剪辑执行期间发生变化。
 		</p>
 
-		<h3>Animation Mixer</h3>
+		<h3>Animation Mixer(动画混音器)</h3>
 
 		<p class="desc">
-
-			The stored data form only the basis for the animations - actual playback is controlled by
-			the [page:AnimationMixer]. You can imagine this not only as a player for animations, but
-			as a simulation of a hardware like a real mixer console, which can control several animations
-			simultaneously, blending and merging them.
-
+			存储的数据仅构成动画的基础 - 实际播放由控制
+			[page：AnimationMixer]。 你可以想象这不仅仅是动画的播放器，而是
+			作为硬件的模拟，如真正的调音台控制台，可以控制几个动画
+			同时，混合和合并它们。
 		</p>
 
 		<h3>Animation Actions</h3>
 
 		<p class="desc">
-
-			The *AnimationMixer* itself has only very few (general) properties and methods, because it
-			can be controlled by the [page:AnimationAction AnimationActions]. By configuring an
-			*AnimationAction* you can determine when a certain *AnimationClip* shall be played, paused
-			or stopped on one of the mixers, if and how often the clip has to be repeated, whether it
-			shall be performed with a fade or a time scaling, and some additional things, such crossfading
-			or synchronizing.
-
+			* AnimationMixer *本身只有很少（通用）属性和方法，因为它
+			可以通过[page：AnimationAction AnimationActions]来控制。 通过配置
+			* AnimationAction *您可以确定何时播放某个* AnimationClip *，暂停
+			或者停在其中一个混音器上，是否以及频率必须重复，无论是否
+			应使用淡入淡出或时间缩放以及一些其他内容（例如交叉渐变）来执行
+			或同步。
 		</p>
 
-		<h3>Animation Object Groups</h3>
+		<h3>Animation Object Groups(动画对象组)</h3>
 
 		<p class="desc">
-
-			If you want a group of objects to receive a shared animation state, you can use an
-			[page:AnimationObjectGroup].
+				如果您希望一组对象接收共享动画状态，则可以使用[page:AnimationObjectGroup].
 
 		</p>
 
-		<h3>Supported Formats and Loaders</h3>
+		<h3>Supported Formats and Loaders(支持的格式和加载器)</h3>
 
 		<p class="desc">
-			Note that not all model formats include animation (OBJ notably does not), and that only some
-			three.js loaders support [page:AnimationClip AnimationClip] sequences. Several that <i>do</i>
-			support this animation type:
+			请注意，并非所有模型格式都包含动画（尤其是OBJ，没有），而且只有一些
+			three.js加载器支持[page：AnimationClip AnimationClip]序列。 以下几个<i>确实</ i>
+			支持此动画类型：		
 		</p>
 
 			<ul>
@@ -118,8 +98,8 @@
 			</ul>
 
 		<p class="desc">
-			Note that 3ds max and Maya currently can't export multiple animations (meaning animations which are not
-			on the same timeline) directly to a single file.
+			请注意，3ds max和Maya当前无法导出多个动画（这意味着动画不是
+			在同一时间线上）直接到一个文件。
 		</p>
 
 		<h2>Example</h2>

docs/manual/zh/introduction/How-to-update-things.html

@@ -10,12 +10,12 @@
 	<body>
 		<h1>[name]</h1>
 		<div>
-			<p>All objects by default automatically update their matrices if they have been added to the scene with</p>
+			<p>默认情况下，所有对象都会自动更新它们的矩阵（如果它们已添加到场景中）</p>
 			<code>
 var object = new THREE.Object3D();
 scene.add( object );
 			</code>
-			or if they are the child of another object that has been added to the scene:
+			或者它们是已添加到场景中的另一个对象的子节点:
 			<code>
 var object1 = new THREE.Object3D();
 var object2 = new THREE.Object3D();
@@ -25,38 +25,34 @@ scene.add( object1 ); //object1 and object2 will automatically update their matr
 			</code>
 		</div>
 
-		<p>However, if you know object will be static, you can disable this and update the transform matrix manually just when needed.</p>
+		<p>但是，如果你知道对象将是静态的，则可以禁用此选项并在需要时手动更新转换矩阵。</p>
 
 		<code>
 object.matrixAutoUpdate  = false;
 object.updateMatrix();
 		</code>
 
-		<h2>Geometries</h2>
+		<h2>Geometries(几何形状)</h2>
 		<div>
 			<h3>[page:BufferGeometry]</h3>
 			<div>
 				<p>
-					BufferGeometries store information (such as vertex positions, face indices, normals, colors,
-					UVs, and any custom attributes) in [page:BufferAttribute buffers] - that is,
+					BufferGeometries 将信息（例如顶点位置，面索引，法线，颜色，uv和任何自定义属性） 存储在 [page:BufferAttribute buffers] - 也就是,
 					[link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays typed arrays].
-					This makes them generally faster than standard Geometries, at the cost of being somewhat harder to
-					work with.
+					这使得它们通常比标准Geometries更快，缺点是更难用。
 				</p>
 				<p>
-					With regards to updating BufferGeometries, the most important thing to understand is that
-					you cannot resize buffers (this is very costly,	basically the equivalent to creating a new geometry).
-					You can however update the content of buffers.
+					关于更新BufferGeometries, 最重要的是理解你不能调整 buffers 大小(这种操作开销很大,	相当于创建了个新的geometry).
+					但你可以更新 buffers的内容.
 				</p>
 				<p>
-					This means that if you know an attribute of your BufferGeometry will grow, say the number of vertices,
-					you must pre-allocate a buffer large enough to hold any new vertices that may be created. Of
-					course, this also means that there will be a maximum size for your BufferGeometry - there is
-					no way to create a BufferGeometry that can efficiently be extended indefinitely.
+					这意味着如果你知道BufferGeometry的一个属性会增长，比如顶点的数量，
+					你必须预先分配足够大的buffer来容纳可能创建的任何新顶点。
+					当然，这也意味着BufferGeometry将有一个最大大小 - 无法创建一个可以高效地无限扩展的BufferGeometry。
 				</p>
 				<p>
-					We'll use the example of a line that gets extended at render time. We'll allocate space
-					in the buffer for 500 vertices but draw only two at first, using [page:BufferGeometry.drawRange].
+					我们以在渲染时扩展的line来示例。我们将分配可容纳500个顶点的空间但起初仅绘制2个，使用
+					在500个顶点的缓冲区中，但首先只使用 [page:BufferGeometry.drawRange].
 				</p>
 				<code>
 var MAX_POINTS = 500;
@@ -80,7 +76,7 @@ var line = new THREE.Line( geometry,  material );
 scene.add( line );
 				</code>
 			 	<p>
-					Next we'll randomly add points to the line using a pattern like:
+					然后我们随机增加顶点到line中，以这样的一种方式：
 				</p>
 				<code>
 var positions = line.geometry.attributes.position.array;
@@ -101,21 +97,20 @@ for ( var i = 0, l = MAX_POINTS; i < l; i ++ ) {
 }
 				</code>
 				<p>
-					If you want to change the <em>number of points</em> rendered after the first render, do this:
+					如果要更改第一次渲染后渲染的<em>点数</em>，执行以下操作：
 				</p>
 				<code>
 line.geometry.setDrawRange( 0, newValue );
 				</code>
 				<p>
-					If you want to change the position data values after the first render, you need to
-					set the needsUpdate flag like so:
+					如果要在第一次渲染后更改position数值，则需要像这样设置needsUpdate标志：
 				</p>
 				<code>
 line.geometry.attributes.position.needsUpdate = true; // required after the first render
 				</code>
 
 				<p>
-					[link:http://jsfiddle.net/w67tzfhx/ Here is a fiddle] showing an animated line which you can adapt to your use case.
+					[link:http://jsfiddle.net/w67tzfhx/ 这个fiddle] 展示了一个你可以参考的运动的line.
 				</p>
 
 				<h3>Examples:</h3>
@@ -128,11 +123,10 @@ line.geometry.attributes.position.needsUpdate = true; // required after the firs
 			<h3>[page:Geometry]</h3>
 			<div>
 				<p>
-					The following flags control updating of various geometry attributes. Set flags only
-					for attributes that you need to update, updates are costly. Once buffers
-					change, these flags reset automatically back to false. You need to keep setting them to
-					true if you want to keep updating buffers. Note that this applies only to [page:Geometry]
-					and not to [page:BufferGeometry].
+					以下标志控制各种geometry属性的更新. 仅对于需要更新的属性设置标志
+					，因为更新成本很高. 一旦buffers
+					改变, 这些标志位会自动重置为false. 你需要保持这些设置为true,如果你想要持续更新buffers. 请注意这仅适用于[page:Geometry]
+					而不是 [page:BufferGeometry].
 				</p>
 				<code>
 var geometry = new THREE.Geometry();
@@ -146,8 +140,8 @@ geometry.tangentsNeedUpdate = true;
 				</code>
 
 				<p>
-					In versions prior to [link:https://github.com/mrdoob/three.js/releases/tag/r66 r66] meshes
-					additionally need the <em>dynamic</em> flag enabled (to keep internal typed arrays):
+					在早于 [link:https://github.com/mrdoob/three.js/releases/tag/r66 r66]版本中， meshes
+					需要额外设定 <em>dynamic</em> 标志true (为了维持内部的 typed arrays):
 				</p>
 
 				<code>
@@ -164,19 +158,19 @@ geometry.tangentsNeedUpdate = true;
 
 
 
-		<h2>Materials</h2>
+		<h2>Materials(材质)</h2>
 		<div>
-			<p>All uniforms values can be changed freely (e.g. colors, textures, opacity, etc), values are sent to the shader every frame.</p>
+			<p>所有uniforms值都可以自由改变 (e.g. colors, textures, opacity, etc), 这些数值在每帧都发给shader .</p>
 
-			<p>Also GLstate related parameters can change any time (depthTest, blending, polygonOffset, etc).</p>
+			<p>GL状态相关参数也可以随时改变 (depthTest, blending, polygonOffset, etc).</p>
 
-			<p>Flat / smooth shading is baked into normals. You need to reset normals buffer (see above).</p>
+			<p>平滑/平滑阴影被作到法线. 你需要重置法线 buffer (见上).</p>
 
-			<p>The following properties can't be easily changed at runtime (once the material is rendered at least once):</p>
+			<p>在运行时无法轻松更改以下属性 (一旦material被渲染了一次):</p>
 			<ul>
-				<li>numbers and types of uniforms</li>
-				<li>numbers and types of lights</li>
-				<li>presence or not of
+				<li>uniforms的数量和类型</li>
+				<li>lights的数量和类型</li>
+				<li>存在与否
 					<ul>
 						<li>texture</li>
 						<li>fog</li>
@@ -189,19 +183,19 @@ geometry.tangentsNeedUpdate = true;
 				</li>
 			</ul>
 
-			<p>Changes in these require building of new shader program. You'll need to set</p>
+			<p>这些变化需要建立新的shader程序. 你需要设置</p>
 			<code>material.needsUpdate = true</code>
 
-			<p>Bear in mind this might be quite slow and induce jerkiness in framerate (especially on Windows, as shader compilation is slower in DirectX than OpenGL).</p>
+			<p>请记住，这可能会非常缓慢并导致帧率的波动。 (特别是在Windows上，因为shader编译在directx中比opengl慢).</p>
 
-			<p>For smoother experience you can emulate changes in these features to some degree by having "dummy" values like zero intensity lights, white textures, or zero density fog.</p>
+			<p>为了获得更流畅的体验，您可以通过“虚拟”值（如零强度光，白色纹理或零密度雾）在一定程度上模拟这些功能的变化.</p>
 
-			<p>You can freely change the material used for geometry chunks, however you cannot change how an object is divided into chunks (according to face materials). </p>
+			<p>您可以自由更改用于几何块的材质，但是无法更改对象如何划分为块（根据面材料）. </p>
 
-			<h3>If you need to have different configurations of materials during runtime:</h3>
-			<p>If the number of materials / chunks is small, you could pre-divide the object beforehand (e.g. hair / face / body / upper clothes / trousers for a human, front / sides / top / glass / tire / interior for a car). </p>
+			<h3>如果你需要在运行时使用不同的材料配置：</h3>
+			<p>如果材料/块的数量很少，您可以事先预先划分物体（例如，人的头发/脸部/身体/上衣/裤子，汽车的前部/侧面/顶部/玻璃/轮胎/内部）. </p>
 
-			<p>If the number is large (e.g. each face could be potentially different), consider a different solution, such as using attributes / textures to drive different per-face look.</p>
+			<p>如果数量很大（例如，每个面可能有所不同），请考虑不同的解决方案，例如使用属性/纹理来驱动不同的每个面部外观。</p>
 
 			<h3>Examples:</h3>
 			[example:webgl_materials_cars WebGL / materials / cars]<br />
@@ -209,9 +203,9 @@ geometry.tangentsNeedUpdate = true;
 		</div>
 
 
-		<h2>Textures</h2>
+		<h2>Textures(纹理)</h2>
 		<div>
-			<p>Image, canvas, video and data textures need to have the following flag set if they are changed:</p>
+			<p>如果更改了图像，画布，视频和数据纹理，则需要设置以下标志：</p>
 			<code>
 				texture.needsUpdate = true;
 			</code>
@@ -224,9 +218,9 @@ geometry.tangentsNeedUpdate = true;
 		</div>
 
 
-		<h2>Cameras</h2>
+		<h2>Cameras(相机)</h2>
 		<div>
-			<p>A camera's position and target is updated automatically. If you need to change</p>
+			<p>相机的位置和目标会自动更新。 如果你需要改变</p>
 			<ul>
 				<li>
 					fov
@@ -242,7 +236,7 @@ geometry.tangentsNeedUpdate = true;
 				</li>
 			</ul>
 			<p>
-				then you'll need to recompute the projection matrix:
+				那么你需要重新计算投影矩阵：
 			</p>
 			<code>
 camera.aspect = window.innerWidth / window.innerHeight;

docs/manual/zh/introduction/Matrix-transformations.html

@@ -11,55 +11,56 @@
 		<h1>[name]</h1>
 
 		<p>
-		Three.js uses *matrices* to encode 3D transformations---translations (position), rotations, and scaling. Every instance of [page:Object3D] has a [page:Object3D.matrix matrix] which stores that object's position, rotation, and scale. This page describes how to update an object's transformation.
+				Three.js使用*matrix*编码3D变换 - 平移（位置），旋转和缩放。 [page:Object3D]的每个实例都有一个[page:Object3D.matrix matrix]，用于存储该对象的位置，旋转和比例。 本页介绍如何更新对象的转换。
 		</p>
 
-		<h2>Convenience properties and *matrixAutoUpdate*</h2>
+		<h2>Convenience properties and *matrixAutoUpdate*(便利属性和 *matrixAutoUpdate*)</h2>
 
-		There are two ways to update an object's transformation:
+		有两种方法可以更新对象的转换：
 		<ol>
 			<li>
-				Modify the object's *position*, *quaternion*, and *scale* properties, and let three.js recompute
-				the object's matrix from these properties:
+				修改对象的* position *，* quaternion *和* scale *属性，让three.js重新计算
+				来自这些属性的对象矩阵：
 				<code>
 				object.position.copy(start_position);
 				object.quaternion.copy(quaternion);
 				</code>
-				By default, the *matrixAutoUpdate* property is set true, and the matrix will be automatically recalculated.
-				If the object is static, or you wish to manually control when recalculation occurs, better performance can be obtained by setting the property false:
+				默认情况下，* matrixAutoUpdate *属性设置为true，并且将自动重新计算矩阵。
+如果对象是静态的，或者您希望在重新计算时手动控制，则可以通过将属性设置为false来获得更好的性能：
 				<code>
 				object.matrixAutoUpdate = false;
 				</code>
-				And after changing any properties, manually update the matrix:
+				更改任何属性后，手动更新矩阵：
 				<code>
 				object.updateMatrix();
 				</code>
 			</li>
 			<li>
-				Modify the object's matrix directly. The [page:Matrix4] class has various methods for modifying the matrix:
+				直接修改对象的矩阵。 [page：Matrix4]类有各种修改矩阵的方法：
 				<code>
 				object.matrix.setRotationFromQuaternion(quaternion);
 				object.matrix.setPosition(start_position);
 				object.matrixAutoUpdate = false;
 				</code>
-				Note that *matrixAutoUpdate* <em>must</em> be set to *false* in this case, and you should make sure <em>not</em> to call *updateMatrix*. Calling *updateMatrix* will clobber the manual changes made to the matrix, recalculating the matrix from *position*, *scale*, and so on.
+				请注意，在这种情况下，* matrixAutoUpdate * <em>必须</em>设置为* false *，并且您应该确保<em>不</em>调用* updateMatrix *。 调用* updateMatrix *将破坏对矩阵所做的手动更改，从* position *，* scale *重新计算矩阵，依此类推。
 			</li>
 		</ol>
 
-		<h2>Object and world matrices</h2>
+		<h2>Object and world matrices(对象和世界矩阵)</h2>
 		<p>
-		An object's [page:Object3D.matrix matrix] stores the object's transformation <em>relative</em> to the object's [page:Object3D.parent parent]; to get the object's transformation in <em>world</em> coordinates, you must access the object's [page:Object3D.matrixWorld].
+		对象的[page：Object3D.matrix matrix]将对象的转换<em> 相对于 </em>对象的[page：Object3D.parent parent]; 要在<em> 世界 </em>坐标中获取对象的转换，您必须访问该对象的[page：Object3D.matrixWorld]。
+		An object's [page:Object3D.matrix matrix] stores the object's transformation 
 		</p>
 		<p>
-		When either the parent or the child object's transformation changes, you can request that the child object's [page:Object3D.matrixWorld matrixWorld] be updated by calling [page:Object3D.updateMatrixWorld updateMatrixWorld]().
+		当父对象或子对象的转换发生更改时，可以通过调用[page：Object3D.updateMatrixWorld updateMatrixWorld]（）来请求更新子对象的[page：Object3D.matrixWorld matrixWorld]。
 		</p>
 
-		<h2>Rotation and Quaternion</h2>
+		<h2>Rotation and Quaternion(旋转和四元数)</h2>
 		<p>
-		Three.js provides two ways of representing 3D rotations: [page:Euler Euler angles] and [page:Quaternion Quaternions], as well as methods for converting between the two. Euler angles are subject to a problem called "gimbal lock," where certain configurations can lose a degree of freedom (preventing the object from being rotated about one axis). For this reason, object rotations are <em>always</em> stored in the object's [page:Object3D.quaternion quaternion].
+		Three.js提供了两种表示3D旋转的方式：[page：Euler Euler angles]和[page：Quaternion Quaternions]，以及两者之间的转换方法。 欧拉角受到称为“万向节锁定”的问题，其中某些配置可能失去一定程度的自由度（防止物体绕一个轴旋转）。 因此，对象旋转<em>始终</em>存储在对象的[page：Object3D.quaternion quaternion]中。
 		</p>
 		<p>
-		Previous versions of the library included a *useQuaternion* property which, when set to false, would cause the object's [page:Object3D.matrix matrix] to be calculated from an Euler angle. This practice is deprecated---instead, you should use the [page:Object3D.setRotationFromEuler setRotationFromEuler] method, which will update the quaternion.
+		该库的早期版本包含* useQuaternion *属性，当设置为false时，将导致对象的[page：Object3D.matrix矩阵]从欧拉角计算。 这种做法已被弃用 - 相反，您应该使用[page：Object3D.setRotationFromEuler setRotationFromEuler]方法，该方法将更新四元数。	
 		</p>
 
 	</body>