Properties

Basename of font file to match for this configuration. Notice that only the filename of the font file is used - the path is stripped off. This is done to make matching easier and avoid problems when font files might move to other locations in extensions etc.

So if you use the font file EXT:my_extension/Resources/Private/Fonts/vera.ttf or EXT:install/Resources/Private/Font/vera.ttf both of them will match with this configuration.

The key:

The value of the array key will be the key used when forcing the configuration into splitRendering configuration of the individual GIFBUILDER objects. In the [array] example below the key is 123.

splitRendering configuration to set. See GIFBUILDER TEXT object for details.

If set, this will take the font size of the GIFBUILDER TEXT object and multiply with this amount (xx.xx) and override the fontSize property inside [array].charMapConfig.

If set, this will multiply the four [x/y]Space[Before/After] properties of split rendering with the relationship between the font size and this value.

In other words: Since pixel space may vary depending on the font size used, you can specify by this value at what font size the pixel space settings are optimized and for other font sizes this will automatically be adjusted according to this font size.

Example:

_GIFBUILDER.charRangeMap {
  123 = arial.ttf
  123 {
    charMapConfig {
      fontFile = EXT:install/Resources/Private/Font/vera.ttf
      value = 48-57
      color = green
      xSpaceBefore = 3
      xSpaceAfter = 3
    }

    pixelSpaceFontSizeRef = 24
  }
}

In this example xSpaceBefore and xSpaceAfter will be "3" when the font size is 24. If this configuration is used on a GIFBUILDER TEXT object where the font size is only 16, the spacing values will be corrected by "16/24", effectively reducing the pixel space to "2" in that case.

This will allow for the closest color to be matched instead. You may need this, if your image is not guaranteed "clean".