imagesettile

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

imagesettile — Устанавливает изображение как элемент мозаичной заливки

Описание

imagesettile(GdImage $image, GdImage $tile): bool

Функция imagesettile() устанавливает изображение как элемент мозаичной заливки, с которым работают функции наподобие imagefill() и imagefilledpolygon() при заполнении специальным цветом IMG_COLOR_TILED.

Это изображение замащивает области изображения повторяющимся узором. Функция умеет использовать как плитку произвольное GD-изображение. А при установке прозрачного цвета для этого изображения функцией imagecolortransparent() отдельные части нижележащего изображения будут просвечивать через мозаику, которую создаст функция.

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

Дополнительных действий после завершения работы с мозаичным элементом не требуется, но при уничтожении изображения плитки или разрешении PHP уничтожить его нельзя использовать цвет IMG_COLOR_TILED до установки нового изображения!

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

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

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

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

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

Версия	Описание
8.0.0	Параметры `image` и `tile` теперь ожидают экземпляр класса GdImage; раньше ожидался ресурс (resource).

Примеры

Пример #1 Пример установки изображения в качестве элемента мозаичной заливки функцией imagesettile()

<?php

// Загрузка внешнего изображения
$zend = imagecreatefromgif('./zend.gif');

// Создание изображения размером 200x200
$im = imagecreatetruecolor(200, 200);

// Установка мозаичного элемента
imagesettile($im, $zend);

// Заливка
imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED);

// Вывод картинки в браузер
header('Content-Type: image/png');

imagepng($im);

?>

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