Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Doc/zh]: Improve Chinese translation related to Controls. #29107

Merged
merged 7 commits into from
Aug 12, 2024
Merged

[Doc/zh]: Improve Chinese translation related to Controls. #29107

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
8513689
[Docs/zh]: Improve DragControls Chinese translation.
puxiao Aug 10, 2024
72cf6ae
add zh Controls.html
puxiao Aug 10, 2024
9151614
update zh PointerLockControls.html
puxiao Aug 10, 2024
b202953
update zh PointerLockControls.html
puxiao Aug 10, 2024
79531e5
update zh FlyControls
puxiao Aug 10, 2024
ffa88b8
update zh FirstPersonControls
puxiao Aug 10, 2024
c18d1a7
update zh ArcballControls
puxiao Aug 11, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 7 additions & 25 deletions docs/examples/zh/controls/ArcballControls.html
View file
Open in desktop
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
Open in desktop
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
Open in desktop
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