Design

Design

The <design> element defines a design file to be used or edited. You can also:
  1. Apply a transform (for placement, rotation, etc).
  2. Modify existing lettering or monogram objects within the design (only with editDesign and editDesignTrueview).

XML structure

<design>
      file="logo1.emb"            // Name of the EMB design file
      colorwaytype="specified"    // Colorway type: current, all, or specified
      colorway="White">           // Name of the colorway 
      <transform ... />           // Optional: transform for the design
      <lettering_objects ... />   // Optional: modify lettering objects
      <monogram_objects ... />    // Optional: modify monogram objects
</design>

Attributes

Attribute
Type
Description
file
String
Name of the EMB file. This file must be included in your <files> list.
colorwaytype
String
Determines which colorway(s) TrueView will return:
  1. current (default): Current colorway only.
  2. all: All colorways — ignored by newDesignTrueview.
  3. specified: Use a specific colorway — name it with colorway.
colorway
String
Name of the colorway to use when colorwaytype='specified'.

Child elements

Element
Description
Optional transform for the design. Ignored by designTrueview.
Use with editDesign or editDesignTrueview to modify existing lettering.
Use with editDesign or editDesignTrueview to modify existing monograms.

Remarks

Lettering and monogram changes:
  1. <lettering_objects> and <monogram_objects> are ignored when using newDesign or newDesignTrueview.
  2. They only work with editDesign and editDesignTrueview.
If colorwaytype=’specified’ and no colorway is given:
  1. newDesignTrueview uses the current colorway.
  2. designTrueview returns an error.
  1. EWA design recipe
  2. EWA API methods overview
  3. EWA data packages overview