> For the complete documentation index, see [llms.txt](https://plugin-everything.gitbook.io/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/docs/controls/repeater.md). # Repeater The `Repeater` group creates multiple copies of the stroke. Use it for motion trails, echoes, offset duplicates, stepped 3D strokes, fading repeats, or color-shifted copies. {% hint style="info" %} For values of 2 or more, `Total Copies` includes the original stroke. A value of 3 means the original plus 2 repeated copies. A value of 1 activates the single-copy preview behavior described below. {% endhint %} ## Controls
Enable Repeater #### Enable Repeater `Enable Repeater` turns repeated copies on or off. When it is unchecked, the other `Repeater` controls are disabled and the stroke renders normally.
Total Copies #### Total Copies `Total Copies` sets the total number of strokes produced by the repeater. For values of 2 or more, the original stroke is copy 0. Repeated copies are copy 1, copy 2, and so on. Per-copy style and transform changes are cumulative, so later copies receive stronger changes than earlier copies. The original draws on top of repeated copies by default, which makes motion trails sit behind the current stroke. When `Total Copies` is 1, Thicc Pro shows one modified stroke as a preview of copy 1 instead of showing the untouched copy 0.
Path Offset Interval (sec) #### Path Offset Interval `Path Offset Interval` controls when each repeated copy samples its source path. If your source path is static, `Path Offset Interval` has no effect. | Value | Result | | -------------- | --------------------------------- | | Negative value | Later copies sample earlier times | | `0` | All copies use the current path | | Positive value | Later copies sample future times | Use negative values for trails that follow animation. Use positive values for lead-in echoes. Use `0` when you want repeated style or transform copies without time-offset path sampling. The interval is measured in seconds, so it behaves consistently if you change the composition framerate. When `Total Copies` is 1, the visible stroke is sampled once at the specified interval from the current time.
Width % #### Width % `Width %` multiplies stroke width for each repeated copy. A value below 100% makes each later copy thinner. A value above 100% makes each later copy thicker. The change compounds by copy number, so 80% produces 80%, 64%, 51.2%, and so on. This modifies the base stroke width before `Width Control Mode` maps its width curve over the path.
Width +/- #### Width +/- `Width +/-` adds or subtracts width for each repeated copy. Positive values make later copies wider. Negative values make later copies narrower. The offset is cumulative, so copy 3 receives 3 times the value. Width is clamped at zero, so extreme negative values can make later copies disappear.
Opacity % #### Opacity % `Opacity %` multiplies opacity for each repeated copy. A value below 100% creates a fading trail. For example, 90% gives copy 1 90% opacity, copy 2 81%, copy 3 72.9%, and so on. This stacks with `Master Opacity` and gradient stop opacity. The original stroke keeps the normal opacity from the `Color & Opacity` group.
Hue Shift #### Hue Shift `Hue Shift` rotates the color of each repeated copy around the hue wheel. The shift is cumulative by copy number. A value of 20 degrees gives copy 1 a 20 degree shift, copy 2 a 40 degree shift, copy 3 a 60 degree shift, and so on. This affects both `Solid` and `Gradient` color modes.
Gradient Cycle #### Gradient Cycle `Gradient Cycle` offsets the gradient for each repeated copy. Use it to make repeated copies pick up different parts of the same gradient, which is useful for color trails, chasing lights, and rainbow echoes. `Gradient Cycle` only changes the result when `Color Mode` is set to `Gradient`.
Transform #### Transform The `Transform` sub-group offsets, rotates, and scales repeated copies.
ParameterResult
Position X, Position YMoves each copy in 2D screen space
Position ZMoves each copy in depth for Sphere (3D)
Rotation X, Rotation Y, Rotation ZRotates each copy around the transform origin
Scale X, Scale Y, Scale ZScales each copy around the transform origin
Origin X, Origin YOffsets the composition-center origin for normal paths or sets the world-space origin for light motion paths
Origin ZSets the depth of the transform origin
Transform values are cumulative. If `Position X` is 20, copy 1 moves 20 pixels, copy 2 moves 40 pixels, copy 3 moves 60 pixels, and so on. Scale compounds by percentage, so 90% gets progressively smaller across copies. For masks, shapes, and text, Thicc Pro starts with the composition center as the transform origin, then adds `Origin X` and `Origin Y` as offsets. `Origin Z` sets its depth. For light motion paths, `Origin X`, `Origin Y`, and `Origin Z` define the origin directly in world space.
## Interactions
Single-Copy Preview When `Enable Repeater` is checked and `Total Copies` is 1, Thicc Pro renders only the copy 1 result. It does not also draw the untouched original. The visible stroke receives one increment of every per-copy setting: * `Path Offset Interval (sec)` is applied once * `Width %`, `Width +/-`, and `Opacity %` are applied once * `Hue Shift` and `Gradient Cycle` are applied once * Position, rotation, and scale transforms are applied once This is useful for previewing or animating the first repeater step before adding more copies.
Draw Order Repeated copies are inserted behind the original stroke. This makes the current stroke draw on top of its trail. For the copy-index calculation and the sequence used with multiple source paths, see [Repeater order with multiple paths](/docs/faq.md#how-does-repeater-order-work-how-does-it-work-with-multiple-paths).
Trim Paths `Trim Paths` is applied after repeater copies are collected, so repeated copies are trimmed too. With `Trim Multiple Paths` set to `Simultaneously`, `Trim Time Offset (sec)` staggers across all paths, including repeater copies. Increasing `Total Copies` can therefore change the apparent trim timing across the full set of paths. For an illustrated explanation of the processing sequence, see [Trim Paths with repeater copies](/docs/faq.md#how-does-trim-paths-work-with-repeater-copies).
Dashes Dashes are applied after repeater copies are collected, so repeated copies are dashed too. If `Width Scope` or `Gradient Scope` is set to `Individual Dashes`, each dash segment receives its own width curve or gradient inside every copy.
Width Scope and Gradient Scope Scope modes treat repeated copies as additional paths.
ScopeRepeater behavior
Multiple PathsWidth or color spans all repeated paths plus the original
Individual PathsWidth or color restarts on each copied path
Individual TrimsWidth or color restarts on each trim segment
Individual DashesWidth or color restarts on each dash segment
Path Sources `Path Offset Interval (sec)` resamples the active path source at each copy's time. This works with masks, shape paths, text outlines, and light motion paths. Animated text or shape content can produce a different number of paths at different time offsets. Thicc Pro handles this naturally; copies do not need to contain the same path count as the original. When `Pen Shape` is `Sphere (3D)` and a `Parent Layer` is used, the parent layer transform is sampled per copy at the same time offset as that copy's path.
## Interface Conditionals
Enable Repeater | Condition | Result | | ------------------------------ | ------------------------------------------------------------ | | `Enable Repeater` is unchecked | Repeater controls are disabled | | `Enable Repeater` is checked | Repeater controls are enabled | | `Total Copies` is `1` | Only the copy 1 result is rendered; copy 0 is not also drawn |
Transform | Condition | Result | | -------------------------------- | ----------------------------------------------------------------- | | `Pen Shape` is not `Sphere (3D)` | `Position Z` is disabled | | `Use Light Motion Paths` is off | `Origin X` and `Origin Y` offset the composition-center origin | | `Use Light Motion Paths` is on | `Origin X`, `Origin Y`, and `Origin Z` set the world-space origin |
Gradient Cycle | Condition | Result | | -------------------------- | --------------------------------------------- | | `Color Mode` is `Solid` | `Gradient Cycle` has no visible effect | | `Color Mode` is `Gradient` | `Gradient Cycle` offsets each copy's gradient |
--- # 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/docs/controls/repeater.md?ask=&goal= ``` `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.