Colour Tolerance in Craftphilia Studio: How to Make the Preview Match the Rug

Every tufted design goes through one step before it can become a rug: the picture has to be reduced to a handful of yarn colours.

By hand, you do that in your head. You pick the yarns you'll use, squint the image down to those few colours, project it onto the cloth and trace each area. It's also where most beginner advice — "keep it to three to five colours" — comes from.

In Craftphilia Studio that step is one slider. Colour tolerance decides how many yarn colours your design keeps, and the tufting paths are built from the result.

The goal isn't the lowest layer count or the most faithful copy of the image. It's something more specific: a preview on screen that matches the rug that comes off the frame. Getting there means choosing a value for your particular image, at your particular tufting size — and this guide shows how.

Everything here works without a machine. Craftphilia Studio is free, whether you tuft with a gun or with a Craftphilia machine.

What colour tolerance does

Colour tolerance sets how similar two colours have to be to count as one. Colours inside that range merge into a single layer, and each layer becomes one yarn colour.

That matters because an area that looks like one solid colour on screen is rarely one colour in the file. Zoom in and it's many shades that are almost the same, but not quite — anti-aliased edges, soft shading, compression noise.

When you upload an image, Studio separates it at the default tolerance of 40 and shows how many layers it found:

• Lower the value and you get more layers, because more shades stay apart.
• Raise it and similar shades merge into fewer layers.

Two things decide the right value

There's no single correct tolerance, and it isn't only about the artwork. The right value depends on two things working together: how many pixels are in your image, and how big you're going to tuft it.

1. The pixels in your image

The Color Layering window shows your image's size in its title bar — 600 × 600 px, 650 × 1004 px and so on. That number matters more than it looks.

A high-resolution image carries more subtle variation. A 4,000-pixel photo holds thousands of near-identical shades along every edge and across every gradient. At the same tolerance, it splits into more layers than a clean 600-pixel illustration of the same subject — most of them shading that yarn can't show anyway.

A heavily compressed image carries noise. JPG compression adds blocky artefacts that read as extra colours. They show up as layers made of scattered specks.

Two tools deal with this before you touch the slider:

• Denoise Original smooths compression noise and fine grain out of the source image, so tolerance is working on the colours you meant rather than the artefacts.
• Remove Isolated Pixels clears stray specks below a minimum size after processing — the small islands that would otherwise become a colour change for a few stitches.

2. The size you'll tuft

Your screen shows far more detail than a rug can hold. A rug has its own resolution: it's built from rows of yarn, and each row has a real width.

Tuft the same design smaller and every shape gets fewer rows to work with. Tolerance can't add rows. What it changes is how many colours have to share the space you have.

Why the two go together

What actually decides the result is how much image detail lands on each part of the cloth. A detailed, high-resolution image tufted small crams a great deal of detail into very few rows — so it usually wants a higher tolerance and fewer, larger colour areas. The same image tufted at full working size has room to keep more tones.

That's why a value that looks perfect on screen can still be wrong. The screen is showing you the image. Path Preview, at the size you'll tuft, shows you the rug.

Flat designs: find the value that matches the artwork

Designs with solid areas and clear edges have a tolerance that matches the original exactly. In our tests that was 25 for a leaf illustration (650 × 1004 px) and 15 for a banded pattern (600 × 600 px). Every design is different, so treat the default as a starting point.

Two signs tell you which way to move:

• One colour has split into several layers. Raise the tolerance.
• The result looks clean, but a colour from your artwork is missing. Lower it, and compare against the Original tab.

The layer thumbnails tell you whether an extra layer belongs. A thumbnail showing complete, connected shapes is part of your design — keep it. A thumbnail that looks like scattered specks is leftover shading or noise — merge it, or clear it with Remove Isolated Pixels.

Shaded designs: you decide how many tones to keep

Designs with shading and gradients work differently. No single value reproduces them, because a gradient isn't made of a fixed number of colours to begin with. Here, tolerance decides how many steps of shading you keep — and that's a design decision, not a setting to get right.

