> For the complete documentation index, see [llms.txt](https://docs.icraft.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.icraft.design/editor-features/resource-panel/basic-graphics/text.md).

# Text

In 3D scene creation, **text** is a core element for conveying information, labeling equipment, and enhancing visual presentation.

iCraft provides two types of text tools: **2D Text** and **3D Text**, designed to meet different needs for information annotation and spatial decoration.

***

## 2D Text

2D Text displays text in a flat, screen-oriented style and is widely used for labels, descriptions, and interface-style annotations.\
After adding text, you can drag the corner handles of the text box with the mouse to resize the text container.

<figure><img src="/files/BGV4Lbz1Xa81dqIQkb3P" alt=""><figcaption></figcaption></figure>

***

#### Font

* **Content**\
  The text input field where you can type the content you want to display.
* **Size**\
  Controls the font size of the text. The parameter is text scale size.

  Default value: 0.3

  Adjustable range: `0.05 ~ unlimited`
* **Font**\
  Select different font styles from the dropdown menu.\
  Default font: **Roboto**
* **Font Weight**\
  Choose the stroke thickness of the selected font, such as **`Regular`** or **`Bold`**.
* **Color**\
  Set the text color using the color picker.

<figure><img src="/files/WverThkFBbf61nrUDVA4" alt=""><figcaption></figcaption></figure>

***

#### Align

* **Text Align**\
  Controls the horizontal alignment of the text.

  Default: Left

  Options: Left / Center / Right
* **Anchor X**\
  Defines the horizontal reference point of the text.

  Default: Center of the text box

  Options: Left / Center / Right
* **Anchor Y**\
  Defines the vertical reference point of the text.

  Default: Center of the text box

  Options: Top / Center / Bottom
* **Padding**\
  Controls the spacing between the text content and its bounding box.

  Default value: 0.1

  Adjustable range: `0 ~ 1`

<figure><img src="/files/eyYrWENUtNKjUJYMVbxv" alt=""><figcaption></figcaption></figure>

***

#### Stroke

* **Color**\
  Sets the outline color of the text using the color picker.

  Default: `#FFFFFF`
* **Width**\
  Controls the thickness of the text outline.

  Default value: 0.02

  Adjustable range: `0 ~ 0.1`

<figure><img src="/files/wmiRsV1HLHy4HNfdHkGN" alt=""><figcaption></figcaption></figure>

***

#### Background

* **Visible**\
  Toggle whether a background panel appears behind the text.\
  Default: Off
* **Color**\
  Select the fill color of the background panel.

  Default: `#FFFFFF`
* **Opacity**\
  Controls the transparency of the background panel. Lower values increase transparency.

  Default value: 1 (fully opaque)

  Adjustable range: `0 ~ 1`
* **Radius**\
  Controls the roundness of the four corners of the background rectangle. Larger values make the panel appear more capsule-shaped.

  Default value: 0

  Adjustable range: `0 ~ 1`
* **Border**\
  Toggle whether a border is displayed around the background panel.\
  Default: Off
* **Border Color**\
  Select the color of the background panel border.

  Default: `#000000`
* **Border Line**\
  Controls the thickness of the border line.

  Default value: 0.01

  Adjustable range: `0 ~ 0.1`
* **Border Dashed**\
  Converts the border into a dashed line. The value determines the spacing between dashes. When the value is 0, it is a solid line.\
  Default value: 0

  Adjustable range: `0 ~ 1`

<figure><img src="/files/LEbhrOjb5bZGNE57wIah" alt=""><figcaption></figcaption></figure>

***

## 3D Text

Unlike flat text, 3D Text is a geometric object with physical volume and depth.

It behaves like other 3D assets in the scene, allowing you to modify materials, colors, shadows, and other rendering parameters. Because it interacts with lighting and produces realistic shadows, it is an essential tool for enhancing spatial depth, creating scene titles, or building logos for structures.

#### Shape

* **Content**\
  The text input field where you can type the content you want to display.
* **Size**\
  Controls the font size of the text.

  Default value: 0.5

  Adjustable range: `0.05 ~ unlimited`
* **Font**\
  Select different font styles from the dropdown menu.\
  Default font: **Roboto**
* **Weight**\
  Choose the stroke thickness of the font, such as **`Regular`** or **`Bold`**.
* **Thickness**\
  Controls the extrusion depth of the text along the axis perpendicular to the text plane. Larger values produce thicker text.

  Default value: 0.2

  Adjustable range: `0 ~ 2`
* **Curve Segments**\
  Determines the smoothness of curved edges in the text geometry. Higher values create smoother curves.

  Default value: 12

  Adjustable range: `2 ~ 20`
* **Bevel**\
  Adds a rounded edge to the corners of the text, enhancing visual quality and improving light reflection.

  Default value: 0

  Adjustable range: `0 ~ 0.1`
* **Bevel Sides**\
  Available only when **Bevel** value greater than 0. Controls the smoothness of the bevel surface. Higher values produce more rounded edges.

  Default value: 3

  Adjustable range: `1 ~ 10`

<figure><img src="/files/fdcAQTsEyDP5DoIF0mU4" alt=""><figcaption></figcaption></figure>


---

# 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.icraft.design/editor-features/resource-panel/basic-graphics/text.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.
