Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
36 changes: 35 additions & 1 deletion src/script-reference/commands/changeFigure.md
Original file line number Diff line number Diff line change
Expand Up @@ -214,7 +214,7 @@ changeFigure:1/open_eyes.png -eyesOpen=1/open_eyes.png;
### eyesClose
- 字符串

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

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

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

这里似乎有一个拼写错误,正方形向 应该为 正方向

Suggested change
x 轴以向右为正方形向,y 轴以向下为正方向。
x 轴以向右为正方向,y 轴以向下为正方向。


::: warning
此参数仅在立绘出场,或替换立绘时生效。
Expand All @@ -254,3 +255,36 @@ changeFigure:character_a/model.json -expression=sad;
; 往左和往右拓展 300 像素
changeFigure:character_a/model.json -bounds=-300,0,300,0;
```

### blink
- 字符串

对于 Live2D 立绘,填写 json 字符串,控制眨眼参数。
通常不需要书写所有的属性, 没填写的属性会继承上一次设置的值, 立绘出场时会继承默认值。

参数有
- `"blinkInterval"`: 数字,眨眼间隔,单位毫秒,默认值 24 小时

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

blinkInterval 的单位是毫秒,但默认值写的是 “24 小时”,这可能会让使用者困惑。建议将默认值也用毫秒单位表示,即 86400000,以保持单位一致性。

Suggested change
- `"blinkInterval"`: 数字,眨眼间隔,单位毫秒,默认值 24 小时
- `"blinkInterval"`: 数字,眨眼间隔,单位毫秒,默认值 86400000

- `"blinkIntervalRandom"`: 数字,眨眼间隔随机值,单位毫秒,默认值 1000
- `"closingDuration"`: 数字,闭眼持续时间,单位毫秒,默认值 100
- `"closedDuration"`: 数字,闭眼时间,单位毫秒,默认值 50
- `"openingDuration"`: 数字,睁眼持续时间,单位毫秒,默认值 150

```webgal
changeFigure:character_a/model.json -blink={"blinkInterval":5000,"blinkIntervalRandom":2000,"closingDuration":100,"closedDuration":50,"openingDuration":150};
```

### focus
- 字符串

对于 Live2D 立绘,填写 json 字符串,控制立绘的注视参数。
通常不需要书写所有的属性, 没填写的属性会继承上一次设置的值, 立绘出场时会继承默认值。
x 轴以向右为正方形向,y 轴以向上为正方向。

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

这行文档存在两个潜在问题:

  1. 正方形向 疑似拼写错误,应为 正方向
  2. y 轴的正方向定义为向上,与 bounds 参数中 y 轴向下为正方向的定义(第 247-248 行)相矛盾。这种不一致性可能会导致用户混淆。请确认 focus 参数的坐标系定义是否正确。如果定义无误,建议在文档中特别强调与 bounds 的区别,并修正拼写错误。
Suggested change
x 轴以向右为正方形向,y 轴以向上为正方向。
x 轴以向右为正方向,y 轴以向上为正方向。


参数有
- `"x"`: 数字,注视点的 x 坐标,范围 -1 到 1,默认值 0
- `"y"`: 数字,注视点的 y 坐标,范围 -1 到 1,默认值 0
- `"instant"`: 布尔值,是否立即转向注视点,默认值 false

```webgal
changeFigure:character_a/model.json -focus={"x":0.5,"y":0.2,"instant":false};
```
4 changes: 2 additions & 2 deletions src/script-reference/commands/setTransform.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,10 +41,10 @@ setTransform:{"brightness":0.5} -target=aaa -duration=500 -writeDefault;
<!-- @include: ../arguments/keep.md -->
```webgal
; 假设这是一个特别长的动画
setTransform:{"scale":{"x":2,"y":2}} -target=aaa -duration=10000;
setTransform:{"scale":{"x":2,"y":2}} -target=aaa -duration=10000 -keep;
角色A: 第一句话;
角色A: 第二句话;
角色A: 第三句话;
; 这会打断 aaa 的跨语句动画,并播放新动画
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000;
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000 -keep;
Comment on lines +44 to +49

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

根据 keep 参数的文档(keep.md),它 通常需要配合 next 参数一起使用。为了让示例更清晰地展示其非阻塞特性,并与 setTempAnimation 的示例保持一致,建议在示例中也加入 -next 参数。

Suggested change
setTransform:{"scale":{"x":2,"y":2}} -target=aaa -duration=10000 -keep;
角色A: 第一句话;
角色A: 第二句话;
角色A: 第三句话;
; 这会打断 aaa 的跨语句动画,并播放新动画
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000;
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000 -keep;
setTransform:{"scale":{"x":2,"y":2}} -target=aaa -duration=10000 -keep -next;
角色A: 第一句话;
角色A: 第二句话;
角色A: 第三句话;
; 这会打断 aaa 的跨语句动画,并播放新动画
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000 -keep -next;

```