> 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/tube.md).

# Tube

The **Tube component** is an essential element in iCraft for building process pipelines, energy systems, and industrial infrastructure.

By combining geometry, appearance, connectors, and advanced parameters, users can quickly construct clear and realistic 3D tube systems without complex modeling. It is suitable for scenarios such as concept design, system visualization, and presentation demonstrations.

***

## How to Draw a Tube？

#### Create a Tube Component

* Click the **「Tube」** icon in the system asset library on the left, or drag the icon directly onto the canvas.
* If there are existing elements on the canvas, click an element, then click the **「Tube Connection」** icon in the floating toolbar on the right. This allows you to quickly create a tube path starting from that element and connect it to another element. Press **`ENTER`** to finish drawing and generate the tube.\
  Alternatively, click on an empty area of the canvas to place control anchor points and freely draw a tube path. Press **`ENTER`** to complete the path and generate the tube.

<figure><img src="/files/5FI0RjvnyVvokZXJoDHQ" alt=""><figcaption></figcaption></figure>

***

#### Edit and Adjust the Tube Path

After drawing the tube, **`double-click the tube`** to enter path editing mode. You can further adjust the tube path using the following methods:

* **Adjust Node Position**\
  In path editing mode, drag the control anchor points along the path to change the direction of the tube. For more precise adjustments, it is recommended to use the three-axis transform gizmo on the control points.
* **Add Nodes**\
  In path editing mode, click between existing path segments to insert a new control anchor point.
* **Delete Nodes**\
  In path editing mode, select a control anchor point and press **`Delete`** to remove it.

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

***

## Special Parameters of the Tube

#### Shape

* **Tube Radius**\
  Defines the radius of the circular cross-section of the tube, determining its thickness.\
  Larger values produce thicker tubes.

  Default value: 0.1

  Adjustable range: `0.1 – 1`
* **Radial Segments**\
  Controls the number of segments around the circular cross-section, determining how smooth the tube appears. More segments produce a smoother cylinder.

  Default value: 16

  Adjustable range: `4 – 32`
* **Corner Radius**\
  Defines the arc radius used at curved sections of the tube path, determining how rounded the bends appear. Larger values produce smoother and wider curves.

  Default value: 0.5

  Adjustable range: `0.1 – 2`
* **Corner Segments**\
  Controls the number of segments used in the curved sections of the tube.\
  Higher values produce smoother bends.\
  Default value: 64

  Adjustable range: `4 – 64`
* **Close Path**\
  A toggle that determines whether the tube path forms a closed loop.

  Default: Disabled (path remains open)

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

***

#### Appearance

* **Material Type**\
  Determines the material model used to render the tube surface, affecting lighting, reflection, and overall visual appearance.

  Default: **Clay Material.** Other material types can also be selected.
* **Color**\
  Sets the color of the tube surface using the color picker.
* **Opacity**\
  Controls the transparency of the tube. Lower values increase transparency.

  Default value: 1 (fully opaque)

  Adjustable range: `0 – 1`

<figure><img src="/files/9TW3Wn8N8Z5wrLJLILak" alt=""><figcaption></figcaption></figure>

***

#### Joint

* **Visible**\
  A toggle that determines whether joints appear at the ends of the tube.

  Default: Disabled
* **Type**\
  Defines the style of the tube joint.

  Default: Cylinder

  Optional: Cone
* **Two-Way**\
  Determines whether joints appear at both ends of the tube.

  Default: Disabled
* **Size**\
  Controls the size scale of the joint components.

  Default value: 0.3

  Adjustable range: `0.1 – 1`

<figure><img src="/files/XWNxJdU246RTUz4YuRfw" 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/tube.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.