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   file size of image read in
       %c   comment property
       %d   directory component of path
       %e   filename extension or suffix
       %f   filename (including suffix)
       %g   layer canvas page geometry   ( = %Wx%H%X%Y )
       %h   current image height in pixels
       %i   image filename (note: becomes output filename for "info:")
       %k   number of unique colors
       %l   label property
       %m   image file format (file magic)
       %n   exact number of images in current image sequence
       %o   output filename  (used for delegates)
       %p   index of image in current image list
       %q   quantum depth (compile-time constant)
       %r   image class and colorspace
       %s   scene number (from input unless re-assigned)
       %t   filename without directory or extension (suffix)
       %u   unique temporary filename (used for delegates)
       %w   current width in pixels
       %x   x resolution (density)
       %y   y resolution (density)
       %z   image depth (as read in unless modified, image save depth)
       %A   image transparency channel enabled (true/false)
       %C   image compression type
       %D   image dispose method
       %G   image size ( = %wx%h )
       %H   page (canvas) height
       %M   Magick filename (original file exactly as given,  including read mods)
       %O   page (canvas) offset ( = %X%Y )
       %P   page (canvas) size ( = %Wx%H )
       %Q   image compression quality ( 0 = default )
       %S   ?? scenes ??
       %T   image time delay
       %W   page (canvas) width
       %X   page (canvas) x offset (including sign)
       %Y   page (canvas) y offset (including sign)
       %Z   unique filename (used for delegates)
       %@   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.

$ identify -format "%m:%f %wx%h" bird.miff MIFF: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

Discourse Server • Studio