首页 发现 帮助
登录
javascript
/
three.js
镜像自地址 https://github.com/tazdij/three.js.git
2
0
派生 0
文件 工单管理 0 Wiki
浏览代码

zh doc: translate some pages in examples/controls

gogoend 5 年之前
父节点
e8f3f036f7
当前提交
a19730fb4a
共有 7 个文件被更改，包括 163 次插入 和 169 次删除
合并视图 显示文件统计
  1. 18 18
      docs/examples/zh/controls/DeviceOrientationControls.html
  2. 22 22
      docs/examples/zh/controls/DragControls.html
  3. 30 31
      docs/examples/zh/controls/FirstPersonControls.html
  4. 19 20
      docs/examples/zh/controls/FlyControls.html
  5. 1 2
      docs/examples/zh/controls/OrbitControls.html
  6. 28 29
      docs/examples/zh/controls/PointerLockControls.html
  7. 45 47
      docs/examples/zh/controls/TransformControls.html

+ 18 - 18
docs/examples/zh/controls/DeviceOrientationControls.html
查看文件 

@@ -9,78 +9,78 @@
 
 	</head>
 
 	</head>
 
 	<body>
 
 	<body>
 
 
 
-		<h1>[name]</h1>
 
+		<h1>设备朝向控制器（[name]）</h1>
 
 
 
 		<p class="desc">
 
 		<p class="desc">
 
-			Can be used to orient the camera based on the mobile device's orientation.
 
+			通过使用设备朝向来确定摄像机的朝向。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Example</h2>
 
+		<h2>示例</h2>
 
 
 
 		<p>[example:misc_controls_deviceorientation misc / controls / deviceorientation ]</p>
 
 		<p>[example:misc_controls_deviceorientation misc / controls / deviceorientation ]</p>
 
 
 
-		<h2>Constructor</h2>
 
+		<h2>构造函数</h2>
 
 
 
 		<h3>[name]( [param:Camera object] )</h3>
 
 		<h3>[name]( [param:Camera object] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Camera object]: The camera to be controlled.
 
+				[page:Camera object]: 被控制的摄像机。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Creates a new instance of [name].
 
+				创建一个新的 [name] 实例。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Properties</h2>
 
+		<h2>属性</h2>
 
 
 
 		<h3>[property:Number alphaOffset]</h3>
 
 		<h3>[property:Number alphaOffset]</h3>
 
 		<p>
 
 		<p>
 
-			The alpha offset in radians. Default is *0*.
 
+			alpha角偏移量，以弧度表示，默认为*0*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Object deviceOrientation]</h3>
 
 		<h3>[property:Object deviceOrientation]</h3>
 
 		<p>
 
 		<p>
 
-			The current *deviceorientation* event object.
 
+			当前 *deviceorientation* 事件的对象。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the controls are enabled.
 
+			是否启用控制器。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Camera object]</h3>
 
 		<h3>[property:Camera object]</h3>
 
 		<p>
 
 		<p>
 
-			The camera to be controlled.
 
+			被控制的摄像机。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number screenOrientation]</h3>
 
 		<h3>[property:Number screenOrientation]</h3>
 
 		<p>
 
 		<p>
 
-			The orientation in degrees (in 90-degree increments) of the viewport relative to the device's natural orientation. Default is *0*.
 
+			相对于设备自然朝向的视口朝向，以角度表示（增量为90）。默认为*0*。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Methods</h2>
 
+		<h2>方法</h2>
 
 
 
 		<h3>[method:null connect] ()</h3>
 
 		<h3>[method:null connect] ()</h3>
 
 		<p>
 
 		<p>
 
-			Adds the event listeners of the controls and enables it.
 
+			增加控制器的事件监听，并启用控制器。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null disconnect] ()</h3>
 
 		<h3>[method:null disconnect] ()</h3>
 
 		<p>
 
 		<p>
 
-			Removes the event listeners of the controls and disables it.
 
+			移除控制器的事件监听，并禁用控制器。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null dispose] ()</h3>
 
 		<h3>[method:null dispose] ()</h3>
 
 		<p>
 
 		<p>
 
-			Should be called if the controls is no longer required.
 
