PHP Imagick/GD distortImage校正折叠纸张扫描图（支持多坐标点）

一、Imagick 畸变类型选择与问题分析 #

1. 当前POLYNOMIAL 1.5效果不佳的原因 #

你使用的POLYNOMIAL 1.5（双线性反向）属于全局线性变换，仅能处理整体拉伸、偏移类的均匀变形，无法解决折叠纸张的局部非均匀变形（比如折痕处的角度偏移）。这种变换会以统一规则拉伸整个图像，折痕区域的局部畸变无法被精准修正。

2. 针对不同点数的畸变方案 #

• 4个点：纯透视畸变
  若仅标记纸张四个角，直接使用Imagick::DISTORTION_PERSPECTIVE，这是专为平面透视校正设计的类型，能精准将透视变形的纸张拉成标准矩形。
  代码片段：

  $distortedCoords = [x1,y1, x2,y2, x3,y3, x4,y4]; // 纸张四个角的原始坐标
  $destCoords = [0,0, $w,0, $w,$h, 0,$h]; // 目标矩形四个角
  $points = [];
  for ($i=0; $i<count($distortedCoords); $i+=2) {
      $points[] = $distortedCoords[$i];
      $points[] = $distortedCoords[$i+1];
      $points[] = $destCoords[$i];
      $points[] = $destCoords[$i+1];
  }
  $imagick->distortImage(Imagick::DISTORTION_PERSPECTIVE, $points, true);
  

• 5+个点：局部畸变校正（推荐PERSPECTIVEMAP或高阶POLYNOMIAL）
  针对折叠纸张的局部变形，推荐以下两种方式：

  • DISTORTION_PERSPECTIVEMAP：支持任意数量的点对，会根据点的分布做局部插值计算，能精准拟合折痕处的分段变形，无需前置阶数参数。
    代码片段：

    $points = [];
    for ($i=0; $i<count($distortedCoords); $i+=2) {
        $points[] = $distortedCoords[$i];
        $points[] = $distortedCoords[$i+1];
        $points[] = $destCoords[$i];
        $points[] = $destCoords[$i+1];
    }
    $imagick->distortImage(Imagick::DISTORTION_PERSPECTIVEMAP, $points, true);
    

  • 高阶POLYNOMIAL：将前置阶数从1.5改为2（二次多项式，至少6个点）或3（三次多项式，至少10个点），越高阶越能拟合复杂的局部变形，但需保证点数与阶数匹配。

• 25个点（5x5网格）：网格畸变
  若有5x5的网格标记点，可使用DISTORTION_BILINEAR（双线性网格畸变），它会将图像分割为多个小网格，每个网格单独做双线性变换，能最大化修正局部折叠细节。

二、坐标点标记优化建议 #

• 折痕区域重点标记：在折痕的两侧各标记至少2个点，让算法识别局部角度变化，不要仅标记纸张外边缘。
• 目标坐标严格对齐：确保目标坐标的边缘点（比如左边缘的[0,0]、[0,$h]等）处于同一直线，避免目标区域本身出现偏移。

三、PHP GD 替代方案（PHP 8+） #

GD原生无多点畸变函数，但可通过分段透视校正处理：将折叠纸张按折痕划分为多个子区域，分别对每个子区域做透视校正后拼接。
代码片段（以左右两个区域为例）：

// 左半区域坐标映射
$leftSrc = [x1,y1, x2,y2, x3,y3, x4,y4];
$leftDst = [0,0, 0,$h, $w/2,$h, $w/2,0];
// 右半区域坐标映射
$rightSrc = [x5,y5, x6,y6, x7,y7, x8,y8];
$rightDst = [$w/2,0, $w,0, $w,$h, $w/2,$h];

// 左半区域校正
$leftImg = imagecreatetruecolor($w/2, $h);
$matrix = imageperspectivetransform($leftSrc, $leftDst);
imagecopyresampled($leftImg, $srcImg, 0,0, 0,0, $w/2,$h, $w/2,$h);
// 右半区域校正
$rightImg = imagecreatetruecolor($w/2, $h);
$matrix = imageperspectivetransform($rightSrc, $rightDst);
imagecopyresampled($rightImg, $srcImg, 0,0, $w/2,0, $w/2,$h, $w/2,$h);

// 拼接最终图像
$finalImg = imagecreatetruecolor($w, $h);
imagecopy($finalImg, $leftImg, 0,0, 0,0, $w/2,$h);
imagecopy($finalImg, $rightImg, $w/2,0, 0,0, $w/2,$h);

四、优化步骤总结 #

1. 多点场景优先用DISTORTION_PERSPECTIVEMAP，它的局部插值能力最适配折叠变形。
2. 用POLYNOMIAL时，根据点数匹配对应阶数（2阶≥6点，3阶≥10点）。
3. 精准标记折痕两侧的坐标点，目标坐标严格对齐矩形边缘。
4. GD环境下采用分段透视校正处理局部折叠。

内容的提问来源于stack exchange，提问作者abe1432181