# 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    |