Text Padding

The amount of spacing (in pixels) to add around the text.

The default is 10, except when txt-bg is set: with a background box, txt-pad becomes the padding inside the box and its default drops to 0. Use txt-pad[N] to override this for a specific text layer — bare txt-pad applies to every layer by default.

Pixels or a Fraction

How the number is written decides its unit. A whole number such as 20 is pixels multiplied by dpr, as it has always been. A decimal written with a dot from 0 to 1 inclusive — 0.05, .5, 1.0 — is a fraction instead, and is never multiplied by dpr. Anything else, such as 2.5, is read as pixels.

So txt-pad=1 is one pixel, while txt-pad=1.0 is the full size of the image on that axis. One URL written with fractions therefore holds its proportions at every width and dpr.