I've noticed that colors when exporting as a CSV file are not "true colors". They appear random like a DST file would.

Also when exporting as a PES, regardless of amount of colors, it defaults to 1 color and it separates them all over the place.

This is not due to the conversion program itself as I export as a CSV within the extension and then use the module by itself via CLI to convert to PES and it holds design integrity.

What about an inset option for fill underlay like the one that is implemented for the satin column?

Some fill shapes are "complex" enough that the underlay may peak through. Or have to drastically make the stitch length smaller on the top stitch, so it can flush out those more complex shapes, which can lead to very dense stitching.

Thoughts?

Hi,

using Inkscape and inkstich on MacOS caused my some trouble. Main issue is, with MacOS comes a historic python at /usr/bin. But many more advanced MacOS users install their tools via brew or Macports, which usually ends up getting a nice, up-to-date python installed, which supports pip and all other features.
But this "good" python is in /usr/local/bin located.

In some of the inkstitch scripts is the header fine to support this (embroider_params.py - "#!/usr/bin/env python").

While others use a hardcoded python path (embroider.py/embroider_update.py - "#!/usr/bin/python" or have no header (embroider_simulate.py).

So I would recommend to use the env... header in all files. It is a simple change, so I think it is faster than using a pull-request.

Kind regards, Thomas

When Params fills in a default value, it should also save that default into the SVG file.

Original comment follows:

When I go to apply the settings for a traveling run stitch, if I use the default ones, it appears on my end, it doesn't add the XML data for the embroidery. Embroider extension itself was throwing an error and it took me awhile to trace it to that. Once I did below, the script worked without fail.

However, if I change it from the default and then apply it, it works. Typically, I do change the default, depending on what I'm trying to do and on what substrate it's going on.

Anybody else experiencing this?

I did confirm that I'm on the latest stable release (I went back to that after I tested the CSV and retaining repeating colors, which the CSV from this file does not retain repeating colors, so I confirmed that it is the stable release and not a regression with a developing release).

It would be good to have some kind of realistic rendering view. Customers of embroidery designers generally expect to see a proof with a simulated view of the embroidery. It may be possible to do something like this using inkscape filters.

Let's add another extension that upgrades inkstitch to the latest version. It would download the latest tarball/zip for the current platform and unzip it on top of itself.

This should work fine on Linux and Mac. Not sure if Windows will balk at replacing the currently-running executable.

By carefully choosing where the needle penetrations fall in each row of a fill, we can create some pretty nifty fill effects. It'd be especially cool if the user could add their own, perhaps with a mini extension to set up a template canvas.

@wwderw How often do you use patterned fill?

It would be useful to be able to set the start and end point for autofill. You can sort of do this now: autofill will start from the point on the border of the fill region that is closest to where the previous stitch was from the last object. But then it just does running stitch around the outer border to where it really wants to start.

There are two challenges here:

• the algorithm itself
  • probably not actually all that hard
• how to handle the UI for choosing the start/end points
  • this may have to be in Params, rather than something you can edit visually in inkscape

How hard would it be to implement the exponent algorithm used in interpolate as a modifier for the stitch spacing for Fill and Satin ?

This would be very usefull for colour blending

image reference page

I was wondering, is there anyway that default directory saved is where the SVG file is also saved? The extension would just know based on where the SVG is saved (now of course, that would mean that the SVG would have to be saved first before any file could be exported, at least I would imagine that would be the case).

Right now from what I can tell it's either saving to the extension directory (if no destination is listed for the Directory) or have to manually set it each and every time.

It also looks like to me that simulate requires the exported file to be in the same directory as the SVG in order to properly work. I think it would help in that regard as well.

Thoughts?

This will augment the documentation and make the UI more discoverable.

All that's necessary is to add tooltip="the tooltip text" to the @param() lines in embroider.py.

Research/find or write a good code of conduct for contributors and add it to the repository. Now that we seem to be picking up some steam, let's ensure that we're all on the same page so that everyone can feel safe contributing.

Potential template: https://gist.github.com/Integralist/4e84af31c483d0f5a182

On selected object:

Step 03 + 06:
I don't know if there a possibility to passing parameters into DialogFillStroke
Step 11:
We have to find out the opposite node (starting from the first), select booth and do a SelectionBreakApart

Edit: Even i don't know if all verbs available in extensions / phython scripts
Edit2: with inkscape devel builds replace StrokeToPath -> StrokeToPathLegacy

This may only affect non-satin Stroke -- will have to check.

This is in regard of #72 Exporting Issues, but I thought I would mention it in it's own issue. Just in case it is separate.

Ok, I think I know what's going on.

The last file that I had posted last night (RE #72 ) has 13 color changes. Only 9 unique changes, meaning the other color changes are using the same color. For instance, I have 2 color blocks that are white. The CSV is only recognizing 1 white color block correctly. The rest it doesn't appear to acknowledge.

Now, I can go in and manually change that in Xed and then use lib-embroidery to convert that out to the file that I need with regard to PES etc.

Is this something that can be corrected in this project or should I put in an issue in the EmbroiderModder project? Or perhaps mention it in the other project anyway?

Simulate sometimes prints spurious warnings to stderr. Suppress them like we do for Params.

original issue description follows:

Getting this warning on simulate

** (embroider_simulate:3696): WARNING **: Error retrieving accessibility bus address: org.freedesktop.DBus.Error.ServiceUnknown: The name org.a11y.Bus was not provided by any .service files

But it shows the simulation apparently ok

Is it too much of a hassle to setup a 32 bit build version of the extension? Same as the current latest version just 32bit version

Is there a way to customize the language of Inkstitch?
Or is this already prepared in the code?
My native language is German and it would be nice (as with Inkscape) to be able to use the UI of Inkstitch in German as well.
Of course I am aware that many technical terms are used in the subject of machine embroidery and these cannot be translated or not easily translated. I also thought more about the ToolTips and/or explanations of their individual settings. Of course I would like to help with the translation, if needed!
Keep coding!

P.S.: Machine: Janome MC350E FW: 1.10 Format: JEF

#31 showed that we have no constraints on values, even when they're so invalid as to break ink/stitch. #44 is just a stopgap; we should enforce correct values in the GUI and in the stitch engine.

In embroidery, there are many terms that have prevailed, as an abbreviation, as a derivative of the sewing area or independent technical terms. Without naming the terms of digitizing.
I initially had some problems to understand something (instructions on the internet, for example).
The translations into German are also a bit strange in some situations. That's why I have to write down these terms. The list is constantly growing, because you dive deeper into the topic.
Note: Cross references are still missing

Machine embroidery terminology and definitions

3D Embroidery / 3D Foam Embroidery :
Also known as Puff Embroidery, is a special technique to give three dimensional appearance to embroidery.
A layer of foam is placed under the area where the design will be embroidered. A high stitch density is
used to cut the foam for easy removal, and the foam beneath the design will not show through.

Aetzing :
The process used to create schiffli laces. The base fabric is dissolved, leaving the threads that have been stitched together to form the lace.

Alignment :
Using Rulers and Templates to correctly mark the position of your design.

Appliqué (APPL) :
Decoration or trimming cut from one fabric piece and stitched to another to add dimension.

Appliqué Outline :
Three lines of stitching around the fabric appliqued:

1. Placement
2. Tack Down / Dieline?
3. Cover

Auto-Digitizing :
Turning artwork into embroidery design with software that does the digitizing for you automatically.
Not recommended!

Back Appliqué :
A fabric piece used behind a design, where the front fabric will be cut away to reveal the fabric beneath it.

Backing / Stabilizer :
Woven or nonwoven material used beneath the embroidered fabric to provide stability and support. Can be hooped with the fabric or placed between the machine's throat plate and the hooped item : Available in various weights and styles.

Basting Stitches :
Long stitches that go around the edge of your hoop & prevents shifting of material during embroidery.

Bean Stitch :
Three stitches placed back and forth between two points. Often used for outlining because it eliminates the need for repeatedly digitizing a single-ply running stitch outline.

Bias :
The direction across a fabric that is located at a 45-degree angle from the lengthwise or crosswise grain. The bias has high stretch and a very fluid drape.

Bias Tape :
Made from fabric strips cut on a 45-degree angle to the grainline, the bias cut creates an edging fabric that will stretch to enclose smooth or curved edges.
You can buy bias tape ready-made or make your own.

Birdnesting / Birds Nest / Nesting :
Thread collection between the fabric and the needle plate, resembling a bird's nest. May be caused by inadequate upper thread tension; upper thread not going through the take-up lever; upper thread not following the correct path; or flagging--the up and down motion caused in part by improper hooping.

Blanks :
Blank emblem shapes for monogrammers or apparel with no embroidery or printing; also refered to as "blank" goods.

Blatt Stitch :
Schiffli term meaning "to feed the yarn", which produces a long zigzag stitch with threads lying close together.

Blending (Gradients) :
A digitizing technique that makes different colors of thread flow together in a more pleasing manner. Relies heavily on variable densities.
Gives a design a more realistic (3D) look.

Bobbin :
Spool or reel that holds the bobbin thread in a sewing machine; this thread forms stitches on the fabric underside.

Bobbin Case :
Unit holding bobbin in a sewing machine.

Bobbin Embroidery :
Designs worked with the fabric hooped facedown and the specialty thread or ribbon wound onto the bobbin : Most effective for simple designs such as leaves and vines, or special effects with threads too heavy to be threaded through the needle.

Bobbin Thread :
Thread used on the bobbin of your embroidery machine. Often sold as a separate thread.

Bonding :
Permanently joining two fabrics together with a bonding agent. Also called heat sealing.

Boring :
Embroidered goods that have been punctured with a sharp pointed tool known as a bore,
the edges of the hole produced by the bore are embroidered, the hole is enlarged by the embroidery.

Buckram / Buckram Lining :
Coarsely-woven fabric stiffened with glue, used to stabilize items for embroidery : Commonly used in caps.

Canvas :
Closely woven heavy hemp, flax or cotton cloth used for tote bags, covers, etc.

Cap Frames :
Specialized embroidery frames designed to hold finished caps for embroidering.
Available in a variety of styles for various machines, with two basic styles being to
sew the finished cap flattened out, or sewing the finished cap (on a tubular machine) in its natural curve.

Card :
Disk containing computerized embroidery designs read by the embroidery machine's computer.

Cartoon :
Finished artwork of an embroidery design to be digitized.

Center Line Input :
When the embroidery software creates a satin stitch around a single line entered by the digitizer.

Center Point :
The center of the embroidery design.

Chain Stitch :
Stitch that resembles a chain link, formed with one thread fed from the bottom side of the fabric. Done on a manual or computerized machine with a hook that functions like a needle.

Check Spring :
Assists in upper thread tensioning and is used to detect upper thread breaks in many embroidery machine models.

Chenille :
Form of embroidery in which a loop (moss) stitch is formed on the top side of the fabric. Uses heavy yarns of wool, cotton, or acrylic.
Created by a chain stitch machine that has been adjusted to form this stitch type.

Cross Stitch :
Two stitches that cross to form an X.

Custom Designs :
Designs created by digitizing artwork or manipulating existing patterns.

Colorfill :
Combination of the Deboss and color, deboss then filled.

Column Stitch :
A series of zig-zag stitches placed closely together to form a column. Also know as a steil stitch or satin stitch.

Complex Fill :
Refers to a digitizing capability that allows areas to be designated as voids at the same time the design's edges are defined.
The design can thus be digitized as one fill area, instead of being broken down into multiple sections.

Condensed Format :
Method of embroidery digitizing where a design is saved in a skeletal form, so a proportionate number of stitches may later be
placed between defined points after a scale has been designated.
If a machine can read condensed format, the scale, density and stitch lengths in a design may be changed.

Deboss / Debossing :
Machine presses a die into the surface of the material, resulting in a depressed imprint.

Denier :
A system of measuring the weight of a continuous filament fiber.
In the United States, this measurement is used to number all manufactured fibers (both filament and staple), and silk, but excluding glass fiber.
The lower the number, the finer the fiber; the higher the number, the heavier the fiber.
Numerically, a denier is the equivalent to the weight in grams of 9,000 meters of continuous filament fiber.
600 vertical threads and 600 horizontal threads that help make a garment more durable and stronger.

Density :
Number of stitches per given area.

Digitizer :
A person who digitizes.

Digitizing :
Conversion of artwork into a series of commands, read by an embroidery machine's computer via a card.

Double Stitched :
The finish on a sleeve and/or bottom hem that uses two needles to create parallel rows of visible stitching.
It gives the garment a cleaner, more finished look and adds durability.

Emboss / Embossing :
A surface effect achieved on fabric by means of passing cloth through a series of engraved rollers that impart figures or designs to its surface. Rollers work through heat and pressure.

Embroidery :
Decorative stitching on fabric.

Embroidery Arm / Embroidery Unit :
The moving part of your embroidery machine used when stitching out an embroidery design.

Embroidery Machine :
A computer controlled sewing machine that can stitch out patterns automatically.

Embroidery Point :
Unit of measurement in embroidery, in which 10 points equals 1 mm.

Embroidery Thread :
Sewing thread design specially for machine embroidery. Most often polyester or rayon.

Emblem / Patch :
Embroidered design with a finished edge, applied to a garment or item after stitching.

Expanded Format :
A design program where individual stitches in a design have been specifically digitized for a certain size.
Designs digitized in this format cannot generally be enlarged or reduced more than 10 to 20 percent without
distortion because stitch count remains constant.

Fabric Glue Stick :
Used in place of spray adhesive to hold fabric or item in place on stabilizer while stitching is started.

Facing :
Material hooped or placed on top of fabric, with a nap or surface texture to contain the nap and hold the embroidery stitches above it.

Fancy Fills :
See Speciality Fills.

Feather Stitching :
Lightweight designs constructed of run stitches. Ideal for tricots, nylons and taffetas.

Felt :
Non-woven fabric made from wool, fur or hair matted together by heat, moisture and pressure. Often used for patches or stitched samples.

Fill Stitch (FS) :
A series of running stitches commonly used to cover large areas. Different fill patterns are created by altering the stitch angle, length or repeat sequence.

Finishing :
Processes done after the embroidery is completed, including trimming loose threads, removing excess facing or backing, and pressing or steaming to remove puckers and hoop marks.

Flagging :
Up-and-down motion of the fabric under the needle action, caused by improper hooping. Results in poor registration, unsatisfactory stitch formation and bird-nesting.

Flat Embroidery :
Embroidery that is framed in hoops, usually exclusively on the top of the embroidery machine's hook assembly.

Float :
Longer-than-normal satin stitches that lay on top of a design, or the stitches made when the needle is disconnecting from the design; later removed.

Foil :
Comes in several colors, with the most popular being red, gold and silver. To use foil, screen print the garment as usual, place the foil over the wet ink, remove the garment from the platen, and cure it with a heat press. The printed and foiled garment can be flash dried before it's removed from the platen, and other colors then can be printed on top of the foil.

FOX Test :
Method of testing thread tension and soundness of timing.
Sew the word FOX in one inch satin stitch block letters.
Examine the reverse side for correctly balanced ratio of one-third bobbin thread to two-thirds top thread.

Frame :
Holding device for inserting the hoop beneath the needle to maintain stability during the embroidery process.

Frame Sash :
Part of the pantograph to hold the frames. Also called a sash.

Free Motion :
Hand-manipulated embroidery done with a zigzag stitch, available on most machines.

Free Standing Lace (FSL) :
Style of embroidery design stitched onto water-soluable stabilizer that is then disintegrated leaving a "thread-only" stitch out.

French Knots :
A stitch featuring a raised, knotted center.

Fringe :
Threads that are cut and hang loosely from the edge of a design.

Frog Stitch :
Tongue-in-cheek references to stitches put in the wrong place. - You have to "rip" them out... "ribbit-ribbit"

Fusible Mesh :
An open-weave stabilizer that is bonded to fabric with heat.

Gapping :
Where the fabric is seen through the embroidery design either in the middle of the pattern or on the edge.

Geflect Stitch :
See Fill Stitch.

Grain :
See Twill Weave.

Grommet :
An eyelet of firm material to strengthen or protect an opening. Often Brass.

Guide Stitch :
Series of stitches used to align embroideries in multi-hooping situations or to assist in fabric placement for appliqué.

H Test :
Method of testing thread tension. Stitch one inch block letters for each needle bar.
The reverse side of the completed embroidery should show a ratio of two-thirds top thread to one-third bobbin thread.

Hand :
The way the fabric feels when it's touched. Terms like softness, crispness, dryness and silkiness are all used to describe the hand of the fabric.

Heirloom Embroidery :
Embroidered goods designed to be passed down from generation to generation.

Hardware :
Computer equipment, digitizer, modem and sewing machine.

Heat 'N Gone :
A topper that dissolves with the heat of an iron.

Hook :
Holds the bobbin case in the machine and plays a vital role in stitch formation.
Making two complete rotations for each stitch, its point meets a loop of top thread at a precisely-timed moment and distance (gap) to form a stitch.

Hook Timing :
Proper synchronization of hook's rotary and needle's up/down movement; necessary to form stitches.

Hole Cutting :
A technique used in digitizing where area under another area is removed.

Hoop :
Wood, plastic or steel device used to tightly grip the fabric and stabilizer between an inner and outer ring; Attaches to machine's frame; Designed to hold fabric taut against the machine bed for embroidery.

Hoop (n) :
A device made from wood, plastic, or steel with which fabric is held in place for machine embroidering.
A frame that attaches to the embroidery unit to hold the fabric taut while stitching.

Hoop (v) :
The process of placing the fabric and/or stabilizer into the embroidery hoop.

Hooping :
Process of putting the stabilizer & fabric in the hoop.

Hoopless Embroidery :
Technique of hooping stabilizer and NOT hooping the fabric or project to be embroidered.

Hooping Board :
Device that aids in precise placement and uniformity in hooping, subsequent garments or items for embroidery.

In The Hoop (ITH) :
A design that stitches out a complete project wihtout un-hooping the fabric.

Interlock Stitch :
Two or more rows of overlapping satin stitches.

Jumbo Rotary Hook :
Rotary hook which holds a bobbin case with a much larger thread capacity than a standard hook.

Jump Stitch :
A stitch that moves the needle from one part of a design to another part. Usually removed after design is finished stitching.

Lettering :
Refers to the embroidery of letters, either made completely with stitches, or a combination of cutout appliqué pieces and stitching.

Line Work (LW) :
There are major 3 types of Line Work :

• Red Work (RW) : Is a single line of stitching done in a red work stitch all in one color.
• Blue Work (BW) : Is a single line of stitching done in a triple bean stitch all in one color.
• Color Work (CW) : Is a single line of stitching done in a red work or triple bean but is done in multiple colors.

Lint Brush :
Use to get the fuzz from under the needle plate on your machine.

Lip Hooping :
Known as recessed hooping, this technique is useful when hooping bulky or slick fabrics such as insulated jackets.

Lock Stitch :
Formed by three or four consecutive short, tight threads stitched at end of embroidery to prevent raveling.

Lock Stitch Machine :
Machine which forms a stitch using a hook and needle. Includes home sewing machines, as well as computerized embroidery machines.

Looping :
Loops on the embroidery surface generally caused by poor top tension or tension problems.
Typically occurs when polyester top thread has been improperly tensioned.

Low Profile Cap :
A cap style with a low slope that is more closely fitted to the head. Can be either structured or unstructured.

Marking :
Making temporary marks on fabric to aid in hoop placement and to reference needle beginning points.

Merrowed Edge :
A merrowed edge is a 3/16" overlocked sewn edge done to secure the cut fabric from unravelling. Usually used for the bottom edge of emblems, pant cuffs or garment interior cut edges.

Metafill :
A needle with an elongated eye, especially useful when using decorative or metallic threads.

Monogram :
Embroidered design composed of one or more letters, usually one's initials.

Moss Stitch :
See Chenille.

Motif :
A single embroidered design.

Nap :
A fuzzy or downy surface of fabric covering either one side or both, produced by brushing

Network :
Links computer, digitizer and embroidery machine together, usually via a modem.

Needle bar :
Bar that holds the needle and regulates the distance to which the needle is driven into the bobbin assembly.

Nippers :
See Thread Clippers.

No-Spray Adhesive :
Use the blue painters tape. Cheaper and less hazardous than spray glue.

Offset :
The ability to move the pantograph out of the design with a specific movement and then return to the original point.
Used for placing appliquès.

Origin :
The starting point of your design.

Overrun :
Specialties produced in excess of the number originally ordered.

Pantograph :
A bar, rack, or holder that frames or holding fixtures are attached to.
The pantograph moves in X and Y directions to form the embroidery design,
controlled electronically or mechanically depending on the machine.

Pattern :
The digitized design.

Pencil Rub / Pencil Transfer :
A low-cost way of producing a "sample" of an embroidery design.
Consists literally of a piece of tracing paper placed over a sewout and rubbed lightly with a pencil to produce an impression of the embroidery.

Piqué :
A fabric of cotton or spun rayon woven lengthwise with raised cords.

Pre-tensioner :
Thread tension assemblies that are before the main tension assembly in the thread path.
The function of the pre-tensioner is to apply a light amount of tension in order to make the main tensioner work.

Presser Foot :
Metal device that touches the goods being embroidered while the needle is in the goods.
The main function of the presser foot is to hold the material being embroidered until the hook point catches the thread loop formed by the needle rise.

Puckering / Pucker :
Result of fabric being gathered by the stitches. Possible causes include loose hooping, lack of or improper backing, incorrect tension or a dull needle.

Puff Embroidery :
Stitching a dense motif over embroidery/craft foam to create a three-dimensional effect.

Punching :
See Digitizing.

Push and Pull :
The distortion of design elements caused by the interaction of the needle, thread, backing and machine tensions.
In most cases the element and/or the fabric are causing either push or pull, but not both.
The exception to this rule tends to be in satin stitch columns, whether in a letter, outline or otherwise.
Satin columns can pull in on the ends (thus reducing column width) and push out on the sides (thus increasing column length).
To counteract these distortions, digitizers use a technique call Compensation.

Push-Pull Compensation :
Fine-tuning digitizer includes in a design to prevent thread direction from affecting design symetry.

Registration :
Correctly aligning all stitches and design elements.

Repeat :
Layout used for making emblems or designs on a fabric span that are repeated at regular intervals.

Resizing :
The ability to scale a design to different sizes; May cause density problems unless stitch count can be altered.

Running Stitch :
A single stitch between two points, used for outlining and fine detail.

Satin Stitch :
Formed by closely arranged zigzag stitches; Can be stitched at any angle and with varying lengths.

Short Stitch :
A digitizing technique that places shorter stitches in curves and corners to avoid an unnecessary bulky buildup of stitches.

Software :
Computer programs or design cards.

Specialty Fill :
Fill stitch capability that produces a design in relief.

Specialty Threads :
Threads designed for effects such as shine, glitter, iridescence or thickness. The threads often are made from synthetic materials including rayon, mercerized cotton, metallic and textured nylon.

SPI :
Stitches per inch.

SPM :
Stitches per minute.

Spray Adhesive :
Used for holding fabric in place when doing applique and in the hoop projects.

Stabilizer :
See "Backing" and "Facing".

Stitch Processing :
The calculation of stitch information by means of specialized software, allowing scaling of expanded format designs with density compensation.

Steil Stitch :
See Column Stitch.

Stock Designs :
Embroidery designs readily available on disks or brand-specific cards.

Swatch :
A small sample of material used for inspection, comparison, construction, color, finish and sales purposes.

Swiss Embroidery :

• Satin stitch embroidery.
• Also recalls the origins of an automated embroidery machine that was developed in the 1800s by Isaak Groebli. Embroidery remains a government-supported industry in Switzerland today.

Tack Down Stitch :
Line of stitches that hold applique material in place on top of bacground fabric.

Tackle Twill :
Letters or numbers cut from polyester or rayon twill fabric that are commonly used for athletic teams and organizations.

Take-up Spring :
See Check Spring.

Tatami Stitch :
Series of run stitches, commonly used to cover large areas. Different fill patterns can be created by varying the stitch length, angle or sequence.

Tear-Away :
A type of stabilizer that can be easily torn to remove excess after embroidery is finished stitching.

Template (Digitizing) :
When opening artwork to digitize you use the artwork as a guide or "template" for the design.

Template (Embroidery) :
Print out of your design on paper used to help with determining proper design placement on fabric.

Tension :
Tautness of thread when forming stitches. Top thread tension, as well as bobbin thread tension, needs to be set.
Proper thread tension is achieved when about one third of the thread showing on the underside of the fabric on a column stitch is bobbin thread.

Tensioner :
Device used to adjust the tautness of thread when forming stitches.

Thread :
Fine cord of natural or synthetic material with two or more elements twisted together and used for stitching.
Machine embroidery threads come in :

• Rayon (high sheen)
• Cotton (duller finish)
• Polyester (strong and colorfast)
• Metallic (synthetic core wrapped with metal foil or thin slivers of metal foil)
• Acrylic (sheen similar to rayon).

Thread Clippers :
Small cutting utensil with a spring action that is operated by the thumb in a hole on the top blade and the fingers cupped around the bottom blade.
Useful for quick thread cutting, but unsuitable for detailed trimming or removal of backing.

Tie In Stitches :
Small stitches used at the beginning of a sewing cycle, particularly on satin stitches, to prevent the thread from pulling out of the embroidery.

Tie Off Stitches :
Small stitches, usually about 1 mm in length that “lock” the stitches in the fabric to prevent the stitch from unraveling when the thread is trimmed.
Without Tie off stitches the thread can potentially unravel and destroy the embroidery.
They are particularly necessary when making satin stitches wider than 1.2mm, as satin stitches have a tendency to unravel more easily than running or fill stitches.

Topper / Toppping :
A thin material placed on top of fabric to hold down nap. Usually designed to wash out.

Trapunto :
A form of 3D embroidery. An area is stitched to create a pocket between the fabric and backing, which is then stuffed from the back with some type of fluffy filling.

Trimming :
The action of cutting loose thread, removing backing, etc., from the final embroidered product.

Tubular Embroidery :
Embroidery produced on an embroidery machine which allows tubular fabric or pre-assembled garments to be placed around the hook assembly. Allows sewing of the front of a garment without sewing through the front and back of it.

Tulle :
A fine net of acetate, nylon, rayon or silk used for the embroidery of imitation laces.

Twill :
Characterized by a diagonal rib. Twill weaves are used to produce a strong, durable, firm fabric usually cotton or polyester.

Twill Weave / Grain :
A basic weave in which the fabrics are constructed by interlacing warp and filling yarns in a progressive alternation which
creates a diagonal effect on the face, or right side, of the fabric.
In some twill weave fabrics, the diagonal effect may also be seen clearly on the backside of the fabric.

Two-ply Stitch :
A double running stitch. The stitch is formed by the machine sewing a complete running stitch area and then coming back over the same area and stopping where it started. Sews from Point A to Point B and then from Point B to Point A.

Underlay :
Used under the regular stitching in a design. The stitches are placed to provide stability to the fabric and to create different effects.
Underlay is normally a series of running stitches or a very light density fill often placed in the opposite direction that the stitching w/ill go.

Underlay Stitch :
Stitches, laid down before other design elements to help stabilize fabrics.

Variable Sizing :
Ability to scale a design to different sizes.

Verify :
Sample sewout or print-out of a new embroidery design to make sure the pattern is correct.

*Walk Stitch :
See Running Stitch.

Wash-Away :
A type of stabilizer that can be removed by rinsing project after design is stitched out.

Water Soluble Stabilizer (WSS) :
A stabilizer that melts when exposed to water.

Zig-Zag :
Stitches that progress in an alternating-angle (zig zag) fashion; typically used for final stitching on appliqué and tackle twill.

@wwderw, would it be useful to be able to File -> Open embroidery files? Of course you'd only be able to edit them stitch by stitch, but you could move, resize (within reason) and add other inkstitch-supported objects to build on an existing design.

Is this a good idea, or not something you'd have much occasion to make use of?

Since we have l10n support, error messages are no longer displayed.
If a Object/Path has different number of nodes, nothing happens.
Even if I change inkscape to english.
Can anyone confirm this?

An option for satin columns to split the column into several side-by-side columns. Inkstitch would just divide each normal satin stitch into X equal stitches.

description of bean stitch: https://www.mrxstitch.com/bean-stitch/

Right now, the Simulate version of the extension only seems to work with the CSV format.

Since the addition of libembroidery convert directly to the extension, I would imagine the CSV format in most instances (other then for testing/debugging of functions in stitch files) would be skipped in place for machine files.

Is it possible to have Simulate run a simulation of say a DST, PES file etc?

The simulation is severely cropped to the stitches, making it hard to see running stitch that's right along the top (for example). Add a border of white so that it's easier to see the design.

I first want to say I'm glad that I found this project. I've been a freelance digitizing for many years (23.5 yrs now), running Wilcom mainly, and it was hard to find open source programs that had a good feature set.

I've tried Thred (limited due to the time period it was written, although being able to work with the CSV version of the THR file helped improve that to some degree), embroiderymodder was too alpha, so I've always had to stick with Wilcom and VM Windows on my Linux boxes.

I've tried the extension for a few days and I'm liking what I've seen. Just wanted to see if a few things were possible. I wish I could code to try to do myself, but I'm an idiot when it comes to coding.

1. With regard to the python scripts, is there anyway to install those scripts without having to install everything else to grab those dependencies? I try to run as lean of an install as I can and since I have no use for pip and the like elsewhere since I'm not a developer and just uninstalling those other programs doesn't give back a lot of space.

Is there anyway to bundle them in within the extension itself? As a non coder, I don't know if that's possible or not. Just making the extension as portable as possible would be my way of thinking.

With regard to the function of the extension:

2. Is there anyway that we can set it up to where we can insert functions in specific objects. Trim, stop, jump, drop sequin (I do have a sequin attachment on one of my machines) etc?

3. Is there any way we can have the option of making a vector fill object either a fill stitch or satin stitch. Some of the more complex turning satin stitches won't easily be done with just using strokes to tell it to do a satin stitch. Strokes wouldn't have the same ability as a fill stitch, but it also has to be able to handle multiple angles, not just the static one angle (hence being called turning satin stitches).

4. Also is there way to have an option for both RGB color values and a generic color name as well for a stitch list? I'm thinking more as a freelance digitizing and those that use DST files, I have to send a stitch chart out to my customers.

Possible or is my coding ignorance really showing itself here?

Thanks again for a wonderful extension and glad to see that it's still active.

I am getting the following error using a MacBook Pro with High Sierra 10.13.2 Python 2.7.14 :: Anaconda custom (64-bit)

Traceback (most recent call last):
File "embroider.py", line 31 in
import shapely.geometry as shgeo
Import Error: No module named shapely.geometry

This is wierd because I tried importing shapely.geometry in a python console and I had no problem importing it. I tried doing the same from the directory that Inkscape is launched from Applications/Inkscape.app/Contents/Resources/bin/ with no problem

Python 2.7.14 |Anaconda custom (64-bit)| (default, Oct 5 2017, 02:28:52)
[GCC 4.2.1 Compatible Clang 4.0.1 (tags/RELEASE_401/final)] on darwin
Type "help", "copyright", "credits" or "license" for more information.

import shapely.geometry as shgeo

gave no errors.

Swapping the stitch order of a Satin Column is possible, but it's a pain and you lose all of your embroidery parameter settings. It should be pretty easy to write an extension to swap the order. Later on, this extension could be turned into a more generalized tool to set the starting/ending points for all kinds of embroidery objects, not just satin columns.

original issue description follows:

I know we can't on the fly change start/end points of various embroidery objects. However, given that we can predict run stitch start and end points due to the 1st and last node, could we do the same thing with SatinColumns?

Given the attached:

Do you think that would be possible? Just something to help predict start/end points. I don't necessarily know how we would be able to get it done for fills, but if we can help predict start/end points that would preclude the need to be able to have on the fly editing abilities for start/end points.

I know I used a simple shape for this example, but this should be able to be applied to any SatinColumn object regardless of shape (just so long as it doesn't confuse the extension for rendering stitches).

When I run the Embroidery extension:
Embroider.. works
Params gives me the following error:

Traceback (most recent call last):
File "embroider_params.py", line 618, in
e.affect()
File "/Applications/Inkscape.app/Contents/Resources/share/inkscape/extensions/inkex.py", line 283, in affect
self.effect()
File "embroider_params.py", line 592, in effect
frame = SettingsFrame(tabs_factory=self.create_tabs)
File "embroider_params.py", line 316, in init
self.preset_chooser = wx.ComboBox(self, wx.ID_ANY, style=wx.CB_SORT)
wxAssertionError: C++ assertion "!(style & wxCB_SORT)" failed at /Users/robind/projects/buildbots/macosx-vm6/dist-osx-py27/Phoenix/ext/wxWidgets/src/osx/combobox_osx.cpp(60) in Create(): wxCB_SORT not currently supported by wxOSX/Cocoa

Is there sometime a "real" makefile / setup.py / cmake filelist?
Given other distributions and operating systems, compile inkstitch natively would be great.
Most dependencies are required by Inkscape itself, for compiling you would have to install the development packages. I'm not a friend of static builds, so my question as an feature request.
I can build packages for RPM-based distributions, unfortunately I don't know enough about it in the "Python World". Is there a setup.py or a cmake template for Python modules/packages somewhere?

We're using an outdated version of wxPython in the Linux build. 4.0.1 contains some fixes that may be relevant, including one that may even mean we don't have to specify the LD_LIBRARY_PATH in bin/build-dist anymore.

original issue text follows:

.travis.yml:

58      # wxPython doen't publish linux wheels in pypi
59      wget https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-14.04/wxPython-4.0.0b2-cp27-cp27mu-linux_x86_64.whl
60      pip install wxPython-4.0.0b2-cp27-cp27mu-linux_x86_64.whl

You don't need wget to download .whl, so you can use pip for it:

58      # wxPython doen't publish linux wheels in pypi
59      pip install https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-14.04/wxPython-4.0.0b2-cp27-cp27mu-linux_x86_64.whl

requirements.txt:

01 backports.functools_lru_cache
02 wxPython
03 networkx
...

To:

01 backports.functools_lru_cache
02 https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-14.04/wxPython-4.0.0b2-cp27-cp27mu-linux_x86_64.whl
03 networkx
...

This works for me (fedora 27 x86_64).

You should also replace the wheel file to the latest version of wxPython (4.0.1):
https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-14.04/wxPython-4.0.1-cp27-cp27mu-linux_x86_64.whl
Some changes:
This release is a quick hot-fix of some issues discovered in 4.0.0 just after the release, plus a bit of low-hanging fruit that was easy to squeeze in too. Changes in this release include the following:

A fix for a segfault that happens upon startup on newer linux releases. (#648)

Set LD_RUN_PATH for the wxWidgets part of the build so the wx libs that are loaded by other wx libs can be found successfully. (#723)

Use wxApp::GetInstance to check if there is an existing wxApp object. (#720)

We have shortcut keys now:

• + or =: speed up
• -: slow down
• r: restart animation
• q: close

Make these more obvious, preferably with buttons with tooltips that mention the keyboard shortcuts.

Right now my fork has 1mm hardcoded to 10 pixels. This works fine if you're aware of it but it's confusing because the units in the Inkscape UI are incorrect.

It'd be better to use whatever units/DPI the document has set. For my existing files, I can just set my document to the somewhat bizarre 10 ppmm (about 254 DPI) and be done with it. This will have the added benefit of being able to properly use the ruler tool.

I tried getting this to run on my little raspberrypi because of my difficulty running it on my Mac. I got an error installing Shapely. Here is the output:
pip install -r requirements.txt
Downloading/unpacking backports.functools-lru-cache (from -r requirements.txt (line 1))
Downloading backports.functools_lru_cache-1.4-py2.py3-none-any.whl
Downloading/unpacking wxPython (from -r requirements.txt (line 2))
Downloading wxPython-4.0.1.tar.gz (67.9MB): 67.9MB downloaded
Running setup.py (path:/tmp/pip-build-2D4GjI/wxPython/setup.py) egg_info for package wxPython

no previously-included directories found matching 'docs/sphinx/build'
warning: no previously-included files matching '.git' found under directory 'wx'
warning: no previously-included files matching '*.pyc' found under directory 'wx'
warning: no previously-included files matching '__pycache__' found under directory 'wx'

Downloading/unpacking networkx (from -r requirements.txt (line 3))
Downloading networkx-2.1.zip (1.6MB): 1.6MB downloaded
Running setup.py (path:/tmp/pip-build-2D4GjI/networkx/setup.py) egg_info for package networkx

warning: no files found matching '*.html' under directory 'doc'
warning: no files found matching '*.css' under directory 'doc'
warning: no previously-included files matching '*~' found anywhere in distribution
warning: no previously-included files matching '*.pyc' found anywhere in distribution
warning: no previously-included files matching '.svn' found anywhere in distribution
no previously-included directories found matching 'doc/build'
no previously-included directories found matching 'doc/auto_examples'
no previously-included directories found matching 'doc/modules'
no previously-included directories found matching 'doc/reference/generated'
no previously-included directories found matching 'doc/reference/algorithms/generated'
no previously-included directories found matching 'doc/reference/classes/generated'
no previously-included directories found matching 'doc/reference/readwrite/generated'

Downloading/unpacking shapely (from -r requirements.txt (line 4))
Downloading Shapely-1.6.4.post1.tar.gz (224kB): 224kB downloaded
Running setup.py (path:/tmp/pip-build-2D4GjI/shapely/setup.py) egg_info for package shapely
Failed CDLL(libgeos_c.so.1)
Failed CDLL(libgeos_c.so)
Traceback (most recent call last):
File "", line 17, in
File "/tmp/pip-build-2D4GjI/shapely/setup.py", line 80, in
from shapely._buildcfg import geos_version_string, geos_version,
File "shapely/_buildcfg.py", line 167, in
fallbacks=['libgeos_c.so.1', 'libgeos_c.so'])
File "shapely/_buildcfg.py", line 161, in load_dll
libname, fallbacks or []))
OSError: Could not find library geos_c or load any of its variants ['libgeos_c.so.1', 'libgeos_c.so']
Complete output from command python setup.py egg_info:
Failed CDLL(libgeos_c.so.1)

Failed CDLL(libgeos_c.so)

Traceback (most recent call last):

File "", line 17, in

File "/tmp/pip-build-2D4GjI/shapely/setup.py", line 80, in

from shapely._buildcfg import geos_version_string, geos_version, \

File "shapely/_buildcfg.py", line 167, in

fallbacks=['libgeos_c.so.1', 'libgeos_c.so'])

File "shapely/_buildcfg.py", line 161, in load_dll

libname, fallbacks or []))

