Skip to content

Commit

Permalink
[Doc/zh]: Improve Chinese translation related to Controls. (mrdoob#…
Browse files Browse the repository at this point in the history 
…29107)

* [Docs/zh]: Improve DragControls Chinese translation.

* add zh Controls.html

* update zh PointerLockControls.html

* update zh PointerLockControls.html

* update zh FlyControls

* update zh FirstPersonControls

* update zh ArcballControls
  • Loading branch information
@puxiao
puxiao committed Aug 12, 2024
1 parent a539d90 commit 4f067f0
Show file tree
Hide file tree
Showing 7 changed files with 180 additions and 147 deletions.
32 changes: 7 additions & 25 deletions docs/examples/zh/controls/ArcballControls.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
</head>

<body>
[page:EventDispatcher] &rarr;
[page:Controls] &rarr;

<h1>弧球控制器([name])</h1>

Expand Down Expand Up @@ -70,9 +70,9 @@ <h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement], [param:Sce
<p>
[page:Camera camera]：（必填）要控制的相机。相机不能是另一个对象的子对象，除非该对象是场景本身。<br><br>

[page:HTMLDOMElement domElement]： 用于事件侦听器的 HTML 元素。<br><br>
[page:HTMLDOMElement domElement]： 用于事件侦听器的 HTML 元素。(可选)<br><br>

[page:Scene scene]： 相机渲染的场景。如果未给出，则小控件无法显示。
[page:Scene scene]： 相机渲染的场景。如果未给出，则小控件无法显示。(可选)
</p>

<h2>事件</h2>
Expand All @@ -94,6 +94,8 @@ <h3>end</h3>

<h2>属性</h2>

<p>共有属性请参见其基类[page:Controls]。</p>

<h3>[property:Boolean adjustNearFar]</h3>
<p>
如果为 true，则每次执行缩放时都会调整相机的近端和远端值，尝试保持初始近端和远端值给出的相同可见部分（仅限 [page:PerspectiveCamera] ）。默认为 false。
Expand All @@ -116,16 +118,6 @@ <h3>
设置为 [page:.enableAnimations] 为true 时使用的阻尼惯性。
</p>

<h3>[property:HTMLDOMElement domElement]</h3>
<p>
HTMLDOMElement 用于监听鼠标/触摸事件。这必须在构造函数中传递；此处更改它不会设置新的事件侦听器。
</p>

<h3>[property:Boolean enabled]</h3>
<p>
当设置为 时 `false`，小控件将不再响应用户交互。默认为 `true`。
</p>

<h3>[property:Boolean enableAnimations]</h3>
<p>
设置为 true 以启用旋转（阻尼）和聚焦操作的动画。默认为 true。
Expand Down Expand Up @@ -201,9 +193,10 @@ <h3>[property:Float wMax]</h3>
旋转动画开始时允许的最大角速度。
</p>


<h2>方法</h2>

<p>共有方法请参见其基类[page:Controls]。</p>

<h3>[method:undefined activateGizmos] ( [param:Boolean isActive] )</h3>
<p>
使小控件或多或少可见。
Expand All @@ -214,11 +207,6 @@ <h3>[method:undefined copyState] ()</h3>
将当前状态复制到剪贴板（作为可读的 JSON 文本）。
</p>

<h3>[method:undefined dispose] ()</h3>
<p>
删除所有事件侦听器，取消任何待处理的动画并清除场景中的小控件和网格。
</p>

<h3>[method:undefined pasteState] ()</h3>
<p>
从剪贴板设置控件状态，假设剪贴板存储从 [page:.copyState] 保存的 JSON 文本。
Expand Down Expand Up @@ -264,16 +252,10 @@ <h3>[method:Boolean unsetMouseAction] ( mouse, key )</h3>
键盘修饰符可以指定为 'CTRL'、'SHIFT' 或 null(如果不再需要) 。
</p>

<h3>[method:undefined update] ()</h3>
<p>
更新控件。必须在对相机变换进行任何手动更改后调用。
</p>

<h3>[method:Raycaster getRaycaster] ()</h3>
<p>
返回用于用户交互的 [page:Raycaster] 对象。如果设置了 [name] 的 [page:Object3D.layers .layers] 属性，您还需要使用匹配的值设置 [page:Raycaster.layers
.layers] 的 [page:Raycaster] 属性，否则 [name] 将无法按预期工作。
won't work as expected.
</p>

<h2>源代码</h2>
Expand Down
116 changes: 116 additions & 0 deletions docs/examples/zh/controls/Controls.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="utf-8" />
<base href="../../../" />
<script src="page.js"></script>
<link type="text/css" rel="stylesheet" href="page.css" />
</head>
<body>
[page:EventDispatcher] &rarr;

<h1>控制器([name])</h1>

<p class="desc">
控制器的抽象基类。
</p>

<h2>构造函数</h2>

<h3>[name]( [param:Object3D object], [param:HTMLDOMElement domElement] )</h3>

<p>
[page:Object3D object] - 控件应该管理的对象（通常是相机）。
</p>
<p>
[page:HTMLDOMElement domElement]: 用于添加事件侦听器的 HTML 元素。(可选)
</p>
<p>
创建一个 [name] 实例。
</p>

<h2>属性</h2>

<h3>[property:HTMLDOMElement domElement]</h3>
<p>
用于添加事件侦听器的 HTML 元素。 如果没有在构造函数中提供，[page:.connect]() 必须在 `domElement` 设置后才能调用。
</p>

<h3>[property:Boolean enabled]</h3>
<p>
如果设置为 `false`，控制器将不再响应用户设备输入。 默认值为 `true`。
</p>

<h3>[property:Object keys]</h3>
<p>
该对象用于定义控制器的键盘输入。
默认值为 `{}`。
</p>

<h3>[property:Object mouseButtons]</h3>
<p>
此对象定义分配给可用鼠标按键的操作类型。
支持哪些鼠标按键和操作取决于控制器的具体实现。
默认值为 `{ LEFT: null, MIDDLE: null, RIGHT: null }`。
</p>
<p>
按键可能为: `LEFT`, `MIDDLE`, `RIGHT`。
</p>
<p>
可能的操作是定义在 [page:Core Constants] 中。
</p>

<h3>[property:Object3D object]</h3>
<p>
由控制器管理的 Object3D 对象。
</p>

<h3>[property:Integer state]</h3>
<p>
控制器的内部状态。默认值为 `-1` (`NONE`)。
</p>

<h3>[property:Object touches]</h3>
<p>
此对象定义将哪种类型的操作分配给哪种触摸交互。
支持哪种触摸交互和操作取决于控制器的具体实现。
默认值为 `{ ONE: null, TWO: null }`。
</p>
<p>
可能触摸点操作有: `ONE`, `TWO`.
</p>
<p>
可能的操作是定义在 [page:Core Constants] 中。
</p>

<h2>方法</h2>

<p>共有方法请参见其基类[page:EventDispatcher]。</p>

<h3>[method:undefined connect] ()</h3>
<p>
将控制器连接到 DOM。此方法具有所谓的“副作用”，因为它将模块的事件侦听器添加到 DOM。
</p>

<h3>[method:undefined disconnect] ()</h3>
<p>
断开控制器与 DOM 的连接。
</p>

<h3>[method:undefined dispose] ()</h3>
<p>
如果您不再需要使用这些控制器，请调用此方法。它将释放所有内部资源并删除所有事件侦听器。
</p>

<h3>[method:undefined update] ( [param:Number delta] )</h3>
<p>
如果控制器必须在每个模拟步骤中更新其内部状态，则应实现此方法。
</p>

<h2>源代码</h2>

<p>
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/Controls.js examples/jsm/controls/Controls.js]
</p>
</body>
</html>
50 changes: 24 additions & 26 deletions docs/examples/zh/controls/DragControls.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<link type="text/css" rel="stylesheet" href="page.css" />
</head>
<body>
[page:EventDispatcher] &rarr;
[page:Controls] &rarr;