+			若不再需要该控制器，则应当调用此函数。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null update] ()</h3>
 
 		<h3>[method:null update] ()</h3>
 
 		<p>
 
 		<p>
 
-			Updates the controls. Usually called in the animation loop.
 
+			更新控制器，常被用在动画循环中。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Source</h2>
 
+		<h2>源代码</h2>
 
 
 
 		<p>
 
 		<p>
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/DeviceOrientationControls.js examples/js/controls/DeviceOrientationControls.js]
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/DeviceOrientationControls.js examples/js/controls/DeviceOrientationControls.js]

+ 22 - 22
docs/examples/zh/controls/DragControls.html
查看文件 

@@ -10,13 +10,13 @@
 
 	<body>
 
 	<body>
 
 		[page:EventDispatcher] &rarr;
 
 		[page:EventDispatcher] &rarr;
 
 
 
-		<h1>[name]</h1>
 
+		<h1>拖放控制器（[name]）</h1>
 
 
 
 		<p class="desc">
 
 		<p class="desc">
 
-		This class can be used to provide a drag'n'drop interaction.
 
+		该类被用于提供一个拖放交互。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Example</h2>
 
+		<h2>示例</h2>
 
 
 
 		<p>[example:misc_controls_drag misc / controls / drag ]</p>
 
 		<p>[example:misc_controls_drag misc / controls / drag ]</p>
 
 
 
@@ -39,78 +39,78 @@ controls.addEventListener( 'dragend', function ( event ) {
 
 
 
 		</code>
 
 		</code>
 
 
 
-		<h2>Constructor</h2>
 
+		<h2>构造函数</h2>
 
 
 
 		<h3>[name]( [param:Array objects], [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 
 		<h3>[name]( [param:Array objects], [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Array objects]: An array of draggable 3D objects.
 
+			[page:Array objects]: 一组可被拖拽的3D Objects。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-			[page:Camera camera]: The camera of the rendered scene.
 
+			[page:Camera camera]: 渲染场景的摄像机。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-			[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
 
+			[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Creates a new instance of [name].
 
+				创建一个新的 [name] 实例。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Events</h2>
 
+		<h2>事件</h2>
 
 
 
 		<h3>dragstart</h3>
 
 		<h3>dragstart</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the user starts to drag a 3D object.
 
+			当用户开始拖拽3D Objects时触发。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>drag</h3>
 
 		<h3>drag</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the user drags a 3D object.
 
+			当用户拖拽3D Objects时触发。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>dragend</h3>
 
 		<h3>dragend</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the user has finished dragging a 3D object.
 
+			当用户开始完成3D Objects时触发。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>hoveron</h3>
 
 		<h3>hoveron</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the pointer is moved onto a 3D object, or onto one of its children.
 
+			当指针移动到一个3D Object或者其某个子级上时触发。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>hoveroff</h3>
 
 		<h3>hoveroff</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the pointer is moved out of a 3D object.
 
+			当指针移出一个3D Object时触发。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Properties</h2>
 
+		<h2>属性</h2>
 
 
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the controls are enabled.
 
+			是否启用控制器。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Methods</h2>
 
+		<h2>方法</h2>
 
 
 
-		<p>See the base [page:EventDispatcher] class for common methods.</p>
 
+		<p>共有方法请参见其基类[page:EventDispatcher]。</p>
 
 
 
 		<h3>[method:null activate] ()</h3>
 
 		<h3>[method:null activate] ()</h3>
 
 		<p>
 
 		<p>
 
-			Adds the event listeners of the controls.
 
+			添加控制器的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null deactivate] ()</h3>
 
 		<h3>[method:null deactivate] ()</h3>
 
 		<p>
 
 		<p>
 
-			Removes the event listeners of the controls.
 
+			移除控制器的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null dispose] ()</h3>
 
 		<h3>[method:null dispose] ()</h3>
 
 		<p>
 
 		<p>
 
-			Should be called if the controls is no longer required.
 
+			若不再需要该控制器，则应当调用此函数。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Source</h2>
 
+		<h2>源代码</h2>
 
 
 
 		<p>
 
 		<p>
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/DragControls.js examples/js/controls/DragControls.js]
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/DragControls.js examples/js/controls/DragControls.js]

+ 30 - 31
docs/examples/zh/controls/FirstPersonControls.html
查看文件 

@@ -9,57 +9,56 @@
 
 	</head>
 
 	</head>
 
 	<body>
 
 	<body>
 
 
 
-		<h1>[name]</h1>
 
+		<h1>第一人称控制器（[name]）</h1>
 
 
 
 		<p class="desc">
 
 		<p class="desc">
 
-			This class is an alternative implementation of [page:FlyControls].
 
+			该类是 [page:FlyControls] 的另一个实现。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Example</h2>
 
+		<h2>示例</h2>
 
 
 
 		<p>[example:webgl_geometry_terrain webgl / geometry / terrain ]</p>
 
 		<p>[example:webgl_geometry_terrain webgl / geometry / terrain ]</p>
 
 
 
-		<h2>Constructor</h2>
 
+		<h2>构造函数</h2>
 
 
 
 		<h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
 
 		<h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Camera object]: The camera to be controlled.
 
+				[page:Camera object]: 被控制的摄像机。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
 
+				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Creates a new instance of [name].
 
+				创建一个新的 [name] 实例。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Properties</h2>
 
+		<h2>属性</h2>
 
 
 
 		<h3>[property:Boolean activeLook]</h3>
 
 		<h3>[property:Boolean activeLook]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not it's possible to look around. Default is *true*.
 
+			是否能够环视四周。默认为*true*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean autoForward]</h3>
 
 		<h3>[property:Boolean autoForward]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the camera is automatically moved forward. Default is *false*.
 
+			摄像机是否自动向前移动。默认为*false*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean constrainVertical]</h3>
 
 		<h3>[property:Boolean constrainVertical]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not looking around is vertically constrained by [[page:.verticalMin], [page:.verticalMax]]. Default is *false*.
 