OSError: Could not find library geos_c or load any of its variants ['libgeos_c.so.1', 'libgeos_c.so']

Cleaning up...
Command python setup.py egg_info failed with error code 1 in /tmp/pip-build-2D4GjI/shapely
Storing debug log for failure in /home/pi/.pip/pip.log

I thinking that with this latest official release, I thought it might be worth seeing if we are able to do the same thing with the Windows and Mac platforms like Linux and create a portable release?

It might make things more accessible to a much wider audience (especially since the majority of digitizers that I'm aware of using Windows (although I do know a few that use Mac with Windows VM'ed and have both Mac digitizing software (mainly Embrilliance) and Windows software (mainly Wilcom)).

The only viable (that I'm aware of) open source software for Windows is Thred and it just doesn't compare.

Thoughts?

The new-style satin with rungs isn't in the README, although there's an example: https://github.com/lexelby/inkstitch/blob/master/images/satin_column_rungs_example.svg

from @wwderw in #24:

might want to think about a batch exporting function as well. When I do my stock designs, I usually have to save in Wilcom one at a time in the individual format.

Apparently, I'm unable to generate a satin column used Embroider. If I want to generate any satin stitching, I go into XML editor and I change True to False for the Satin Column setting and then it generates.

I'm hoping that Satin Column allows for more editing of the shape (think turning satin stitching that I mentioned awhile back). I however, am unable to use the "reshape tool" to make any changes to the overall shape of the satin stitch when I change that XML setting from True to False, it's static.

Also, how is the changes of the shape done with the node tool? Is it at the individual stitch level or can it be broader then that?

After the column satin has gone through the reshape process, what would be the way of updating that info? Is it already accounted for in the XML data or how exactly is it applied?
Satin Test.zip

Some machines have a sequin dispenser that allows the specification of placement for sequins in the design file. We'd like to be able to support this in Ink/stitch.

TRIM and STOP have been implemented already. Here's the original description of this issue for historical purposes:

It would be very useful to be able to add instructions like TRIM, STOP, or SEQUIN (drop a sequin, supported by certain machines). Some questions are up in the air, such as:

• does libembroidery/embroidermodder support all of these?
• what should the UI look like?

For home embroidery machines, we can kind of get away with no tie-in or tie-off stitches. But for commercial embroidery with trimming and multiple needles, tie stitches are a must. It'd be cool if the user could just check a box for tie-in and another for tie-off to have the tie stitches generated automatically. Another option would be to automatically tie off after a TRIM and tie-in on the next object.

@wwderw How would you expect tie-in and tie-off to be generated by the software? I'm thinking it could generate the stitch plan for the object first, then add tie-in or tie-off stitches after. For tie-off, it could back-track along the stitch plan and then forward again. For example, if you number the stitches for a 100-stitch object "... 97 98 99 100", then it could repeat the last couple: "... 97 98 99 100 99 98 99 100". In fact, very early versions of the old inkscape-embroidery project did exactly this.

Another option would be to backtrack along the direction of the stitch plan, but only go a set number of millimeters. Is that preferable?

For tie-in we could just do the reverse of what we pick for tie-off.

When we hit embroider, the generated onscreen paths is what is being sent to the machine file right?

Would it be possible to have a stitch as is option, where the points were exported as they are draw?

Would it be possible to use the preview layer manually tweek the Stitches and then use this new embroid-as-is check box?

I was wondering, what about putting the portable stable release for Linux OS on Inkscape's AddOn page of their website?

That might get more people over to here and maybe get someone that can do builds for Windows and Macs to have parity with the Linux build.

Thoughts?

I was just wondering. I know the designs start at the top left by default.

And that's fine for most flat substrates (shirts, totes, fabric swatches etc), but for designs going on hats, is there way that we could, for instance, have an option box that would tell libembroidery (I would assume libembroidery would handle this as it's whats spitting out the file, maybe this is to be handled by the extension itself, if that makes it any easier) to zero in on the center of a design versus the top left?

