tf.io.decode_image | TensorFlow v2.0.0 (original) (raw)
tf.io.decode_image
Stay organized with collections Save and categorize content based on your preferences.
Function for decode_bmp, decode_gif, decode_jpeg, and decode_png.
View aliases
Main aliases
Compat aliases for migration
SeeMigration guide for more details.
tf.compat.v1.image.decode_image, tf.compat.v1.io.decode_image
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 Tensorof type dtype.
| Args | |
|---|---|
| contents | 0-D string. 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 | Controls the shape of the returned op's output. IfTrue, 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. |
| Returns |
|---|
| Tensor with type dtype and a 3- or 4-dimensional shape, depending on the file type and the value of the expand_animations parameter. |
| Raises | |
|---|---|
| ValueError | On incorrect number of channels. |