CrochetPARADE

×

About

CrochetPARADE (Crochet PAttern Renderer, Analyzer, and DEbugger) is a platform that allows users to create, visualize, and analyze both 2D and 3D crochet patterns.

OVERVIEW

CrochetPARADE uses a custom language grammar that allows users to define stitches and stitch patterns. The CrochetPARADE grammar aims to ensure accuracy and precision in the crochet pattern instructions, avoiding the ambiguities encountered with instructions in plain English. The code parses and checks any user provided pattern for correctness and then creates a virtual model of the project, which is then rendered in 3D.

After rendering a pattern, users can review ('debug') the final project's shape and make adjustments. The platform identifies overly loose or tight stitches, enabling users to replace them with more suitable ones before crocheting, thus reducing the need for blocking.

CrochetPARADE's export feature allows users to export an automatically generated crochet chart of their project using standard crochet symbols. One can also export an SVG image that shows stitch connections and identifies stitches by their type, row number, and position within a row. The SVG pattern shows the same information as standard crochet diagrams and can be used as an alternative guide when crocheting. Users can also export projects to 3D files that can be imported in Blender for further manipulation and visualization.

CrochetPARADE includes interactive features such as the ability to rotate, zoom, and pan the 3D view, as well as animating the pattern creation process, which can help in visualizing how stitches attach to each other. Additional features include highlighting and hiding selected stitches, and changing yarn thickness and color. Users can access stitch information by hovering over stitches in the 3D view.

CrochetPARADE performs all calculations locally on your device, ensuring that no data is collected to a central server or transmitted over the internet. As a side effect, the platform can be sluggish on old hardware. Models of patterns involving (tens of) thousands of stitches can take minutes or more to calculate.

GOALS AND POSSIBLE APPLICATIONS

The main goal of CrochetPARADE is to facilitate crochet project design and execution.
Patterns created with CrochetPARADE can be easily shared, ensuring they are free from ambiguities or typographic mistakes. Creators can simply copy and paste the pattern text to share it, and others can use the CrochetPARADE platform to render the shared text into a model of the pattern exactly as intended by the pattern author.
CrochetPARADE can be used in education to teach crocheting but also programming skills, since the CrochetPARADE grammar follows rules similar to those of real programming languages.
The virtual models created by CrochetPARADE can be imported in 3D modelling and CGI software. Picture an animated movie where characters wear crochet hats and sweaters that match real-world crochet projects.
It is probably inevitable that the grammar along with the renderer can allow AI to learn how to write correct crochet instructions of complicated patterns (beyond simple amigurumi) based on general project descriptions.

LICENSE AND COPYRIGHT

The website and all of its computational components are free and open source and are released under the GPLv3 license. This ensures that the platform will be free and open to all in perpetuity.
The showcase patterns are either in the public domain (as specified in the pattern description) or are created by the author and are released in the public domain.
The user manual which includes a description of the CrochetPARADE grammar is released under the Creative Commons BY-NC-SA license. The grammar itself cannot be copyrighted and, as any language, is in the public domain.

ACKNOWLEDGEMENTS

CrochetPARADE uses the following libraries: SVG.js, three.js and PrismJS.

AUTHOR

Svetlin Tassev (2023)

×

Key bindings

General shortcuts.

ctrl+l: Toggle layouts.

Shortcuts in the text input area.

shift+Enter: Calculate positions of all stitches.
ctrl+Enter (experimental!): Keep positions of already placed stitches. Then calculate positions of newly added stitches since last calculation. Speeds up calculation, but results will be poorer than rerunning whole calculation by pressing on "Calculate..." button or pressing shift+Enter.
ctrl+r (experimental!): Same as the previous one, but recalculates only the positions calculated last time the calculation was run. So, it undoes the last calculation and restarts the calculation with the new stitches only. Speeds up code, but will lead to poorer results than rerunning the whole calculation again.

Shortcuts in 3D view. To activate, click on the 3D canvas first.