Ideally, later on, it would be good to be able to do this user defined, in case doing a "wide format" hat design, but it only goes on the center of the hat and on one of the sides. However, when tracing the design, we would want it to start and end on the center of what's going on the front of the hat.

Thoughts on the feasibility of that?

In traditional embroidery software, occasionally it's useful to be able to enter "manual stitch mode", which lets you specify the exact position of each stitch. In Inkstitch, this would probably be a path with straight line segments and each node being one stitch.

Would like to have the ability to see stitch info.

A couple of places that I think could show up, just depends on what's doable. Ideally, it may not be bad to have all of them, but it does depend on what's doable.

1. Within the XML editor itself. Along with all the other individual embroidery parameters for each layer. Here though, for us, it might be better to have just the last stitch number in the XML info. That way we know that if we want to do 3 jump stitches in a row (which translates to a trim on most machines) we want to put it after this stitch number.

This would have to be able to live update if the stacking order changes. At least in my mind, it should, thoughts on that?

2. In the Simulate module, have the information displayed on the bottom of the player that shows progression (stitch x out of xx etc), play/pause, fast/slow etc

Something so that way we can get the actual stitch number of where we want to put in those individual commands. This could also be done for any other commands that we would want to input at the individual stitch level, just so long as it's supported within the conversion program libembroidery-convert from the embroidermodder project.

