ImgScript

An image-based programming language.

Installation/Compilation

In order to install ImgScript, clone the project:

git clone https://github.com/csaye/imgscript
cd imgscript/

Then compile your image file like so:

./compile.sh <image>

If necessary, give permission to execute compile.sh:

chmod +x compile.sh

Interpreter

The interpreter takes an image as input and processes the pixels from top left to bottom right.

A pixel with an alpha of zero will be skipped.

The r value determines the function, the g value determines the function type, and the b value determines the function value.

r0 (value)

• g0 (ascii)
• g1 (integer)
• g2 (variable)
• g3 (operator)
  • b (value)

r1 (variable)

• g0 (start read)
• g1 (end read)
  • b (variable index)

r2 (if)

• two term statements
  • g0 (equals)
  • g1 (not equals)
  • g2 (greater than)
  • g3 (less than)
  • pixel + 1: term 1
  • pixel + 2: term 2
    • b (pixels to skip if false)
• three term statements
  • g4 (equals)
  • g5 (not equals)
  • g6 (greater than)
  • g7 (less than)
  • pixel + 1: term 1
  • pixel + 2: operation
  • pixel + 3: term 2
  • pixel + 4: term 3
    • b (pixels to skip if false)

r3 (goto)

• g0 (go to pixel)
• g1 (skip forward pixels)
• g1 (skip backward pixels)
• g2 (go to end)
  • b (pixel count)

Examples

HelloWorld.png

Prints "Hello World".

(0, 0, 72), (0, 0, 101), (0, 0, 108), (0, 0, 108), (0, 0, 111), (0, 0, 32), (0, 0, 87), (0, 0, 111), (0, 0, 114), (0, 0, 108), (0, 0, 100), (0, 0, 10)

IfStatement.png

Evaluates 1 + 1 = 2 and prints "2" if true.

(2, 0, 1), (0, 1, 1), (0, 3, 0), (0, 1, 1), (0, 1, 2), (0, 1, 2)

ForLoop.png

Prints and increments 0 until it is equal to 10.

(1, 0, 0), (0, 1, 0), (1, 1, 0), (2, 0, 1), (0, 2, 0), (0, 1, 10), (3, 3, 0), (0, 2, 0), (1, 2, 0), (3, 0, 3)

More Examples

More examples can be found in the examples folder.