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()