Our golden retriever design gives:

On screen, all three look fine. That's the catch. Looking fine on screen doesn't mean it will look fine on the rug — which one works depends on the size you're tufting.

Our test: one design, two sizes

When a shape gets too narrow, the path can no longer follow it, and that detail is lost. We ran the golden retriever at two sizes to see where it happens.

At 700 mm, tolerance 20 keeps 14 tones and every one of them has room. At 300 mm, the same image has less than half the width to live in — so raising tolerance to 40 gives fewer, larger areas and brings the big shapes back. Same image, different size, different right answer.

Small details like eyes and noses need a finer fix than the slider.

When tolerance alone isn't enough

Tolerance works on the whole image at once. For the parts it can't reach, Studio gives you four more precise tools:

• Merge two layers. A few areas can still come out split in two colours. Drag one layer onto the other to fix just that pair. Check the thumbnail first — a merge applies to every area of that colour, not only the one you're looking at.
• Give detail layers less erosion. Erosion pulls each colour back from its neighbours so they don't run together on the cloth. Detail layers can be set separately, down to 1 mm, so a small eye survives instead of vanishing into the gap.
• Remove isolated pixels. Clear specks below a minimum size in one pass, rather than merging them layer by layer.
• Add the path by hand. If a detail still doesn't come through, draw its path yourself before tufting. Anything you draw merges into the current layer.

How to check before you tuft

The Color Layering preview can't show you this, because it's drawn at screen detail. Path Preview can.

1. Set your design to the size you'll actually tuft, in millimetres.
2. Turn on Path Preview.
3. Look at each colour area and ask one question: does its path still follow the shape it had in your design?

A path that's only an outline still counts. So does a single line, as long as it follows the turns of the shape. A detail is lost when its path shrinks to a dot, disappears into the blank space between colours, or runs into the next area so the two can't be told apart.

If something is lost, go back one step: adjust tolerance, erosion, or the layer itself — then check again. When every area passes, the preview and the rug are the same picture.

The workflow in one list

1. Upload your image and note its pixel size in the Color Layering title bar.
2. Denoise the original if it's a photo or a compressed JPG.
3. Start at tolerance 40 and adjust — up if one colour has split, down if one has gone missing.
4. Read the layer thumbnails. Keep connected shapes; merge or clear scattered specks.
5. Set the real tufting size and open Path Preview.
6. Fix what the slider can't: merge a pair, lower erosion on detail layers, or draw a path by hand.
7. Check every area once more, then tuft.

Detail needs room. Your image decides how much detail there is; your tufting size decides how much room it gets. Colour tolerance is how you bring the two into balance — so the rug you see before you start is the rug you end up with.

Frequently asked questions

What colour tolerance should I use?

Start at the default of 40 and adjust from there. Flat, graphic designs usually have one value that matches the artwork exactly — in our tests between 15 and 25. Shaded designs don't have a single right value; tolerance there decides how many tones you keep, and the right number depends on your image and your tufting size.

Why does my design have so many layers?

Usually because the image carries a lot of near-identical shades — common in high-resolution photos and compressed JPGs. Run Denoise Original, raise the tolerance, and use Remove Isolated Pixels to clear any speck layers that remain.

Does a higher-resolution image give a better rug?

Not by itself. A rug can only hold as much detail as its rows of yarn allow, so extra pixels past that point mostly become extra shades to merge. A clean image at a sensible resolution is often easier to work with than a very large one.

Why does the same design need a different tolerance at a different size?

Because the rug's resolution changes with its size. Tuft smaller and every shape gets fewer rows, so fewer, larger colour areas hold up better. The same image at full working size has room to keep more tones.

Why did a small detail disappear in Path Preview?

The shape became narrower than the path can follow at that size, or erosion pulled it back to nothing. Lower erosion on that layer, merge it with a neighbour, or draw its path by hand.

Do I need a Craftphilia machine to use colour tolerance?

No. Colour separation, tolerance, layer editing and Path Preview all work with no machine connected, so you can prepare a design for a tufting gun the same way.