tf.image.encode_jpeg(image, format=None, quality=None, progressive=None, optimize_size=None, chroma_downsampling=None, density_unit=None, x_density=None, y_density=None, xmp_metadata=None, name=None)
JPEG-encode an image.
image is a 3-D uint8 Tensor of shape [height, width, channels].
The attr format can be used to override the color format of the encoded output. Values can be:
-
'': Use a default format based on the number of channels in the image. -
grayscale: Output a grayscale JPEG image. Thechannelsdimension ofimagemust be 1. -
rgb: Output an RGB JPEG image. Thechannelsdimension ofimagemust be 3.
If format is not specified or is the empty string, a default format is picked in function of the number of channels in image:
- 1: Output a grayscale image.
- 3: Output an RGB image.
Args:
-
image: ATensorof typeuint8. 3-D with shape[height, width, channels]. -
format: An optionalstringfrom:"", "grayscale", "rgb". Defaults to"". Per pixel image format. -
quality: An optionalint. Defaults to95. Quality of the compression from 0 to 100 (higher is better and slower). -
progressive: An optionalbool. Defaults toFalse. If True, create a JPEG that loads progressively (coarse to fine). -
optimize_size: An optionalbool. Defaults toFalse. If True, spend CPU/RAM to reduce size with no quality change. -
chroma_downsampling: An optionalbool. Defaults toTrue. See http://en.wikipedia.org/wiki/Chroma_subsampling. -
density_unit: An optionalstringfrom:"in", "cm". Defaults to"in". Unit used to specifyx_densityandy_density: pixels per inch ('in') or centimeter ('cm'). -
x_density: An optionalint. Defaults to300. Horizontal pixels per density unit. -
y_density: An optionalint. Defaults to300. Vertical pixels per density unit. -
xmp_metadata: An optionalstring. Defaults to"". If not empty, embed this XMP metadata in the image header. -
name: A name for the operation (optional).
Returns:
A Tensor of type string. 0-D. JPEG-encoded image.
Please login to continue.