Mikko's blog » Imagick http://valokuva.org My Thoughts Exactly Sat, 19 Sep 2009 12:07:56 +0000 en hourly 1 http://wordpress.org/?v=3.0.1 Imagick and Gmagick builds available for Windows http://valokuva.org/?p=161 http://valokuva.org/?p=161#comments Sat, 19 Sep 2009 03:23:42 +0000 Mikko Koppanen http://valokuva.org/?p=161 The new Windows build page http://valokuva.org/magick/ contains builds for both Imagick and Gmagick. All builds are done using VC9 and PHP 5.3.

ImageMagick builds are QuantumDepth 16 (default).
GraphicsMagick builds are QuantumDepth 8 (default).

Please note that these builds won’t work with the official PHP.net binaries which are compiled using VC6.

Edit: Pierre corrected me that there are official VC9 builds of PHP available at http://windows.php.net/download/

]]> http://valokuva.org/?feed=rss2&p=161 15 Perspective transformations http://valokuva.org/?p=112 http://valokuva.org/?p=112#comments Wed, 04 Feb 2009 20:48:21 +0000 Mikko Koppanen http://valokuva.org/?p=112 Finally (after a long break) I managed to force myself to update the PHP documentation and this time it was distortImage code example. Things have been hectic lately but that does not quite explain the 6 months(?) break between this and the previous post. As a matter of a fact there is no excuse for such a long silence so I will try to update this blog a bit more often from now on.

Back in the day I used to blog the examples and update the documentation if I remembered but I am trying to fix this bad habit. Most of the latest examples have been updated in to the manual. In the case of the two last examples I updated the documentation first and then blogged on the subject.

I took some time to actually understand the perspective transformations properly using the excellent ImageMagick examples (mainly created by Anthony Thyssen) as a reference. The basic idea of perspective distortion seems simple: to distort the control points to new locations. Grabbing the syntax for Imagick was easy, an array of control point pairs in the form of:

PLAIN TEXT
PHP:
  1. array(source_x, source_y, dest_x, dest_y ... )

The following example uses the built-in checkerboard pattern to demonstrate perspective distortion:

PLAIN TEXT
PHP:
  1. <?php
  2. /* Create new object */
  3. $im = new Imagick();
  4.  
  5. /* Create new checkerboard pattern */
  6. $im->newPseudoImage(100, 100, "pattern:checkerboard");
  7.  
  8. /* Set the image format to png */
  9. $im->setImageFormat('png');
  10.  
  11. /* Fill background area with transparent */
  12. $im->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_TRANSPARENT);
  13.  
  14. /* Activate matte */
  15. $im->setImageMatte(true);
  16.  
  17. /* Control points for the distortion */
  18. $controlPoints = array( 10, 10,
  19.                         10, 5,
  20.  
  21.                         10, $im->getImageHeight() - 20,
  22.                         10, $im->getImageHeight() - 5,
  23.  
  24.                         $im->getImageWidth() - 10, 10,
  25.                         $im->getImageWidth() - 10, 20,
  26.  
  27.                         $im->getImageWidth() - 10, $im->getImageHeight() - 10,
  28.                         $im->getImageWidth() - 10, $im->getImageHeight() - 30);
  29.  
  30. /* Perform the distortion */ 
  31. $im->distortImage(Imagick::DISTORTION_PERSPECTIVE, $controlPoints, true);
  32.  
  33. /* Ouput the image */   
  34. header("Content-Type: image/png");
  35. echo $im;
  36. ?>

Here is the source image:
checker before

And the result:
after

]]> http://valokuva.org/?feed=rss2&p=112 33 Fill patterns http://valokuva.org/?p=102 http://valokuva.org/?p=102#comments Sat, 26 Apr 2008 09:15:28 +0000 Mikko Koppanen http://valokuva.org/?p=102 My work life has been quite busy lately and I haven't had a chance to sit down and blog. I have been touring around London and some parts of the northern England consulting and organizing some training here and there. Luckily I have had the chance to do some work on Imagick and the 2.2.0 beta release is getting closer. The internal structure was completely restructured and broken down into several smaller files. During this time Imagick was adapted to follow the PHP Coding Standards more closely. Still a work in progress :)

