imagegd2

    (PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

    imagegd2 — Вывод GD2 изображения в браузер или файл

    Описание

    imagegd2(
        GdImage$image,
        ?string$file = null,
        int$chunk_size = 128,
        int$mode = IMG_GD2_RAW
    ): bool

    Выводит GD2 изображение в заданный файл file.

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

    image

    Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().

    file

    Путь, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен null, изображение будет выведено в поток вывода в бинарном виде.

    chunk_size

    Размер части изображения.

    mode

    Либо IMG_GD2_RAW, либо IMG_GD2_COMPRESSED. По умолчанию IMG_GD2_RAW.

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

    Возвращает true в случае успешного выполнения или false, если возникла ошибка.

    Предостережение

    Однако, если libgd не может вывести изображения, эта функция вернёт true.

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

    ВерсияОписание
    8.0.3file теперь допускает значение null.
    8.0.0 Параметр image теперь ожидает экземпляр класса GdImage; раньше параметр ждал корректный gd-ресурс (resource).

    Примеры

    Пример #1 Вывод GD2 изображения

    <?php
    // Создание пустого изображения и добавление на него текста
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5, "Простая Текстовая Строка", $text_color);

    // Вывод изображения
    imagegd2($im);

    // Освобождение памяти
    imagedestroy($im);
    ?>

    Пример #2 Сохранение GD2 изображения

    <?php
    // Создание пустого изображения и добавление на него текста
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5, "Простая Текстовая Строка", $text_color);

    // Сохранение изображения
    // Формат файлов GD2 - .gd2, смотрите http://www.libgd.org/GdFileFormats
    imagegd2($im, 'simple.gd2');

    // Освобождение памяти
    imagedestroy($im);
    ?>

    Примечания

    Замечание:

    Формат GD2 используется в основном для быстрой загрузки частей изображений. Следует учитывать, что GD2 формат может использоваться только в GD2-совместимых приложениях.

    Внимание

    Форматы изображений GD и GD2 являются проприетарными форматами изображений libgd. Они должны рассматриваться как устаревшие и должны использоваться только для целей разработки и тестирования.

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

    • imagegd() - Вывод GD-изображения в браузер или в файл
    To Top