imagesettile

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

imagesettile — Modifica la imagen utilizada para el mosaico

Descripción

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

imagesettile() reemplaza la imagen de pavimentación actual por la imagen tile, a utilizar en todos los rellenos (como con las funciones imagefill() y imagefilledpolygon()) durante los rellenos con la opción IMG_COLOR_TILED.

Una imagen de mosaico es una imagen utilizada para rellenar una zona, de manera repetitiva. Cualquier imagen GD puede servir como imagen de relleno. El uso de la transparencia (gestionada con la función imagecolortransparent()) permite que ciertas zonas aparezcan a través del mosaico.

Precaución

No hay nada que hacer cuando se ha terminado con un pincel, pero si se destruye la imagen del pincel (o se deja que PHP lo destruya), ya no DEBE utilizarse la opción IMG_COLOR_TILED de las funciones imagefill() y imagefilledpolygon(), antes de crear un nuevo pincel.

Parámetros

image: Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
tile: El objeto de la imagen a utilizar como mosaico.

Valores devueltos

Retorna siempre true.

Historial de cambios

Versión	Descripción
8.0.0	`image` y `tile` ahora esperan instancias de GdImage ; anteriormente, se esperaban resources.

Ejemplos

Ejemplo #1 Ejemplo con imagesettile()

<?php
// Carga de una imagen externa
$zend = imagecreatefromgif('./zend.gif');

// Creación de una imagen de 200x200 píxeles
$im = imagecreatetruecolor(200, 200);

// Definición del mosaico
imagesettile($im, $zend);

// Repetición de la imagen
imagefilledrectangle($im, 0, 0, 199, 199, IMG_COLOR_TILED);

// Visualización en el navegador
header('Content-Type: image/png');

imagepng($im);
?>

Resultado del ejemplo anterior es similar a:

Visualización del ejemplo: imagesettile()