Slashdot Mirror


The Definitive Guide to ImageMagick

Michael J. Ross writes "To modify a digital image, most computer users turn to a GUI-based image processing application, such as Photoshop. However, while Photoshop and many other similar programs can process multiple images in batch mode, they still require manual usage, and thus typically are unable to process images via a command line or within a second application. Those capabilities call for a programmatic digital image manipulation tool such as ImageMagick, which is explored in a relatively new book, The Definitive Guide to ImageMagick." Read the rest of Michael's review. The Definitive Guide to ImageMagick author Michael Still pages 335 publisher Apress rating 7 reviewer Michael J. Ross ISBN 1590595904 summary An introduction to using ImageMagick for digital image manipulation.

The author of this title is Michael Still, a programmer who gained experience with ImageMagick during his eight years of working on imaging applications, as well as writing articles on ImageMagick for IBM DeveloperWorks. Apress maintains a Web page for the title, where a visitor can purchase the electronic version of the book, read its table of contents, or download its source code or a sample chapter (Chapter 4 — Using Other ImageMagick Tools) in PDF format. They also have a link where readers can submit errata — and apparently be the first to do so, as there are no existing errata listed on the Web page.

The book's 335 pages are organized into a dozen chapters, following an introduction and a few other standard sections, including a forward written by ImageMagick's principal architect, Christy, who briefly explains the product's 20 years of history, development, and lack of decent documentation. That is where this book is intended to fill the gap, and Christy notes that most future questions about ImageMagick will be answered by pointing people to this book, as is also noted on ImageMagick's homepage.

The first chapter of the book explains how to install and configure ImageMagick, for several Linux distros, as well as Microsoft Windows — using the precompiled versions, or by compiling from ImageMagick's source code. The chapter is wrapped up with a brief description of ImageMagick's online help, debug output, verbose output, and version information. The next ten chapters fall into two categories: ImageMagick usage as a standalone, and from within other applications. The first category of chapters covers basic image manipulation, compression, other metadata, ImageMagick tools, artistic transformations, other image transformations, and drawing commands. The second category discusses how to utilize ImageMagick from within programs written in Perl, C, Ruby, and PHP. The 12th and final chapter is quite brief, and describes where to find online help (Web sites, blogs, mailing lists, and forums) and where to report any apparent bug in ImageMagick.

For Windows users, the first chapter may begin badly, as the author fails to explain which precompiled version the reader should select if they wish to install ImageMagick on a Windows PC. For each version, there are four flavors to choose from. But which one is right for the reader? "static" vs. "dll?" "Q16" vs. "Q8?" What are the differences? The ImageMagick Web site and FTP file listings appear to have no README file or installation help file to explain which flavor you should download. The book should provide some assistance here, but does not. The former topic, static versus DLL, is mentioned only in reference to compiling ImageMagick from source — information which the reader will probably never see, should they choose to install the precompiled binaries and get started on ImageMagick as quickly as possible.

The latter topic is not covered at all — not even in the index, where a "quantum depth" entry would be useful. For those readers who are interested, "Q8" indicates 8 bits-per-pixel components, and "Q16" means 16 bits-per-pixel. The latter allows one to read or write 16-bit images without losing precision, but requires twice as much resources as Q8. Apparently Q16 is the best choice for medical or scientific images, or those with limited contrast. Otherwise, Q8 should be sufficient, and offers greater performance.

The material most likely to be read, referenced, and valued in this book, is the chapters devoted to explaining how to use ImageMagick for resizing, compressing, transforming, and drawing digital images. Most of these first-category chapters begin with a concise summary of the theory put into practice throughout the rest of the respective chapter — a wise inclusion in each case, since even the most experienced computer programmers and other users have had no instruction or experience in image theory. All of these chapters do a competent job of explaining what each ImageMagick command is used for, and then illustrating it with a straightforward example.

The most glaring deficiency in these chapters, and the book as a whole, is that far too many of the book's figures (digital images, naturally) fail to reflect what is intended to be conveyed by each figure. This is primarily because they are all in black-and-white, and in many cases do not offer the size and resolution necessary. In other words, there are many cases where the "before" and "after" images look almost identical. In the cases of color manipulation, most of those black-and-white images are of little value — occasionally laughably so.

