ImageMagick Logo ImageMagick Sprite
Unix
Mac OS X
iOS
Windows
Processing
Options
Usage
MagickWand
MagickCore
PerlMagick
Magick++
Unix
Windows
Links

ImageMagick Escapes

Use the -format option to print properties associated with an image in a format of your choosing. You can include the image filename, type, width, height, EXIF data, or other image attributes by embedding special format characters:

   %b   original file size of image file
   %c   comment property
   %d   directory path
   %e   filename extension or suffix
   %f   filename (including suffix)
   %g   page geometry   ( = %Wx%H%X%Y )
   %h   current image height in pixels
   %i   input filename (full path)
   %k   number of unique colors
   %l   label property
   %m   magick format used during read
   %n   number of images in sequence
   %o   output filename
   %p   index of image in sequence
   %q   quantum depth (compile-time constant)
   %r   image class and colorspace
   %s   scene number (from input unless re-assigned)
   %t   top of filename (excluding suffix)
   %u   unique temporary filename
   %w   current width in pixels
   %x   x resolution
   %y   y resolution
   %z   image depth (as read in)
   %A   image transparency channel enabled (true/false)
   %C   image compression type
   %D   image dispose method
   %G   image size ( = %wx%h )
   %H   page (canvas) height
   %O   page (canvas) offset ( = %X%Y )
   %P   page (canvas) size ( = %Wx%H )
   %Q   image compression quality
   %S   ?? scenes ??
   %T   image time delay
   %W   page (canvas) width
   %X   page (canvas) x offset (including sign)
   %Y   page (canvas) y offset (including sign)
   %@   bounding box
   %#   signature
   %%   a percent sign
   \n   newline
   \r   carriage return

Here is a sample command and its output for an image with filename bird.miff and whose width is 512 and height is 480.

$magick> identify -format "%m:%f %wx%h" bird.miffMIFF:bird.miff 512x480

Additional properties are recognized when enclosed in braces:

   %[base]                 base filename, no suffixes (as %t)
   %[channels]
   %[colorspace]           Colorspace of Image Data (excluding transparency)
   %[copyright]            ImageMagick Copyright String
   %[depth]                depth of image for write (as input unless changed)
   %[directory]            directory part of filename (as %d)
   %[extension]            extention part of filename (as %e)
   %[group]
   %[height]               original height of image (when it was read in)
   %[magick]               coder used to read image (not the file suffix)
   %[max]
   %[mean]
   %[min]
   %[name]
   %[opaque]
   %[page]
   %[scene]                original scene number of image in input file
   %[scenes]               original number of scenes in input file
   %[size]                 original size of image (when it was read in)
   %[standard-deviation]
   %[unique]               unique temporary filename ???
   %[version]              Version Information of this running ImageMagick
   %[width]                original width of image (when it was read in)
   %[xresolution]
   %[yresolution]
   %[*]                    list of image property strings

Use %[fx:...] to evaluate FX expressions:

   %[fx:expression]

Use pixel: to evaluate a pixel color as defined by the FX expression:

   %[pixel:expression]

You can also use the following special formatting syntax to print EXIF information contained in the file:

   %[EXIF:tag]