+			垂直环视是否约束在[[page:.verticalMin], [page:.verticalMax]]之间。默认值为*false*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<p>
 
 		<p>
 
-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
 
-			not set up new event listeners.
 
+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the controls are enabled. Default is *true*.
 
+			是否启用控制器。默认为*true*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number heightCoef]</h3>
 
 		<h3>[property:Number heightCoef]</h3>
 
@@ -79,55 +78,55 @@
 
 
 
 		<h3>[property:Boolean heightSpeed]</h3>
 
 		<h3>[property:Boolean heightSpeed]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the camera's height influences the forward movement speed. Default is *false*.
 
-			Use the properties [page:.heightCoef], [page:.heightMin] and [page:.heightMax] for configuration.
 
+			摄像机的高度是否影响向前移动的速度。默认值为*false*。
 
+			使用属性 [page:.heightCoef]、 [page:.heightMin] 和 [page:.heightMax] 来进行配置。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean lookVertical]</h3>
 
 		<h3>[property:Boolean lookVertical]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not it's possible to vertically look around. Default is *true*.
 
+			是否能够垂直环视。默认为*true*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number lookSpeed]</h3>
 
 		<h3>[property:Number lookSpeed]</h3>
 
 		<p>
 
 		<p>
 
-			The look around speed. Default is *0.005*.
 
+			环视速度。默认为*0.005*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean mouseDragOn]</h3>
 
 		<h3>[property:Boolean mouseDragOn]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the mouse is pressed down. Read-only property.
 
+			鼠标是否被按下。只读属性。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number movementSpeed]</h3>
 
 		<h3>[property:Number movementSpeed]</h3>
 
 		<p>
 
 		<p>
 
-			The movement speed. Default is *1*.
 
+			移动速度。默认为*1*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Camera object]</h3>
 
 		<h3>[property:Camera object]</h3>
 
 		<p>
 
 		<p>
 
-			The camera to be controlled.
 
+			被控制的摄像机。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number verticalMax]</h3>
 
 		<h3>[property:Number verticalMax]</h3>
 
 		<p>
 
 		<p>
 
-			How far you can vertically look around, upper limit. Range is 0 to Math.PI radians. Default is *Math.PI*.
 
+			你能够垂直环视角度的上限。范围在 0 到 Math.PI 弧度之间。默认为*Math.PI*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number verticalMin]</h3>
 
 		<h3>[property:Number verticalMin]</h3>
 
 		<p>
 
 		<p>
 
