TensorFlow函数教程：tf.io.decode_image
tf.io.decode_image函数
别名：
- tf.image.decode_image
- tf.io.decode_image
tf.io.decode_image(
contents,
channels=None,
dtype=tf.dtypes.uint8,
name=None
)
定义在：tensorflow/python/ops/image_ops_impl.py。
decode_bmp，decode_gif，decode_jpeg和decode_png的便捷函数。
检测图像是BMP，GIF，JPEG还是PNG，并执行适当的操作将输入字节string转换为dtype类型的Tensor。
注意：decode_gif返回一个4-D数组[num_frames, height, width, 3]，而不是decode_bmp，decode_jpeg和decode_png，它们返回3-D数组[height，width，num_channels]。如果要将GIF文件与BMP，JPEG或PNG文件混合，请确保在构建图形时考虑到这一点。参数：
- contents：0-D string。编码图像字节。
- channels：可选的int。默认为0。解码图像的颜色通道数。
- dtype：返回的Tensor所需的DType。
- name：操作的名称（可选）
返回：
dtype类型的Tensor，对于BMP，JPEG和PNG图像其shape为[height, width, num_channels]，对于GIF图像，其shape为[num_frames, height, width, 3]。
可能引发的异常：
- ValueError：不正确的通道数。