Imagick::setImageFormat

(PECL imagick 2, PECL imagick 3)

Imagick::setImageFormat — 为图片设置指定的格式

说明

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

为图片设置指定的格式

参数

format: 表示图片格式的一个字符串。支持的格式依赖于 ImageMagick 的安装。

返回值

成功时返回 true。

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 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

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

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