-			How far you can vertically look around, lower limit. Range is 0 to Math.PI radians. Default is *0*.
 
+			你能够垂直环视角度的下限。范围在 0 到 Math.PI 弧度之间。默认为*0*。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Methods</h2>
 
+		<h2>方法</h2>
 
 
 
 		<h3>[method:null dispose] ()</h3>
 
 		<h3>[method:null dispose] ()</h3>
 
 		<p>
 
 		<p>
 
-			Should be called if the controls is no longer required.
 
+			若不再需要该控制器，则应当调用此函数。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null handleResize] ()</h3>
 
 		<h3>[method:null handleResize] ()</h3>
 
 		<p>
 
 		<p>
 
-			Should be called if the application window is resized.
 
+			若应用程序窗口大小发生改变，则应当调用此函数。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:FirstPersonControls lookAt]( [param:Vector3 vector] )<br />
 
 		<h3>[method:FirstPersonControls lookAt]( [param:Vector3 vector] )<br />
 
@@ -135,14 +134,14 @@
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
 				<p>
 
 				<p>
 
-					vector - A vector representing the target position.
 
+					vector - 一个表示目标位置的向量。
 
 				</p>
 
 				</p>
 
 				<p>
 
 				<p>
 
-					Optionally, the x, y, z components of the world space position.
 
+					或者，世界空间位置的x、y、z分量。
 
 				</p>
 
 				</p>
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Ensures the controls orient the camera towards the defined target position.
 
+				确保控制器将相机方向朝向到所传入的目标的位置。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
@@ -152,11 +151,11 @@
 
 				[page:Number delta]: Time delta value.
 
 				[page:Number delta]: Time delta value.
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Updates the controls. Usually called in the animation loop.
 
+				更新控制器，常被用在动画循环中。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Source</h2>
 
+		<h2>源代码</h2>
 
 
 
 		<p>
 
 		<p>
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/FirstPersonControls.js examples/js/controls/FirstPersonControls.js]
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/FirstPersonControls.js examples/js/controls/FirstPersonControls.js]

+ 19 - 20
docs/examples/zh/controls/FlyControls.html
查看文件 

@@ -9,70 +9,69 @@
 
 	</head>
 
 	</head>
 
 	<body>
 
 	<body>
 
 
 
-		<h1>[name]</h1>
 
+		<h1>飞行控制器（[name]）</h1>
 
 
 
 		<p class="desc">
 
 		<p class="desc">
 
-			[name] enables a navigation similar to fly modes in DCC tools like Blender. You can arbitrarily transform the camera in
 
-			3D space without any limitations (e.g. focus on a specific target).
 
+			[name] 启用了一种类似于数字内容创建工具（例如Blender）中飞行模式的导航方式。
 
+			你可以在3D空间中任意变换摄像机，并且无任何限制（例如，专注于一个特定的目标）。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Example</h2>
 
+		<h2>示例</h2>
 
 
 
 		<p>[example:misc_controls_fly misc / controls / fly ]</p>
 
 		<p>[example:misc_controls_fly misc / controls / fly ]</p>
 
 
 
-		<h2>Constructor</h2>
 
+		<h2>构造函数</h2>
 
 
 
 		<h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
 
 		<h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Camera object]: The camera to be controlled.
 
+				[page:Camera object]: 被控制的摄像机。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
 
+				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Creates a new instance of [name].
 
+				创建一个新的 [name] 实例。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Properties</h2>
 
+		<h2>属性</h2>
 
 
 
 		<h3>[property:Boolean autoForward]</h3>
 
 		<h3>[property:Boolean autoForward]</h3>
 
 		<p>
 
 		<p>
 
-			If set to *true*, the camera automatically moves forward (and does not stop) when initially translated. Default is *false*.
 
+			若该值设为*true*，初始变换后，摄像机将自动向前移动（且不会停止）。默认为*false*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<p>
 
 		<p>
 
-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
 
-			not set up new event listeners.
 
+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean dragToLook]</h3>
 
 		<h3>[property:Boolean dragToLook]</h3>
 
 		<p>
 
 		<p>
 
