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. Thechannels
dimension ofimage
must be 1. -
rgb
: Output an RGB JPEG image. Thechannels
dimension ofimage
must 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
: ATensor
of typeuint8
. 3-D with shape[height, width, channels]
. -
format
: An optionalstring
from:"", "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 optionalstring
from:"in", "cm"
. Defaults to"in"
. Unit used to specifyx_density
andy_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.