Choose tag from the following:

   *  (print all EXIF tags, in keyword=data format)
   !  (print all EXIF tags, in tag_number data format)
   #hhhh (print data for EXIF tag #hhhh)
   ImageWidth
   ImageLength
   BitsPerSample
   Compression
   PhotometricInterpretation
   FillOrder
   DocumentName
   ImageDescription
   Make
   Model
   StripOffsets
   Orientation
   SamplesPerPixel
   RowsPerStrip
   StripByteCounts
   XResolution
   YResolution
   PlanarConfiguration
   ResolutionUnit
   TransferFunction
   Software
   DateTime
   Artist
   WhitePoint
   PrimaryChromaticities
   TransferRange
   JPEGProc
   JPEGInterchangeFormat
   JPEGInterchangeFormatLength
   YCbCrCoefficients
   YCbCrSubSampling
   YCbCrPositioning
   ReferenceBlackWhite
   CFARepeatPatternDim
   CFAPattern
   BatteryLevel
   Copyright
   ExposureTime
   FNumber
   IPTC/NAA
   EXIFOffset
   InterColorProfile
   ExposureProgram
   SpectralSensitivity
   GPSInfo
   ISOSpeedRatings
   OECF
   EXIFVersion
   DateTimeOriginal
   DateTimeDigitized
   ComponentsConfiguration
   CompressedBitsPerPixel
   ShutterSpeedValue
   ApertureValue
   BrightnessValue
   ExposureBiasValue
   MaxApertureValue
   SubjectDistance
   MeteringMode
   LightSource
   Flash
   FocalLength
   MakerNote
   UserComment
   SubSecTime
   SubSecTimeOriginal
   SubSecTimeDigitized
   FlashPixVersion
   ColorSpace
   EXIFImageWidth
   EXIFImageLength
   InteroperabilityOffset
   FlashEnergy
   SpatialFrequencyResponse
   FocalPlaneXResolution
   FocalPlaneYResolution
   FocalPlaneResolutionUnit
   SubjectLocation
   ExposureIndex
   SensingMethod
   FileSource
   SceneType

Surround the format specification with quotation marks to prevent your shell from misinterpreting any spaces and square brackets.

The following special formatting syntax can be used to print IPTC information contained in the file:

   %[IPTC:dataset:record]

Select dataset and record from the following:

    Envelope Record
      1:00  Model Version
      1:05  Destination
      1:20  File Format
      1:22  File Format Version
      1:30  Service Identifier
      1:40  Envelope Number
      1:50  Product ID
      1:60  Envelope Priority
      1:70  Date Sent
      1:80  Time Sent
      1:90  Coded Character Set
      1:100  UNO (Unique Name of Object)
      1:120  ARM Identifier
      1:122  ARM Version

    Application Record
      2:00  Record Version
      2:03  Object Type Reference
      2:05  Object Name (Title)
      2:07  Edit Status
      2:08  Editorial Update
      2:10  Urgency
      2:12  Subject Reference
      2:15  Category
      2:20  Supplemental Category
      2:22  Fixture Identifier
      2:25  Keywords
      2:26  Content Location Code
      2:27  Content Location Name
      2:30  Release Date
      2:35  Release Time
      2:37  Expiration Date
      2:35  Expiration Time
      2:40  Special Instructions
      2:42  Action Advised
      2:45  Reference Service
      2:47  Reference Date
      2:50  Reference Number
      2:55  Date Created
      2:60  Time Created
      2:62  Digital Creation Date
      2:63  Digital Creation Time
      2:65  Originating Program
      2:70  Program Version
      2:75  Object Cycle
      2:80  By-Line (Author)
      2:85  By-Line Title (Author Position) [Not used in Photoshop 7]
      2:90  City
      2:92  Sub-Location
      2:95  Province/State
      2:100  Country/Primary Location Code
      2:101  Country/Primary Location Name
      2:103  Original Transmission Reference
      2:105  Headline
      2:110  Credit
      2:115  Source
      2:116  Copyright Notice
      2:118  Contact
      2:120  Caption/Abstract
      2:122  Caption Writer/Editor
      2:125  Rasterized Caption
      2:130  Image Type
      2:131  Image Orientation
      2:135  Language Identifier
      2:150  Audio Type
      2:151  Audio Sampling Rate
      2:152  Audio Sampling Resolution
      2:153  Audio Duration
      2:154  Audio Outcue
      2:200  ObjectData Preview File Format
      2:201  ObjectData Preview File Format Version
      2:202  ObjectData Preview Data

    Pre-ObjectData Descriptor Record
      7:10   Size Mode
      7:20   Max Subfile Size
      7:90   ObjectData Size Announced
      7:95   Maximum ObjectData Size

    ObjectData Record
      8:10   Subfile

    Post ObjectData Descriptor Record
      9:10   Confirmed ObjectData Size