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

PBM (.pbm)

MIME type: image/x-portable-bitmap
PBM monochrome raster image format.
Member of the Portable family of image formats.
Related to PGM and PPM.
Implements a subset of the PNM format.
Native format of the Netpbm graphics software package.
Primarily used as an intermediate file format on Unix systems.
PBM is an acronym derived from Portable Bit Map.
ASCII or binary format.
Stores raster images formatted as plain text, representing each pixel as a 0 (white) or 1 (black).
Developed in 1988 as part of the Pbmplus package.
  • Export creates binary PBM files.
  • If multiple images are present in a PBM file, Import returns the first of the images.
  • Import["file.pbm"] imports a PBM file, returning a graphics object.
  • Export["file.pbm", expr] exports graphics or any other expression as a PBM raster image.
  • Export by default generates binary PGM files.
  • Import["file.pbm"] returns an expression of the form Graphics[Raster[data], opts], where data is an array of bit values.
  • Export["file.pbm", expr] creates a PBM image with the same image size as the displayed form of expr.
  • Because PBM is a raster image format, all fonts are rasterized on export.
  • Import["file.pbm", elem] imports the specified element from a PBM file.
  • Import["file.pbm", {elem, suba, subb, ...}] imports a subelement.
  • Import["file.pbm", {{elem1, elem2, ...}}] imports multiple elements.
  • The import format can be specified with Import["file", "PBM"] or Import["file", {"PBM", elem, ...}].
  • Export["file.pbm", expr, elem] creates a PBM file by treating expr as specifying element elem.
  • Export["file.pbm", {expr1, expr2, ...}, {{elem1, elem2, ...}}] treats each expri as specifying the corresponding elemi.
  • Export["file.pbm", expr, opt1->val1, ...] exports expr with the specified option elements taken to have the specified values.
  • Export["file.pbm", {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 PBM file into a cell.
  • Save Selection As exports the selected part of a notebook as a PBM 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 RGB triples
"Graphics"Graphics object representing an image
"GrayLevels"array of normalized gray-level values
"RGBColorArray"array of RGBColor objects
  • Import and Export by default use the "Graphics"element for PBM files.
"ImageSize"raster dimensions
  • General option:
ImageSizeAutomaticoverall image size
  • Detailed properties:
"ColorSpace"GrayLevelcolor space of the image
"ImageTopOrientation"Toporientation of the image in the file