Colors in machine files

Colors in machine files

When working with embroidery machine files like Tajima DST, developers often expect the design colors to be preserved. However, unlike Wilcom EMB files, machine files do not contain any color information – only stitch coordinates and STOP codes. This means the Embroidery Web API must assign colors in a different way when generating TrueView previews. Operators must assign needle/thread colors manually at the machine.

Using API calls with machine files

  1. When you upload a machine file such as DST and call api/editDesignTrueview, the API must still return a colored TrueView image.
  2. Since DST files lack colors, the system applies the Wilcom default Color Palette.
  3. This palette has 15 preset colors, cycled through if the design has more than 15 stops.
  4. A DST with 20 stops will be displayed using the 15 default colors, then repeat.

Default color palette

The Wilcom default Color Palette includes colors such as Dark Green, Blue, Red, Yellow, Aqua, Black, White, Purple, Brown, and Pink.


Example XML thread block from the API:

Quote<threads>
  <thread color="39168" code="1" brand="Default" description="Dark Green" />
  <thread color="16711680" code="2" brand="Default" description="Blue" />
  <thread color="255" code="3" brand="Default" description="Red" />
  ...
</threads>

Key points

  1. Most commercial embroidery logos use 6 or fewer colors, so the 15-color default palette is usually enough.
  2. If you want accurate brand/thread colors, always work from an EMB file (not just a machine file).
Info
For more information, contact support@wilcom.com

    • Related Articles

    • Understanding embroidery files

      Embroidery designs are created, edited, shared, and stitched using different types of embroidery files. Understanding the purpose of each file type will help you choose the right format for editing, sharing, and production. Wilcom applications work ...

    • A file exported from Digital Edition File > Export Machine File does not appear on a ZSK machine.

      Problem: Files exported with File > Export Machine File method cannot be seen on a ZSK machine Cause: The issue is caused by the permissions assigned to a file which prevent the ZSK machine reading the file. Workaround: Setup and use Connection ...

    • Fixing machine file Export Failures in Embroidery Studio

      Troubleshooting Repeated Export Failures in Embroidery Studio: A Comprehensive Guide This article addresses the most common concerns raised by users, provides actionable solutions based on real support cases, and offers a structured approach to ...

    • Embroidery Machine Serial Connection Information

      Machine Connections can be handled in a number of ways: 1) If your embroidery machine comes with machine connection software, such as, Ricoma PC Communication Software(EMB_soft.exe) for Ricoma embroidery machine, or "Happy Link" software for Happy ...

    • Embroidery files

      By default, WilcomWorkspace saves to its native EMB file format. This format contains all information necessary both for stitching a design and for later modification. When opening designs created or saved in other formats, WilcomWorkspace converts ...