# Thickness Repeats

### What It Does

Thickness Repeats applies a yarn thickness pattern to your warp or weft. Just as Color Repeats lets you create repeating color sequences, Thickness Repeats lets you create repeating thickness sequences — defining which threads use thicker or thinner yarn in a repeating cycle.

Yarn thickness affects how the fabric renders in TempoWeave's cloth preview and View Fabric display, showing the visual impact of using different yarn weights in a structured pattern (such as thick-thin alternation in rep weave or textured effects with mixed gauges).

***

### Opening Thickness Repeats

* **Ribbon**: Design tab > Repeats group > Thickness Repeats button

***

### The Dialog

The dialog has two sections: the thickness pattern editor (top) and the destination controls (bottom).

***

### Thickness Pattern Editor

#### Building a Thickness Pattern

The pattern is a list of entries, each specifying a thickness value and how many consecutive threads receive that thickness.

Each entry shows:

* A **thickness size** spinner (1–16) — the relative yarn weight
* A **repeat count** spinner (1–1,000) — how many consecutive threads get this thickness

**Add Size** — Adds a new thickness entry with the default size of 4 and repeat count of 1.

**Remove** — Removes the selected entry.

**Clear All** — Removes all entries.

**Load from Warp** — Reads your current warp and builds a pattern by grouping consecutive threads with the same thickness. Useful for capturing an existing thickness arrangement.

**Load from Weft** — Same but reads from weft picks.

**Mirror** — Creates a symmetrical pattern by appending a reversed copy (excluding the first entry). Pattern A-B-C becomes A-B-C-B-A.

A summary line shows the total: "Pattern: N sizes, M threads."

***

### Destination Controls

#### Apply To

**Warp** — Apply the thickness pattern to warp threads.

**Weft** — Apply the thickness pattern to weft picks.

#### Start Thread / Start Pick

The thread or pick number where the pattern begins (1-based).

#### Mode

Two modes control how the pattern fills the destination:

**Repeats Mode**

Applies the complete pattern a specified number of times.

**Times** — How many complete cycles (1–100).

Shows a preview of the affected range and resulting measurement.

**Ending Mode**

Applies the pattern cyclically until reaching a target thread or pick number.

**End Thread / End Pick** — The last position to fill.

The pattern repeats until it reaches the specified end point. After applying, the start position automatically advances to the next position for convenient sequential application.

***

### How to Use It

1. Open **Thickness Repeats** from the Design tab
2. Build your thickness pattern:
   * Click **Add Size** to add entries
   * Set the thickness value (1 = finest, 16 = thickest) and repeat count for each
3. Choose **Warp** or **Weft**
4. Set the start position
5. Choose a mode (Repeats or Ending)
6. Click **Apply**

***

### Step-by-Step Example: Thick-Thin Weft for Rep Weave

You're weaving rep weave and want alternating thick and thin weft picks:

1. Open **Thickness Repeats**
2. Add Size: thickness 2, repeat 1 (thin tabby pick)
3. Add Size: thickness 8, repeat 1 (thick pattern pick)
4. Choose **Weft**, Start Pick 1
5. Select **Ending** mode, set End Pick to your total pick count
6. Click **Apply** — every other pick alternates between thin and thick

### Step-by-Step Example: Textured Warp with Mixed Gauges

You want a warp that alternates groups of fine and heavy threads:

1. Open **Thickness Repeats**
2. Add Size: thickness 3, repeat 6 (group of fine threads)
3. Add Size: thickness 10, repeat 2 (pair of heavy threads)
4. Choose **Warp**, Start Thread 1
5. Select **Repeats** mode, Times 15
6. Click **Apply** — the pattern tiles across your warp

***

### Tips

* **Thickness is visual** — Thickness values affect how threads render in the drawdown and fabric viewer. They represent relative yarn weight, not absolute measurements.
* **Scale is 1–16** — 1 is the finest yarn, 16 is the thickest. The default is 4.
* **Load from existing** — Use Load from Warp/Weft to capture an existing thickness arrangement as a repeatable pattern.
* **Mirror for symmetry** — Creates balanced thickness patterns that read the same in both directions.
* **Ending mode auto-advances** — After applying in Ending mode, the start position moves forward for easy sequential application of different patterns.
* **Combine with Color Repeats** — Use Color Repeats and Thickness Repeats together to create coordinated color and weight patterns.
* **Undo works** — Ctrl+Z (Cmd+Z) reverts the thickness application.

***

### Quick Reference

| Control             | What It Does                                 |
| ------------------- | -------------------------------------------- |
| Add Size            | Add a thickness entry (default size 4)       |
| Remove              | Remove the selected entry                    |
| Clear All           | Remove all entries                           |
| Load from Warp/Weft | Build pattern from existing thickness values |
| Mirror              | Make the pattern symmetrical                 |

| Mode    | How It Applies                         |
| ------- | -------------------------------------- |
| Repeats | Apply N complete cycles                |
| Ending  | Cycle until reaching a target position |

| Thickness Scale |                  |
| --------------- | ---------------- |
| 1               | Finest yarn      |
| 4               | Default / medium |
| 16              | Thickest yarn    |


---

# Agent Instructions: 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:

```
GET https://docs.tempoweave.com/help-by-menu-tabs/design-menu/thickness-repeats.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
