Monogram ornament

Monogram ornament

The <monogram_ornament> element defines the ornament set that decorates a monogram. This ornament can be a motif or an embroidery file. It can be repeated in multiple positions around the monogram lettering.

XML structure

<monogram_ornament
      is_motif="true"                                                              <!-- Motif or file -->
      alphabet_name="01Monogram Ornaments"             <!-- Motif alphabet name -->
      name="M001a"                                                            <!-- Motif or file name -->
      width="0"                                                                      <!-- Ornament width (0 = default) -->
      height="0"                                                                    <!-- Ornament height (0 = default) -->
      style="duplicates">                                                      <!-- Ornament style -->
      <transform ... />                                                           <!-- Ornament transform (scale ignored) -->
      <positions>                                                                   <!-- Positions for ornament placement -->
            <position>top_centre</position>
            <position>centre_left</position>
            <position>centre_right</position>
            <position>bottom_centre</position>
      </positions>
      <thread ... />                                                                <!-- Ornament thread -->
</monogram_ornament>

Elements & attributes

Attribute
Description
is_motif
true → ornament is a motif from an embroidery set.
false → ornament is an embroidery file.
alphabet_name
Name of the motif alphabet (ignored if using a file).
name
Motif name or file name.
width & height
Scale the ornament to a specific size in mm. 0 means use default motif size.
style
Layout style for multiple ornaments:
duplicates → repeats same motif as-is.
mirrors → mirrors the ornament for symmetry.
cycle → cycles through available motifs (if multiple).

✅ Transform

Use <transform> to adjust ornament position.
  1. Scale is ignored — use width and height instead.
  2. dx shifts the ornament’s distance from the lettering.
  3. dy is ignored for all positions except centre_centre.

✅ Positions

You can place an ornament in up to 9 positions relative to the lettering. For example, place decorative flourishes on top, sides, or corners.

top_left

top_centre

top_right

centre_left

centre_centre

centre_right

bottom_left

bottom_centre

bottom_right

✅ Thread

The <thread> element defines the thread color and properties used for the entire ornament set.

✅ If using a file

If is_motif=’false’:
  1. name is the filename.
  2. alphabet_name is ignored.
  3. The actual file is provided base64 encoded in <files>.

Remarks

  1. Flexible for frames, flourishes, corner accents.
  2. Supports multiple layout styles.
  3. Thread can match or contrast the monogram.

Example

<monogram_ornament
      is_motif="true"
      alphabet_name="Classic Frames"
      name="FrameA"
      width="20"
      height="20"
      style="mirrors">
      <transform dx="5.0" />
      <positions>
            <position>top_left</position>
            <position>bottom_right</position>
      </positions>
      <thread color="Gold" />
</monogram_ornament>

This defines:
  1. A monogram ornament using the 'FrameA' motif from the 'Classic Frames' collection
  2. Placed in the top-left and bottom-right corners of the design
  3. Sized at 20mm x 20mm, shifted 5mm to the right
  4. And stitched in gold thread.
  1. EWA design recipe
  2. EWA API methods overview
  3. EWA data packages overview

    • Related Articles

    • EWA API capabilities

      Wilcom’s Embroidery Web API (EWA) provides a RESTful interface for integrating advanced embroidery capabilities into web and cloud-based applications. The API exposes functionality for rendering, modifying, and generating embroidery designs using ...

    • 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 ...

    • EWA API overview

      Wilcom’s Embroidery Web API (EWA) is a modern, third-generation web-based software toolkit designed specifically for web developers in the embroidery and apparel industries. It allows businesses to seamlessly integrate professional embroidery ...

    • Supported file formats

      The Wilcom Embroidery Web API supports a wide range of embroidery-specific and artwork input/output formats to ensure compatibility with professional embroidery workflows and machine types. This format support enables seamless integration across ...

    • EWA API technical notes

      Wilcom’s Embroidery Web API is a cloud-hosted, RESTful interface that enables developers to integrate professional embroidery design and personalization features into websites, e-commerce platforms, or internal systems. The API supports rendering, ...