Autodigitize Documentation
Description
You can create embroidery from vector or bitmap images
Format
Autodigitize/[path]?[parameters]
For example: Autodigitize/MySubdirectory/MyImage.PNG
-
Supporting Formats
- Bitmap images(*.bmp;*.jpg;*.tif;*.pcx;*.mac;*.pcd;*.tga)
- Vector images(*.cdr;*.cmx;*.emf;*.wmf;*.eps;*.ai)
- Adobe Illustrator (AI)(*.ai)
- Postscript (EPS)(*.eps)
- Windows Metafiles (EMF,WMF)(*.emf;*.wmf)
- Windows Bitmaps (BMP)(*.bmp)
- JPEG Images (JPG)(*.jpg)
- PNG Images(*.png)
- TIF Images (TIF)(*.tif)
- PCX Images (PCX)(*.pcx)
- MAC Images (MAC)(*.mac)
- PhotoCD (PCD)(*.pcd)
- TARGA (TGA)(*.tga)
Working with Files
Parameters
- Autodigitize Note: The image must be uploaded using the Upload action of the API
- GenerateBackground - True/False value whether or not to generate the background of the embroidery as stitches. Default is false.
- StitchInnerBackground - True/False value whether or not to stitch the inner areas of the background. Default is false.
- IgnoreSmallAreas - True/False value whether or not to ignore the small areas of background. Default is false.
- UseImageDimensions - True/False value whether or not to include the image size in the size of the final image. Default is false.
- CreateSatinAndSteil - True/False value whether or not to create satin and steil segments. If False, complex fill segments will be created instead. Default is true.
- CenterResult - True/False value whether or not to center the result around (0,0). If False, the result will have the top left corner at (0,0). Default is false.
- AddSteilBorders - True/False value whether or not to add steil borders to large complex fill segments. Default is false.
- MatchThreadChart - Name of a thread chart that should be used to color match threads for the final design. If empty, RGB values that match the image colors will be used.
- BackgroundColor - True/False value that specifies which colour in the image is considered to be the background when deciding whether or not to stitch it. Default is false.
- BackgroundColor Note: If true and the following values aren't not specified than the max value for RGB will be assumed being 255.
- BackgroundColor Note: Requires GenerateBackground set to True.
- BackgroundRed - 0-255 value for Red for the BackgroundColor. Default is 255 if BackgroundColor is True.
- BackgroundGreen - 0-255 value for Green for the BackgroundColor. Default is 255 if BackgroundColor is True.
- BackgroundBlue - 0-255 value for Blue for the BackgroundColor. Default is 255 if BackgroundColor is True.
- MaximumRunWidth - Value in embroidery points to override the default outlined below
- MaximumSatinWidth - Value in embroidery points to override the default outlined below
- MaximumSteilWidth - Value in embroidery points to override the default outlined below
- By default, segments will be digitized as follows:
- Width Segment type applied
- 1–5 points Run Stitch
- 6–15 points Steil Stitch
- 15–70 points Satin Column
- 70 points or wider Complex fill
- Overrides for segement widths based on type
- NumColors - Is the number of colours in the palette
- The original colors of the image (RGB) will be used and closely matched to a palette
- Setting the value of NumColors to a value less than the original number will automatically attempt to select the best color for each reduced thread
- Setting the value of NumColors to a value more than the original number will cause an exception
-
SequenceType - Adjust the sewing sequence. Valid values are:
- stNone
- stMinimizeColorChanges
- stMinimizeJumps
- stSmart
- Smart sequencing is a option that preferentially moves narrow border stitches later in the sewing sequence, so that the sew on top of large complex fill areas, rather than the other way around.
- Default is stMinimizeColorChanges
-
TrimType - Adjust the trim settings. Valid values are:
- ttNever
- ttAlways
- ttTrimAt
- The system will place a trim if the distance between stitches is longer than the distance displayed in the Trim At box.
- Default is ttAlways
-
LockType - Adjust the lock stitch settings. Valid values are:
- This stitch is formed by three or four consecutive stitches of at least a 10 point movement. It should be used at the end of all columns, fills and any element where a trim will follow, such as color changes or the end of a design.
- ltNever
- ltAlways
- ltAroundTrim
- Default is ltAroundTrim
- TrimThreshold - Distance between segments to perform a trim.
- FinalWidth - Width in embroidery points for resizing the image before autodigitizing.
- FinalHeight - Height in embroidery points for resizing the image before autodigitizing.
- ProportionalResize - True/False value whether or not to resize the image proportionally.
- Default is True.
- If False, the width and height will be changed independently, according to the FinalWidth and FinalHeight parameters.
- If True, the image will be resized proportionally, fitting both the FinalWidth and FinalHeight parameters.
- TimeoutSeconds - The maximum time, in seconds, to wait for the autodigitizing process.
- The default is 60 seconds.