ext/gd: adding imagecopyrotated.

UPGRADING

@@ -243,6 +243,9 @@ PHP 8.3 UPGRADE NOTES
 - DOM:
   . Added DOMNode::contains() and DOMNameSpaceNode::contains().
 
+- GD:
+  . Added imagerotated which copy a rotated area from a defined position and angle.
+
 - JSON:
   . Added json_validate(), which returns whether the json is valid for
     the given $depth and $options.

ext/gd/config.m4

@@ -149,6 +149,7 @@ AC_DEFUN([PHP_GD_CHECK_VERSION],[
   PHP_CHECK_LIBRARY(gd, gdImageStringFT,               [AC_DEFINE(HAVE_GD_FREETYPE,          1, [ ])], [], [ $GD_SHARED_LIBADD ])
   PHP_CHECK_LIBRARY(gd, gdVersionString,               [AC_DEFINE(HAVE_GD_LIBVERSION,        1, [ ])], [], [ $GD_SHARED_LIBADD ])
   PHP_CHECK_LIBRARY(gd, gdImageGetInterpolationMethod, [AC_DEFINE(HAVE_GD_GET_INTERPOLATION, 1, [ ])], [], [ $GD_SHARED_LIBADD ])
+  PHP_CHECK_LIBRARY(gd, gdImageCopyRotated,            [AC_DEFINE(HAVE_GD_COPY_ROTATED,      1, [ ])], [], [ $GD_SHARED_LIBADD ])
 ])
 
 dnl

ext/gd/gd.c

@@ -1055,6 +1055,59 @@ PHP_FUNCTION(imagecopyresampled)
 }
 /* }}} */
 
+#if defined(HAVE_GD_COPY_ROTATED)
+PHP_FUNCTION(imagecopyrotated)
+{
+	zval *SIM, *DIM;
+	zend_long SX, SY, SW, SH, A;
+	gdImagePtr im_dst, im_src;
+	int srcH, srcW, srcY, srcX, angle;
+	double dstX, dstY;
+
+	if (zend_parse_parameters(ZEND_NUM_ARGS(), "OOddlllll", &DIM, gd_image_ce, &SIM, gd_image_ce, &dstX, &dstY, &SX, &SY, &SW, &SH, &A) == FAILURE) {
+		RETURN_THROWS();
+	}
+
+	im_dst = php_gd_libgdimageptr_from_zval_p(DIM);
+	im_src = php_gd_libgdimageptr_from_zval_p(SIM);
+
+	srcX = SX;
+	srcY = SY;
+	srcW = SW;
+	srcH = SH;
+	angle = A;
+
+	if (srcX < 0) {
+		zend_argument_value_error(5, "must be positive");
+		RETURN_THROWS();
+	}
+
+	if (srcY < 0) {
+		zend_argument_value_error(6, "must be positive");
+		RETURN_THROWS();
+	}
+
+	if (srcW <= 0) {
+		zend_argument_value_error(7, "must be greater than 0");
+		RETURN_THROWS();
+	}
+
+	if (srcH <= 0) {
+		zend_argument_value_error(8, "must be greater than 0");
+		RETURN_THROWS();
+	}
+
+	if (angle <= 0) {
+		zend_argument_value_error(9, "must be greater than 0");
+		RETURN_THROWS();
+	}
+
+
+	gdImageCopyRotated(im_dst, im_src, dstX, dstY, srcX, srcY, srcW, srcH, angle);
+}
+#endif
+
+
 #ifdef PHP_WIN32
 /* {{{ Grab a window or its client area using a windows handle (HWND property in COM instance) */
 PHP_FUNCTION(imagegrabwindow)

ext/gd/gd.stub.php

@@ -520,6 +520,10 @@ function imagecolorexactalpha(GdImage $image, int $red, int $green, int $blue, i
 
 function imagecopyresampled(GdImage $dst_image, GdImage $src_image, int $dst_x, int $dst_y, int $src_x, int $src_y, int $dst_width, int $dst_height, int $src_width, int $src_height): bool {}
 
+#ifdef HAVE_GD_COPY_ROTATED
+function imagecopyrotated(GdImage $dst_image, GdImage $src_image, float $dst_x, float $dst_y, int $src_x, int $src_y, int $src_width, int $src_height, int $angle): void {}
+#endif
+
 #ifdef PHP_WIN32
 
 /** @refcount 1 */

ext/gd/tests/copyrotated.phpt

@@ -0,0 +1,67 @@
+--TEST--
+imagecopyrotated
+--EXTENSIONS--
+gd
+--SKIPIF--
+<?php
+    if (!function_exists("imagecopyrotated")) die("skip requires imagecopyrotated");
+?>
+--FILE--
+<?php
+
+$src_tc = imagecreatetruecolor(5,5);
+imagefill($src_tc, 0,0, 0x000000);
+imagesetpixel($src_tc, 1, 2, 0x0000ff);
+imagesetpixel($src_tc, 2, 2, 0xffffff);
+imagesetpixel($src_tc, 3, 2, 0xff0000);
+
+
+$dst_tc = imagecreatetruecolor(5,5);
+imagecopyrotated($dst_tc, $src_tc, 3.0,3.0, 0,0, imagesx($src_tc), imagesy($src_tc), 180);
+$p1 = imagecolorat($dst_tc, 1, 2) == imagecolorat($src_tc, 3, 2);
+$p2 = imagecolorat($dst_tc, 2, 2) == imagecolorat($src_tc, 2, 2);
+$p3 = imagecolorat($dst_tc, 3, 2) == imagecolorat($src_tc, 1, 2);
+
+if ($p1 && $p2 && $p3) {
+    echo "TC/TC: ok\n";
+}
+
+try {
+	imagecopyrotated($dst_tc, $src_tc, 3.0,3.0, -10,0, imagesx($src_tc), imagesy($src_tc), 180);
+} catch (\ValueError $e) {
+	echo $e->getMessage() . PHP_EOL;
+}
+
+try {
+	imagecopyrotated($dst_tc, $src_tc, 3.0,3.0, 0,PHP_INT_MAX, imagesx($src_tc), imagesy($src_tc), 180);
+} catch (\ValueError $e) {
+	echo $e->getMessage() . PHP_EOL;
+}
+
+try {
+	imagecopyrotated($dst_tc, $src_tc, 3.0,3.0, 0,0, -5, imagesy($src_tc), 180);
+} catch (\ValueError $e) {
+	echo $e->getMessage() . PHP_EOL;
+}
+
+try {
+	imagecopyrotated($dst_tc, $src_tc, 3.0,3.0, 0,0, imagesx($src_tc), PHP_INT_MAX, 180);
+} catch (\ValueError $e) {
+	echo $e->getMessage() . PHP_EOL;
+}
+
+try {
+	imagecopyrotated($dst_tc, $src_tc, 3.0,3.0, 0,0, imagesx($src_tc), imagesy($src_tc), PHP_INT_MAX);
+} catch (\ValueError $e) {
+	echo $e->getMessage() . PHP_EOL;
+}
+
+imagedestroy($src_tc); imagedestroy($dst_tc);
+?>
+--EXPECT--
+TC/TC: ok
+imagecopyrotated(): Argument #5 ($src_x) must be positive
+imagecopyrotated(): Argument #6 ($src_y) must be positive
+imagecopyrotated(): Argument #7 ($src_width) must be greater than 0
+imagecopyrotated(): Argument #8 ($src_height) must be greater than 0
+imagecopyrotated(): Argument #9 ($angle) must be greater than 0