Imagick::setImageFormat

(PECL imagick 2, PECL imagick 3)

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

Description

public Imagick::setImageFormat(string $format): bool

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.

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 7 notes

down

nathan at crause dot name ¶

14 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".

down

optymizer at yahoo dot com ¶

16 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!

down

layzee dot dk at gmail dot com ¶

11 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().

down

markus dot s dot schmitz at gmail dot com ¶

11 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.

down

andy at live dot nl ¶

15 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();

?>

down

Devo ¶

17 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" );
?>

down

barclay[dot]loftus[at]gmail.com ¶

16 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;
?>

＋add a note