The .flag file type - Pyrbor/andrewsarnold-flagmaker-archive GitHub Wiki

.flag is a file type you can use to save and open your flags. It's a plain text file so you can also use your favorite text editor to modify them. Feel free to look at the presets for some examples, but here's a rundown of the .flag file syntax:

name – Only used to fill the Presets menu. Put anything you want here.
ratio – The ratio of the flag's height to width. Separate with a colon.
gridsize – A multiple of the ratio, which determines how finely you can place your elements (when snap-to-grid is enabled). Play around with the dropdown in the program to get a good handle on what this does.
division – Start defining the division. Only include once!
type – One of the following:
- bends backward
- bends both
- bends forward
- fesses
- grid
- pales
color1 / color2 / color3 – Pretty self-explanatory. Use either RGB or ARGB formatted in hexadecimal, e.g. 822433 or fedd00 or cc284e36. No # sign. Sorry, no Pantone. (Converting Pantone to RGB is some kind of black magic that I don't understand at all.)
overlay – Start defining a new overlay. You can have as many of these sections as you like.
type – One of the following, or the name of a custom overlay:
- anchor
- angola
- box
- border
- branches
- cedar
- chakra
- coronet
- cpusa
- crescent
- cross
- crown
- diamond
- eagle
- eagle american
- ellipse
- egypt
- ermine
- flag
- flash
- fleur de lis
- forth international
- equitorial cross
- fimbriation backward
- fimbriation forward
- half ellipse
- half saltire
- hand
- hammer and sickle
- harp
- image
- iran
- iron cross
- kangaroo
- kiwi
- laurel
- line horizontal
- line vertical
- maltese cross
- maple leaf
- mozambique
- pall
- papua new guinea
- parteiadler
- pentagram
- quadrilateral
- rays
- reichsadler
- repeater lateral
- repeater radial
- saltire
- sikh
- shahadah
- springbok
- star
- star eight
- star four
- star of david
- star seven
- star six
- sword
- sun
- swastika
- takbir
- tree
- triangle
- trident
- triskele
- yin
color – Same as above.
path – For the flag and image overlays, the local path to the .flag file or image file (PNG, JPG, etc.). You can also use relative paths. See the Australia preset for an example.
size1 / size2 / etc. – Slider values. Different overlays have different numbers of adjustable values, so play around with them in the program first to see what they do.

The files should mostly be backward-compatible (it'll generate a box for any overlays not supported in your version). For some overlays, some values have been swapped around for consistency between various versions. Check the history to see which versions might break which overlays.