-			If set to *true*, you can only look around by performing a drag interaction. Default is *false*.
 
+			若该值设为*true*，你将只能通过执行拖拽交互来环视四周。默认为*false*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number movementSpeed]</h3>
 
 		<h3>[property:Number movementSpeed]</h3>
 
 		<p>
 
 		<p>
 
-			The movement speed. Default is *1*.
 
+			移动速度，默认为*1*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Camera object]</h3>
 
 		<h3>[property:Camera object]</h3>
 
 		<p>
 
 		<p>
 
-			The camera to be controlled.
 
+			被控制的摄像机。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number rollSpeed]</h3>
 
 		<h3>[property:Number rollSpeed]</h3>
 
 		<p>
 
 		<p>
 
-			The rotation speed. Default is *0.005*.
 
+			旋转速度。默认为*0.005*。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Methods</h2>
 
+		<h2>方法</h2>
 
 
 
 		<h3>[method:null dispose] ()</h3>
 
 		<h3>[method:null dispose] ()</h3>
 
 		<p>
 
 		<p>
 
-			Should be called if the controls is no longer required.
 
+			若不再需要该控制器，则应当调用此函数。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null update] ( [param:Number delta] )</h3>
 
 		<h3>[method:null update] ( [param:Number delta] )</h3>
 
@@ -81,11 +80,11 @@
 
 				[page:Number delta]: Time delta value.
 
 				[page:Number delta]: Time delta value.
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Updates the controls. Usually called in the animation loop.
 
+				更新控制器，常被用在动画循环中。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Source</h2>
 
+		<h2>源代码</h2>
 
 
 
 		<p>
 
 		<p>
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/FlyControls.js examples/js/controls/FlyControls.js]
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/FlyControls.js examples/js/controls/FlyControls.js]

+ 1 - 2
docs/examples/zh/controls/OrbitControls.html
查看文件 

@@ -83,8 +83,7 @@ function animate() {
 
 
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<p>
 
 		<p>
 
-			用于监听鼠标事件或触摸事件的HTMLDOMElement（DOM元素）。该值必须在构造函数中进行传入；
 
-			在此更改它将不会设置新的事件监听器
 
+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<h3>[property:Boolean enabled]</h3>

+ 28 - 29
docs/examples/zh/controls/PointerLockControls.html
查看文件 

@@ -10,14 +10,14 @@
 
 	<body>
 
 	<body>
 
 		[page:EventDispatcher] &rarr;
 
 		[page:EventDispatcher] &rarr;
 
 
 
-		<h1>[name]</h1>
 
+		<h1>指针锁定控制器（[name]）</h1>
 
 
 
 		<p class="desc">
 
 		<p class="desc">
 
-		The implementation of this class is based on the [link:https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API Pointer Lock API].
 
-		[name] is a perfect choice for first person 3D games.
 
+		该类的实现是基于[link:https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API Pointer Lock API]的。
 
+		对于第一人称3D游戏来说， [name] 是一个非常完美的选择。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Example</h2>
 
+		<h2>示例</h2>
 
 
 
 		<p>[example:misc_controls_pointerlock misc / controls / pointerlock ]</p>
 
 		<p>[example:misc_controls_pointerlock misc / controls / pointerlock ]</p>
 
 
 
@@ -40,107 +40,106 @@ controls.addEventListener( 'unlock', function () {
 
 
 
 		</code>
 
 		</code>
 
 
 
-		<h2>Constructor</h2>
 
+		<h2>构造函数</h2>
 
 
 
 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 
 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-			[page:Camera camera]: The camera of the rendered scene.
 
+			[page:Camera camera]: 渲染场景的摄像机。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-			[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
 
+			[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Creates a new instance of [name].
 
+				创建一个新的 [name] 实例。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Events</h2>
 
+		<h2>事件</h2>
 
 
 
 		<h3>change</h3>
 
 		<h3>change</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the user moves the mouse.
 
+			当用户移动鼠标时触发。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>lock</h3>
 
 		<h3>lock</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the pointer lock status is "locked" (in other words: the mouse is captured).
 
+			当指针状态为 “locked” （即鼠标被捕获）时触发。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>unlock</h3>
 
 		<h3>unlock</h3>
 
 		<p>
 
 		<p>
 
-			Fires when the pointer lock status is "unlocked" (in other words: the mouse is not captured anymore).
 
+			当指针状态为 “unlocked” （即鼠标不再被捕获）时触发。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Properties</h2>
 
+		<h2>属性</h2>
 
 
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<p>
 
 		<p>
 
-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
 
-			not set up new event listeners.
 
+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 
 
 		<h3>[property:Boolean isLocked]</h3>
 
 		<h3>[property:Boolean isLocked]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the controls are locked.
 
+			控制器是否被锁定。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Methods</h2>
 
+		<h2>方法</h2>
 
 
 
-		<p>See the base [page:EventDispatcher] class for common methods.</p>
 
+		<p>共有方法请参见其基类[page:EventDispatcher]。</p>
 
 
 
 		<h3>[method:null connect] ()</h3>
 
 		<h3>[method:null connect] ()</h3>
 
 		<p>
 
 		<p>
 
-			Adds the event listeners of the controls.
 
+			添加控制器的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null disconnect] ()</h3>
 
 		<h3>[method:null disconnect] ()</h3>
 
 		<p>
 
 		<p>
 
-			Removes the event listeners of the controls.
 
+			移除控制器的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:Vector3 getDirection] ( [param:Vector3 target] )</h3>
 
 		<h3>[method:Vector3 getDirection] ( [param:Vector3 target] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Vector3 target]: The target vector.
 
+				[page:Vector3 target]: 目标向量。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Returns the look direction of the camera.
 
+				返回摄像机的观看方向。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null lock] ()</h3>
 
 		<h3>[method:null lock] ()</h3>
 
 		<p>
 
 		<p>
 
-			Activates the pointer lock.
 
+			激活指针锁定。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null moveForward] ( [param:Number distance] )</h3>
 
 		<h3>[method:null moveForward] ( [param:Number distance] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Number distance]: The signed distance.
 
+				[page:Number distance]: 距离（区分正负）。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Moves the camera forward parallel to the xz-plane. Assumes camera.up is y-up.
 
+				平行于xz平面，向前移动摄像机。假定camera.up是y朝上。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null moveRight] ( [param:Number distance] )</h3>
 
 		<h3>[method:null moveRight] ( [param:Number distance] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Number distance]: The signed distance.
 
