This is documentation for Mathematica 6, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)
Mathematica Import/Export Format

JPEG2000 (.jp2, .j2k)

MIME type: image/jp2
JPEG2000 raster image and compression format.
Used for photographic images.
JPEG is an acronym for Joint Photographic Experts Group.
Binary file format.
Supports a variety of color resolutions and opacity.
Uses lossy or lossless compression based on wavelet transforms.
Can store images as an array of rectangular tiles that are encoded separately.
  • Import and Export support the JP2 file format as well as the JPEG2000 features specified in Part 1 of the ISO 15444 standard.
  • Import["file.jp2"] imports a JPEG2000 file, returning a graphics object.
  • Export["file.jp2", expr] exports graphics or any other expression as an image to a JPEG2000 file.
  • Import["file.jp2"] returns an expression of the form Graphics[Raster[data], opts], where data is an array of color values.
  • Export["file.jp2", expr] creates a JPEG2000 image with the same image size as the displayed form of expr.
  • Because JPEG2000 is a raster image format, all fonts are rasterized on export.
  • Import["file.jp2", elem] imports the specified element from a JPEG2000 file.
  • Import["file.jp2", {elem, suba, subb, ...}] imports a subelement.
  • Import["file.jp2", {{elem1, elem2, ...}}] imports multiple elements.
  • The import format can be specified with Import["file", "JPEG2000"] or Import["file", {"JPEG2000", elem, ...}].
  • Export["file.jp2", expr, elem] creates a JPEG2000 file by treating expr as specifying element elem.
  • Export["file.jp2", {expr1, expr2, ...}, {{elem1, elem2, ...}}] treats each expri as specifying the corresponding elemi.
  • Export["file.jp2", expr, opt1->val1, ...] exports expr with the specified option elements taken to have the specified values.
  • Export["file.jp2", {elem1->expr1, elem2->expr2, ...}, "Rules"] uses rules to specify the elements to be exported.
  • See the reference pages for full general information on Import and Export.
  • In the notebook front end, Insert ► Picture and the Open menu allow import of a JPEG2000 file into a cell.
  • Save Selection As exports the selected part of a notebook as a JPEG2000 file.
"Elements"list of elements and options available in this file
"Rules"full list of rules for each element and option
"Options"list of rules for options, properties, and settings
  • Data representation elements:
"Data"array of color values
"Graphics"raster image given as a Graphics object
"GrayLevels"array of normalized gray-level values
"RGBColorArray"array of RGBColor objects
  • Import and Export by default use "Graphics" for JPEG2000 files.
  • Import["file.jp2", "Data"] gives an array of color values taken to be encoded using the color model specified by the "ColorSpace" option.
"BitDepth"bit resolution used for each color channel in the file
"ImageSize"raster dimensions
  • General option:
ImageSizeAutomaticoverall image size
"ImageTopOrientation"Toporientation of the image as stored in the file
"BitDepth"8bit resolution used for each color channel
"CompressionLevel"Automaticsets the compression parameter of the image-encoding algorithm
"ImageTopOrientation"Toporientation of the exported image
  • Allowed settings for "BitDepth" are integers in the range 1 to 31.
  • Possible values of "CompressionLevel" range from 0 to 1, with larger values corresponding to smaller file sizes.
  • For lossy compression methods, a higher compression level corresponds to a lower quality encoding.
  • Detailed properties and settings:
"ColorSpace"Automaticcolor space of the image
"ImageEncoding""JPEG2000"compression method used in the file
  • Import and Export support JPEG2000 alpha channels in gray-level and RGB images.
  • Possible settings for "ImageEncoding":
"JPEG2000"standard lossy JPEG2000 encoding
"Lossless"lossless variant of the JPEG2000 compression method
This imports a JPEG2000 sample file as Graphics:
Click for copyable input
Mathematica can export arbitrary graphics to JPEG2000:
Click for copyable input