Создаёт новое палитровое изображение

# imagecreate

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecreate — Создаёт новое палитровое изображение

### Описание

function imagecreate(int `$width`, int `$height`): GdImage|false

Функция imagecreate() возвращает идентификатор пустого изображения заданного размера.

Рекомендуют пользоваться функцией imagecreatetruecolor() вместо функции imagecreate(), поскольку она обрабатывает изображения с максимально возможным качеством. Если необходимо вывести палитру изображения, то функцию imagetruecolortopalette() вызывают непосредственно перед сохранением изображения функцией imagepng() или imagegif().

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

`width`

  Ширина изображения.

`height`

  Высота изображения.

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

Функция возвращает объект изображения, если выполнилась успешно, или `false`, если возникла ошибка.

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

Версия | Описание
--- | ---
8.0.0 | В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource).

### Примеры

Пример #1 Пример создания нового GD-потока изображения и вывод изображения

    <?php

    header("Content-Type: image/png");

    $im = @imagecreate(110, 20)
        or die("Невозможно создать поток изображения");

    $background_color = imagecolorallocate($im, 0, 0, 0);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);
    imagepng($im);

    ?>

Вывод приведённого примера будет похож на:

### Смотрите также

- imagecreatetruecolor() - Создаёт новое truecolor-изображение

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open