imagecopy

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecopy — Kopiert einen Bildausschnitt

Beschreibung

imagecopy(
    GdImage $dst_image,
    GdImage $src_image,
    int $dst_x,
    int $dst_y,
    int $src_x,
    int $src_y,
    int $src_width,
    int $src_height
): bool

Kopiert einen Teil des Quellbildes src_image nach dst_image. Der zu kopierende Teil wird über die x/y-Koordinaten src_x und src_y angegeben. Die Breite wird in src_width und die Höhe in src_height angegeben. Der Ausschnitt wird an die x/y-Koordinaten dst_x und dst_y kopiert.

Parameter-Liste

dst_image

Ressource des Zielbildes.

src_image

Ressource des Quellbildes.

dst_x

x-Koordinate des Zielpunkts.

dst_y

y-Koordinate des Zielpunkts.

src_x

x-Koordinate des Quellpunkts.

src_y

y-Koordinate des Quellpunkts.

src_width

Breite der Quelle.

src_height

Höhe der Quelle.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 dst_image und src_image erwarten jetzt GdImage-Instanzen; zuvor wurde eine Ressource erwartet.

Beispiele

Beispiel #1 Beschneiden des PHP.net-Logos

<?php
// Erzeuge die Bilder
$src = imagecreatefromgif('php.gif');
$dest = imagecreatetruecolor(80, 40);

// Kopiere
imagecopy($dest, $src, 0, 0, 20, 13, 80, 40);

// Ausgeben und Speicher freigeben
header('Content-Type: image/gif');
imagegif($dest);

imagedestroy($dest);
imagedestroy($src);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Ausgabe des Beispiels : Beschneiden des PHP.net-Logos

Siehe auch