使用 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

您可以使用属于 IShapeCollection 接口的 addPictureFrame 方法将任何图像插入演示文稿。

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

  1. 创建 SvgImage 对象以将其插入 ImageShapeCollection
  2. 从 ISvgImage 创建 PPImage 对象
  3. 使用 IPPImage 接口创建 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 弹出菜单

该功能由 IShapeCollection 接口的 addGroupShape 方法的一个重载实现,该方法接受 ISvgImage 对象作为第一个参数。

以下示例代码展示了如何使用上述方法将 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 实例或集合中已有的另一图像来替换图像。

请按以下步骤操作:

  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 转换为一组形状,随后每个部件都可以使用标准形状属性进行编辑。

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

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

如何防止因大量图片导致演示文稿体积急剧增大?

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