Определяет, сохранять ли полную информацию альфа-канала при сохранении изображений

# imagesavealpha

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

imagesavealpha — Определяет, сохранять ли полную информацию альфа-канала при сохранении изображений

### Описание

function imagesavealpha(GdImage `$image`, bool `$enable`): true

Функция imagesavealpha() устанавливает флаг, который определяет, сохранится ли вместо одноцветной прозрачности полная информация альфа-канала, и сохраняет изображение. Установка флага поддерживается только для форматов изображений, которые содержат полную информацию об альфа-канале: `PNG`, `WebP` и `AVIF`.

> Замечание: Функцию imagesavealpha() вызывают только на изображениях в формате `PNG`, поскольку для форматов `WebP` и `AVIF` всегда сохраняется полный альфа-канал. Полагаться на поведение функции не рекомендуют из-за возможного изменения поведения в новых версиях. Поэтому функцию imagesavealpha() принудительно вызывают и на изображениях в форматах `WebP` и `AVIF`.

Для приоритетного сохранения альфа-канала потребуется отключить альфа-смешивание вызовом `imagealphablending($im, false)`.

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

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

  Параметр определяет, сохранять ли альфа-канал. Значение по умолчанию равняется `false`.

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

Функция возвращает логическое значение `true`.

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

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

### Примеры

Пример #1 Пример настройки сохранения полной информации альфа-канала при сохранении изображения функцией imagesavealpha()

    <?php

    // Загрузка PNG-изображения с альфа-каналом
    $png = imagecreatefrompng('./alphachannel_example.png');

    // Выключение альфа-смешения
    imagealphablending($png, false);

    // Какие-то операции

    // Установка альфа-флага
    imagesavealpha($png, true);

    // Устанавливаем заголовок с MIME-типом изображения и выводим результат
    header('Content-Type: image/png');
    imagepng($png);

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

- imagealphablending() - Устанавливает режим сопряжения цветов для изображения

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