Color Match Mode: Full Control Over Every Color in Your Print

Every other mode in HueForge starts with the same idea: measure brightness, convert it to height. Color Match throws that out entirely.

Instead of letting brightness drive the mesh, Color Match lets you decide which colors go where. You pick colors from the image, place them on a separate core, and HueForge builds the geometry around your choices. It's the most powerful mode in HueForge — and once you understand the concept behind it, it's less intimidating than it looks.

Why Color Match exists

Standard, Color Pop, and Color Aware all share a fundamental limitation: they derive mesh height from some version of brightness. That means colors at similar brightness levels can end up at the same height, sharing the same filament. A medium-blue sky and a medium-green tree, same brightness, same layer. Same filament. Muddy print.

Color Match solves this by letting you manually define which colors occupy which layers. HueForge then looks at each pixel, finds the closest match to the colors you've placed, and sets that pixel's height accordingly. Brightness is no longer the boss — you are.

Two cores, two jobs

This is the concept that makes Color Match click. Every other mode uses a single Color Core to define both the mesh shape and the print filaments. Color Match splits that into two separate systems.

The Mesh Core defines the geometry — the 3D shape of your STL. You populate it with colors sampled from your image (called "fake filaments" — more on that in a second) or with library filaments. Each color occupies a position, and the matching algorithm assigns each pixel to the nearest color, setting its height accordingly.

The Color Core defines the actual print. Only real filaments from the library go here. This is what your printer sees — which filament at which layer.

Think of it like this: the Mesh Core is the architect's blueprint. The Color Core is the contractor's materials list. They work together but serve different purposes.

🔰 Beginner Note: When the Mesh Core is active, you'll see a cyan border around it and the preview shows the mesh structure. When the Color Core is active, the preview shows what the final print should look like. Switch between them with the comma and period keys.

Fake filaments — the key concept

A "fake filament" is a color sampled directly from your source image and placed on the Mesh Core. It's "fake" because it doesn't represent any physical spool you own — it's a virtual color target that helps HueForge build better geometry.

Here's why they matter. Your image might contain forty distinct shades. You might own eight filaments. The fake filaments fill that gap — they give the matching algorithm precise targets to work with, even though you'll only print with the real filaments on your Color Core.

To create one: hold Ctrl (or Cmd on Mac), click a pixel in your source image, and drag it onto the Mesh Core. A hexagonal flag appears. Library filaments show pentagonal flags — that visual difference keeps them straight.

The biggest mistake people make with fake filaments? Leaving the TD at its default of 1.0. At TD 1, the color saturates almost instantly — one or two layers — creating thin, harsh bands instead of smooth gradients. Bump it up. For photographic images, TD 3–5 on your fake filaments is a reasonable starting point. For atmospheric gradients like skies, go higher.

⚡ Pro Tip: Having three times as many colors on the Mesh Core as filaments on the Color Core is completely normal. A 5-filament print with 15 Mesh Core colors is standard practice.

Picking the right matching algorithm

Color Match gives you five algorithms for how it compares each pixel to your Mesh Core colors. The dropdown is in the image pane — you'll see options like Default CM, HSL CM, CIELAB CM, CIELAB 2 CM, and Dot Product.

The short version: CIELAB 2 CM is the default and works well for most images. If you're working with stylized or illustrated art — anime characters, logos, flat-color designs — try HSL CM. If you're on a slower computer and working with photos, Dot Product is the fastest option and was improved specifically for photographic images in the latest version.

Try a couple early on. Switching algorithms takes seconds and you'll see the preview update in real time.

Common pitfalls

If your gradients look stair-stepped, your fake filament TDs are too low. Increase them above 1.0.

If you placed an image color on the Color Core, move it back to the Mesh Core. Image colors aren't printable — they belong on the Mesh Core only.

If you accidentally changed a real filament's TD value, save your project, close HueForge, and when it asks to save the filament library — say no. Reopen and your library values are safe.

Is Color Match right for you yet?

Color Match rewards patience. If you're comfortable with Standard mode and you've tried Color Pop or Color Aware, you're ready. Start with an image that has five or six distinct colors, place those colors on the Mesh Core, assign three or four real filaments to the Color Core, and see what happens.

The learning curve is real — but so is the payoff. This is the mode that turns HueForge from a grayscale tool into a full-color studio.

Ready to go deeper? Grab HueForge at shop.thehueforge.com and explore Color Match on a colorful image that's been giving you trouble in other modes. I walk through the full Color Match workflow on YouTube — and whenever you hit a wall, the Discord crew has seen it before.