Copyright (c) 2013-2024 The EmbroiderModder Team
(Under construction, please wait for v1.0 release.)
Libembroidery is a low-level library for reading, writing, and altering digital embroidery files in C. It is part of the Embroidermodder Project for open source machine embroidery.
Libembroidery is the underlying library that is used by Embroidermodder 2
and is developed by The Embroidermodder Team.
A full list of contributors to the project is maintained in
the Embroidermodder 2 github
in the file CREDITS.md.
It handles over 45 different embroidery specific formats as well
as several non-embroidery specific vector formats.
It also includes a CLI called embroider that allows for better automation of
changes to embroidery files and will be more up-to date than
the Embroidermodder 2 GUI.
Libembroidery is documented as part of the Embroidermodder 2.0 manual. If you need libembroidery for any non-trivial usage or want to contribute to the library we advise you read the appropriate design sections of the manual first. Copies of this manual will be shipped with the packaged version of libembroidery, but to build it we use the Doxyfile in the Embroidermodder git repository.
For more basic usage, embroider should have some in-built help starting with:
$ embroider --helpLibembroidery is distributed under the permissive zlib licence, see the LICENCE file.
We're currently trying out some fill techniques which will be demonstrated here and in the script qa_test.sh.
Converts to:
libembroidery and EmbroiderModder 2 use CMake builds so if you are building the project to use as a library we recommend you run:
git clone https://github.com/Embroidermodder/libembroidery
cd libembroidery
cmake .
cmake --build .
cmake --install .This builds both the static and shared versions of the library as well
as the command line program embroider.