imagesettile

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

imagesettileModifica la imagen utilizada para el mosaico

Descripción

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

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 recurso image, es devuelto 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

Devuelve true en caso de éxito o false en caso de error.

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);
?>

El resultado del ejemplo sería algo similar a:

Visualización del ejemplo: imagesettile()