I committed slightly modified version of this example to PHP Manual http://uk.php.net/manual/en/imagick.examples.php page a few days ago. The example illustrates using an image as a part of a named fill pattern. The fill pattern is used to annotate text but the named pattern could also be used to fill any shapes that allow fill to be specified (include circles, ellipses, rectangles, polygons etc etc). The code itself is pretty straight forward: Read the image, create the pattern and use the pattern as a fill.

The ice formations image is from http://www.photoeverywhere.co.uk/west/winterholiday/slides/iceformations5679.htm.

PLAIN TEXT
PHP:
  1. <?php
  2.  
  3. /* Create a new imagick object */
  4. $im = new Imagick( 'iceformations5679.JPG' );
  5.  
  6. /* Create imagickdraw object */
  7. $draw = new ImagickDraw();
  8.  
  9. /* Start a new pattern called "ice" */
  10. $draw->pushPattern( 'ice'  , 0  , 0  , 50  , 50 );
  11.  
  12. /* Composite the image on the pattern */
  13. $draw->composite( Imagick::COMPOSITE_OVER, 0, 0, 50, 50, $im );
  14.  
  15. /* Close the pattern */
  16. $draw->popPattern();
  17.  
  18. /* Use the pattern called "ice" as the fill */
  19. $draw->setFillPatternURL( '#ice' );
  20.  
  21. /* Set font size to 52 */
  22. $draw->setFontSize( 52 );
  23.  
  24. /* Annotate some text */
  25. $draw->annotation( 5, 50, "Hello World!" );
  26.  
  27. /* Create a new canvas and white image */
  28. $canvas = new Imagick();
  29. $canvas->newImage( 310, 70, "white" );
  30.  
  31. /* Add black border around the resulting image */
  32. $canvas->borderImage( 'black', 1, 1 );
  33.  
  34. /* Draw the ImagickDraw on to the canvas */
  35. $canvas->drawImage( $draw );
  36.  
  37. /* Set the format to PNG */
  38. $canvas->setImageFormat( 'png' );
  39.  
  40. /* Output the image */
  41. header( "Content-Type: image/png" );
  42. echo $canvas;
  43. ?>

And the result is here:

]]> http://valokuva.org/?feed=rss2&p=102 41 phplondon conference 2008 http://valokuva.org/?p=101 http://valokuva.org/?p=101#comments Sun, 02 Mar 2008 19:35:59 +0000 Mikko Koppanen http://valokuva.org/?p=101 To summarize it: I had fun :) My conference preparations started about two weeks before the conference. The PHPLondon fellows (Paul, Matt and Richard) asked me to do a small presentation about Imagick at the pre-conference social event. The presentation I assembled ended up being a little over two hours, give or take. The hardest part was to trim down from two hours to about 40 minutes (I didn't want to bore the people with too many code examples). The slides are available at http://valokuva.org/talks if you need them for some reason.

My conference day was pretty hectic from the beginning to the end. I gave a few demos about the products that we represent and the moment I opened my mouth for the first time people started leaving the room. I hope that it had something to do with the "My Framework is better than yours?" talk starting at the same time ;)

I met quite a lot of new people at the conference and of course it was nice to see the familiar faces from other conferences and PHPLondon meetings. I was especially happy that I was able to answer the questions Nigel James had ;)

A huge thanks to the organizers for making this day possible!

]]> http://valokuva.org/?feed=rss2&p=101 5 Seam carving http://valokuva.org/?p=99 http://valokuva.org/?p=99#comments Wed, 13 Feb 2008 18:38:21 +0000 Mikko Koppanen http://valokuva.org/?p=99 Today I was reading trough the ImageMagick ChangeLog and noticed an interesting entry. "Add support for liquid rescaling". I rushed to check the MagickWand API docs and there it was: MagickLiquidRescaleImage! After about ten minutes of hacking the Imagick support was done. Needless to say; I was excited :)

For those who don't know what seam carving is check the demo here. More detailed information about the algorithm can be found here: "Seam Carving for Content-Aware Image Resizing" by Shai Avidan and Ariel Shamir

To use this functionality you need to install at least ImageMagick 6.3.8-2 and liblqr. Remember to pass --with-lqr to ImageMagick configuration line. You can get liblqr here: http://liblqr.wikidot.com/. The Imagick side of the functionality should appear in the CVS today if everything goes as planned.

