Skip to content

Commit e7d6b51

Browse files
mrdoobmrdoob
authored
Merge pull request #17818 from gogoend/zh_doc
zh doc: sync with en doc, some fixes and translation.
2 parents 5d6777a + c3a5235 commit e7d6b51

File tree

76 files changed

+508
-447
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

76 files changed

+508
-447
lines changed

‎docs/api/zh/animation/AnimationAction.html‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,8 @@ <h3>[property:Boolean enabled]</h3>
5454
(将 *enabled* 置为 *false* 不会重置此次动作) <br /><br />
5555

5656
说明: 将*enabled*置为*true*不会让动画自动重新开始。只有满足以下条件时才会马上重新开始:
57-
暂停（[page:.paused paused]）值为*false*, 同时动作没有失效 (执行停止([page:.stop stop])命令或重置([page:.reset reset])命令，
58-
且权重([page:.weight weight])和时间比例([page:.timeScale timeScale])都不能为0
57+
暂停（[page:.paused paused]）值为*false*, 同时动作没有失效 (执行停止([page:.stop stop])命令或重置([page:.reset reset])命令，
58+
且权重([page:.weight weight])和时间比例([page:.timeScale timeScale])都不能为0
5959

6060
</p>
6161

@@ -64,7 +64,7 @@ <h3>[property:Number loop]</h3>
6464
循环模式 (可以通过[page:.setLoop setLoop]改变)。默认值是
6565
[page:Animation THREE.LoopRepeat] (重复[page:.repetitions repetitions]次数无穷)<br /><br />
6666

67-
必须是以下值之一：<br /><br />
67+
必须是以下值之一：<br /><br />
6868
[page:Animation THREE.LoopOnce] - 只执行一次 <br />
6969
[page:Animation THREE.LoopRepeat] - 重复次数为*repetitions*的值, 且每次循环结束时候将回到起始动作开始下一次循环。 <br />
7070
[page:Animation THREE.LoopPingPong] - 重复次数为*repetitions*的值, 且像乒乓球一样在起始点与结束点之间来回循环。
@@ -120,12 +120,12 @@ <h3>[property:Number weight]</h3>
120120

121121
<h3>[property:Boolean zeroSlopeAtEnd]</h3>
122122
<p>
123-
启用平滑插值，无须单独剪辑开始、循环和结束。默认值是*true*
123+
启用平滑插值，无须单独剪辑开始、循环和结束。默认值是*true*
124124
</p>
125125

126126
<h3>[property:Boolean zeroSlopeAtStart]</h3>
127127
<p>
128-
启用平滑插值，无须单独剪辑开始、循环和结束。默认值是*true*
128+
启用平滑插值，无须单独剪辑开始、循环和结束。默认值是*true*
129129
</p>
130130

131131

@@ -144,20 +144,20 @@ <h3>[method:AnimationAction crossFadeFrom]( [param:AnimationAction fadeOutAction
144144

145145
<h3>[method:AnimationAction crossFadeTo]( [param:AnimationAction fadeInAction], [param:Number durationInSeconds], [param:Boolean warpBoolean] )</h3>
146146
<p>
147-
在传入的时间段内, 让此动作淡出（[page:.fadeOut fade out]），同时让另一个动作淡入。此方法可链式调用。<br /><br />
147+
在传入的时间段内, 让此动作淡出（[page:.fadeOut fade out]），同时让另一个动作淡入。此方法可链式调用。<br /><br />
148148
如果warpBoolean值是true, 额外的 [page:.warp warping] (时间比例的渐变)将会被应用。<br /><br />
149149

150150
说明: 与 *fadeIn*/*fadeOut*一样, 淡入淡出动作开始/结束时的权重是1.
151151
</p>
152152

153153
<h3>[method:AnimationAction fadeIn]( [param:Number durationInSeconds] )</h3>
154154
<p>
155-
在传入的时间间隔内，逐渐将此动作的权重（[page:.weight weight]）由0升到1。此方法可链式调用。
155+
在传入的时间间隔内，逐渐将此动作的权重（[page:.weight weight]）由0升到1。此方法可链式调用。
156156
</p>
157157

158158
<h3>[method:AnimationAction fadeOut]( [param:Number durationInSeconds] )</h3>
159159
<p>
160-
在传入的时间间隔内，逐渐将此动作的权重（[page:.weight weight]）由1降至0。此方法可链式调用。
160+
在传入的时间间隔内，逐渐将此动作的权重（[page:.weight weight]）由1降至0。此方法可链式调用。
161161
</p>
162162

163163
<h3>[method:Number getEffectiveTimeScale]()</h3>
@@ -177,7 +177,7 @@ <h3>[method:AnimationClip getClip]()</h3>
177177

178178
<h3>[method:AnimationMixer getMixer]()</h3>
179179
<p>
180-
返回负责完成此动作的混合器
180+
返回负责完成此动作的混合器
181181
</p>
182182

183183
<h3>[method:Object3D getRoot]()</h3>
@@ -224,7 +224,7 @@ <h3>[method:AnimationAction reset]()</h3>
224224
[page:.time time]设为0, 中断任何预定的淡入淡出和变形, 以及移除内部循环次数以及延迟启动。<br /><br />
225225

226226
说明: 停止方法[page:.stop stop]内调用了重置方法（reset）, 但是 .*reset*不会调用 .*stop*。
227-
这就表示: 如果你想要这两者, 重置并且停止, 不要调用*reset*; 而应该调用*stop*。
227+
这就表示: 如果你想要这两者, 重置并且停止, 不要调用*reset*; 而应该调用*stop*。
228228
</p>
229229

230230
<h3>[method:AnimationAction setDuration]( [param:Number durationInSeconds] )</h3>
@@ -295,7 +295,7 @@ <h3>[method:AnimationAction syncWith]( [param:AnimationAction otherAction] )</h3
295295

296296
<h3>[method:AnimationAction warp]( [param:Number startTimeScale], [param:Number endTimeScale], [param:Number durationInSeconds] )</h3>
297297
<p>
298-
在传入的事件间隔内，通过逐渐将时间比例[page:.timeScale timeScale]由*startTimeScale*修改至*endTimeScale*来改变回放速度。该方法可被链式调用。
298+
在传入的事件间隔内，通过逐渐将时间比例[page:.timeScale timeScale]由*startTimeScale*修改至*endTimeScale*来改变回放速度。该方法可被链式调用。
299299
</p>
300300

301301

‎docs/api/zh/animation/AnimationClip.html‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ <h3>[property:String name]</h3>
4949

5050
<h3>[property:Array tracks]</h3>
5151
<p>
52-
一个包含该剪辑中有动画的所有属性的关键帧轨道（[page:KeyframeTrack]）的数组。
52+
一个包含该剪辑中有动画的所有属性的关键帧轨道（[page:KeyframeTrack]）的数组。
5353
</p>
5454

5555
<h3>[property:String uuid]</h3>
@@ -67,14 +67,12 @@ <h3>[method:AnimationClip clone]()</h3>
6767

6868
<h3>[method:this optimize]()</h3>
6969
<p>
70-
通过移除等效的顺序键（在变形目标序列中很常见）来优化每一个轨道
71-
70+
通过移除等效的顺序键（在变形目标序列中很常见）来优化每一个轨道
7271
</p>
7372

7473
<h3>[method:this resetDuration]()</h3>
7574
<p>
7675
将剪辑的持续时间（[page:.duration duration]）设为最长的关键帧轨道([page:KeyframeTrack])的持续时间。
77-
.
7876
</p>
7977

8078
<h3>[method:this trim]()</h3>
@@ -84,7 +82,7 @@ <h3>[method:this trim]()</h3>
8482

8583
<h3>[method:Boolean validate]()</h3>
8684
<p>
87-
对剪辑中的每个轨道执行最小验证。如果所有轨道都有效，返回true。
85+
对剪辑中的每个轨道执行最小验证。如果所有轨道都有效，返回true。
8886
</p>
8987

9088

@@ -99,7 +97,7 @@ <h3>[method:Array CreateClipsFromMorphTargetSequences]( [param:String name], [pa
9997

10098
<h3>[method:AnimationClip CreateFromMorphTargetSequence]( [param:String name], [param:Array morphTargetSequence], [param:Number fps], [param:Boolean noLoop] )</h3>
10199
<p>
102-
返回一个由几何体变形目标数组([page:Geometry.morphTargets morph targets array])得到的新动画剪辑，接收名称和帧率参数。<br /><br />
100+
返回一个由几何体变形目标数组([page:Geometry.morphTargets morph targets array])得到的新动画剪辑，接收名称和帧率参数。<br /><br />
103101

104102
说明: 帧率是必须参数, 但是动画速度可能会在*AnimationAction*中被[page:AnimationAction.setDuration animationAction.setDuration]方法重写。
105103

@@ -117,7 +115,7 @@ <h3>[method:AnimationClip parse]( [param:Object json] )</h3>
117115

118116
<h3>[method:AnimationClip parseAnimation]( [param:Object animation], [param:Array bones] )</h3>
119117
<p>
120-
解析动画层级格式并返回动画剪辑。
118+
解析动画层级格式并返回动画剪辑。
121119
</p>
122120

123121
<h3>[method:Object toJSON]( [param:AnimationClip clip] )</h3>

‎docs/api/zh/animation/AnimationMixer.html‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
<h1>[name]</h1>
1212

1313
<p class="desc">
14-
动画混合器是用于场景中特定对象的动画的播放器。当场景中的多个对象独立动画时，每个对象都可以使用同一个动画混合器。<br /><br />
14+
动画混合器是用于场景中特定对象的动画的播放器。当场景中的多个对象独立动画时，每个对象都可以使用同一个动画混合器。<br /><br />
1515

1616
在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述
1717
</p>
@@ -41,6 +41,13 @@ <h3>[property:Number timeScale]</h3>
4141
说明: 将混合器的时间比例设为0, 稍后再设置为1，可以暂停/取消暂停由该混合器控制的所有动作。
4242
</p>
4343

44+
<h3>[method:AnimationMixer setTime]([param:Number timeInSeconds]) </h3>
45+
<p>
46+
设置全局混合器到一个给定的时间，并相应地更新动画。<br /><br />
47+
48+
当你需要在一个动画里跳转到一个精确的时间，该函数将是十分有用的。输入的参数将会被混合器的[page:.timeScale timeScale]进行缩放。
49+
</p>
50+
4451

4552
<h2>方法</h2>
4653

‎docs/api/zh/animation/AnimationObjectGroup.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,10 @@ <h1>[name]</h1>
1818
<h2>用法:</h2>
1919

2020
<p class="desc">
21-
将本来要作为根对象传入构造器或者动画混合器([page:AnimationMixer AnimationMixer])的[page:AnimationMixer.clipAction clipAction]方法中的对象加入组中，并将这个组对象作为根对象传递。
21+
将本来要作为根对象传入构造器或者动画混合器([page:AnimationMixer AnimationMixer])的[page:AnimationMixer.clipAction clipAction]方法中的对象加入组中，并将这个组对象作为根对象传递。
2222
<br /><br />
2323

24-
注意，这个类的实例作为混合器中的一个对象，因此，必须对组内的单个对象做缓存控制。
24+
注意，这个类的实例作为混合器中的一个对象，因此，必须对组内的单个对象做缓存控制。
2525
</p>
2626

2727

‎docs/api/zh/animation/AnimationUtils.html‎

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
<h1>[name]</h1>
1212

1313
<p class="desc">
14-
一个提供各种动画辅助方法的对象，内部使用。
14+
一个提供各种动画辅助方法的对象，内部使用。
1515
</p>
1616

1717

@@ -25,25 +25,25 @@ <h3>[method:Array arraySlice]( array, from, to )</h3>
2525

2626
<h3>[method:Array convertArray]( array, type, forceClone )</h3>
2727
<p>
28-
将数组转换为某种特定类型。
28+
将数组转换为某种特定类型。
2929
</p>
3030

3131
<h3>[method:Array flattenJSON]( jsonKeys, times, values, valuePropertyName )</h3>
3232
<p>
33-
用于解析AOS关键帧格式。
33+
用于解析AOS关键帧格式。
3434
</p>
3535

3636
<h3>[method:Array getKeyframeOrder]( times )</h3>
3737
<p>
38-
返回一个数组，时间和值可以根据此数组排序。
38+
返回一个数组，时间和值可以根据此数组排序。
3939
</p>
4040

4141
<h3>[method:Number insertKeyframe]( [param:KeyframeTrack track], [param:Number time] )</h3>
4242
<p></p>
4343

4444
<h3>[method:Boolean isTypedArray]( object )</h3>
4545
<p>
46-
如果该对象是类型化数组，返回*true*
46+
如果该对象是类型化数组，返回*true*
4747

4848
</p>
4949

@@ -52,10 +52,13 @@ <h3>[method:AnimationClip mergeMorphTargetTracks]( [param:AnimationClip clip], [
5252

5353
<h3>[method:Array sortedArray]( values, stride, order )</h3>
5454
<p>
55-
将[page:AnimationUtils.getKeyframeOrder getKeyframeOrder]方法返回的数组排序。
56-
55+
将[page:AnimationUtils.getKeyframeOrder getKeyframeOrder]方法返回的数组排序。
5756
</p>
5857

58+
<h3>[method:AnimationClip subclip]( [param:AnimationClip clip], [param:String name], [param:Number startFrame], [param:Number endFrame], [param:Number fps] )</h3>
59+
<p>
60+
创建一个新的片段，仅包含所给定帧之间的原始剪辑片段。
61+
</p>
5962

6063
<h2>源码</h2>
6164

‎docs/api/zh/animation/KeyframeTrack.html‎

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -17,26 +17,26 @@ <h1>[name]</h1>
1717
</p>
1818

1919
<p>
20-
在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述
20+
在使用手册的“下一步”章节中，“动画系统”一文对three.js动画系统中的不同元素作出了概述
2121
</p>
2222

2323
<p>
24-
和[link:https://github.com/mrdoob/three.js/wiki/JSON-Model-format-3 JSON model format]的动画层级相反，
25-
关键帧轨道（KeyframeTrack）不会将单帧作为对象存储在“key”数组(一个存有每一帧的时间和值的地方)中。
24+
和[link:https://github.com/mrdoob/three.js/wiki/JSON-Model-format-3 JSON model format]的动画层级相反，
25+
关键帧轨道（KeyframeTrack）不会将单帧作为对象存储在“key”数组(一个存有每一帧的时间和值的地方)中。
2626

2727
</p>
2828

2929
<p>
30-
关键帧轨道(KeyframeTrack)中总是存在两个数组：[page:.times times]数组按顺序存储该轨道的所有关键帧的时间值，而[page:.values values]数组包含动画属性的相应更改值。
30+
关键帧轨道(KeyframeTrack)中总是存在两个数组：[page:.times times]数组按顺序存储该轨道的所有关键帧的时间值，而[page:.values values]数组包含动画属性的相应更改值。
3131
</p>
3232

3333
<p>
34-
值数组中的每一个成员，属于某一特定时间点，不仅可以是一个简单的数字，还可以是（比如）一个向量（如果是位置动画）或者是一个四元数（如果是旋转动画）。
35-
因此，值数组（也是一个平面阵列）的长度可能是时间数组的三四倍。
34+
值数组中的每一个成员，属于某一特定时间点，不仅可以是一个简单的数字，还可以是（比如）一个向量（如果是位置动画）或者是一个四元数（如果是旋转动画）。
35+
因此，值数组（也是一个平面阵列）的长度可能是时间数组的三四倍。
3636
</p>
3737

3838
<p>
39-
与不同类型的动画值对应，存在若干关键帧轨道(KeyframeTrack)的子类，继承了它大多数属性和方法：
39+
与不同类型的动画值对应，存在若干关键帧轨道(KeyframeTrack)的子类，继承了它大多数属性和方法：
4040
</p>
4141

4242
<ul>
@@ -49,15 +49,15 @@ <h1>[name]</h1>
4949
</ul>
5050

5151
<p>
52-
可以在[link:https://threejs.org/examples/js/animation/AnimationClipCreator.js AnimationClipCreator]文件中找到用不同类型的关键帧轨道创建动画剪辑([page:AnimationClip AnimationClips])的示例。
52+
可以在[link:https://threejs.org/examples/js/animation/AnimationClipCreator.js AnimationClipCreator]文件中找到用不同类型的关键帧轨道创建动画剪辑([page:AnimationClip AnimationClips])的示例。
5353
</p>
5454

5555
<p>
56-
由于显式值仅针对存储在时间数组中的离散时间点指定，因此必须在两个时间点之间进行插值
56+
由于显式值仅针对存储在时间数组中的离散时间点指定，因此必须在两个时间点之间进行插值
5757
</p>
5858

5959
<p>
60-
轨道的名称对于这个轨道与动画节点的特定属性的连接(由[page:PropertyBinding]完成)很重要。
60+
轨道的名称对于这个轨道与动画节点的特定属性的连接(由[page:PropertyBinding]完成)很重要。
6161
</p>
6262

6363

@@ -81,11 +81,11 @@ <h2>属性</h2>
8181

8282
<h3>[property:String name]</h3>
8383
<p>
84-
轨道的名称可以指动画对象中的变形目标([page:Geometry.morphTargets morph targets])、骨骼([page:SkinnedMesh bones])或可能的其他值
84+
轨道的名称可以指动画对象中的变形目标([page:Geometry.morphTargets morph targets])、骨骼([page:SkinnedMesh bones])或可能的其他值
8585
查看[page:PropertyBinding.parseTrackName]可获知哪些形式的字符串可以解析出绑定的属性:
8686
</p>
8787
<p>
88-
可以使用节点名称或uuid（尽管它需要位于传递到混合器的场景图节点的子树中）引用到某节点。或者， 如果轨道名称的首字符是点,
88+
可以使用节点名称或uuid（尽管它需要位于传递到混合器的场景图节点的子树中）引用到某节点。或者， 如果轨道名称的首字符是点,
8989
该轨道会应用到传入到混合器的根节点上。
9090
</p>
9191

@@ -94,7 +94,7 @@ <h3>[property:String name]</h3>
9494
</p>
9595

9696
<p>
97-
还可以使用对象名称来指定骨骼或多材质，例如：.bones[R_hand].scale；再比如，材料数组中的第四个材料的漫反射颜色的红通道可以通过 .materials[3].diffuse[r]访问到。
97+
还可以使用对象名称来指定骨骼或多材质，例如：.bones[R_hand].scale；再比如，材料数组中的第四个材料的漫反射颜色的红通道可以通过 .materials[3].diffuse[r]访问到。
9898
</p>
9999

100100
<p>
@@ -159,30 +159,30 @@ <h3>[method:Number getValueSize]()</h3>
159159

160160
<h3>[method:DiscreteInterpolant InterpolantFactoryMethodDiscrete]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
161161
<p>
162-
根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的离散插值([page:DiscreteInterpolant DiscreteInterpolant])。
163-
可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
162+
根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的离散插值([page:DiscreteInterpolant DiscreteInterpolant])。
163+
可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
164164
</p>
165165

166166
<h3>[method:null InterpolantFactoryMethodLinear]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
167167
<p>
168-
根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的线性插值([page:LinearInterpolant LinearInterpolant])。
169-
可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
168+
根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的线性插值([page:LinearInterpolant LinearInterpolant])。
169+
可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
170170
</p>
171171

172172
<h3>[method:null InterpolantFactoryMethodSmooth]( [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array result] )</h3>
173173
<p>
174-
根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的立方插值([page:CubicInterpolant CubicInterpolant])。
175-
可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
174+
根据时间([page:KeyframeTrack.times times])和值([page:KeyframeTrack.times values])创建一个新的立方插值([page:CubicInterpolant CubicInterpolant])。
175+
可传入一个Float32Array类型的变量来接收结果， 否则会自动创建一个长度适宜的新数组。
176176
</p>
177177

178178
<h3>[method:this optimize]()</h3>
179179
<p>
180-
删除等效的顺序键，这些键在变形目标序列中很常见。
180+
删除等效的顺序键，这些键在变形目标序列中很常见。
181181
</p>
182182

183183
<h3>[method:this scale]()</h3>
184184
<p>
185-
缩放所有关键帧的时间。<br /><br />
185+
缩放所有关键帧的时间。<br /><br />
186186

187187
说明: 这个方法很有用，例如， 可用于转化为某一特定帧率(正如[page:AnimationClip.CreateFromMorphTargetSequence animationClip.CreateFromMorphTargetSequence]内部所做的一样)。
188188
</p>
@@ -194,7 +194,7 @@ <h3>[method:this setInterpolation]( [param:Constant interpolationType] )</h3>
194194

195195
<h3>[method:this shift]( [param:Number timeOffsetInSeconds] )</h3>
196196
<p>
197-
及时删除之前或之后的所有关键帧。
197+
及时删除之前或之后的所有关键帧。
198198
</p>
199199

200200

@@ -205,7 +205,7 @@ <h3>[method:this trim]( [param:Number startTimeInSeconds], [param:Number endTime
205205

206206
<h3>[method:Boolean validate]()</h3>
207207
<p>
208-
在轨道上执行最小验证，有效则返回true
208+
在轨道上执行最小验证，有效则返回true
209209
</p>
210210

211211
<p>
@@ -217,12 +217,12 @@ <h2>静态方法</h2>
217217

218218
<h3>[method:KeyframeTrack parse]( [param:JSON json] )</h3>
219219
<p>
220-
解析JSON对象并返回一个正确类型的新关键帧轨道。
220+
解析JSON对象并返回一个正确类型的新关键帧轨道。
221221
</p>
222222

223223
<h3>[method:JSON toJSON]( [param:KeyframeTrack track] )</h3>
224224
<p>
225-
将该轨道转化为JSON
225+
将该轨道转化为JSON
226226
</p>
227227

228228

0 commit comments

Comments
 (0)