Adding grommets using a Fixup

Besides using the Switchboard action, it is also possible to use a Fixup instead.
To refelect the 2 possible ways of positioning grommets ("by distance" or "by number"), several Variables have to be defined to ensure a proper placement.

Used variables

Key of the Variable
Value
Description
grommet_template
Path to a grommet file (as PDF, JPEG, PNG)
Defines the path to the grommet to be used.
Must be an absolute path.
measurement_unit
cm, mm, in, pt
Default: mm
Defines the unit used for all defined distances of other Variables.
distance_bottom
Number
Default: 20
Distance from TrimBox - bottom
distance_left
Number
Default: 20
Distance from TrimBox - left
distance_right
Number
Default: 20
Distance from TrimBox - right
distance_top
Number
Default: 20
Distance from TrimBox - top
count_horizontal
Number
Default: 10
Grommet count for "Grommets by number" (horizontal)
Must be set to number of requested grommets or to "-1" if "spacing_..."-Variables are used
count_vertical
Number
Default: 10
Grommet count for "Grommets by number" (vertical)
Must be set to number of requested grommets or to "-1" if "spacing_..."-Variables are used
spacing_horizontal
Number
Default: -1 (inactive)
Spacing between Grommets for "Grommets by Distance" (horizontal)
Must be set to number of requested grommets (or to "-1" if "count_..."-Variables are used)
spacing_vertical
Number
Default: -1 (inactive)
Spacing between Grommets for "Grommets by Distance" (vertical)
Must be set to number of requested grommets (or to "-1" if "count_..."-Variables are used)

As already mentioned in the table above, the usage of the Variables "count_..." or "spacing_..." will decide if the grommets are placed "by number" or "by distance".
As the default values for the "spacing_..." are set to "-1", they are not active unless Variables are explicitly defined. If they are used, the "count_..."-Variables must be "switched off" by setting their value to "-1".

It is of course possible to combine e.g. the "count_vertical" with the "spacing_horizontal" Variable, but please remember to set the corresponding variable to "-1" if a "spacing_"-Variable is used.

Sample CLI calls

To place e.g. 15 grommets horizontally and 12 vertically, the respective CLI call would look like:

pdfToolbox <kfpx> <PDF> --setvariable=grommet_template:<Path to grommet PDF> --setvariable=count_horizontal:15 --setvariable=count_vertical:12

For placing grommets by distance (approx. 480mm on the vertical and horizontal edge) , the "spacing_..."-Variables have to be set and (as described above) the "count_..."-Variables must be set to "-1":

pdfToolbox <kfpx> <PDF> --setvariable=grommet_template:<Path to grommet PDF> --setvariable=count_horizontal:-1 --setvariable=count_vertical:-1 --setvariable=spacing_horizontal:480 --setvariable=spacing_vertical:480

Please note: As the distance between the grommets is adjusted to the total length of the edge, the effective distance used in the resulting PDF may differ from the defined input values.

Using the Fixup in the Desktop version

The Fixup can be used in the Desktop version as well of course, but using the Switchboard action is much more convenient here.

Sample files

You'll find the Fixup, which is used internally for the "Grommets" Switchboard action as well as a typical LFP PDF and a Grommet PDF below.