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