The PadImage command increases the size of an image by adding padding around its edges.

The img parameter must be of type Image.

The optional height and width parameters specify the range of indices for the height and width of the padded image. The padded dimensions must be larger than the original dimensions. These override other dimension settings (border, top, etc.).

bottom = nonnegint

If specified, sets the width of the padding on the bottom edge.

border = nonnegint

Specifies the width of the padding around any otherwise unspecified edges. The default is 0.

fill = numeric, list(numeric), reflect, replicate

Specifies how to fill the padding. If numeric, then that value is inserted everywhere. If a list of numeric values, then each layer of a color image is filled with the appropriate value in the list. If reflect is specified, then the image is reflected into the padding. If replicate is specified, then the edge values are extended into the padding. The default is 0.

left = nonnegint

If specified, sets the width of the padding on the left edge.

right = nonnegint

If specified, sets the width of the padding on the right edge.

top = nonnegint

If specified, sets the width of the padding on the top edge.

reindex = truefalse

If true then the indices of the returned image are reindexed so that they start at 1. The default is false.