imagesettile

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

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

Описание

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

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

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

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

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

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

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

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

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

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

Версия	Описание
8.0.0	Параметры `image` и `tile` теперь принимают объект GdImage; раньше принимался тип resource.

Примеры

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

<?php

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

// Создаём изображение размером 200 на 200 пикселей
$im = imagecreatetruecolor(200, 200);

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

// Заливаем область
imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED);

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

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

Вывод примера: Отрисовка изображения функцией imagesettile()