Simple lettering

Simple lettering

The <simple_lettering> element defines the core lettering parameters, including text content, font (alphabet), size, style (bold/italic), spacing, alignment, and baseline shape.

XML structure

<simple_lettering 
      text="Lettering 1"                    <!-- The text -->
      alphabet_name="London"      <!-- Embroidery alphabet name -->
      height="20.0"                           <!-- Height in mm (5.0–50.0) -->
      bold="false"                              <!-- Bold: true/false -->
      italic="false"                             <!-- Italic: true/false -->
      word_spacing="0.6"                <!-- Word spacing, as ratio of height -->
      justification="centre"              <!-- Multi-line justification -->
      baseline="horizontal"              <!-- Baseline type -->
      baseline_radius="50.0"           <!-- Circle radius in mm -->
      baseline_length="100.0"        <!-- Fixed baseline length in mm -->
      auto_fit_mode="spacing"       <!-- Auto-fit mode for fixed baselines -->
/>

Attributes

Attribute
Purpose
text
The lettering text. May contain multiple lines.
alphabet_name
Embroidery font face (alphabet) name. Must match an alphabet installed with the API.
height
Lettering height in mm (5.0–50.0).
bold
True or false. Makes text bold.
italic
True or false. Makes text italic.
word_spacing
Word spacing as a ratio of height – e.g. 0.6 = 60% of height.
justification
For multi-line text: left, right, centre, or fit (fully justified).
baseline
Defines the text path. Options: horizontal, vertical, circle_cw (circle clockwise), circle_ccw (circle counter-clockwise), horizontal_fixed, vertical_fixed.
baseline_radius
Circle radius in mm (20–1000). Used only for circular baselines.
baseline_length
Length in mm (20–1000). Used for fixed baselines to constrain lettering width/height.
auto_fit_mode
How lettering fits the fixed baseline:
  1. spacing – adjusts spacing only
  2. letter – reduces letter width/height only
  3. letter_prop – proportionally reduces letter width/height
  4. whole – adjusts spacing and letter width/height
  5. whole_prop – proportionally adjusts all

Remarks

  1. Fixed baselines (horizontal_fixed, vertical_fixed) use baseline_length and auto_fit_mode to constrain size.
  2. Circle baselines use baseline_radius.
  3. For standard horizontal/vertical baselines, text size is flexible.

This allows precise control of embroidery text shape, alignment, and size.

Example

<simple_lettering
   text="Custom Text"
   alphabet_name="London"
   height="30.0"
   bold="true"
   italic="false"
   word_spacing="0.5"
   justification="centre"
   baseline="circle_cw"
   baseline_radius="80.0"
/>

    • Related Articles

    • Creating production-ready embroidery lettering

      When selling decorated garments online, it’s not enough to simply let customers type in text and place it on a shirt. Unlike printing, embroidery requires fabric-specific settings to produce good stitch quality. The same lettering will need different ...

    • Reducing the number of trims for lettering

      Symptom: You have found that there are too many trims between letters when stitching on your machine. Solution: If the lettering part in the emb file is the lettering object, then you need to adjust Connectors parameter for the lettering object. This ...

    • EWA API getting started

      These notes guide developers through the initial setup, authentication, API calling structure, and development tools available for integrating the Wilcom Embroidery Web API into web applications. ✅ Step 1: Sign up and get API credentials Visit the ...

    • Embroidery fonts vs printing fonts

      This article is for Embroidery Web API customers and developers, especially those with a printing or graphics background. In printing, fonts are just shapes – easy to scale, resize, or modify because they are made of vectors and pixels. Embroidery is ...

    • Protecting against unsuitable image uploads

      Auto-digitizing (automatic digitizing) converts artwork into embroidery files. The Embroidery Web API uses AI to reduce colors, define objects, and choose stitch types and directions, similar to what a human digitizer would do. ⚠️ Not all images are ...