A scripting language for controlling the AxiDraw plotter.

• Requirements
• Usage
• Syntax
• Examples
• License
• Changelog

• An AxiDraw plotter
• CMake 3.20+
• A C++ compiler that supports C++17 (GCC, Clang, etc.)
• Python 3.7+
• pyaxidraw (Just run pip install https://cdn.evilmadscientist.com/dl/ad/public/AxiDraw_API.zip)
• Boost
• cURL

• Clone the repository

$ git clone https://github.com/Sid110307/AxiLang.git

• Configure the project

$ cd AxiLang
$ cmake -S . -B bin

• Build the executable

$ cmake --build bin --clean-first --target all -j4

• Run the executable

$ ./bin/axilang

• Raise and lower pen
• Plot an SVG from an internet URL
• Draw a square

Check the tests directory for more examples.

The file extension for AxiLang files is .axi.

Line comments:

% This is a comment

Block comments:

%=
  This is a very long paragraph, so I would
  need to use multiple lines.
=%

The mode can be set to either plot or interactive.

MODE P
% Or
MODE I

Options can be set using the OPTS and END_OPTS keywords.

OPTS
  ACCEL 75      % Acceleration rate factor (1 - 100). Default: 75
  PENU_POS 60   % Height of pen when raised (0 - 100). Default: 60
  PEND_POS 30   % Height of pen when lowered (0 - 100). Default: 30
  PENU_DELAY 0  % Optional delay after pen is raised (ms). Default: 0
  PEND_DELAY 0  % Optional delay after pen is lowered (ms). Default: 0
  PENU_SPEED 75 % Maximum transit speed, when pen is up (1 - 100). Default: 75
  PEND_SPEED 25 % Maximum plotting speed, when pen is down (1 - 100). Default: 25
  PENU_RATE 75  % Rate of raising pen (1 - 100). Default: 75
  PEND_RATE 50  % Rate of lowering pen (1 - 100). Default: 50
  MODEL 1       % AxiDraw Model (1 - 6).
                  % 1: AxiDraw V2 or V3 (Default).
                  % 2: AxiDraw V3/A3 or SE/A3.
                  % 3: AxiDraw V3 XLX.
                  % 4: AxiDraw MiniKit.
                  % 5: AxiDraw SE/A1.
                  % 6: AxiDraw SE/A2.
  PORT "auto"   % Serial port or named AxiDraw to use. "auto" (Default) will plot to first unit found.
  UNITS 1       % Units to use (0 - 2).
                  % 0: Inches (Default). 1: Millimeters. 2: Pixels.
                  % Can only be set in interactive mode.
END_OPTS

First, the mode must be set to plot.

MODE P

Then, the file path (or internet URL) of the SVG file must be specified (options can be set before this).

SETPLOT "tests/square.svg"
% Or
SETPLOT "https://example.com/square.svg"

Finally, the plot command must be executed.

PLOT

First, the mode must be set to interactive.

MODE I

Then, the AxiDraw must be connected.

CONNECT

The following commands can be used in interactive mode:

• PENUP - Raise the pen.
• PENDOWN - Lower the pen.
• PENTOGGLE - Toggle the pen state.
• HOME - Move the pen to the home position (0, 0).
• GOTO <X> <Y> - Move the pen to the specified position (X, Y).
• GOTO_REL <X> <Y> - Move the pen to the specified position (X, Y) relative to the current position.
• DRAW <X1> <Y1> <X2> <Y2> ... <Xn> <Yn> - Draw a path from (X1, Y1) through the coordinates in between to (Xn, Yn). If only 1 pair of coordinates are provided, then the pen will only move to that position.
• WAIT <TIME> - Wait for the specified time (in milliseconds).
• GETPOS - Print the current position of the pen.
• GETPEN - Print the current state of the pen (up or down).

For updating the options anytime in between, use the UOPTS and END_UOPTS keywords, with the same options as OPTS and END_OPTS.

UOPTS
  % ...
END_UOPTS

Finally, the AxiDraw must be disconnected.

DISCONNECT

MIT License

Just read the title and description of the commits. I'm too lazy to write a changelog.

Check the TODO.md file for what I plan to add in the future.