imagesetclip 函数

适用 PHP 版本：PHP 4及以上

函数说明

imagesetclip() 函数设置图像裁剪区域的边界。在使用图像输出函数时，只有在裁剪区域内的部分会被显示。

函数语法

bool imagesetclip ( void )

参数

此函数无参数。

返回值

如果成功返回 true，失败返回 false。

示例

$im = imagecreate(100, 100);
$bg = imagecolorallocate($im, 255, 255, 255);
$clip_color = imagecolorallocate($im, 255, 0, 0);
<p>// 设置裁剪区域<br>
imagefilledrectangle($im, 20, 20, 80, 80, $clip_color);<br>
imagesetclip();</p>
<p>// 画图只会显示裁剪区域内的部分<br>
imageellipse($im, 50, 50, 100, 100, $bg);</p>
<p>// 输出图像<br>
header('Content-Type: image/png');<br>
imagepng($im);<br>
imagedestroy($im);<br>

示例代码的说明

在这个示例中，我们创建了一个 100x100 像素的图像并给其背景上色。然后，设置了一个矩形区域，调用 imagesetclip() 来指定该区域为裁剪区域。之后，使用 imageellipse() 函数绘制一个椭圆，只有裁剪区域内的部分才会显示。最后，图像被输出为 PNG 格式。