Here is a really simple example just to illustrate the results of the operation. The parameters might be far from optimal (didn't do much testing yet). The original dimensions of image are 500x375 and the resulting size is 500x200.

Update: the functionality is pending until license issues are solved.

PLAIN TEXT
PHP:
  1. <?php
  2.  
  3. /* Create new object */
  4. $im = new Imagick( 'test.jpg' );
  5.  
  6. /* Scale down */
  7. $im->liquidRescaleImage( 500, 200, 3, 25 );
  8.  
  9. /* Display */
  10. header( 'Content-Type: image/jpg' );
  11. echo $im;
  12.  
  13. ?>

The original image by flickr/jennconspiracy

result

And the result:

result

Update. On kenrick's request here is an image which is scaled down to 300x300

result2

]]> http://valokuva.org/?feed=rss2&p=99 50 Typesetting http://valokuva.org/?p=93 http://valokuva.org/?p=93#comments Wed, 16 Jan 2008 22:07:28 +0000 Mikko Koppanen http://valokuva.org/?p=93 Ever had the situation where you have a piece of string which you need to overlay on an image? Maybe a situation where the area reserved for the string is known in pixels but you need to know the font size to fill most of the area? Think no more!

Here is a small example of how to fit a certain piece of a string on to an area of which you know the width and the height or only the width. The magic happens through the ImageMagick CAPTION: format. You can see from the example images how the parameters actually affect the image.

PLAIN TEXT
PHP:
  1. <?php
  2.  
  3. /* How wide is our image */
  4. $image_width = 200;
  5.  
  6. /* Give zero for autocalculating the height */
  7. $image_height = 200;
  8.  
  9. /* Specify the text */
  10. $text = "Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
  11.          Mauris lectus mi, mattis non, euismod vel, sagittis nec, ipsum.";
  12.  
  13. /* Instanciate imagick */
  14. $im = new Imagick();
  15.  
  16. /* Create new image using caption: pseudo format */
  17. $im->newPseudoImage( $image_width, $image_height, "caption:" . $text );
  18.  
  19. /* Put 1px border around the image */
  20. $im->borderImage( 'black', 1, 1 );
  21.  
  22. /* PNG format */
  23. $im->setImageFormat( "png") ;
  24.  
  25. /* Output */
  26. header( "Content-Type: image/png" );
  27. echo $im;
  28.  
  29. ?>

Here is image with width 100 and height 0:

width_100_height_0.png

Width 100 Height 50:

width_100_height_50.png

Width 200 Height 200 (as you can see the font size is now larger):

width_200_height_200.png

]]> http://valokuva.org/?feed=rss2&p=93 40 Padding thumbnail with color http://valokuva.org/?p=92 http://valokuva.org/?p=92#comments Fri, 11 Jan 2008 12:30:34 +0000 Mikko Koppanen http://valokuva.org/?p=92 I know, it's been a while since I last blogged. This is because a lot of things are happening in my personal life. I recently relocated to London from Finland and started a new job. Things are quite busy but I will try to post an example now and then. In the meanwhile I would like to hear about sites using Imagick, so if your project is not super secret please post an url and maybe a small explanation what you're doing with Imagick on the site. This is purely for my personal interest.

Anyway, to the point. Today's example originates from a question asked by a user. How do I thumbnail the image inside given dimensions proportionally and fill the "blank" areas with a color? Well, the answer is here :)

The code is for Imagick 2.1.0 but adapting to older versions should not be hard.

PLAIN TEXT
PHP:
  1. <?php
  2. /* Define width and height of the thumbnail */
  3. $width = 100;
  4. $height = 100;
  5.  
  6. /* Instanciate and read the image in */
  7. $im = new Imagick( "test.png" );
  8.  
  9. /* Fit the image into $width x $height box
  10. The third parameter fits the image into a "bounding box" */
  11. $im->thumbnailImage( $width, $height, true );
  12.  
  13. /* Create a canvas with the desired color */
  14. $canvas = new Imagick();
  15. $canvas->newImage( $width, $height, 'pink', 'png' );
  16.  
  17. /* Get the image geometry */
  18. $geometry = $im->getImageGeometry();
  19.  
  20. /* The overlay x and y coordinates */
  21. $x = ( $width - $geometry['width'] ) / 2;
  22. $y = ( $height - $geometry['height'] ) / 2;
  23.  
  24. /* Composite on the canvas  */
  25. $canvas->compositeImage( $im, imagick::COMPOSITE_OVER, $x, $y );
  26.  
  27. /* Output the image*/
  28. header( "Content-Type: image/png" );
  29. echo $canvas;
  30.  
  31. ?>

