# Combine Weft

### What It Does

Combine Weft merges the treadling from two open documents, either by **interleaving** (inserting source picks between existing picks, increasing the total pick count) or by **overlaying** (adding source treadle assignments on top of existing picks, keeping the same pick count).

This is the weft companion to Interleave Warp — while Interleave Warp combines threadings, Combine Weft combines treadling sequences.

***

### Location

* **Ribbon**: Design tab > Combine group > Combine Weft button

***

### The Dialog

#### Source Document

A dropdown of all other open documents. Select the document whose treadling you want to combine with your current draft.

#### Combine Type

**Interleave** — Inserts source picks between your existing picks, increasing the total number of picks. The result alternates: one pick from the current draft, one from the source, and so on.

**Overlay** — Places source treadle assignments onto existing picks without adding new ones. The pick count stays the same, but picks gain additional treadle activations.

#### Start at Pick

The pick number where combining begins (1-based). Picks before this position are left unchanged.

#### Shift Right

A treadle offset applied to the source's treadle assignments (0 to number of treadles available). This shifts the source treadling to different treadle positions, keeping it separate from your current treadling.

#### Ratio

Controls how frequently source picks are inserted or overlaid:

* **1:1** — Every pick gets a source pick (one source per one current)
* **2:1** — Every second pick gets a source pick
* **3:1** — Every third pick, and so on

Higher ratios spread the source picks more thinly through the fabric.

#### Options

**Copy colors** — Bring the source's weft colors.

**Copy thickness** — Bring the source's thickness values.

**Repeat source** — Cycle the source treadling if it's shorter than the current draft.

**Wrap treadles** — Wrap treadle numbers that exceed the maximum instead of expanding the treadle count.

***

### How It Works

#### Interleave Mode

Source picks are inserted between existing picks:

```
Current:  1  2  3  4
Source:   A  B  C  D  (ratio 1:1)
Result:   1  A  2  B  3  C  4  D  (8 picks total)
```

With a 2:1 ratio:

```
Current:  1  2  3  4  5  6
Source:   A  B  C        (ratio 2:1)
Result:   1  2  A  3  4  B  5  6  C  (9 picks total)
```

#### Overlay Mode

Source treadle assignments are added to existing picks:

```
Current:  Treadle 1, Treadle 2, Treadle 3
Source:   Treadle A, Treadle B, Treadle C
Result:   Treadle 1+A, Treadle 2+B, Treadle 3+C  (same 3 picks)
```

When overlaying with a shift, the draft automatically converts to multi-treadle mode if needed, allowing multiple treadles to be active on the same pick.

***

### How to Use It

1. Open both documents — your current draft and the source draft
2. Go to **Design tab > Combine Weft**
3. Select the **Source Document**
4. Choose **Interleave** or **Overlay**
5. Set the **Start at Pick**
6. Set **Shift Right** if you want the source on different treadles
7. Set the **Ratio** (1:1 for every pick, 2:1 for every other, etc.)
8. Check the options you want
9. Click **Apply**

***

### Step-by-Step Example: Adding Tabby Picks Between Pattern Picks

You have a pattern treadling and want to insert tabby (plain weave) picks between each pattern pick:

1. Create a second document with just a tabby treadling (alternating treadle 1 and 2)
2. In your pattern draft, open **Combine Weft**
3. Select the tabby document as the source
4. Choose **Interleave**, ratio 1:1
5. Set Shift Right to offset the tabby treadles if needed
6. Check **Repeat source**
7. Apply — every pattern pick now has a tabby pick after it

### Step-by-Step Example: Overlaying a Ground Weave

You have a pattern treadling and want to overlay a ground structure:

1. Open your pattern draft and the ground draft
2. Open **Combine Weft**
3. Select the ground document as source
4. Choose **Overlay**
5. Set Shift Right to place the ground on separate treadles
6. Apply — each pick now activates both pattern and ground treadles

***

### Tips

* **Interleave adds picks; Overlay doesn't** — Choose interleave when you want extra picks (like tabby between pattern). Choose overlay when you want multiple structures on the same pick.
* **Shift separates treadles** — Use Shift Right to keep source and current treadling on different treadle groups, just like shaft shift in Interleave Warp.
* **Ratio controls density** — A 1:1 ratio doubles your picks (interleave) or affects every pick (overlay). Higher ratios space out the source.
* **Multi-treadle automatic** — Overlay with a shift automatically enables multi-treadle mode so multiple treadles can be active per pick.
* **Works with liftplan** — Combine Weft handles both single-treadle mode and liftplan mode.
* **Undo works** — Ctrl+Z reverts the combine operation.

***

### Quick Reference

| Setting         | What It Does                          |
| --------------- | ------------------------------------- |
| Source Document | Other open document to combine from   |
| Interleave      | Insert source picks (increases total) |
| Overlay         | Add source treadles to existing picks |
| Start at Pick   | Where combining begins                |
| Shift Right     | Offset source treadle assignments     |
| Ratio           | How frequently source picks appear    |
| Copy colors     | Bring source weft colors              |
| Copy thickness  | Bring source thickness                |
| Repeat source   | Cycle source if shorter               |
| Wrap treadles   | Wrap vs. expand treadle count         |


---

# 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/combine-weft.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.