Ideally, would like to have an option within the Embroider module that allows for ticking a box (which activates sub options, 1 for approval sheet (Realistic Rendering of the design) and 2nd for the color blocks of the design (the colors used might actually be easier to do, if it is pulled from the layer names, of course, that would mean that the layers would have to be named as colors for that to work). Size and stitch count would also be nice to have on the approval sheet.

See attached PDF that is generated within Wilcom's TruSizer program.

EmbroiderModder has some basic functionality of this with their print to PDF (see attached for that one, I did remove the grid and ruler from the printout). It does allow for realistic rendering.

One workaround to this issue that I can think of, which wouldn't affect InkStitch, is to bring the CSV file into embroidermodder, get that image. Then get the individual layers from Inkscape and plug those into a Scribus template and then do a Print to PDF from there.
Printout Samples.zip

It would be useful to be able to include color names (not just RGB values). This would show up in two places: the PDF printout (#18) and directly in the embroidery file (for formats that support this).

This could be done either through direct entry of color names in Params or by using thread palettes. If the latter, Ink/stitch would look at the RGB value, find the nearest color in the thread palette, and use that name.

A couple of thread palettes to run in Inkscape.

One, I found the RGB values on their website, the other, I had to pull from an existing thread chart.

I thought having these would help with the PDF print out portion, if we are able to retrieve this info from the palette. I know in the XML data, it only references the HTML bit, is there anyway that we could reverse that when doing the print out? If the PDF printout is a feasible function.
Thread Chart.zip

I don't know if this before 1.2.0:
institch/bin/share/icons and institch/bin/share/themes packaged in the last release.
Is that what we want, or is it an accident?