Knitout

Knitout is a language for controlling knitting machines. Knitout files are utf8 text files with linux line-endings. Each line of the file contains an operation and/or a comment.

All knitout files must begin with a magic string that indicates that knitout is the file format and specifies the version—;!knitout-VERSION. (NOTE: it is important that this is the very first line of code; not even a ;comment can precede it).
Next, a number of headers can be added, with the only required header being ;;Carriers:.
Comments start with a semi-colon (e.g. ;a comment); any text in that line of code that follows the semi-colon will be ignored.

Needle Operations

Needle operations form or manipulate loops.

  • tuck — adds a loop of to a needle
  • knit — pulls a loop through the loops on a needle
  • split — pulls a loop through the loops on a needle, transfer the loops to an aligned needle
  • amiss — (tuck with no yarns) pulls on the loops on a needle without otherwise influencing them (rarely used)
  • drop — (knit with no yarns) drops loops held on a needle
  • xfer — (split with no yarns) moves loops held on a needle to an aligned needle

Yarn Operations

Yarn operations control yarn carriers.

  • in — bring a yarn carrier into action from grippers
  • out — bring a yarn carrier out of action with grippers
  • inhook — bring a yarn carrier into action using yarn holding hook
  • releasehook — bring yarn holding hook out of action
  • outhook — yarn carrier(s) into action using yarn holding hook
  • miss — moves a yarn carrier past a given needle

Configuration Operations

Configuration operations Other Operations — adjust machine settings or state.