{"id":1131,"date":"2014-09-10T09:55:11","date_gmt":"2014-09-10T13:55:11","guid":{"rendered":"https:\/\/blogs.mathworks.com\/steve\/?p=1131"},"modified":"2019-11-01T11:18:57","modified_gmt":"2019-11-01T15:18:57","slug":"image-file-information-using-imfinfo","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/steve\/2014\/09\/10\/image-file-information-using-imfinfo\/","title":{"rendered":"Image file information using imfinfo"},"content":{"rendered":"

How can you find out what's in an image file before you read in the data? The answer is the function imfinfo<\/tt>. Today I want to explore the basics of using this function.<\/p>

The function imfinfo<\/tt> returns a struct. The fields of the struct contain information about the image file.<\/p>

Here's an example.<\/p>

imfinfo('peppers.png'<\/span>)\r\n<\/pre>
\r\nans = \r\n\r\n                  Filename: '\/Applications\/MATLAB_R2014a.app\/toolbox\/matla...'\r\n               FileModDate: '02-Apr-2013 15:55:52'\r\n                  FileSize: 287677\r\n                    Format: 'png'\r\n             FormatVersion: []\r\n                     Width: 512\r\n                    Height: 384\r\n                  BitDepth: 24\r\n                 ColorType: 'truecolor'\r\n           FormatSignature: [137 80 78 71 13 10 26 10]\r\n                  Colormap: []\r\n                 Histogram: []\r\n             InterlaceType: 'none'\r\n              Transparency: 'none'\r\n    SimpleTransparencyData: []\r\n           BackgroundColor: []\r\n           RenderingIntent: []\r\n            Chromaticities: []\r\n                     Gamma: []\r\n               XResolution: []\r\n               YResolution: []\r\n            ResolutionUnit: []\r\n                   XOffset: []\r\n                   YOffset: []\r\n                OffsetUnit: []\r\n           SignificantBits: []\r\n              ImageModTime: '16 Jul 2002 16:46:41 +0000'\r\n                     Title: []\r\n                    Author: []\r\n               Description: 'Zesty peppers'\r\n                 Copyright: 'Copyright The MathWorks, Inc.'\r\n              CreationTime: []\r\n                  Software: []\r\n                Disclaimer: []\r\n                   Warning: []\r\n                    Source: []\r\n                   Comment: []\r\n                 OtherText: []\r\n\r\n<\/pre>
The fields returned by imfinfo<\/tt> aren't the same for all image files. Here's the output for a TIFF file.<\/p>
imfinfo('forest.tif'<\/span>)\r\n<\/pre>
\r\nans = \r\n\r\n                     Filename: '\/Applications\/MATLAB_R2014a.app\/toolbox\/im...'\r\n                  FileModDate: '25-Sep-2013 20:12:00'\r\n                     FileSize: 124888\r\n                       Format: 'tif'\r\n                FormatVersion: []\r\n                        Width: 447\r\n                       Height: 301\r\n                     BitDepth: 8\r\n                    ColorType: 'indexed'\r\n              FormatSignature: [73 73 42 0]\r\n                    ByteOrder: 'little-endian'\r\n               NewSubFileType: 0\r\n                BitsPerSample: 8\r\n                  Compression: 'PackBits'\r\n    PhotometricInterpretation: 'RGB Palette'\r\n                 StripOffsets: [1x17 double]\r\n              SamplesPerPixel: 1\r\n                 RowsPerStrip: 18\r\n              StripByteCounts: [1x17 double]\r\n                  XResolution: 72\r\n                  YResolution: 72\r\n               ResolutionUnit: 'Inch'\r\n                     Colormap: [256x3 double]\r\n          PlanarConfiguration: 'Chunky'\r\n                    TileWidth: []\r\n                   TileLength: []\r\n                  TileOffsets: []\r\n               TileByteCounts: []\r\n                  Orientation: 1\r\n                    FillOrder: 1\r\n             GrayResponseUnit: 0.0100\r\n               MaxSampleValue: 255\r\n               MinSampleValue: 0\r\n                 Thresholding: 1\r\n                       Offset: 122964\r\n             ImageDescription: 'Carmanah Ancient Forest, British Columbia,...'\r\n\r\n<\/pre>
Only the first nine fields of the returned struct are always the same:<\/p>
  • Filename<\/tt><\/li>
  • FileModDate<\/tt><\/li>
  • FileSize<\/tt><\/li>
  • Format<\/tt><\/li>
  • FormatVersion<\/tt><\/li>
  • Width<\/tt><\/li>
  • Height<\/tt><\/li>
  • BitDepth<\/tt><\/li>
  • ColorType<\/tt><\/li><\/ul><\/div>
    FileModDate<\/tt> is the file modification date (as reported by the operating system). FileSize<\/tt> is the size of the file in bytes. The peppers.png file takes up 287,677 bytes on disk.<\/p>
    Format<\/tt> is an abbreviation indicating the type of image file (PNG, TIFF, JPEG, etc.). Although frequently the filename extension indicates the image format type, this isn't always the case. The Format<\/tt> field shows you the format type whether or not the filename extension indicates it.<\/p>
    FormatVersion<\/tt> has turned out to be less useful than I thought would be back in the mid-1990s. You generally don't need to pay attention to it.<\/p>
    Width<\/tt> is the number of image columns, and Height<\/tt> is the number of rows.<\/p>
    If I were designing imfinfo<\/tt> from scratch today, I'd probably call the next field BitsPerPixel<\/tt> instead of BitDepth<\/tt>. I might also add a field called SamplesPerPixel<\/tt>. Anyway, images such as peppers.png used to be frequently called \"24-bit images\" because each pixel is represented by three samples (one number for red, one for green, and one for blue), and each sample is represented by 8 bits. 3*8 is 24, hence 24-bit image.<\/p>
    The file forest.tif, on the other hand, uses only one sample for each pixel, and each sample is represented by 8 bits, so forest.tif is sometimes called an \"8-bit image,\" and its BitDepth<\/tt> is 8.<\/p>
    ColorType<\/tt> tells us how the pixel values are interpreted as colors on the screen. The most common values for ColorType<\/tt> are 'grayscale'<\/tt>, 'indexed'<\/tt>, and 'truecolor'<\/tt>. In a grayscale image, each pixel value represents a shade of gray. In an indexed image, each pixel value is really a lookup index used to get the pixel color from a colormap (also called a palette). Truecolor (in this context) originally referred to a 24-bit image with three samples per pixels, and with the samples representing red, green, and blue. In MATLAB, though, we use the term to refer to any RGB image represented by three samples per pixel, regardless of the bit depth.<\/p>
    Here's an example of using the information returned by imfinfo<\/tt> to compute the compression ratio for a JPEG file. Let's use ngc6543a.jpg, the first truecolor sample image shipped with MATLAB.<\/p>
    info = imfinfo('ngc6543a.jpg'<\/span>);\r\nfile_bytes = info.FileSize;\r\nimage_bytes = info.Width * info.Height * info.BitDepth \/ 8;\r\n<\/pre>
    I divided by 8 in the line above because BitDepth<\/tt> is in bits instead of bytes.<\/p>
    compression_ratio = image_bytes \/ file_bytes\r\n<\/pre>
    \r\ncompression_ratio =\r\n\r\n   42.7210\r\n\r\n<\/pre>
    So what about all those other fields after the first nine? Well, they vary depending on the file format and the specific information contained in the file. For example, TIFF files optionally contain horizontal and vertical resolution information.<\/p>
    info = imfinfo('forest.tif'<\/span>);\r\ninfo.XResolution\r\n<\/pre>
    \r\nans =\r\n\r\n    72\r\n\r\n<\/pre>
    info.YResolution\r\n<\/pre>
    \r\nans =\r\n\r\n    72\r\n\r\n<\/pre>
    info.ResolutionUnit\r\n<\/pre>
    \r\nans =\r\n\r\nInch\r\n\r\n<\/pre>
    Most image file formats allow you to store text descriptions in them.<\/p>
    info = imfinfo('peppers.png'<\/span>);\r\ninfo.Description\r\n<\/pre>
    \r\nans =\r\n\r\nZesty peppers\r\n\r\n<\/pre>
    These days, most cameras store a lot more information in image files than the older sample images that are in MATLAB and the Image Processing Toolbox. This information is also available using imfinfo<\/tt>.<\/p>
    imshow('IMG_1046.JPG'<\/span>,'InitialMagnification'<\/span>,20)\r\n<\/pre>\"\" 
    info = imfinfo('IMG_1046.JPG'<\/span>)\r\n<\/pre>
    \r\ninfo = \r\n\r\n            Filename: '\/Users\/steve\/Dropbox\/MATLAB\/Blogs\/IMG_1046.JPG'\r\n         FileModDate: '28-Jun-2014 22:07:32'\r\n            FileSize: 1595137\r\n              Format: 'jpg'\r\n       FormatVersion: ''\r\n               Width: 2816\r\n              Height: 1880\r\n            BitDepth: 24\r\n           ColorType: 'truecolor'\r\n     FormatSignature: ''\r\n     NumberOfSamples: 3\r\n        CodingMethod: 'Huffman'\r\n       CodingProcess: 'Sequential'\r\n             Comment: {}\r\n    ImageDescription: '                               '\r\n                Make: 'Canon'\r\n               Model: 'Canon PowerShot S95'\r\n         Orientation: 1\r\n         XResolution: 180\r\n         YResolution: 180\r\n      ResolutionUnit: 'Inch'\r\n            DateTime: '2014:06:28 19:07:32'\r\n    YCbCrPositioning: 'Co-sited'\r\n       DigitalCamera: [1x1 struct]\r\n       ExifThumbnail: [1x1 struct]\r\n\r\n<\/pre>
    That extra information is in the DigitalCamera<\/tt> field.<\/p>
    info.DigitalCamera\r\n<\/pre>
    \r\nans = \r\n\r\n                ExposureTime: 0.0040\r\n                     FNumber: 4.9000\r\n             ISOSpeedRatings: 80\r\n                 ExifVersion: [48 50 51 48]\r\n            DateTimeOriginal: '2014:06:28 19:07:32'\r\n           DateTimeDigitized: '2014:06:28 19:07:32'\r\n     ComponentsConfiguration: 'YCbCr'\r\n      CompressedBitsPerPixel: 3\r\n           ShutterSpeedValue: 7.9688\r\n               ApertureValue: 4.5938\r\n           ExposureBiasValue: 0\r\n            MaxApertureValue: 4.5938\r\n                MeteringMode: 'Pattern'\r\n                       Flash: 'Flash did not fire, no strobe return detect...'\r\n                 FocalLength: 22.5000\r\n                   MakerNote: [1x2764 double]\r\n                 UserComment: [1x264 double]\r\n             FlashpixVersion: [48 49 48 48]\r\n                  ColorSpace: 'sRGB'\r\n            CPixelXDimension: 2816\r\n            CPixelYDimension: 1880\r\n         InteroperabilityIFD: [1x1 struct]\r\n       FocalPlaneXResolution: 9.6438e+03\r\n       FocalPlaneYResolution: 9.6575e+03\r\n    FocalPlaneResolutionUnit: 2\r\n               SensingMethod: 'One-chip color area sensor'\r\n                  FileSource: 'DSC'\r\n              CustomRendered: 'Normal process'\r\n                ExposureMode: 'Auto exposure'\r\n                WhiteBalance: 'Auto white balance'\r\n            DigitalZoomRatio: 1\r\n            SceneCaptureType: 'Standard'\r\n                 UnknownTags: [1x1 struct]\r\n\r\n<\/pre>
    Do you have questions about imfinfo<\/tt>? Do you ever use it for writing batch processing scripts? I'd be interested to hear about it, so please leave a comment below.<\/p>