> For the complete documentation index, see [llms.txt](https://docs.febucci.com/text-animator-unity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.febucci.com/text-animator-unity/2.x-ko/undefined-1/undefined.md).

# 텍스트에 효과 추가

## 카테고리 개요 <a href="#effects-categories" id="effects-categories"></a>

효과는 기능/적용 방식에 따라 세 가지 카테고리로 나뉩니다. 구성은 다음과 같습니다:

<table data-view="cards"><thead><tr><th align="center"></th><th></th><th></th></tr></thead><tbody><tr><td align="center"><strong>행동 효과</strong> </td><td><img src="/files/4743e07ae2c1a7d617867eb29d82d9e6ec393a24" alt="An example of the Behavior Effect <wiggle>" data-size="original"></td><td>행동 효과는 글자가 보이는 동안 지속적으로 글자를 애니메이션합니다.</td></tr><tr><td align="center"><strong>표시 효과</strong>   </td><td><img src="/files/f11985657f60762974f27adc5a1c07e86e96d135" alt="An example of the Appearance Effect {vertexp}" data-size="original"></td><td>표시 효과는 글자가 화면에 나타날 때만 글자를 애니메이션합니다. 이런 이유로 보통 글자를 하나씩 보여주는 타이프라이터와 함께 사용됩니다.</td></tr><tr><td align="center"><strong>사라짐 효과</strong> </td><td><img src="/files/0e5ab295e97c3087ba1f0248817af89fc34ccf9b" alt="An example of the Disappearance Effect {#size}" data-size="original"></td><td>사라짐 효과는 글자가 보이지 않게 되었을 때 글자를 애니메이션하며, 내부적으로는 단순히 표시 효과를 반대로 적용한 것입니다.</td></tr></tbody></table>

{% hint style="info" %}
내장된 효과 목록은 여기에서 확인할 수 있습니다: [내장 효과 목록](/text-animator-unity/2.x-ko/undefined-1/undefined-2.md)
{% endhint %}

***

## 효과 적용 방법 <a href="#how-to-apply-effects" id="how-to-apply-effects"></a>

텍스트에 다양한 효과를 적용하는 주요 방법은 두 가지가 있습니다:

* [#set-default-effects-to-the-entire-text](#set-default-effects-to-the-entire-text "mention") (인스펙터)
* [#set-effects-to-specific-parts-of-the-text](#set-effects-to-specific-parts-of-the-text "mention") (리치 텍스트 태그)

### 텍스트 전체에 기본 효과 설정 <a href="#set-default-effects-to-the-entire-text" id="set-default-effects-to-the-entire-text"></a>

TextAnimator 컴포넌트에서 모든 글자에 기본적으로 적용될 효과를 설정할 수 있습니다, **모든 텍스트에 대해 효과 태그를 일일이 작성할 필요 없이**.

1. TextAnimator 컴포넌트로 이동하여 “Default Tags” 섹션을 확인하세요

   <img src="/files/100dd7ae562e05939ff7cea5b828f9b98c99868a" alt="텍스트 애니메이터 기본 태그 개요" width="600">
2. 편집하려는 효과의 카테고리를 확장하세요
3. 포함하려는 효과 태그를 추가하세요, 예시:

{% hint style="info" %}
&#x20;기본적으로 어떤 효과도 적용하지 않으려면, 단순히 효과 수를 0으로 설정하세요.
{% endhint %}

{% hint style="success" %}
다음도 변경할 수 있습니다 "**기본 태그 모드**" 를 "**항상**" 로 설정하면 효과가 모든 상황에서 항상 적용되도록 할 수 있습니다.
{% endhint %}

{% hint style="success" %}
각 배열 요소에 "shake a=5"와 같은 수정자를 추가할 수 있습니다. 자세한 내용은 여기에서 확인하세요: [수정자(Modifiers)](/text-animator-unity/2.x-ko/undefined-1/undefined/modifiers.md)
{% endhint %}

### 텍스트의 특정 부분에 효과 설정 <a href="#set-effects-to-specific-parts-of-the-text" id="set-effects-to-specific-parts-of-the-text"></a>

리치 텍스트 태그를 사용하여 텍스트의 특정 부분에 기본 태그(있는 경우 “Fallback”)를 재정의하여 효과를 적용할 수 있습니다.

효과 태그는 다음과 같이 보입니다:

* **동작(Behaviors)**: `<tag>` 열려면, `</tag>` 닫으려면
* **표시(appearance)**: `{tag}` 열려면, `{/tag}` 닫으려면
* **사라짐(disappearance)**: `{#tag}` 열려면, `{/#tag}` 닫으려면\
  \&#xNAN;*(기본적으로 앞에 `#` 가 붙은 표시 태그로, 사라짐이 사실은 표시의 반대임을 상기시키기 위한 것입니다)*.

{% hint style="info" %}
효과 태그를 닫으면(기본적으로 설정된 “Fallback”이 있으면) 글자들은 다시 기본 효과의 영향을 받게 됩니다.
{% endhint %}

{% hint style="danger" %}
주의: TMPro 오른쪽 텍스트 태그 형식을 사용하지 마세요!
{% endhint %}

<details>

<summary>예시 1: 간단한 효과</summary>

예시: “`나 추워`” 는 다음과 같이 작성할 수 있습니다 “`I'm <shake>cold</shake>`” (텍스트 컴포넌트에서) 특정 단어 “cold”에 *떨리는* 행동 효과를 적용하기 위해서입니다.

<img src="/files/286944d6b307a25ea9b0b9eaadd7f2fd37419f9c" alt="Untitled" data-size="original">

</details>

<details>

<summary>예시 2: 폴백(Fallback)</summary>

기본 효과(“size”)가 하나 있지만 텍스트의 특정 부분에 “fade” 효과를 적용하고 싶다고 가정해 보겠습니다.\
다음과 같이 작성하면 원하는 결과를 얻을 수 있습니다: "default default \`{fade}\` fade fade fade \`{/fade}\` default default"

![](/files/6dfb0900df3b31cc167f113fd2f7ece3bdc6237c)

보시다시피 "fade" 태그 외부에 있는 글자들은 기본 효과가 적용되고, "{fade}"와 "{/fade}" 내부의 부분은 오직 "fade"만 갖게 됩니다.

</details>

***

### 리치 텍스트 형식에 대한 추가 메모 <a href="#extra-notes-about-rich-text-formatting" id="extra-notes-about-rich-text-formatting"></a>

TextAnimator for Unity를 사용할 때:

* 여러 효과를 겹쳐서 사용할 수 있습니다(예: “`<shake><size>`”).\
  (또한 다음도 확인하세요 [스타일](/text-animator-unity/2.x-ko/undefined-1/undefined/undefined.md))
* 다음으로 닫을 수 있습니다 **모든** 현재 열려 있는 효과를 단일 ‘`/`’ 문자로 닫을 수 있습니다. 예:
  * ”`</>`” 행동 효과의 경우
  * ”`{/}`” 표시 효과의 경우
  * ”`{/#}`” 사라짐 효과의 경우.
* 텍스트 끝에 있는 경우 태그를 닫을 필요가 없습니다. Text Animator는 태그를 여는 순간부터 효과를 적용하기 시작합니다. (예: "`<shake>hello`" 는 이미 hello가 애니메이트되는 결과를 낳습니다).