The second-category chapters, covering ImageMagick usage with Perl, C, Ruby, and PHP, proved disappointing, primarily due to their narrow focus, and lack of tips, recommendations, and coverage of the APIs' capabilities. The details are presented in the form of a single example for each language. For instance, the Perl chapter devotes too many pages to source code listings of a Perl program written by the author, that few readers would probably download from the publisher's Web site, much less read.

Nonetheless, this book should be useful to any programmer interested in making the most of ImageMagick's capabilities, and that is not just because it is the only ImageMagick book on the market. Michael Still certainly had his work cut out for him when he agreed to document the bulk of what ImageMagick can do. It is unfortunate that the color images that he created for the book cannot be seen by the reader, and that the Windows binary versions and ImageMagick APIs, were given short shrift. We can hope that future editions of this book will be significantly strengthened, such as including color and higher resolution images where needed — even if it requires grouping them together within the book, if that reduces production costs.

Lastly, it should be mentioned that, as a smaller technical publisher, Apress is not resting on its laurels, and is not only scheduled to release an impressive variety of programming books this year, but their customer support — at least in my experience — was outstanding, as there was a problem with the shipping of this title, and they bent over backwards to make it right.

Michael J. Ross is a freelance writer, computer consultant, and the editor of the free newsletter of PristinePlanet.com."

You can purchase The Definitive Guide to ImageMagick from bn.com. Slashdot welcomes readers' book reviews -- to see your own review here, read the book review guidelines, then visit the submission page.