<h1>拖放控制器（[name]）</h1>

Expand Down Expand Up @@ -61,7 +61,7 @@ <h3>[name]( [param:Array objects], [param:Camera camera], [param:HTMLDOMElement
[page:Camera camera]: 渲染场景的摄像机。
</p>
<p>
[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。(可选)
</p>
<p>
创建一个新的 [name] 实例。
Expand Down Expand Up @@ -97,53 +97,51 @@ <h3>hoveroff</h3>

<h2>属性</h2>

<h3>[property:Boolean enabled]</h3>
<p>
是否启用控制器。
</p>
<p>共有属性请参见其基类[page:Controls]。</p>

<h3>[property:Boolean transformGroup]</h3>
<h3>[property:Array objects]</h3>
<p>
当[page:DragControls.objects]数组包含一个单个可拖拽的组对象时该选项生效。如果设置为`true`，[name]会转换整个组对象，而不对单个对象做转换。默认值为`false`。
可拖放对象的数组。
</p>

<h3>[property:String mode]</h3>
<h3>[property:Raycaster raycaster]</h3>
<p>
The current transformation mode. Possible values are `translate`, and `rotate`. Default is `translate`.
内部用于检测拾取对象的光线投射器。
</p>

<h2>方法</h2>

<p>共有方法请参见其基类[page:EventDispatcher]。</p>

<h3>[method:undefined activate] ()</h3>
<h3>[property:Boolean recursive]</h3>
<p>
添加控制器的事件监听。
可拖放对象的子对象是否可以独立于其父对象进行拖放。 默认值为 `true`。
</p>

<h3>[method:undefined deactivate] ()</h3>
<h3>[property:Float rotateSpeed]</h3>
<p>
移除控制器的事件监听。
执行 `rotate` 时的旋转速度。该值越大旋转速度越快。 默认值为 `1`。
</p>

<h3>[method:undefined dispose] ()</h3>
<h3>[property:Boolean transformGroup]</h3>
<p>
若不再需要该控制器，则应当调用此函数。
当 [page:DragControls.objects] 数组包含一个单个可拖拽的组对象时该选项生效。
如果设置为`true`，[name]会转换整个组对象，而不对单个对象做转换。默认值为`false`。
</p>

<h3>[method:Array getObjects] ()</h3>
<h2>方法</h2>

<p>共有方法请参见其基类[page:Controls]。</p>

<h3>[method:undefined connect] ()</h3>
<p>
返回可拖拽的对象数组。
添加控制器的事件监听。
</p>

<h3>[method:Raycaster getRaycaster] ()</h3>
<h3>[method:undefined disconnect] ()</h3>
<p>
返回用于相交测试的内部[page:Raycaster]实例。
移除控制器的事件监听。
</p>

<h3>[method:undefined setObjects] ( [param:Array objects] )</h3>
<h3>[method:undefined dispose] ()</h3>
<p>
Sets an array of draggable objects by overwriting the existing one.
若不再需要该控制器，则应当调用此函数。
</p>

<h2>源代码</h2>
Expand Down
Loading

0 comments on commit 4f067f0

Please sign in to comment.