README.md

iconscript

Paperscript parser for icon shape drawing.

This is a part of Map Machine project.

JavaScript part

Install:

npm install paper paperjs-offset
npm install -g live-server

Run:

live-server

Go part

Requires: Go 1.19, ANTLR 4.10.1.

Install:

cd grammar
antlr -Dlanguage=Go -o parser IconScript.g4
cd ..
go build

You may also test installation with go test.

go run main.go -i <file path>

Syntax

Global context

• width — stroke width.
• position — current position of the cursor.

Commands

<positon> is 2D coordinates in the form <x>,<y> or +<x>,<y> (+ means, that the position is relative to the position).

Command	Description
a	Set adding mode (default mode)
r	Set removing mode
w <float>	Set width to a value
p <position>	Set position to a value
l [<position>]	Draw lines between positions
c <position> <float>	Draw circle specified by center point and radius
s <position> <position>	Draw rectangle specified by top left and bottom right points
ar <position> <float> <float> <float>	Draw arc specified by center point, radius, and two angles in radians

Variables

Variable can be defined with <variable> = [<command>] and accessed with @<variable>.

Example

cube = lf +0,0 +2,0 +0,2 +-2,0 +0,-2
{
    %glider
    p 6,2   @cube p +4,4 @cube
    p +-8,4 @cube p +4,0 @cube p +4,0 @cube
}