23 of 173 comments (clear)

  1. yes, you can command line photoshop by Anonymous Coward · · Score: 4, Interesting

    Just create an action which does what you want, then you can export an "EXE" which takes as command line argument the file you want to process, and optionally, the output. Works like a charm.

    1. Re:yes, you can command line photoshop by Anonymous Coward · · Score: 5, Insightful
      Oh, yes, that's much easier than
      for img in `ls *.jpg`
      do
        convert -sample 25%x25% $img thumb-$img
      done
      And the million other things you can do from the command line without making task-specific exes.

    2. Re:yes, you can command line photoshop by tpgp · · Score: 4, Insightful

      Just create an action which does what you want, then you can export an "EXE" which takes as command line argument the file you want to process, and optionally, the output. Works like a charm.

      Maybe the author should have said 'useful commmand line processing' or similar.

      1) Exes are not very useful for osx or linux users.

      2) You need a copy of photoshop for every server you wish to run your exported exe on.

      3) You have to create a different 'exe' for each action.

      Photoshop is not even slightly useful for the sort of areas that imagemagick excels in.

      --
      My pics.
    3. Re:yes, you can command line photoshop by base_chakra · · Score: 4, Informative

      Just create an action which does what you want, then you can export an "EXE" which takes as command line argument the file you want to process, and optionally, the output. Works like a charm.

      I've batch-processed sets comprising about 2,500–4,000 images (greyscale GIFs) both with command-line tools and with Photoshop CS. On each occasion, Photoshop took several hours longer than the specialized CLI apps to complete the jobs. The difference is even more dramatic when executing Photoshop Actions from within Photoshop, since the screen updates further increase processing time (an effect only slightly mitigated by hiding subwindows).

    4. Re:yes, you can command line photoshop by pclminion · · Score: 4, Funny
      for img in `ls *.jpg`

      Am I the only person who laughed out loud?

    5. Re:yes, you can command line photoshop by Anonymous Coward · · Score: 5, Informative

      don't be a dummy

      for i in *jpg; do
        convert -sample 25%x25% "$i" "thumb-$i"
      done

      works perfectly with any special characters, including spaces and newlines, in the filename

    6. Re:yes, you can command line photoshop by niskel · · Score: 3, Informative

      I was refering to the original script that used `ls *.jpg` instead of simply *.jpg. The original script will choke on images with a space in the file name.

    7. Re:yes, you can command line photoshop by foxtrot · · Score: 4, Interesting

      Am I the only person who laughed out loud?

      Probably not, but I think it's kinda silly. If you're on a machine where you're worried about spawning off one more process, I feel sorry for you. :)

      Remember, there's More Than One Way To Do It. That's kinda the beauty of Unix. I do like that 'for i in *.jpg' takes a lot fewer keystrokes, mind, but just because it uses fewer keystrokes and doesn't exec ls doesn't make it the Only Right Way.

      Indeed, for some things, it may not be the Right Way at all. Ferinstance:

      for i in `ls fullsize`
      do
      convert -scale 800x800 fullsize/$i $i
      convert -scale 150x150 fullsize/$i thumbnails/$i
      done

      It's cheaper to exec ls here than it is to crunch $i each time to strip 'fullsize/' off the front. If you really wanted to streamline it (and if you're that worried about it, why the heck are you writing a shell script?) you could throw $PWD at a temporary variable, cd into fullsize, run your converts, but why bother with the extra typing or lines of code when this runs correctly, makes sense, and is only exec'ing the ls once?

      But really what it boils down to, to me, is if exec'ing ls once instead of using the shell builtin * is causing problems on your system, you've got bigger problems than your shellscript-fu.

      -F

    8. Re:yes, you can command line photoshop by Mr.+Underbridge · · Score: 4, Funny
      works perfectly with any special characters, including spaces and newlines, in the filename

      Wow. Anyone who puts newlines in a filename should be beaten publically.

  2. ImageMagick is good stuff. by tetrahedrassface · · Score: 4, Informative

    Imagemagick is good stuff, ive used it for a while now. Although I didn't buy a book to learn how, i just went here, for some great samples of uses:
    http://www.cit.gu.edu.au/~anthony/graphics/imagick 6/
    PIL isn't too shabby either http://www.pythonware.com/library/pil/handbook/ind ex.htm
    Powerful stuff, maybe the book is not that great i don't know, but imagemagick and PIL are!

  3. Better image examples online by digitaldc · · Score: 3, Informative

    In other words, there are many cases where the "before" and "after" images look almost identical. In the cases of color manipulation, most of those black-and-white images are of little value -- occasionally laughably so.

    Haha, that was funny...well if you need to see what it actually does, their examples site has some better images.

    --
    He who knows best knows how little he knows. - Thomas Jefferson
  4. Re:Manual vs. Automatic by wanerious · · Score: 4, Informative

    As an example, in my previous job for a weather company, we'd generate large images of geographic data for a certain area of interest, and separately generate radar or satellite or lightning maps over the same area. We'd then use ImageMagick to combine all the separate images together, along with further generated warning areas, icons, and forecasts representing weather phenomena of interest (tornadoes, mesocyclones, hurricanes) and usually some sort of written annotation (time of image, source). ImageMagick was/is really useful.

  5. Re:Manual vs. Automatic by syphax · · Score: 5, Informative

    Why would one need batch-sized automatic image editing?

    Examples of edits that don't need to be manual: Thumbnails. Resizing. Addition of timestamps/watermarks/copyright info. Conversion to other formats. Motion detection. Mosaics. Proof sheets.

    Gentle readers: just because something doesn't seem useful or make sense to you does not mean that it is categorically useless or senseless for everyone.

    --
    Simple Unexpected Concrete Credible Emotional Stories
  6. ImageMagick + Rails == good by tcopeland · · Score: 4, Informative

    I did some nice charts for the indi admin pages; worked out really nicely thanks to Gruff + RMagick.

    I did have a spot of trouble getting the fonts working at first, but once that was fixed, it was easy to create some nice charts with very little code.

  7. Re:Manual vs. Automatic by fan777 · · Score: 3, Interesting

    Automatic editing is especially useful for web applications where image manipulation occurs based on form choices or happens in the background e.g. thumbnails being created on the fly, allowing certain types of filtering, etc.

    In my senior year of college, we came up with a project to create an online photo storage and editing site much like Yahoo's Flickr. This site allowed users to crop photos, transform pictures to black and white, and adjust contrast amongst other things. We used ImageMagick to do all this, shooting in actions from the command line.

  8. Re:Manual vs. Automatic by prockcore · · Score: 3, Informative

    Why would one need batch-sized automatic image editing?

    How do you think flickr makes perfect square thumbnails automatically?

    convert in.jpg -thumbnail x200 -resize '200x' -resize 50% -gravity center -crop 100x100+0+0 +repage out.jpg

    Any website that takes a user-uploaded photo needs to do something to it. From thumbnails to capping the image size.

  9. Wikipedia uses it by interiot · · Score: 4, Informative

    For what it's worth, Wikipedia uses ImageMagick to automatically resize png/jpeg/gif images for articles (eg. photos uploaded at 1920x1080 can be displayed at 300x169 in an article). So it's good enough to run on a high-traffic website (and is pretty flexible for ad-hoc command-line use too).

    1. Re:Wikipedia uses it by theurge14 · · Score: 3, Informative

      Just to clarify, ImageMagick is not called everytime someone views that smaller thumbnail everytime they view the Wikipedia article, ImageMagick is called upon only when the orginal article was edited, the output is saved by MediaWiki as a totally new image into an images folder. From then on, it's a straight HTML img tag.

      I just wanted to make sure people didn't think ImageMagick is being called upon the MediaWiki software every time the image got a page hit.

  10. Not just for command line use! by PeeAitchPee · · Score: 3, Informative

    ImageMagick's function library is also accessible through a variety of APIs for your favorite language -- scripting or otherwise. If you haven't used it, try it . . . it's GPL and it Rawks (with a capital "r"). ;-)

  11. Flickr Hacks by jbum · · Score: 3, Interesting

    My book, Flickr Hacks, contains a number of examples of using ImageMagick (via the Perl API) with Flickr. This is one area where it really shines. I used ImageMagick to create these mosaic posters, the Flickr Colr Pickr and other cool things.

  12. check out netpbm too by resfilter · · Score: 3, Informative

    those interested in command line image processing, should check out netpbm too. it's really neat

    instead of a single image processing program, netpbm is a massive collection of programs all using a small set of proprietery formats (they are all compatible with each other). you use pipes for communication between them, giving you some more flexibility.

    for example:

    pngtopnm foo.png | pnmscale -xsize=600 ysize=400 | pnmtojpeg > foo.jpg

    the other advantage is, their proprietery formats were designed to be easy to use, so coding your own netpbm programs is much easier than rewriting imagemagick for a specific task.

  13. Re:Manual vs. Automatic by temojen · · Score: 3, Informative

    If you're doing multiple transformations to the same file, PerlMagick is much faster than ImageMagick, since you only have to load and convert to internal format once for each file. One project I worked on thrashed badly as a BASH-ImageMagick script, but could be run in the background while the computer scanned (300 DPI, legal size, with a document feeder, 4ppm) as a PerlMagick script.

  14. Re:Manual vs. Automatic by plover · · Score: 3, Interesting
    We use it for "normalizing" images. We have a device with a fixed resolution and some pretty severe limitations on the sizes, resolutions, formats, etc., of images we can send to it.

    The original developer had his "submit image here" web page load the image into some Windows "object" format, and then do a bunch of tests, like 'reject if is it > 500 pixels wide' and 'warn if color depth > 2' and 'reject if not .BMP format'. But this is horrible for the users -- they may not have the image in the required format, and some won't have the knowledge to get it into the format we require.

    I told him to just inline imagemagick's convert function, and output the exact format he requires. The sanitization is now very simple: if imagemagick can read it and successfully convert it to the desired format, it's good. That means we don't even have to tell our users to use .BMP or .GIF or .whatever -- if they can get us an image in a format recognized by imagemagick, we can use it. We've published guidelines that say "if you make your image conform to such-and-such attributes, our output will be as good as we can possibly make it." We're not promising an image that is horribly tortured by Imagemagick will print as well as they desire, but at least our app won't crash if they try to feed us garbage, or try to blow us up with a 10MB .TIFF or .WMF.

    --
    John