# Text

The **Text Object** is a very versatile feature of **Incari Studio**.

## Value

`Value` defines the text that will appear in the **Text Object**. This can be any sequence of characters that the font supports, including special characters such as emojis 😉.

{% hint style="info" %}
Additionally, the `Value` **Attribute** can be used to add extra styling in the form of HTML/CSS. This is achieved using `<span>` tags and is only recommended to users who are familiar with these languages.
{% endhint %}

```markup
Without CSS
<br>
<span style="
    font-style: italic;font-weight:bold;
    background:linear-gradient(#FEE140 0%, #FA709A 100%);
    -webkit-background-clip:text;-webkit-text-fill-color:transparent;">

    With CSS
</span>
```

![](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-26a5bf6e233bb5724ee6e5a4a3d714e0c94a881c%2Fcss.png?alt=media)

## Size and Resolution

Although you may already be familiar with the `Size` and `Resolution` **Attributes** of the **Camera Object**, things work slightly differently with **Text** and **Web Sprite Objects**.

With **Camera**, `Resolution` relates to the resolution of a *physical* piece of hardware ,i.e., a display. With **Text** and **Web Sprite**, however, both `Size` and `Resolution` relate to something which exists in *virtual* 3D space. So although, like **Camera**, the `Size` **Attribute** defines the **Object's** size in 3D space, the `Resolution` **Attribute** defines the resolution of the content that will be stretched to fit that space.

## Font Family

`Font Family` allows one to select a generic font family (`Manrope` or `Source Code Pro`) or a custom font that has been added in [**Project Settings**](https://docs.incari.com/incari-studio/2024.1/modules/project-settings/fonts).

**Text Objects** are capable of handling [*variable fonts*](https://docs.incari.com/incari-studio/2024.1/modules/project-settings/fonts#variable-fonts) and let the user configure certain aspects, called `Parameters`. The *gif* below demonstrates what a font looks like with no `Parameters` in its **Attributes** and what it looks like when the user switches to a font that does.

![No Parameters vs. Four Parameters.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-3ca8f05b3c1b502c7008e2ca2928a28332754e85%2Ftext3dfontexample.gif?alt=media)

## Alignment

Alignment works like any other word processor. You can align your text to be left-aligned, centre-aligned or right-aligned, using the `left`, `center`and `right`options respectively.

![](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-782a09d2eae5a79788d8d43e9190b6528491205a%2Falignment.png?alt=media)

## Font Size

`Font Size` defines the approximate height, in pixels, from the *lowest descent* to the *highest ascent* of a font.

![](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-51e98d4b7983936977b3c193e81eb16656682e3c%2Ffont-size.png?alt=media)

## Font Color / Background Color

**Colors** can be set in various ways in **Incari** and work very much like they do in other software. You can manually adjust the **HSB** / **RGBA** values or input a **Hex Code**, using their corresponding [**Color Attribute**](https://docs.incari.com/incari-studio/2024.1/objects-and-types/attributes/attribute-types/color-attribute).

## Sprite

Additionally, **Text** also shares **Common Attributes** of the **Sprite** category; which are:

* `Alpha`
* `Flip U` and `Flip V`
* `Sort Index`

There are also several **Nodes** attributed to **Text Objects**. More information can be found [here](https://docs.incari.com/incari-studio/2024.1/toolbox/incari/object/set-text), [here](https://docs.incari.com/incari-studio/2024.1/toolbox/incari/object/get-text-color) and [here.](https://docs.incari.com/incari-studio/2024.1/toolbox/incari/object/set-text-color)

## Translation

It is also possible to switch to `Translation` by clicking the right-most icon of the `Text` **Attribute**.

![Static Text and Translation.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-981fcfec4b57d2dca4efa0b62b3bde4612b662f3%2Ftextvstranslation.png?alt=media)

This lets the user access the `.local` file provided in the [**Project Settings**](https://docs.incari.com/incari-studio/2024.1/modules/project-settings/localization). The keys will appear as options in the `Translation` dropdown. The translation of the current language will be used. This is set in the **Project Settings** but can be altered with the [**Localization Nodes**](https://docs.incari.com/incari-studio/2024.1/toolbox/localization).