+				[page:Number distance]: 距离（区分正负）。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Moves the camera sidewards parallel to the xz-plane.
 
+				平行于xz平面，向侧面移动摄像机。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null unlock] ()</h3>
 
 		<h3>[method:null unlock] ()</h3>
 
 		<p>
 
 		<p>
 
-			Exits the pointer lock.
 
+			退出指针锁定。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Source</h2>
 
+		<h2>源代码</h2>
 
 
 
 		<p>
 
 		<p>
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/PointerLockControls.js examples/js/controls/PointerLockControls.js]
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/PointerLockControls.js examples/js/controls/PointerLockControls.js]

+ 45 - 47
docs/examples/zh/controls/TransformControls.html
查看文件 

@@ -10,33 +10,32 @@
 
 	<body>
 
 	<body>
 
 		[page:Object3D] &rarr;
 
 		[page:Object3D] &rarr;
 
 
 
-		<h1>[name]</h1>
 
+		<h1>变换控制器（[name]）</h1>
 
 
 
 		<p class="desc">
 
 		<p class="desc">
 
-			This class can be used to transform objects in 3D space by adapting a similar interaction model of DCC tools like Blender.
 
-			Unlike other controls, it is not intended to transform the scene's camera.
 
+			该类可提供一种类似于在数字内容创建工具（例如Blender）中对模型进行交互的方式，来在3D空间中变换物体。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Example</h2>
 
+		<h2>示例</h2>
 
 
 
 		<p>[example:misc_controls_transform misc / controls / transform ]</p>
 
 		<p>[example:misc_controls_transform misc / controls / transform ]</p>
 
 
 
-		<h2>Constructor</h2>
 
+		<h2>构造函数</h2>
 
 
 
 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 
 		<h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Camera camera]: The camera of the rendered scene.
 
+				[page:Camera camera]: 被控制的摄像机。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				[page:HTMLDOMElement domElement]: The HTML element used for event listeners.
 
