Special overlays - Pyrbor/andrewsarnold-flagmaker-archive GitHub Wiki

Repeaters

Using a repeater requires two overlays: one repeater (lateral or radial), and one other overlay of your choice. The repeater should be directly above the other overlay in the list.

You can use any kind of overlay you want to be repeated—even another repeater.

See the included United States and Europe presets for a basic example.

Transformers

Transformers work similar to repeaters. Using them, you can apply arbitrary skew, scaling, and rotation to another overlay. Like repeaters, simply add a transformer overlay above the overlay you want to transform.

The "left" and "top" attributes refer to the transformer's center coordinate. This is the point the second overlay will rotate around, or from which scaling or skewing will apply.

See the included Bavaria preset for a basic example.

Flags

You can include any FlagMaker flag in another flag.

  1. Create the first flag and save the first flag to a .flag file.
  2. In your second flag, select the Flag overlay in the Special tab.
  3. Navigate to the location where you saved the first flag, and select it.
  4. You can now move the embedded flag around and save the second flag to its own .flag file.

In .flag files, embedded flags must contain a path attribute with the path to the embedded flag. Any valid URI can be used, even relative ones, as long as they point to somewhere on your computer (Web addresses are not spported). Examples include:

  • path=uk.flag
  • path=..\uk.flag
  • path=C:\flags\uk.flag

See the included Australia preset for a basic example.

Images

Images work identically to embedded flags, except they take any PNG or JPG image. Image overlays can be saved to and loaded from .flag files in the same way.

When exporting a flag to SVG, any image overlays will be embedded using base 64 encoding (see docs here). This can result in somewhat large SVG files if your images are particularly big or complicated.