# Warp Amalgamation

### What It Does

Warp Amalgamation converts a selected rectangular area of the drawdown (the cloth view) into threading. You select a region of the fabric, and TempoWeave reads the interlacement pattern to determine shaft assignments for each column — essentially deriving threading from the cloth structure.

This is useful when you've modified the drawdown directly (or found a section of the cloth with a pattern you want to capture) and want to convert that visual pattern back into a threading that can be reproduced.

***

### Location

* **Ribbon**: Design tab > Combine group > Warp Amalgamation button

***

### The Dialog

Warp Amalgamation uses a guided three-step process:

#### Step 1 — Select

Drag to select a rectangular area in the drawdown (cloth view). The dialog shows the selection status — for example, "Selected: 10 cols × 4 rows."

The selection height (number of rows) cannot exceed the number of available shafts — each row position maps to a shaft, so you need at least as many shafts as rows in your selection.

#### Step 2 — Set Destination

Click on a thread position in the warp header to set where the amalgamated threading begins. The dialog shows the destination: "Destination: Thread N."

#### Step 3 — Apply

Click **Apply** to execute the amalgamation. The selected drawdown region is analyzed and converted into threading at the destination.

***

### How It Works

For each column in your selected drawdown region:

1. The column is scanned from top to bottom
2. The first filled cell (warp on top) determines the shaft assignment
3. The cell's row position within the selection maps to a shaft number (topmost row = shaft 1, next = shaft 2, etc.)
4. A warp thread is created at the destination position with that shaft assignment
5. The thread's color is copied from the source column

If a column has no filled cells, the thread is left unthreaded.

***

### How to Use It

1. Open your draft with a drawdown visible
2. Go to **Design tab > Warp Amalgamation**
3. **Step 1**: Click and drag on the drawdown to select a rectangular region
4. Verify the selection status in the dialog
5. **Step 2**: Click on a position in the warp header to set the destination
6. **Step 3**: Click **Apply**
7. The threading at the destination now reflects the drawdown pattern

***

### Step-by-Step Example: Capturing a Drawdown Pattern as Threading

You've been editing the drawdown directly and created a 4-row pattern across 20 columns that you want to use as threading:

1. Open **Warp Amalgamation**
2. Select the 20×4 region in the drawdown
3. The dialog confirms "Selected: 20 cols × 4 rows"
4. Click thread position 1 in the warp header as the destination
5. Click **Apply**
6. Threads 1–20 now have shaft assignments derived from the drawdown pattern — each thread is on the shaft corresponding to the topmost filled cell in its column

***

### Tips

* **Selection height = shaft range** — The number of rows in your selection determines how many shafts are involved. Keep the selection height within your available shaft count.
* **Topmost mark wins** — Each column's shaft assignment comes from the first (topmost) filled cell. Lower filled cells in the same column are ignored.
* **Colors carry over** — Thread colors from the source columns are preserved in the destination.
* **Use with Fabric Analysis** — Warp Amalgamation is a natural companion to Fabric Analysis Mode. Use Fabric Analysis to draw a cloth pattern, then use Amalgamation to capture specific sections as threading.
* **Undo works** — Ctrl+Z reverts the amalgamation.
* **Reset for retry** — The dialog has a Reset button to clear the selection and destination if you want to start over.

***

### Quick Reference

| Step           | Action             | What Happens                   |
| -------------- | ------------------ | ------------------------------ |
| 1. Select      | Drag on drawdown   | Defines the source region      |
| 2. Destination | Click warp header  | Sets where threading starts    |
| 3. Apply       | Click Apply button | Converts drawdown to threading |

| Constraint       | Detail                                      |
| ---------------- | ------------------------------------------- |
| Selection height | Must not exceed available shafts            |
| Shaft mapping    | Top row = shaft 1, next = shaft 2, etc.     |
| Multiple marks   | Only topmost filled cell per column is used |
| Colors           | Copied from source columns                  |


---

# 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/warp-amalgamation.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.