+				[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Creates a new instance of [name].
 
+				创建一个新的 [name] 实例。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Events</h2>
 
+		<h2>事件</h2>
 
 
 
 		<h3>change</h3>
 
 		<h3>change</h3>
 
 		<p>
 
 		<p>
 
@@ -46,152 +45,151 @@
 
 
 
 		<h3>mouseDown</h3>
 
 		<h3>mouseDown</h3>
 
 		<p>
 
 		<p>
 
-			Fires if a pointer (mouse/touch) becomes active.
 
+			如果指针（鼠标/触摸）为活动状态则触发该事件。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>mouseUp</h3>
 
 		<h3>mouseUp</h3>
 
 		<p>
 
 		<p>
 
-			Fires if a pointer (mouse/touch) is no longer active.
 
+			如果指针（鼠标/触摸）不再为活动状态则触发该事件。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>objectChange</h3>
 
 		<h3>objectChange</h3>
 
 		<p>
 
 		<p>
 
-			Fires if the controlled 3D object is changed.
 
+			如果被控制的3D对象发生改变则触发该事件。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Properties</h2>
 
+		<h2>属性</h2>
 
 
 
-		<p>See the base [page:Object3D] class for common properties.</p>
 
+		<p>共有属性请参见其基类[page:Object3D]。</p>
 
 
 
 		<h3>[property:String axis]</h3>
 
 		<h3>[property:String axis]</h3>
 
 		<p>
 
 		<p>
 
-			The current transformation axis.
 
+			当前变换轴。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Camera camera]</h3>
 
 		<h3>[property:Camera camera]</h3>
 
 		<p>
 
 		<p>
 
-			The camera of the rendered scene.
 
+			渲染场景的摄像机。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<h3>[property:HTMLDOMElement domElement]</h3>
 
 		<p>
 
 		<p>
 
-			The HTMLDOMElement used to listen for mouse / touch events. This must be passed in the constructor; changing it here will
 
-			not set up new event listeners.
 
+			该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean dragging]</h3>
 
 		<h3>[property:Boolean dragging]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not dragging is currently performed. Read-only property.
 
+			当前是否正在拖动。只读属性。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<h3>[property:Boolean enabled]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the controls are enabled.
 
+			是否启用控制器。默认为*true*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:String mode]</h3>
 
 		<h3>[property:String mode]</h3>
 
 		<p>
 
 		<p>
 
-			The current transformation mode. Possible values are "translate", "rotate" and "scale". Default is *translate*.
 
+			当前的变换模式。可能的值包括"translate"、"rotate" 和 "scale"。默认为*translate*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Object3D object]</h3>
 
 		<h3>[property:Object3D object]</h3>
 
 		<p>
 
 		<p>
 
-			The 3D object being controlled.
 
+			正在被控制的3D对象。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number rotationSnap]</h3>
 
 		<h3>[property:Number rotationSnap]</h3>
 
 		<p>
 
 		<p>
 
-			By default, 3D objects are continously rotated. If you set this property to a numeric value (radians), you can define in which
 
-			steps the 3D object should be rotated. Deault is *null*.
 
+			默认情况下，3D对象是可以被连续旋转的。如果你将该值设为一个数值（弧度），则你将可以定义每次旋转3D对象时的步幅。
 
+			默认为*null*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean showX]</h3>
 
 		<h3>[property:Boolean showX]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the x-axis helper should be visible. Default is *true*.
 
+			x轴手柄是否显示。默认为*true*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean showY]</h3>
 
 		<h3>[property:Boolean showY]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the y-axis helper should be visible. Default is *true*.
 
+			y轴手柄是否显示。默认为*true*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Boolean showZ]</h3>
 
 		<h3>[property:Boolean showZ]</h3>
 
 		<p>
 
 		<p>
 
-			Whether or not the z-axis helper should be visible. Default is *true*.
 
+			z轴手柄是否显示。默认为*true*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number size]</h3>
 
 		<h3>[property:Number size]</h3>
 
 		<p>
 
 		<p>
 
-			The size of the helper UI (axes/planes). Default is *1*.
 
