Определяет цвет как прозрачный

# imagecolortransparent

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

imagecolortransparent — Определяет цвет как прозрачный

### Описание

function imagecolortransparent(GdImage `$image`, ?int `$color` = `null`): int

Функция получает или устанавливает прозрачность цвета в изображении `image`.

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

`image`
  Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.
`color`

  Идентификатор цвета, который добавила в палитру изображения функция imagecolorallocate().

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

Функция возвращает идентификатор нового (или текущего, если ничего не изменилось) цвета. При установке для параметра `color` значения `null`, когда в изображении нет прозрачных цветов, функция вернёт `-1`.

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

Версия | Описание
--- | ---
8.0.0 | Параметр `image` теперь принимает объект GdImage; раньше параметр принимал корректный `gd`-ресурс (resource).
8.0.0 | Параметр `color` теперь принимает значение `null`.

### Примеры

Пример #1 Пример определения цвета прозрачным функцией imagecolortransparent()

    <?php

    // Создадим изображение размером 55x30
    $im = imagecreatetruecolor(55, 30);
    $red = imagecolorallocate($im, 255, 0, 0);
    $black = imagecolorallocate($im, 0, 0, 0);

    // Сделаем фон прозрачным
    imagecolortransparent($im, $black);

    // Нарисуем красный прямоугольник
    imagefilledrectangle($im, 4, 4, 50, 25, $red);

    // Сохраним изображение
    imagepng($im, './imagecolortransparent.png');

    ?>

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

### Примечания

> Замечание: Прозрачность копируется только функцией imagecopymerge() и для truecolor-изображений. При вызове функции imagecopy() или палитрового изображения значение альфа-компонента не копируется.

> Замечание:

> Прозрачный цвет — свойство изображения, прозрачность не относится к свойствам цвета. При установке прозрачности цвета отдельные области изображения этого цвета, которые нарисовали прежде, станут прозрачными.

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