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
    42
    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
    9 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