The source image:
test.png

The resulting image:
testphp.png

]]> http://valokuva.org/?feed=rss2&p=92 12 Creating buttons with Imagick http://valokuva.org/?p=84 http://valokuva.org/?p=84#comments Wed, 21 Nov 2007 08:24:38 +0000 Mikko Koppanen http://valokuva.org/?p=84 A fellow called kakapo asked me to create a button with Imagick. He had an image of the button and a Photoshop tutorial but unfortunately the tutorial was in Chinese. My Chinese is a bit rusty so it will take a little longer to create that specific button ;)

The button in this example is created after this tutorial http://xeonfx.com/tutorials/easy-button-tutorial/ (yes, I googled "easy button tutorial"). The code and the button it creates are both very simple but the effect looks really nice.

Here we go with the code:

PLAIN TEXT
PHP:
  1. <?php
  2.  
  3. /* Create a new Imagick object */
  4. $im = new Imagick();
  5.  
  6. /* Create empty canvas */
  7. $im->newImage( 200, 200, "white", "png" );
  8.  
  9. /* Create the object used to draw */
  10. $draw = new ImagickDraw();
  11.  
  12. /* Set the button color.
  13.    Changing this value changes the color of the button */
  14. $draw->setFillColor( "#4096EE" );
  15.  
  16. /* Create the outer circle */
  17. $draw->circle( 50, 50, 70, 70 );
  18.  
  19. /* Create the smaller circle on the button */
  20. $draw->setFillColor( "white" );
  21.  
  22. /* Semi-opaque fill */
  23. $draw->setFillAlpha( 0.2 );
  24.  
  25. /* Draw the circle */
  26. $draw->circle( 50, 50, 68, 68 );
  27.  
  28. /* Set the font */
  29. $draw->setFont( "./test1.ttf" );
  30.  
  31. /* This is the alpha value used to annotate */
  32. $draw->setFillAlpha( 0.17 );
  33.  
  34. /* Draw a curve on the button with 17% opaque fill */
  35. $draw->bezier( array(
  36.                     array( "x" => 10 , "y" => 25 ),
  37.                     array( "x" => 39, "y" => 49 ),
  38.                     array( "x" => 60, "y" => 55 ),
  39.                     array( "x" => 75, "y" => 70 ),
  40.                     array( "x" => 100, "y" => 70 ),
  41.                     array( "x" => 100, "y" => 10 ),
  42.                  ) );
  43.  
  44. /* Render all pending operations on the image */            
  45. $im->drawImage( $draw );
  46.  
  47. /* Set fill to fully opaque */
  48. $draw->setFillAlpha( 1 );
  49.  
  50. /* Set the font size to 30 */
  51. $draw->setFontSize( 30 );
  52.  
  53. /* The text on the */
  54. $draw->setFillColor( "white" );
  55.  
  56. /* Annotate the text */
  57. $im->annotateImage( $draw, 38, 55, 0, "go" );
  58.  
  59. /* Trim extra area out of the image */
  60. $im->trimImage( 0 );
  61.  
  62. /* Output the image */
  63. header( "Content-Type: image/png" );
  64. echo $im;
  65.  
  66. ?>

And here is a few buttons I created by changing the fill color value:

red

green

blue

]]> http://valokuva.org/?feed=rss2&p=84 22 Creating a reflection http://valokuva.org/?p=82 http://valokuva.org/?p=82#comments Mon, 19 Nov 2007 20:45:43 +0000 Mikko Koppanen http://valokuva.org/?p=82 Here is a simple example of creating a reflection of an image. The reflection is created by flipping the image and overlaying a gradient on it. Then both, the original image and the reflection is overlayed on a canvas.

