使用 PHP 优化演示文稿中的图像管理

演示文稿幻灯片中的图像

图像使演示文稿更具吸引力和趣味性。 在 Microsoft PowerPoint 中,您可以从文件、互联网或其他位置将图片插入到幻灯片中。 类似地,Aspose.Slides 允许您通过多种方式向演示文稿的幻灯片添加图像。

Aspose.Slides 支持对这些常用格式的图像进行操作:JPEG、PNG、GIF 等。

向幻灯片添加本地存储的图像

您可以将计算机上的一个或多个图像添加到演示文稿的幻灯片中。以下示例代码展示了如何向幻灯片添加图像:

  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $picture;
    $image = Images->fromFile("image.png");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    $slide->getShapes()->addPictureFrame(ShapeType::Rectangle, 10, 10, 100, 100, $picture);
    $pres->save("pres.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

从网页向幻灯片添加图像

如果您想添加到幻灯片的图像在电脑上不可用,您可以直接从网络添加该图像。

以下示例代码展示了如何从网络向幻灯片添加图像:

  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $imageUrl = new URL("[REPLACE WITH URL]");
    $connection = $imageUrl->openConnection();
    $inputStream = $connection->getInputStream();
    $outputStream = new Java("java.io.ByteArrayOutputStream");
    $Array = new java_class("java.lang.reflect.Array");
    $Byte = new JavaClass("java.lang.Byte");
    try {
      $buffer = $Array->newInstance($Byte, 1024);
      $read;
      while ($read = $inputStream->read($buffer, 0, $Array->getLength($buffer)) != -1) {
        $outputStream->write($buffer, 0, $read);
      } 
      $outputStream->flush();
      $image = $pres->getImages()->addImage($outputStream->toByteArray());
      $slide->getShapes()->addPictureFrame(ShapeType::Rectangle, 10, 10, 100, 100, $image);
    } finally {
      if (!java_is_null($inputStream)) {
        $inputStream->close();
      }
      $outputStream->close();
    }
    $pres->save("pres.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

向幻灯片母版添加图像

幻灯片母版是顶部幻灯片,存储并控制其下所有幻灯片的信息(主题、布局等)。因此,当您向幻灯片母版添加图像时,该图像会出现在该母版下的每一张幻灯片上。

以下 Java 示例代码展示了如何向幻灯片母版添加图像:

  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $masterSlide = $slide->getLayoutSlide()->getMasterSlide();
    $picture;
    $image = Images->fromFile("image.png");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    $masterSlide->getShapes()->addPictureFrame(ShapeType::Rectangle, 10, 10, 100, 100, $picture);
    $pres->save("pres.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

将图像设为幻灯片背景

您可能决定将图片用作特定幻灯片或多张幻灯片的背景。在这种情况下,您需要了解如何将图像设为幻灯片背景

向演示文稿添加 SVG

您可以使用属于ShapeCollection类的addPictureFrame方法向演示文稿添加或插入任何图像。

要基于 SVG 图像创建图像对象,可以按以下方式进行:

  1. 创建 SvgImage 对象以将其插入到 ImageShapeCollection
  2. 从 ISvgImage 创建 PPImage 对象
  3. 使用 PPImage 类创建 PictureFrame 对象

以下示例代码展示了如何实现上述步骤,将 SVG 图像添加到演示文稿中:

  # 实例化表示 PPTX 文件的 Presentation 类
  $pres = new Presentation();
  try {
$Array = new JavaClass("java.lang.reflect.Array");
$Byte = (new JavaClass("java.lang.Byte"))->TYPE;
try {
    $dis = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", "image.svg"));
    $bytes = $Array->newInstance($Byte, $dis->available());
    $dis->readFully($bytes);
} finally {
    if (!java_is_null($dis)) $dis->close();
}
    $svgContent = new String($bytes);

    $svgImage = new SvgImage($svgContent);
    $ppImage = $pres->getImages()->addImage($svgImage);
    $pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 0, 0, $ppImage->getWidth(), $ppImage->getHeight(), $ppImage);
    $pres->save("output.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

将 SVG 转换为形状集合

Aspose.Slides 将 SVG 转换为形状集合的功能类似于 PowerPoint 用于处理 SVG 图像的功能:

PowerPoint Popup Menu

该功能由 ShapeCollection 类的 addGroupShape 方法的其中一个重载提供,该重载接受 SvgImage 对象作为第一个参数。

以下示例代码展示了如何使用上述方法将 SVG 文件转换为形状集合:

  # 创建新演示文稿
  $presentation = new Presentation();
  try {
    # 读取 SVG 文件内容
$Array = new JavaClass("java.lang.reflect.Array");
$Byte = (new JavaClass("java.lang.Byte"))->TYPE;
try {
    $dis = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", "image.svg"));
    $bytes = $Array->newInstance($Byte, $dis->available());
    $dis->readFully($bytes);
} finally {
    if (!java_is_null($dis)) $dis->close();
}
    $svgContent = $bytes;

    # 创建 SvgImage 对象
    $svgImage = new SvgImage($svgContent);
    # 获取幻灯片尺寸
    $slideSize = $presentation->getSlideSize()->getSize();
    # 将 SVG 图像转换为形状组并缩放到幻灯片尺寸
    $presentation->getSlides()->get_Item(0)->getShapes()->addGroupShape($svgImage, 0.0, 0.0, $slideSize->getWidth(), $slideSize->getHeight());
    # 以 PPTX 格式保存演示文稿
    $presentation->save("output.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

将图像以 EMF 形式添加到幻灯片

Aspose.Slides for PHP via Java 允许您从 Excel 工作表生成 EMF 图像,并使用 Aspose.Cells 将这些图像以 EMF 形式添加到幻灯片中。

以下示例代码展示了如何执行上述任务:

  $book = new Workbook("chart.xlsx");
  $sheet = $book->getWorksheets()->get(0);
  $options = new ImageOrPrintOptions();
  $options->setHorizontalResolution(200);
  $options->setVerticalResolution(200);
  $options->setImageType(ImageType::EMF);
  # 将工作簿保存到流
  $sr = new SheetRender($sheet, $options);
  $pres = new Presentation();
  try {
    $pres->getSlides()->removeAt(0);
    $EmfSheetName = "";
    for($j = 0; $j < java_values($sr->getPageCount()) ; $j++) {
      $EmfSheetName = "test" . $sheet->getName() . " Page" . $j + 1 . ".out.emf";
      $sr->toImage($j, $EmfSheetName);
      $picture;
      $image = Images->fromFile($EmfSheetName);
      try {
        $picture = $pres->getImages()->addImage($image);
      } finally {
        if (!java_is_null($image)) {
          $image->dispose();
        }
      }
      $slide = $pres->getSlides()->addEmptySlide($pres->getLayoutSlides()->getByType(SlideLayoutType::Blank));
      $m = $slide->getShapes()->addPictureFrame(ShapeType::Rectangle, 0, 0, $pres->getSlideSize()->getSize()->getWidth(), $pres->getSlideSize()->getSize()->getHeight(), $picture);
    }
    $pres->save("output.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

替换图像集合中的图像

Aspose.Slides 允许您替换存储在演示文稿图像集合中的图像(包括幻灯片形状使用的图像)。本节展示了更新集合中图像的几种方法。API 提供了使用原始字节数据、IImage 实例或集合中已存在的另一个图像来替换图像的简便方法。

Follow the steps below:

  1. 使用 Presentation 类加载包含图像的演示文稿文件。
  2. 将新图像从文件加载到字节数组中。
  3. 使用字节数组将目标图像替换为新图像。
  4. 在第二种方法中,将图像加载到 IImage 对象中,并使用该对象替换目标图像。
  5. 在第三种方法中,将目标图像替换为演示文稿图像集合中已存在的图像。
  6. 将修改后的演示文稿写入为 PPTX 文件。
// 实例化表示演示文稿文件的 Presentation 类。
$presentation = new Presentation("sample.pptx");
try {
    // 第一种方式。
    $imagePath = (new Java("java.io.File", "image0.jpeg"))->toPath();
    $imageData = (new Java("java.nio.file.Files"))->readAllBytes($imagePath);
    $oldImage = $presentation->getImages()->get_Item(0);
    $oldImage->replaceImage($imageData);

    // 第二种方式。
    $newImage = Images::fromFile("image1.png");
    $oldImage = $presentation->getImages()->get_Item(1);
    $oldImage->replaceImage($newImage);
    $newImage->dispose();
    
    // 第三种方式。
    $oldImage = $presentation->getImages()->get_Item(2);
    $oldImage->replaceImage($presentation->getImages()->get_Item(3));
    
    // 将演示文稿保存到文件。
    $presentation->save("output.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

常见问题

插入后原始图像分辨率是否保持不变?

是的。源像素得以保留,但最终显示效果取决于图片在幻灯片上的缩放方式以及保存时所使用的压缩。

一次性替换数十张幻灯片中相同徽标的最佳方法是什么?

将徽标放置在母版幻灯片或布局上,并在演示文稿的图像集合中进行替换——更新会传播到所有使用该资源的元素。

插入的 SVG 能否转换为可编辑的形状?

可以。您可以将 SVG 转换为一组形状,之后各个部分即可使用标准形状属性进行编辑。

如何一次性将图片设为多张幻灯片的背景?

在母版幻灯片或相应布局上将图像设为背景,使用该母版/布局的所有幻灯片都会继承该背景。

如何防止因大量图片导致演示文稿体积“膨胀”?

重复使用单一图像资源而非重复拷贝,选择合适的分辨率,保存时进行压缩,并在适当情况下将重复图形放在母版上。