> 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가 애니메이트되는 결과를 낳습니다).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.febucci.com/text-animator-unity/2.x-ko/undefined-1/undefined.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.