This example is created for Imagick 2.1.x but with a little tuning it should work with earlier versions.

PLAIN TEXT
PHP:
  1. <?php
  2.  
  3. /* Read the image */
  4. $im = new Imagick( "strawberry.png" );
  5.  
  6. /* Thumbnail the image */
  7. $im->thumbnailImage( 200, null );
  8.  
  9. /* Create a border for the image */
  10. $im->borderImage( "white", 5, 5 );
  11.  
  12. /* Clone the image and flip it */
  13. $reflection = $im->clone();
  14. $reflection->flipImage();
  15.  
  16. /* Create gradient. It will be overlayd on the reflection */
  17. $gradient = new Imagick();
  18.  
  19. /* Gradient needs to be large enough for the image
  20. and the borders */
  21. $gradient->newPseudoImage( $reflection->getImageWidth() + 10,
  22.                            $reflection->getImageHeight() + 10,
  23.                            "gradient:transparent-black"
  24.                         );
  25.  
  26. /* Composite the gradient on the reflection */
  27. $reflection->compositeImage( $gradient, imagick::COMPOSITE_OVER, 0, 0 );
  28.  
  29. /* Add some opacity */
  30. $reflection->setImageOpacity( 0.3 );
  31.  
  32. /* Create empty canvas */
  33. $canvas = new Imagick();
  34.  
  35. /* Canvas needs to be large enough to hold the both images */
  36. $width = $im->getImageWidth() + 40;
  37. $height = ( $im->getImageHeight() * 2 ) + 30;
  38. $canvas->newImage( $width, $height, "black", "png" );
  39.  
  40. /* Composite the original image and the reflection on the canvas */
  41. $canvas->compositeImage( $im, imagick::COMPOSITE_OVER, 20, 10 );
  42. $canvas->compositeImage( $reflection, imagick::COMPOSITE_OVER,
  43.                         20, $im->getImageHeight() + 10 );
  44.  
  45. /* Output the image*/
  46. header( "Content-Type: image/png" );
  47. echo $canvas;
  48.  
  49. ?>

The source image:

source

And the result:

result

P.S. Please send me some new images which I can use in these examples ;)

]]> http://valokuva.org/?feed=rss2&p=82 21 ImagickPixelIterator is not read-only after all.. http://valokuva.org/?p=79 http://valokuva.org/?p=79#comments Thu, 15 Nov 2007 06:54:50 +0000 Mikko Koppanen http://valokuva.org/?p=79 A few days ago I got a help request from a user: "How do you change pixel color during the iteration with ImagickPixelIterator". My initial response was that ImagickPixelIterator is read-only.

Well, I have to admit I was wrong. After searching trough ImageMagick docs I stumbled across an example and noticed that PixelIterator (and therefor ImagickPixelIterator) is not read-only after all. I have tried the code like in this example before; without the syncIterator call after each row. After adding the Imagick::syncIterator call everything worked as expected.

This example will work with Imagick 2.1.0 (the RC1 was released yesterday) but with a little tweaking it should work with 2.0.x too.

PLAIN TEXT
PHP:
  1. <?php
  2.  
  3. /* Create new object with the image */
  4. $im = new Imagick( "strawberry.png" );
  5.  
  6. /* Get iterator */
  7. $it = $im->getPixelIterator();
  8.  
  9. /* Loop trough pixel rows */
  10. foreach( $it as $row => $pixels )
  11. {
  12.     /* For every second row */
  13.     if ( $row % 2 )
  14.     {
  15.         /* Loop trough the pixels in the row (columns) */
  16.         foreach ( $pixels as $column => $pixel )
  17.         {
  18.                 /* Paint every second pixel black*/
  19.                 if ( $column % 2 )
  20.                 {
  21.                         $pixel->setColor( "black" );
  22.                 }
  23.         }
  24.     }
  25.    
  26.     /* Sync the iterator, this is important
  27.     to do on each iteration */
  28.     $it->syncIterator();
  29. }
  30.  
  31. /* Display the image */
  32. header( "Content-Type: image/png" );
  33. echo $im;
  34.  
  35. ?>

The source image:

strawberry

The result image:

strawberry_result

]]> http://valokuva.org/?feed=rss2&p=79 18