Gérer les cadres d'image dans les présentations avec PHP

Introduction

Un cadre d’image est une forme qui contient une image — c’est comme une photo dans un cadre.

Vous pouvez ajouter une image à une diapositive via un cadre d’image. Ainsi, vous pouvez formater l’image en formatant le cadre d’image.

Astuce

Aspose fournit des convertisseurs gratuits —JPEG vers PowerPoint et PNG vers PowerPoint—qui permettent de créer rapidement des présentations à partir d’images.

Créer un cadre d’image

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive via son indice.
Créez un objet PPImage en ajoutant une image à la ImageCollection associée à l’objet présentation qui sera utilisé pour remplir la forme.
Précisez la largeur et la hauteur de l’image.
Créez un PictureFrame basé sur la largeur et la hauteur de l’image via la méthode addPictureFrame exposée par l’objet forme associé à la diapositive de référence.
Ajoutez le cadre d’image (contenant la photo) à la diapositive.
Enregistrez la présentation modifiée au format PPTX.

Ce code PHP montre comment créer un cadre d’image :

  # Instancie la classe Presentation qui représente un fichier PPTX
  $pres = new Presentation();
  try {
    # Récupère la première diapositive
    $sld = $pres->getSlides()->get_Item(0);
    # Instancie la classe Image
    $imgx = $pres->getImages()->addImage(new Java("java.io.FileInputStream", new Java("java.io.File", "asp1.jpg")));
    # Ajoute un cadre d'image avec la même hauteur et largeur que l'image
    $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # Enregistre le fichier PPTX sur le disque
    $pres->save("RectPicFrame.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Les cadres d’image permettent de créer rapidement des diapositives de présentation à partir d’images. En combinant le cadre d’image avec les options d’enregistrement d’Aspose.Slides, vous pouvez manipuler les opérations d’entrée/sortie pour convertir des images d’un format à un autre. Vous pouvez consulter ces pages : convertir image en JPG; convertir JPG en image; convertir JPG en PNG, convertir PNG en JPG; convertir PNG en SVG, convertir SVG en PNG.

Créer un cadre d’image avec mise à l’échelle relative

En modifiant la mise à l’échelle relative d’une image, vous pouvez créer un cadre d’image plus complexe.

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive via son indice.
Ajoutez une image à la collection d’images de la présentation.
Créez un objet PPImage en ajoutant une image à la ImageCollection associée à l’objet présentation qui sera utilisé pour remplir la forme.
Spécifiez la largeur et la hauteur relatives de l’image dans le cadre d’image.
Enregistrez la présentation modifiée au format PPTX.

Ce code PHP montre comment créer un cadre d’image avec mise à l’échelle relative :

  # Instancie la classe Presentation qui représente le PPTX
  $pres = new Presentation();
  try {
    # Récupère la première diapositive
    $sld = $pres->getSlides()->get_Item(0);
    # Instancie la classe Image
    $imgx = $pres->getImages()->addImage(new Java("java.io.FileInputStream", new Java("java.io.File", "asp1.jpg")));
    # Ajoute un cadre d'image avec la même hauteur et largeur que l'image
    $pf = $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # Définit la mise à l'échelle relative en largeur et hauteur
    $pf->setRelativeScaleHeight(0.8);
    $pf->setRelativeScaleWidth(1.35);
    # Enregistre le fichier PPTX sur le disque
    $pres->save("RectPicFrame.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Extraire des images matricielles des cadres d’image

Vous pouvez extraire des images matricielles des objets PictureFrame et les enregistrer en PNG, JPG et autres formats. L’exemple de code ci‑dessous montre comment extraire une image du document « sample.pptx » et l’enregistrer au format PNG.

  $presentation = new Presentation("sample.pptx");
  try {
    $firstSlide = $presentation->getSlides()->get_Item(0);
    $firstShape = $firstSlide->getShapes()->get_Item(0);
    if (java_instanceof($firstShape, new JavaClass("com.aspose.slides.PictureFrame"))) {
      $pictureFrame = $firstShape;
      try {
        $slideImage = $pictureFrame->getPictureFormat()->getPicture()->getImage()->getImage();
        $slideImage->save("slide_1_shape_1.png", ImageFormat::Png);
      } finally {
        if (!java_is_null($slideImage)) {
          $slideImage->dispose();
        }
      }
    }
  } catch (JavaException $e) {
  } finally {
    $presentation->dispose();
  }

Extraire des images SVG des cadres d’image

Lorsqu’une présentation contient des graphiques SVG placés dans des formes PictureFrame, Aspose.Slides for PHP via Java vous permet de récupérer les images vectorielles d’origine avec une fidélité totale. En parcourant la collection de formes de la diapositive, vous pouvez identifier chaque PictureFrame, vérifier si le PPImage sous‑jacent contient du SVG, puis enregistrer cette image sur disque ou dans un flux au format SVG natif.

L’exemple de code suivant montre comment extraire une image SVG d’un cadre d’image :

$presentation = new Presentation("sample.pptx");

try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->get_Item(0);

    if (java_instanceof($shape, new JavaClass("com.aspose.slides.PictureFrame"))) {
        $svgImage = $shape->getPictureFormat()->getPicture()->getImage()->getSvgImage();

        if ($svgImage !== null) {
            file_put_contents("output.svg", $svgImage->getSvgData());
        }
    }
} finally {
    $presentation->dispose();
}

Obtenir la transparence d’une image

Aspose.Slides vous permet d’obtenir l’effet de transparence appliqué à une image. Ce code PHP démontre l’opération :

  $presentation = new Presentation("Test.pptx");
  $pictureFrame = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);
  $imageTransform = $pictureFrame->getPictureFormat()->getPicture()->getImageTransform();
  foreach($imageTransform as $effect) {
    if (java_instanceof($effect, new JavaClass("com.aspose.slides.AlphaModulateFixed"))) {
      $alphaModulateFixed = $effect;
      $transparencyValue = 100 - $alphaModulateFixed->getAmount();
      echo("Picture transparency: " . $transparencyValue);
    }
  }

Mise en forme d’un cadre d’image

Aspose.Slides propose de nombreuses options de mise en forme applicables à un cadre d’image. En utilisant ces options, vous pouvez modifier un cadre d’image pour répondre à des exigences spécifiques.

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive via son indice.
Créez un objet PPImage en ajoutant une image à la ImageCollection associée à l’objet présentation qui sera utilisé pour remplir la forme.
Précisez la largeur et la hauteur de l’image.
Créez un PictureFrame basé sur la largeur et la hauteur de l’image via la méthode [addPictureFrame](https://reference.aspose.com/sl