tf.keras.ops.image.pad_images

Pad images with zeros to the specified height and width.

tf.keras.ops.image.pad_images(
    images,
    top_padding=None,
    left_padding=None,
    bottom_padding=None,
    right_padding=None,
    target_height=None,
    target_width=None,
    data_format=None
)

images Input image or batch of images. Must be 3D or 4D.
top_padding Number of rows of zeros to add on top.
left_padding Number of columns of zeros to add on the left.
bottom_padding Number of rows of zeros to add at the bottom.
right_padding Number of columns of zeros to add on the right.
target_height Height of output images.
target_width Width of output images.
data_format A string specifying the data format of the input tensor. It can be either "channels_last" or "channels_first". "channels_last" corresponds to inputs with shape (batch, height, width, channels), while "channels_first" corresponds to inputs with shape (batch, channels, height, width). If not specified, the value will default to keras.config.image_data_format.

Padded image or batch of images.

Example:

images = np.random.random((15, 25, 3))
padded_images = keras.ops.image.pad_images(
    images, 2, 3, target_height=20, target_width=30
)
padded_images.shape
(20, 30, 3)
 
batch_images = np.random.random((2, 15, 25, 3))
padded_batch = keras.ops.image.pad_images(
    batch_images, 2, 3, target_height=20, target_width=30
)
padded_batch.shape
(2, 20, 30, 3)