当前位置: 首页> 函数类别大全> imagecrop

imagecrop

将图像裁剪到给定的矩形
名称:imagecrop
分类:图像处理GD
所属语言:php
一句话介绍:将图像裁剪到给定的矩形

PHP函数:imagecrop

适用PHP版本

PHP 5.5.0及更高版本

函数说明

该函数用于裁剪图像。通过提供一个裁剪区域,imagecrop会从给定的图像资源中裁剪出指定的矩形区域。

函数语法

imagecrop ( resource $image , array $rect ) : resource|null

参数

  • $image (resource): 需要裁剪的图像资源。通常由如imagecreatefromjpeg()imagecreatefrompng()等函数生成。
  • $rect (array): 一个包含裁剪区域的关联数组。该数组至少包含以下键:
    • x: 裁剪区域左上角的横坐标。
    • y: 裁剪区域左上角的纵坐标。
    • width: 裁剪区域的宽度。
    • height: 裁剪区域的高度。

返回值

返回一个裁剪后的图像资源,或者在失败时返回null

示例

以下是如何使用imagecrop函数的一个简单示例:

示例代码的说明

该示例展示了如何从一个PNG图像中裁剪出一个矩形区域并保存裁剪后的图像。

  <?php
  // 加载图像
  $image = imagecreatefrompng('example.png');
  
  // 定义裁剪区域
  $rect = [
      'x' => 50,    // 裁剪区域左上角的X坐标
      'y' => 50,    // 裁剪区域左上角的Y坐标
      'width' => 200,  // 裁剪区域的宽度
      'height' => 150  // 裁剪区域的高度
  ];
  
  // 执行裁剪
  $croppedImage = imagecrop($image, $rect);
  
  // 如果裁剪成功,保存裁剪后的图像
  if ($croppedImage !== false) {
      imagepng($croppedImage, 'cropped_example.png');
      imagedestroy($croppedImage);  // 释放内存
  }
  
  // 释放原图像资源
  imagedestroy($image);
  ?>
  
同类函数