# 修饰符

<mark style="color:默认;background-color:yellow;">**修饰符**</mark> <mark style="color:默认;background-color:yellow;">**让你单独更改效果的特性**</mark>，而无需为每个变体创建新的标签或可脚本对象。

`“我曾经<wiggle>强大</wiggle>……但现在我<wiggle a*3>强大了三倍</wiggle>!!!”`

<p align="center"><img src="https://content.gitbook.com/content/XuXUTa2X5PYuYL6yRvl1/blobs/gsZWN78ej2eibo2lDykv/text-animator-modifier-example-ezgif.com-video-to-gif-converter.gif" alt="" data-size="original"></p>

{% hint style="info" %}
你可以在这里阅读每个效果可用修饰符的列表： [nei-zhi-xiao-guo-lie-biao](https://docs.febucci.com/text-animator-unity/3.x-zh/xiao-guo/nei-zhi-xiao-guo-lie-biao "mention")
{% endhint %}

***

### 数值

要修改效果 **的数值** （例如振幅或速度），请在其 **信息写在效果标签本身内部**.&#x20;

#### 乘以

格式： `<effectId`` `**`parameter*value`**`>`

<mark style="color:默认;background-color:yellow;">符号会告诉代码</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**`*`**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">将</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**乘以**</mark> <mark style="color:默认;background-color:yellow;">**一个**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">浮点参数与该值相乘</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**通过这种方式，你可以轻松知道被修改的效果相比基础效果会强/弱多少**</mark><mark style="color:默认;background-color:yellow;">.</mark> （出于这个原因，值为“1”的修饰符将返回与基础值相同的结果） *示例*.

<details>

<summary>使</summary>

* 一个“波动”效果的 `振幅` 变为三倍强： `<wave a*3>`
* 使“彩虹”效果变为两倍慢 `<rainb a*0.5>`

<figure><img src="https://1326131491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FaYNNPUoPShZQvpOqk37r%2FMultiply_Example_TAnim3.0-ezgif.com-video-to-gif-converter.gif?alt=media&#x26;token=6c9e5567-9463-4a0f-8565-f99712390eb7" alt=""><figcaption><p>将摇摆增强五倍</p></figcaption></figure>

</details>

{% hint style="info" %}
符号会告诉代码 **`*`** 符号仅适用于数字。对于字符串，请使用 **`=`**
{% endhint %}

#### 设置

格式： `<effectId`` `**`parameter=value`**`>`

<mark style="color:默认;background-color:yellow;">符号会告诉代码</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**`=`**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">将</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**来直接设置一个**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">参数</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**值**</mark><mark style="color:默认;background-color:yellow;">.</mark> 当你需要在文字区域获得精确的运动/结果，或设置字符串时特别有用。

示例：写入“\<wave a=5>”等同于在检查器中将波动振幅设置为5！（当然好处是“\<wave a=5>”修饰符只在你设置的文本区域内使用该值，关闭标签后会恢复为默认值。）

### 关键词

<mark style="color:默认;background-color:yellow;">**某些**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">效果</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**设置**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">也可以通过一个</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**单词**</mark>来修改，而无需在旁边写任何数值。&#x20;

格式： `<effectId`` `**`关键字`**`>`

示例：使用 [bo-fang](https://docs.febucci.com/text-animator-unity/3.x-zh/xiao-guo/ru-he-bian-ji-xiao-guo/bo-fang "mention")播放效果仅一次，写入 **\<wave once>**

***

### 提示与最佳实践

* 你可以在同一个效果标签上使用多个修饰符！

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FvBzBoXx71oIcJLmnyO3s%2FMultiModifiers_Example_TAnim3.0.mp4?alt=media&token=a42f7f81-29ab-4c4d-af2e-8b4969faf79b>" %}

* 在检查器中，将你的效果设置为它们的“默认状态”/中性音调。\
  这样在你撰写对话时修改参数会更容易，而无需记住每个参数的精确数值。\
  一旦你设置好了一个中性的“抖动”，在写作时就会更容易知道“\<shake a=2>”会使其变为两倍强（例如：用于让某人生气！）

另外：

* :thumbsup: 你也可以在声明“[默认/回退](https://docs.febucci.com/text-animator-unity/3.x-zh/ru-he-tian-jia-xiao-guo#set-default-effects-to-the-entire-text)”效果时使用修饰符（只需直接在检查器中写入）。
* :exclamation: 确保在修饰符ID、“=”符号及其值之间不要留空格
  * ❌ 错误： `<wiggle f = 3>`
  * ✅ 正确： `<wiggle f=3>`
* :warning: 如果在同一个富文本标签中写入相同的属性，只有最后一个会生效。

  写入“\<wiggle **`a=2`** **`a=5`**>”等同于写入“\<wiggle **`a=5`**>”，因为第一个“**`浮点参数与该值相乘`**”参数将被第二个丢弃/覆盖。