left click and drag: Rotate view.
scroll wheel: Zoom.
(right click and drag) or (shift and left click and drag): Pan view.
a: Show stitches one by one.
ctrl+a: Hide stitches one by one.
c: Show project colors. Gray is default if no colors are specified.
esc: Reset visibility and colors of stitches.
ctrl+esc: Hide all but the first stitch.
ctrl+f: Highlight row (by entering: row number) or stitch (by entering: row number, stitch number).
ctrl+d: Highlight stitch or group of stitches with a specific label. One can also select a collection of labels if any. As an example, a collection of labels may be called 'c[ , ]' and if selected, it will highlight all stitches having labels such as 'c[0,1]', 'c[1,2]', etc. with a whitespace being a placeholder.
ctrl+h: Hide after row or stitch.
ctrl +/-: increase/decrease radii of spheres and cylinders. Affects exported GLTF file as well.
i: Toggle visibility of stitch information box.
shift+left click: Toggle persistence of stitch information box.
p: Write crochet chart to SVG file. For 2D projects, it shows a face-on view. For 3D projects, it shows an orthographic projection from the current view.
r: Rotate view automatically.
o: Rotate view a tiny amount and save crochet chart SVG corresponding to that view (only for 3D models!). Repeatedly pressing o leads to saving multiple charts for different views while model is rotating. Useful for creating videos of rotating 3D crochet charts. Resolution is specified only the first time key is pressed.
s: Highlight over/under-stretched stitches. Blue for stitches that are too loose, and red for stitches that are too stretched (by more than about 15%) relative to their baseline height. The rest are shown in gray.
v: Toggle visibility of arrowheads.

×

Built-in stitches and special commands

Stitch Name	Description
`ch`	Chain stitch, the foundation for many crochet projects
`ss`	Slip stitch, used to join rounds or move across stitches without adding height
`sc`	Single crochet, a basic stitch that creates a tight, sturdy fabric
`hdc`	Half double crochet, taller than a single crochet but shorter than a double crochet
`dc`	Double crochet, a tall stitch that creates an open, airy fabric
`tr`	Treble crochet, a very tall stitch that creates an even more open fabric
`dtr`	Double treble crochet, an extra tall stitch for very open, lacy patterns
`trtr`	Triple treble crochet, an extremely tall stitch for creating dramatic height
`rsc`	Reverse single crochet, also known as crab stitch, creates a decorative edging
`bp...` (e.g., `bpsc`, `bphdc`, `bpdc`, `bptr`)	Back post stitches, worked behind the post of the stitch below for texture
`fp...` (e.g., `fpsc`, `fphdc`, `fpdc`, `fptr`)	Front post stitches, worked around the post of the stitch below for texture
`...fl` (e.g., `scfl`, `ssfl`, `dcfl`, `hdcfl`, `trfl`, `dtrfl`, `trtrfl`)	Stitches worked in front loop only, creating a horizontal ridge on the back of the work
`...bl` (e.g., `scbl`, `ssbl`, `dcbl`, `hdcbl`, `trbl`, `dtrbl`, `trtrbl`)	Stitches worked in back loop only, creating a horizontal ridge on the front of the work
`hdcNpuff` (`hdc3puff`, `hdc4puff`, `hdc5puff`)	Half double crochet puff stitch made with N loops, where N is typically 3, 4, or 5
`dcNbobble` (`dc3bobble`, `dc4bobble`, `dc5bobble`)	Double crochet bobble stitch made with N stitches, where N is typically 3, 4, or 5
`tr4bobble`	Treble crochet bobble stitch made with 4 stitches
`dcNpc` (`dc3pc`, `dc4pc`, `dc5pc`)	N-double crochet popcorn stitch, where N is typically 3, 4, or 5
`picot3`	A decorative loop made with 3 chain stitches and a slip stitch
`longsc`, `longdc`, `longtr`	Long sc/dc/tr, worked into a stitch in a previous row for added height
`ring`	A magic ring, forming a circular/point-like foundation for crochet projects
`stitch_nameNinc`, `stitch_nameNtog`	CrochetPARADE can handle automatically stitch increases and decreases with `stitch_nameNinc` and `stitch_nameNtog`, respectively. Here `N` is an integer denoting the number of stitches of the increase or decrease. For example: `sc2inc` corresponds to two single-crochet stitches worked into the same stitch; and `sc2tog` implies that one is doing a decrease by combining two single-crochet stitches.
`sk`	Skip stitch, used to create spaces or shape in the pattern
`tie_up`	Special command: ties up stitches -- used to secure yarn end at end of project.
`start_at`	Special command: creates a hidden stitch used to mark the starting point of a round or row. This marks starting with a new piece of yarn at a specified location in the project. Needs to be followed by a location, e.g. `start_at@[-1,0]`
`start_anew`	Special command: creates a hidden stitch indicating the beginning of a new section or pattern of a disjoint piece.
`start_a_new_chain`	Special command: Begins a new chain of stitches, often used to start a new row or section of a disjoint piece.
`turn`	Special command: `turn` for turning the work at the end of a row or round. (See "Direction of sequential stitch attachment." for more details.)