> For the complete documentation index, see [llms.txt](https://plugin-everything.gitbook.io/plugin-everything-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://plugin-everything.gitbook.io/plugin-everything-docs/controls/dashes.md).

# Dashes

The `Dashes` group breaks the current stroke into repeated visible segments and gaps. Use it for dotted lines, marching paths, technical diagrams, animated chase effects, or dashed trails that still keep Thicc Pro's width, color, trim, and repeater controls.

<div data-with-frame="true"><figure><img src="/files/ywlYHLJeHyvF6aD4eO8Z" alt="" width="340"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Dashes are created inside the current trimmed path range. `Trim Paths` controls the visible window, then `Dash`, `Gap`, and `Dash Offset` divide that window into segments.
{% endhint %}

## Controls

<details>

<summary>Enable Dashes</summary>

#### Enable Dashes

`Enable Dashes` turns dashed rendering on or off.

When it is unchecked, `Dash`, `Gap`, and `Dash Offset` are disabled and the stroke renders as a continuous path.

Enabling dashes also makes the `Individual Dashes` option available in `Width Scope` and `Gradient Scope`, so each dash can receive its own full width curve or gradient.

</details>

<details>

<summary>Dash</summary>

#### Dash

`Dash` sets the length of each visible segment in the dash pattern, measured in pixels.

Larger values create longer visible strokes. Smaller values create short marks or dots, especially when paired with a round cap.

Use `Dash` with `Gap` to set the rhythm of the pattern. A `Dash` of 50 and a `Gap` of 50 creates an even on/off pattern.

</details>

<details>

<summary>Gap</summary>

#### Gap

`Gap` sets the empty space between visible dash segments, measured in pixels.

Larger values spread dashes farther apart. Smaller values make the pattern denser.

If `Gap` is 0, dash segments touch end-to-end. This usually looks like a continuous stroke unless `Width Scope`, `Gradient Scope`, caps, or animated offsets make the segment boundaries visible.

</details>

<details>

<summary>Dash Offset</summary>

#### Dash Offset

`Dash Offset` shifts the dash pattern along the path, measured in pixels.

Animate `Dash Offset` to create marching ants, flowing trails, or moving light pulses. One full loop of the pattern is `Dash` plus `Gap`, so an offset change equal to that combined length returns the pattern to the same phase.

Positive and negative values move the pattern in opposite directions. If the value grows beyond one pattern length, Thicc Pro wraps it internally.

</details>

## Interactions

<details>

<summary>Trim Paths</summary>

Dashes are applied after `Trim Paths`. This means `Trim Start`, `Trim End`, and `Trim Offset` choose the visible part of the path first, then dashes are generated inside that visible range.

Animate `Trim End` for a draw-on dashed stroke. Animate `Dash Offset` when you want the dash pattern itself to move while the visible range stays the same.

</details>

<details>

<summary>Line Cap</summary>

Each dash segment has its own start and end. For `Round` and `Flat` pen shapes, `Line Cap` controls how those dash ends are drawn.

Use `Round Cap` with a short `Dash` value to make dotted strokes. Use `Butt Cap` with `Pen Shape: Flat` for precise square-ended technical dashes.

With `Pen Shape: Sphere (3D)`, dash segments use the sphere rendering pipeline instead of traditional line cap geometry.

</details>

<details>

<summary>Width Scope and Gradient Scope</summary>

When dashes are enabled, `Individual Dashes` becomes available in `Width Scope` and `Gradient Scope`.

<table><thead><tr><th width="231.9453125">Scope</th><th>Result</th></tr></thead><tbody><tr><td><code>Multiple Paths</code></td><td>Width or color spans all paths as one sequence</td></tr><tr><td><code>Individual Paths</code></td><td>Width or color restarts on each path</td></tr><tr><td><code>Individual Trims</code></td><td>Width or color restarts on each trimmed range</td></tr><tr><td><code>Individual Dashes</code></td><td>Width or color restarts on each visible dash segment</td></tr></tbody></table>

Use `Individual Dashes` for tapered dashes, repeated mini-gradients, or dots that each fade from opaque to transparent.

</details>

<details>

<summary>Repeater</summary>

Repeater copies are collected before dashes are generated, so every repeated copy is dashed too.

If `Path Offset Interval (sec)` samples earlier or later frames, each copy uses the dashed version of its own sampled path. Scope modes treat repeated copies as additional paths.

</details>

<details>

<summary>Small or Zero Values</summary>

If both `Dash` and `Gap` are 0, Thicc Pro treats the stroke as continuous.

If `Dash` is 0 and `Gap` is greater than 0, there are no visible dash segments. Very tiny dash patterns are guarded internally to avoid unstable zero-length geometry.

</details>

## Interface Conditionals

<details>

<summary>Enable Dashes</summary>

| Condition                    | Result                                    |
| ---------------------------- | ----------------------------------------- |
| `Enable Dashes` is unchecked | `Dash`, `Gap`, and `Dash Offset` disabled |
| `Enable Dashes` is checked   | `Dash`, `Gap`, and `Dash Offset` enabled  |

</details>

<details>

<summary>Scope Options</summary>

`Enable Dashes` controls whether dash-based scope options are available.

| Condition                                       | Result                                             |
| ----------------------------------------------- | -------------------------------------------------- |
| `Enable Dashes` is unchecked                    | `Individual Dashes` is unavailable in scope popups |
| `Enable Dashes` is checked                      | `Individual Dashes` is available in scope popups   |
| `Color Mode` is `Solid`                         | `Gradient Scope` is hidden regardless of dashes    |
| `Width Control Mode` is `None (Constant Width)` | `Width Scope` is hidden regardless of dashes       |

</details>


---

# 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://plugin-everything.gitbook.io/plugin-everything-docs/controls/dashes.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.