.gmacfx

a dead simple scripting language for gmac.

name: example effect
category: example category 

command: example_gmic_command
params:
integer: int[50]{1...100}
float: float[50.3]{1...100}
boolean: bool[true]
menu: menu[0]{option 0, option 1}
point: point[x,y]
0,1

command: example_next_gmic_command
params:
...

name

a unique name for your effect.

category

determines which submenu the effect should be a member of.
gmac has the following built-in categories:

• 3d
• arrays & tiles
• artistic
• blur
• color
• contours
• deformation
• degradation
• lights & shadows
• pattern

if you give your effect a category that does not exist, it will be created.

command

any gmic command.

params

a command’s parameters.

parameters

locked

0,5,2.5

creates no interface.

numeric

float[default value]{minimum...maximum}

int[default value]{minimum...maximum}

creates a slider interface.

boolean

bool[default]

creates a toggle interface.

menu

menu[default index]{option 0, option 1}

creates a menu interface.

point

point[default x value, default y value]

creates a point interface.

note on point parameters

note on point parameters

×

---

different gmic commands expect different ranges of values for point parameters.

light_relief 0.3,0.2,0.2,0,1,50%,50%,5,0.5,0

fx_light_relief 0.3,0.2,0.2,0,1,50%,50%,5,0.5,0

light_relief is the built-in relief light command from gmic, and fx_light_relief is a community implementation of it. the command parameter values are identical, but see the outputs: light_relief is expecting values ranging from 0-1, while fx_light_relief is expecting values ranging from 0-100.
the included "%" helper is intended to be used as a remedy for this confusion.
for point parameters ranging 0-100, send:

point[default x, default y]

and for point parameters ranging 0-1, send:

point[default x, default y]%

helpers

float[0.5]%

float[0.5]{0...1}

int[50]%

int[50]{0...100}

point[50,50]%

0.5,0.5