使用PHP Imagick合成多图时首图部分被覆盖的问题排查

我正在处理PDF图像，需要将作业图像逐个添加到空白夹具图上，要求各图像位置不重叠。目前遇到的问题是：首张作业图添加正常，但添加第二张时，首张图的部分内容被擦除。我尝试了多种合成算法，均存在该问题。附上相关代码及各阶段效果图，恳请帮忙排查逻辑漏洞。

/**
 * 
 * @param type $jig
 * @param type $point
 * @param string $original
 * @param string $additional
 */
public function addImageToImage($jig, $point, string $original, string $additional, string $jobBase)
{
    $preview = new Imagick();
    $preview->setResolution(300, 300);
    $preview->readImage($original);
    $jobImage = new Imagick();
    $jobImage->setResolution(300, 300);
    $jobImage->readImage($additional);
    $x = $this->mmToPx($jig["points"][$point][JigPoints::XCO] + $jig['products'][$jobBase][JigProducts::X_OFF]);
    $y = $this->mmToPx($jig["points"][$point][JigPoints::YCO] + $jig['products'][$jobBase][JigProducts::Y_OFF]);
    $preview->setImageBackgroundColor($jobImage->getImageBackgroundColor());
    $preview->setImageAlphaChannel($jobImage->getImageAlphaChannel());
    $preview->setImageType($jobImage->getImageType());
    $preview->compositeImage($jobImage,Imagick::COMPOSITE_DISSOLVE,$x,$y,$jobImage->getImageAlphaChannel());
    $preview->flattenImages();
    $preview->writeImage($original);
    $jobImage->destroy();
    $preview->destroy();
} 

各阶段效果图 #

• 初始夹具图
  
• 添加首张作业图后效果
  
• 添加第二张作业图后效果
  

问题核心逻辑漏洞排查 #

1. 图像属性强制覆盖
   代码中setImageAlphaChannel和setImageType会将已合成好的夹具图（含首张作业图）的通道、类型强制替换为新作业图的属性。若新作业图的Alpha通道/图像类型与原有合成图不一致，会直接破坏原有图像的图层或透明信息，导致内容丢失。

2. 合成模式误用
   COMPOSITE_DISSOLVE是基于透明度的溶解混合模式，并非常规的叠加逻辑。如果作业图没有设置合适的透明度参数，该模式会直接覆盖原有图像像素，而非在其上方叠加。

3. 过早执行扁平化
   每次合成后调用flattenImages()会将多图层图像合并为单层，丢失原有图层层级信息，后续合成无法正确识别已有内容的叠加关系。

4. 背景色强制替换
   setImageBackgroundColor会替换原有合成图的背景色，若新作业图背景色与夹具图/首张作业图不一致，会覆盖原有区域背景，造成内容被擦除的视觉效果。

修正后的代码示例 #

/**
 * 将作业图添加到夹具图指定位置
 * @param type $jig
 * @param type $point
 * @param string $original
 * @param string $additional
 * @param string $jobBase
 */
public function addImageToImage($jig, $point, string $original, string $additional, string $jobBase)
{
    $preview = new Imagick();
    $preview->setResolution(300, 300);
    $preview->readImage($original);
    
    $jobImage = new Imagick();
    $jobImage->setResolution(300, 300);
    $jobImage->readImage($additional);
    
    $x = $this->mmToPx($jig["points"][$point][JigPoints::XCO] + $jig['products'][$jobBase][JigProducts::X_OFF]);
    $y = $this->mmToPx($jig["points"][$point][JigPoints::YCO] + $jig['products'][$jobBase][JigProducts::Y_OFF]);
    
    // 使用常规叠加模式替代溶解模式，保留原有图像属性
    $preview->compositeImage($jobImage, Imagick::COMPOSITE_OVER, $x, $y);
    
    // 移除每次合成后的扁平化操作，改为所有图像添加完成后统一处理
    $preview->writeImage($original);
    
    $jobImage->destroy();
    $preview->destroy();
}

内容的提问来源于stack exchange，提问作者Mr. Berzerk