# Built-in Animations

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Tag</strong>: <code>&#x3C;bounce></code></td><td><strong>Params</strong>: <code>a</code>, <code>f</code>, <code>l</code>, <code>w</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2Fl7zN10Qi4kB77FbEt1Rh%2Fbounce.gif?alt=media&#x26;token=c6c2229d-781a-4f3b-96c4-03e35e36fff7">bounce.gif</a></td></tr><tr><td><strong>Tag</strong>: <code>&#x3C;rainbow></code></td><td><strong>Params</strong>: <code>d</code>, <code>f</code>, <code>l</code>, <code>w</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2FSlIwU7Br8coXMWxFZHPG%2Frainbow.gif?alt=media&#x26;token=d552e5bc-8167-4924-bcd9-94586070e021">rainbow.gif</a></td></tr><tr><td><strong>Tag</strong>: <code>&#x3C;rot></code></td><td><strong>Params</strong>: <code>f</code>, <code>w</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2FYPK03kNfTlSQXnyOUQdC%2Frotate.gif?alt=media&#x26;token=e198a1d6-23ec-4ae7-86fb-ae6406a6eb7b">rotate.gif</a></td></tr><tr><td><strong>Tag</strong>: <code>&#x3C;shake></code></td><td><strong>Params</strong>: <code>a</code>, <code>d</code>, <code>f</code>, <code>l</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2FGwRuBPHDmLa3ml7GFP4y%2Fshake.gif?alt=media&#x26;token=9054eb91-88af-4344-ba35-8a5b8250386d">shake.gif</a></td></tr><tr><td><strong>Tag</strong>: <code>&#x3C;size-wave></code></td><td><strong>Params</strong>: <code>a</code>, <code>d</code>, <code>f</code>, <code>l</code>, <code>w</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2F8qaBUJLErRutEIOJYYQn%2Fsize-wave.gif?alt=media&#x26;token=610eebe1-1504-49fb-a231-9a46d2c20c65">size-wave.gif</a></td></tr><tr><td><strong>Tag</strong>: <code>&#x3C;swing></code></td><td><strong>Params</strong>: <code>a</code>, <code>d</code>, <code>f</code>, <code>l</code>, <code>w</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2FmTKo3vpZnykfOuvckDGj%2Fswing.gif?alt=media&#x26;token=4ba9b38e-ea25-4d24-8dd4-bf885d3b072b">swing.gif</a></td></tr><tr><td><strong>Tag</strong>: <code>&#x3C;wave></code></td><td><strong>Params</strong>: <code>a</code>, <code>d</code>, <code>f</code>, <code>l</code>, <code>w</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2FYxu5eZ5TUJRlzIse3MUI%2Fwave.gif?alt=media&#x26;token=8576845e-32e8-498c-a15a-7f92499dae17">wave.gif</a></td></tr><tr><td><strong>Tag</strong>: <code>&#x3C;wiggle></code></td><td><strong>Params</strong>: <code>a</code>, <code>d</code>, <code>f</code>, <code>l</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2FdImhlOzBFZ31z9OUyRv5%2Fwiggle.gif?alt=media&#x26;token=69496d3d-9c22-47e0-8cd0-5cecb2924d0b">wiggle.gif</a></td></tr><tr><td><a data-mention href="custom-animations">custom-animations</a></td><td><strong>Params</strong>: <code>a</code>, <code>d</code>, <code>f</code>, <code>l</code>, <code>w</code></td><td><a href="https://101455922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsXRHzPpSiweEUfocjZwl%2Fuploads%2FlpkeKThUT9ZaxGg9qZ9w%2Fcustom.gif?alt=media&#x26;token=c4d7a2b4-6af3-4609-8469-6117e56208e6">custom.gif</a></td></tr></tbody></table>

### Parameter Types

<table><thead><tr><th width="178">Name</th><th>Description</th></tr></thead><tbody><tr><td><code>a</code></td><td><p><strong>Amplitude</strong>, the strength of an effect. A higher amplitude creates a stronger effect.</p><p>For example: the height of a wave, the amount shake offsets letters.</p></td></tr><tr><td><code>d</code></td><td><strong>Delay</strong>, the time in seconds before the effect starts.</td></tr><tr><td><code>f</code></td><td><strong>Frequency</strong>, the speed of an animation. A higher frequency creates a faster effect.</td></tr><tr><td><code>l</code></td><td><strong>Limit</strong>, the number of cycles (or seconds for animations without cycles) before the animation stops.</td></tr><tr><td><code>w</code></td><td><strong>Wave Size</strong>, for effects that work in waves (<code>&#x3C;wave></code>, <code>&#x3C;rainbow></code>, etc.). For example, a wave size of 5 means the full wave will be completed after 5 letters.</td></tr></tbody></table>

## Examples

<table><thead><tr><th width="452">Code</th><th>Explanation</th></tr></thead><tbody><tr><td><code>Example &#x3C;wave>text&#x3C;/wave>!</code></td><td><code>text</code> is animated as a wave, it uses default parameters.</td></tr><tr><td><code>&#x3C;wiggle>Example&#x3C;/wiggle>&#x3C;wave>text&#x3C;/wave></code></td><td><code>Example</code> wiggles with default parameters; <code>text</code> waves with default parameters</td></tr><tr><td><code>&#x3C;wave>Example &#x3C;swing>text&#x3C;/swing>&#x3C;/wave></code></td><td>Animations can be combined</td></tr><tr><td><code>&#x3C;wave f=5>Example&#x3C;/wave></code></td><td><code>Example</code> waves 5 times per second.</td></tr><tr><td><code>&#x3C;wave a=3 d=3 f=5 w=10>Example&#x3C;/wave></code></td><td><code>Example</code> waves with an amplitude of 3 (very large), a frequency of 5, and a wave size of 10 letters. The animation starts 3 seconds after the text appears.</td></tr></tbody></table>

## Performance cost

The type and amount of animations you use should not significantly impact performance. Most of the performance cost is up-front when you set your text and is mostly dependent on the length of your text.

Check out the [performance-optimization-guide](https://docs.stixgames.com/text-animations/performance-optimization-guide "mention") for more information.

***

Check out [custom-animations](https://docs.stixgames.com/text-animations/animations/custom-animations "mention") and [custom-c-animations](https://docs.stixgames.com/text-animations/c-extensions/custom-c-animations "mention") if you want to extend the asset with your own animations.

Is an important animation missing? Or maybe an animation tag doesn't support a parameter you'd like to use? Contact me via the [contact form](https://stixgames.com/contact/), or join my [Discord](https://discord.gg/jvBFhQA) and I'll try my best to help you!
