Imagick::newImage

    (PECL imagick 2, PECL imagick 3)

    Imagick::newImage — Создаёт новое изображение

    Описание

    public Imagick::newImage(
        int $cols,
        int $rows,
        mixed $background,
        string $format = ?
    ): bool

    Создаёт новое изображение и связывает значение ImagickPixel в качестве цвета фона

    Список параметров

    cols

    Столбцы в новом изображении

    rows

    Строки в новом изображении

    background

    Цвет фона, используемый для этого изображения

    format

    Формат изображения. Этот параметр был добавлен в Imagick версии 2.0.1.

    Возвращаемые значения

    Функция в случае успешной работы возвращает true.

    Ошибки

    Функция выбрасывает исключение ImagickException, если возникла ошибка.

    Список изменений

    Версия Описание
    PECL imagick 2.1.0 Теперь допускается строка, представляющая цвет, в качестве третьего параметра. Ранее допускался только объект ImagickPixel.

    Примеры

    Пример #1 Пример использования Imagick::newImage():

    Создание нового изображения и его отображение.

    <?php

    $image     = new Imagick();
    $image->newImage(100, 100, new ImagickPixel('red'));
    $image->setImageFormat('png');

    header('Content-type: image/png');
    echo     $image;

    ?>

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 3 notes

    up
    44
    christian dot reinecke at web dot de
    15 years ago
    The color value (3rd argument) for transparency is "none".
    up
    5
    jfalner1 at gmail dot com
    10 years ago
    As it isn't obvious, the cols and rows arguments correspond to the width and height of the new image, expressed in pixels. Example #1 would generate a 100 pixel by 100 pixel image.
    up
    1
    Eduard Sukharev
    8 years ago
    It's not obvious and may be related only to some specific versions of ImageMagick (tested only for 6.7.7 and 6.8.9), but $cols and $rows must be a positive non-zero value.

    <?php

    $image     = new Imagick();
    $image->newImage(0, 100, new ImagickPixel('red'));
    $image->setImageFormat('png');

    file_put_contents('image.png', $image);
    ?>

    In this case imagemagick will crash without throwing any exception and you'll get something along the lines (in your apache error log or console output):

    unable to acquire cache view `No such file or directory' @ fatal/cache-view.c/AcquireAuthenticCacheView/121.

    This might be the case when you calculate $cols and $rows (say, based on user input and predefined target image DPI):

    <?php

    $image     = new Imagick();
    $img->newImage($userInput->getWidth() * $defaultPpi, $userInput->getHeight() * $defaultPpi, new ImagickPixel('white'));
    ?>

    In this case if user requested image with 0.006 width (in inches), the code would work for $defaultPpi = 300 ppi, but would crash for
    $defaultPpi = 72 ppi
    ＋Добавить
    To Top