+			手柄UI（轴/平面）的大小。默认为*1*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:String space]</h3>
 
 		<h3>[property:String space]</h3>
 
 		<p>
 
 		<p>
 
-			Defines in which coordinate space transformations should be performed. Possible values are "world" and "local". Default is *world*.
 
+			定义了在哪种空间坐标系中进行变换。可能的值有"world" 和 "local"。默认为*world*。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[property:Number translationSnap]</h3>
 
 		<h3>[property:Number translationSnap]</h3>
 
 		<p>
 
 		<p>
 
-			By default, 3D objects are continously translated. If you set this property to a numeric value (world units), you can define in which
 
-			steps the 3D object should be translated. Deault is *null*.
 
+			默认情况下，3D对象是可以被连续平移的。如果你将该值设为一个数值（世界单位），则你将可以定义每次平移3D对象时的步幅。
 
+			默认为*null*。
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Methods</h2>
 
+		<h2>方法</h2>
 
 
 
-		<p>See the base [page:Object3D] class for common methods.</p>
 
+		<p>共有方法请参见其基类[page:Object3D]。</p>
 
 
 
 		<h3>[method:TransformControls attach] ( [param:Object3D object] )</h3>
 
 		<h3>[method:TransformControls attach] ( [param:Object3D object] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Object3D object]: The 3D object that should be transformed.
 
+				[page:Object3D object]: 应当变换的3D对象。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Sets the 3D object that should be transformed and ensures the controls UI is visible.
 
+				设置应当变换的3D对象，并确保控制器UI是可见的。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:TransformControls detach] ()</h3>
 
 		<h3>[method:TransformControls detach] ()</h3>
 
 		<p>
 
 		<p>
 
-			Removes the current 3D object from the controls and makes the helper UI is invisible.
 
+			从控制器中移除当前3D对象，并确保控制器UI是不可见的。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null dispose] ()</h3>
 
 		<h3>[method:null dispose] ()</h3>
 
 		<p>
 
 		<p>
 
-			Should be called if the controls is no longer required.
 
+			若不再需要该控制器，则应当调用此函数。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:String getMode] ()</h3>
 
 		<h3>[method:String getMode] ()</h3>
 
 		<p>
 
 		<p>
 
-			Returns the transformation mode.
 
+			返回变换模式。
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null setMode] ( [param:String mode] )</h3>
 
 		<h3>[method:null setMode] ( [param:String mode] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:String mode]: The transformation mode.
 
+				[page:String mode]: 变换模式。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Sets the transformation mode.
 
+				设置变换模式。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null setRotationSnap] ( [param:Number rotationSnap] )</h3>
 
 		<h3>[method:null setRotationSnap] ( [param:Number rotationSnap] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Number rotationSnap]: The rotation snap.
 
+				[page:Number rotationSnap]: 旋转捕捉步幅。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Sets the rotation snap.
 
+				设置旋转捕捉。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
 		<h3>[method:null setSize] ( [param:Number size] )</h3>
 
 		<h3>[method:null setSize] ( [param:Number size] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Number size]: The size of the helper UI.
 
+				[page:Number size]: 手柄UI的大小。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Sets the size of the helper UI.
 
+				设置手柄UI的大小。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
@@ -208,14 +206,14 @@
 
 		<h3>[method:null setTranslationSnap] ( [param:Number translationSnap] )</h3>
 
 		<h3>[method:null setTranslationSnap] ( [param:Number translationSnap] )</h3>
 
 		<p>
 
 		<p>
 
 			<p>
 
 			<p>
 
-				[page:Number translationSnap]: The translation snap.
 
+				[page:Number translationSnap]: 平移捕捉步幅。
 
 			</p>
 
 			</p>
 
 			<p>
 
 			<p>
 
-				Sets the translation snap.
 
+				设置平移捕捉。
 
 			</p>
 
 			</p>
 
 		</p>
 
 		</p>
 
 
 
-		<h2>Source</h2>
 
+		<h2>源代码</h2>
 
 
 
 		<p>
 
 		<p>
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/TransformControls.js examples/js/controls/TransformControls.js]
 
 			[link:https://github.com/mrdoob/three.js/blob/master/examples/js/controls/TransformControls.js examples/js/controls/TransformControls.js]