Imagick::setImageFormat

(PECL imagick 2.0.0)

Imagick::setImageFormat — Sets the format of a particular image

Description

bool Imagick::setImageFormat ( string $format )

Sets the format of a particular image in a sequence.

Parameters

format: String presentation of the image format. Format support depends on the ImageMagick installation.

Return Values

Returns TRUE on success.

User Contributed Notes

nathan at crause dot name

5 years ago


For those of you completely confused by the utter lack of documentation for this class (including notes being dropped, probably this one included), the differences between any "setXXX" and "setImageXXX" seems to be entirely dependently on HOW the image was loaded.

If the image was loaded at object constructor time, it seems that you use "setXXX" - if you loaded it after the fact (such as via "readImageBlob") then you use "setImageXXX".

This is irregular, however. For example:

<?php
        $image = new Imagick();

        $image->setResolution(300, 300);
        $image->readImageBlob(...);
        // convert the output to JPEG
        $image->setImageFormat('jpeg');
        $image->setImageCompressionQuality(90);
?>

Note that we use "setResolution" not "setImageResolution".

optymizer at yahoo dot com

8 years ago


The previous example did not work for me. I received an error that the IMagick object cannot be converted to string.

This example uses the IMagick::getImageBlob() method to properly output the contents of the converted image:

function getImage($filename)
{
            $image->readImage($filename);
            $image->setImageFormat("png");
            header("Content-type: image/png");
            echo $image->getImageBlob();
}

Hope this helps!

Devo

8 years ago


A list of formats can be found here: http://www.imagemagick.org/script/formats.php

Formats marked with a W can be output to file with writeImage (capabilities depend on your particular installation of course).

For example:

<?php
// create new imagick object from image.jpg
$im = new Imagick( "image.jpg" );

// change format to png
$im->setImageFormat( "png" );

// output the image to the browser as a png
header( "Content-Type: image/png" );
echo $im;

// or you could output the image to a file:
//$im->writeImage( "image.png" );
?>

markus dot s dot schmitz at gmail dot com

3 years ago


If you use writeFile or writeFiles without setting the format, it is automatically set according to the file extension used within the parameter of writeFile.

layzee dot dk at gmail dot com

2 years ago


This method only affects the individual loaded/constructed images.

To set the format of the entire object, use the Imagick::setFormat method. E.g. load TIFF files, then use setFormat('pdf') on the Imagick object, then writeImagesFile('foo.pdf') or getImagesBlob().

andy at live dot nl

7 years ago


I had a problem when using $im->setImageFormat('jpeg');

Image colors got inverted when i converted pdfs to jpg thumbs.

Had to add $im->setImageColorspace(255); to solve it.



<?php

// read page 1

$im = new imagick( 'test.pdf[ 0]' );



// convert to jpg

$im->setImageColorspace(255);

$im->setCompression(Imagick::COMPRESSION_JPEG);

$im->setCompressionQuality(60);

$im->setImageFormat('jpeg');



//resize

$im->resizeImage(290, 375, imagick::FILTER_LANCZOS, 1);  



//write image on server

$im->writeImage('thumb.jpg');

$im->clear();

$im->destroy();

?>

barclay[dot]loftus[at]gmail.com

8 years ago


Another note about image output. For jpeg images, the quality is adjusted by Imagick::setCompressionQuality(). 

<?php
$img->setCompressionQuality(90);
$img->setImageFormat('jpeg');
header('Content-type: image/jpg');
echo $img;
?>