tf.io.decode_image

Function for decode_bmp, decode_gif, decode_jpeg, and decode_png.

tf.io.decode_image(
    contents,
    channels=None,
    dtype=tf.dtypes.uint8,
    name=None,
    expand_animations=True
)

Detects whether an image is a BMP, GIF, JPEG, or PNG, and performs the appropriate operation to convert the input bytes string into a Tensor of type dtype.

contents A Tensor of type string. 0-D. The encoded image bytes.
channels An optional int. Defaults to 0. Number of color channels for the decoded image.
dtype The desired DType of the returned Tensor.
name A name for the operation (optional)
expand_animations An optional bool. Defaults to True. Controls the shape of the returned op's output. If True, the returned op will produce a 3-D tensor for PNG, JPEG, and BMP files; and a 4-D tensor for all GIFs, whether animated or not. If, False, the returned op will produce a 3-D tensor for all file types and will truncate animated GIFs to the first frame.

Tensor with type dtype and a 3- or 4-dimensional shape, depending on the file type and the value of the expand_animations parameter.

ValueError On incorrect number of channels.