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 meta-data 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 CALCULATED: number of unique colors %l label meta-data property %m image file format (file magic) %n 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 GIF 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 (in centi-seconds) %W page (canvas) width %X page (canvas) x offset (including sign) %Y page (canvas) y offset (including sign) %Z unique filename (used for delegates) %@ CALCULATED: trim bounding box (without actually trimming) %# CALCULATED: 'signature' hash of image values %% a percent sign \n newline \r carriage return < less-than character. > greater-than character. & ampersand character.
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.miffMIFF:bird.miff 512x480
Additional properties are recognized when enclosed in braces:
%[base] base filename, no suffixes (as %t) %[channels] ??? channels in use - colorspace ??? %[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] ??? window group ??? %[height] original height of image (when it was read in) %[kurtosis] CALCULATED: kurtosis statistic of image %[magick] coder used to read image (not the file suffix) %[max] CALCULATED: maximum value statistic of image %[mean] CALCULATED: average value statistic of image %[min] CALCULATED: minimum value statistic of image %[name] The original name of the image %[opaque] CALCULATED: is image fully-opaque? %[page] Virtual canvas (page) geometry %[resolution.y] X density (resolution) without units %[resolution.x] Y density (resolution) without units %[zero] zero (unique filename for delegates %[scene] original scene number of image in input file %[size] original size of image (when it was read in) %[skewness] CALCULATED: skewness statistic of image %[standard-deviation] CALCULATED: standard-deviation statistic of image %[unique] unique temporary filename ??? %[version] Version Information of this running ImageMagick %[width] original width of image (when it was read in) %[*] 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