Skip to content

Commit da11820

Browse files
Merge pull request #73 from HardyNLee/feat-command-argument
docs: update argument
2 parents c6718e8 + 9dbd3c9 commit da11820

2 files changed

Lines changed: 37 additions & 3 deletions

File tree

src/script-reference/commands/changeFigure.md

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -214,7 +214,7 @@ changeFigure:1/open_eyes.png -eyesOpen=1/open_eyes.png;
214214
### eyesClose
215215
- 字符串
216216

217-
填写图片立绘的路径,作为睁眼时的立绘差分
217+
填写图片立绘的路径,作为闭眼时的立绘差分
218218

219219
```webgal
220220
changeFigure:1/open_eyes.png -eyesClose=1/closed_eyes.png;
@@ -245,6 +245,7 @@ changeFigure:character_a/model.json -expression=sad;
245245

246246
对于 Live2D 立绘,填写 number[4] 数组,拓展或收缩立绘的显示区域。
247247
以向右和向下为正方向,顺序为 `左,上,右,下`
248+
x 轴以向右为正方形向,y 轴以向下为正方向。
248249

249250
::: warning
250251
此参数仅在立绘出场,或替换立绘时生效。
@@ -254,3 +255,36 @@ changeFigure:character_a/model.json -expression=sad;
254255
; 往左和往右拓展 300 像素
255256
changeFigure:character_a/model.json -bounds=-300,0,300,0;
256257
```
258+
259+
### blink
260+
- 字符串
261+
262+
对于 Live2D 立绘,填写 json 字符串,控制眨眼参数。
263+
通常不需要书写所有的属性, 没填写的属性会继承上一次设置的值, 立绘出场时会继承默认值。
264+
265+
参数有
266+
- `"blinkInterval"`: 数字,眨眼间隔,单位毫秒,默认值 24 小时
267+
- `"blinkIntervalRandom"`: 数字,眨眼间隔随机值,单位毫秒,默认值 1000
268+
- `"closingDuration"`: 数字,闭眼持续时间,单位毫秒,默认值 100
269+
- `"closedDuration"`: 数字,闭眼时间,单位毫秒,默认值 50
270+
- `"openingDuration"`: 数字,睁眼持续时间,单位毫秒,默认值 150
271+
272+
```webgal
273+
changeFigure:character_a/model.json -blink={"blinkInterval":5000,"blinkIntervalRandom":2000,"closingDuration":100,"closedDuration":50,"openingDuration":150};
274+
```
275+
276+
### focus
277+
- 字符串
278+
279+
对于 Live2D 立绘,填写 json 字符串,控制立绘的注视参数。
280+
通常不需要书写所有的属性, 没填写的属性会继承上一次设置的值, 立绘出场时会继承默认值。
281+
x 轴以向右为正方形向,y 轴以向上为正方向。
282+
283+
参数有
284+
- `"x"`: 数字,注视点的 x 坐标,范围 -1 到 1,默认值 0
285+
- `"y"`: 数字,注视点的 y 坐标,范围 -1 到 1,默认值 0
286+
- `"instant"`: 布尔值,是否立即转向注视点,默认值 false
287+
288+
```webgal
289+
changeFigure:character_a/model.json -focus={"x":0.5,"y":0.2,"instant":false};
290+
```

src/script-reference/commands/setTransform.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,10 +41,10 @@ setTransform:{"brightness":0.5} -target=aaa -duration=500 -writeDefault;
4141
<!-- @include: ../arguments/keep.md -->
4242
```webgal
4343
; 假设这是一个特别长的动画
44-
setTransform:{"scale":{"x":2,"y":2}} -target=aaa -duration=10000;
44+
setTransform:{"scale":{"x":2,"y":2}} -target=aaa -duration=10000 -keep;
4545
角色A: 第一句话;
4646
角色A: 第二句话;
4747
角色A: 第三句话;
4848
; 这会打断 aaa 的跨语句动画,并播放新动画
49-
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000;
49+
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000 -keep;
5050
```

0 commit comments

Comments
 (0)