Cadre de Photo

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

Vous pouvez ajouter une image à une diapositive à l’aide d’un cadre de photo. De cette façon, vous pouvez formater l’image en formatant le cadre de photo.

Conseil

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 de Photo

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive par son index.
Créez un objet IPPImage en ajoutant une image à la IImagescollection associée à l’objet de présentation qui sera utilisé pour remplir la forme.
Spécifiez la largeur et la hauteur de l’image.
Créez un PictureFrame en fonction de la largeur et de la hauteur de l’image par le biais de la méthode AddPictureFrame exposée par l’objet forme associé à la diapositive référencée.
Ajoutez un cadre de photo (contenant l’image) à la diapositive.
Écrivez la présentation modifiée sous forme de fichier PPTX.

Ce code PHP vous montre comment créer un cadre de photo :

  # Instancie la classe Presentation qui représente un fichier PPTX
  $pres = new Presentation();
  try {
    # Obtient 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 de photo avec la hauteur et la largeur équivalentes de l'image
    $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # Écrit 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 de photo vous permettent de créer rapidement des diapositives de présentation basées sur des images. Lorsque vous combinez le cadre de photo avec les options de sauvegarde d’Aspose.Slides, vous pouvez manipuler les opérations d’entrée/sortie pour convertir des images d’un format à un autre. Vous voudrez peut-être 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 de Photo avec Échelle Relative

En modifiant l’échelle relative d’une image, vous pouvez créer un cadre de photo plus compliqué.

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive par son index.
Ajoutez une image à la collection d’images de la présentation.
Créez un objet IPPImage en ajoutant une image à la IImagescollection associée à l’objet de présentation qui sera utilisé pour remplir la forme.
Spécifiez la largeur et la hauteur relatives de l’image dans le cadre de photo.
Écrivez la présentation modifiée sous forme de fichier PPTX.

Ce code PHP vous montre comment créer un cadre de photo avec une échelle relative :

  # Instancie la classe Presentation qui représente le PPTX
  $pres = new Presentation();
  try {
    # Obtenez 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 de photo avec la hauteur et la largeur équivalentes de l'image
    $pf = $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # Définir l'échelle relative de la largeur et de la hauteur
    $pf->setRelativeScaleHeight(0.8);
    $pf->setRelativeScaleWidth(1.35);
    # Écrit le fichier PPTX sur le disque
    $pres->save("RectPicFrame.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Extraire une Image du Cadre de Photo

Vous pouvez extraire des images des objets PictureFrame et les enregistrer au format PNG, JPG et autres. L’exemple de code ci-dessous dé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();
  }

Obtenir la Transparence d’une Image

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

  $presentation = new Presentation($folderPath . "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("Transparence de l'image : " . $transparencyValue);
    }
  }

Formatage du Cadre de Photo

Aspose.Slides propose de nombreuses options de formatage qui peuvent être appliquées à un cadre de photo. En utilisant ces options, vous pouvez modifier un cadre de photo pour qu’il corresponde à des exigences spécifiques.

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive par son index.
Créez un objet IPPImage en ajoutant une image à la IImagescollection associée à l’objet de présentation qui sera utilisé pour remplir la forme.
Spécifiez la largeur et la hauteur de l’image.
Créez un PictureFrame basé sur la largeur et la hauteur de l’image par le biais de la méthode AddPictureFrame exposée par l’objet IShapes associé à la diapositive référencée.
Ajoutez le cadre de photo (contenant l’image) à la diapositive.
Définissez la couleur de ligne du cadre de photo.
Définissez la largeur de ligne du cadre de photo.
Faites pivoter le cadre de photo en lui donnant une valeur positive ou négative.
- Une valeur positive fait pivoter l’image dans le sens des aiguilles d’une montre.
- Une valeur négative fait pivoter l’image dans le sens inverse des aiguilles d’une montre.
Ajoutez le cadre de photo (contenant l’image) à la diapositive.
Écrivez la présentation modifiée sous forme de fichier PPTX.

Ce code PHP démontre le processus de formatage du cadre de photo :

  # Instancie la classe Presentation qui représente le PPTX
  $pres = new Presentation();
  try {
    # Obtient 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 de photo avec la hauteur et la largeur équivalentes de l'image
    $pf = $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # Applique quelques formats au PictureFrameEx
    $pf->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $pf->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
    $pf->getLineFormat()->setWidth(20);
    $pf->setRotation(45);
    # Écrit le fichier PPTX sur le disque
    $pres->save("RectPicFrame.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Conseil

Aspose a récemment développé un créateur de collages gratuit. Si vous avez besoin de fusionner des images JPG/JPEG ou PNG, de créer des grilles à partir de photos, vous pouvez utiliser ce service.

Ajouter une Image en Tant que Lien

Pour éviter les tailles de présentation trop importantes, vous pouvez ajouter des images (ou des vidéos) via des liens au lieu d’incorporer les fichiers directement dans les présentations. Ce code PHP vous montre comment ajouter une image et une vidéo dans un espace réservé :

  $presentation = new Presentation("input.pptx");
  try {
    $shapesToRemove = new Java("java.util.ArrayList");
    $shapesCount = $presentation->getSlides()->get_Item(0)->getShapes()->size();
    for($i = 0; $i < java_values($shapesCount) ; $i++) {
      $autoShape = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item($i);
      if (java_is_null($autoShape->getPlaceholder())) {
        continue;
      }
      switch ($autoShape->getPlaceholder()->getType()) {
        case PlaceholderType::Picture :
          $pictureFrame = $presentation->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, $autoShape->getX(), $autoShape->getY(), $autoShape->getWidth(), $autoShape->getHeight(), null);
          $pictureFrame->getPictureFormat()->getPicture()->setLinkPathLong("https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");
          $shapesToRemove->add($autoShape);
          break;
        case PlaceholderType::Media :
          $videoFrame = $presentation->getSlides()->get_Item(0)->getShapes()->addVideoFrame($autoShape->getX(), $autoShape->getY(), $autoShape->getWidth(), $autoShape->getHeight(), "");
          $videoFrame->getPictureFormat()->getPicture()->setLinkPathLong("https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");
          $videoFrame->setLinkPathLong("https://youtu.be/t_1LYZ102RA");
          $shapesToRemove->add($autoShape);
          break;
      }
    }
    foreach($shapesToRemove as $shape) {
      $presentation->getSlides()->get_Item(0)->getShapes()->remove($shape);
    }
    $presentation->save("output.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

Recadrer une Image

Ce code PHP vous montre comment recadrer une image existante sur une diapositive :

  $pres = new Presentation();
  # Crée un nouvel objet image
  try {
    $picture;
    $image = Images->fromFile($imagePath);
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # Ajoute un PictureFrame à une Diapositive
    $picFrame = $pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 100, 100, 420, 250, $picture);
    # Recadre l'image (valeurs en pourcentage)
    $picFrame->getPictureFormat()->setCropLeft(23.6);
    $picFrame->getPictureFormat()->setCropRight(21.5);
    $picFrame->getPictureFormat()->setCropTop(3);
    $picFrame->getPictureFormat()->setCropBottom(31);
    # Sauvegarde le résultat
    $pres->save($outPptxFile, SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Supprimer les Zones Recadrées de l’Image

Si vous souhaitez supprimer les zones recadrées d’une image contenue dans un cadre, vous pouvez utiliser la méthode deletePictureCroppedAreas(). Cette méthode retourne l’image recadrée ou l’image d’origine si le recadrage n’est pas nécessaire.

Ce code PHP démontre l’opération :

  $presentation = new Presentation("PictureFrameCrop.pptx");
  try {
    $slide = $presentation->getSlides()->get_Item(0);
    # Obtient le PictureFrame de la première diapositive
    $picFrame = $slide->getShapes()->get_Item(0);
    # Supprime les zones recadrées de l'image du PictureFrame et retourne l'image recadrée
    $croppedImage = $picFrame->getPictureFormat()->deletePictureCroppedAreas();
    # Sauvegarde le résultat
    $presentation->save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

NOTE

La méthode deletePictureCroppedAreas() ajoute l’image recadrée à la collection d’images de la présentation. Si l’image n’est utilisée que dans le PictureFrame traité, cette configuration peut réduire la taille de la présentation. Sinon, le nombre d’images dans la présentation résultante augmentera.

Cette méthode convertit les fichiers WMF/EMF en images raster PNG lors de l’opération de recadrage.

Verrouiller le Rapport d’Aspect

Si vous souhaitez qu’une forme contenant une image conserve son rapport d’aspect même après avoir changé les dimensions de l’image, vous pouvez utiliser la méthode setAspectRatioLocked pour définir le réglage Verrouiller le Rapport d’Aspect.

Ce code PHP vous montre comment verrouiller le rapport d’aspect d’une forme :

  $pres = new Presentation("pres.pptx");
  try {
    $layout = $pres->getLayoutSlides()->getByType(SlideLayoutType::Custom);
    $emptySlide = $pres->getSlides()->addEmptySlide($layout);
    $picture;
    $image = Images->fromFile("image.png");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    $pictureFrame = $emptySlide->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $presImage->getWidth(), $presImage->getHeight(), $picture);
    # définit la forme pour préserver le rapport d'aspect lors du redimensionnement
    $pictureFrame->getPictureFrameLock()->setAspectRatioLocked(true);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

NOTE

Ce réglage Verrouiller le Rapport d’Aspect préserve uniquement le rapport d’aspect de la forme et non de l’image qu’elle contient.

Utiliser la Propriété StretchOff

En utilisant les propriétés StretchOffsetLeft, StretchOffsetTop, StretchOffsetRight et StretchOffsetBottom de l’interface IPictureFillFormat et de la classe PictureFillFormat, vous pouvez spécifier un rectangle de remplissage.

Lorsqu’un étirement est spécifié pour une image, un rectangle source est mis à l’échelle pour s’adapter au rectangle de remplissage spécifié. Chaque bord du rectangle de remplissage est défini par un décalage en pourcentage par rapport au bord correspondant de la boîte englobante de la forme. Un pourcentage positif spécifie un retrait tandis qu’un pourcentage négatif spécifie un dépassement.

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive par son index.
Ajoutez une rectangle AutoShape.
Créez une image.
Définissez le type de remplissage de la forme.
Définissez le mode de remplissage d’image de la forme.
Ajoutez une image définie pour remplir la forme.
Spécifiez les décalages d’image par rapport au bord correspondant de la boîte englobante de la forme.
Écrivez la présentation modifiée sous forme de fichier PPTX.

Ce code PHP démontre un processus dans lequel une propriété StretchOff est utilisée :

  # Instancie la classe Presentation qui représente un fichier PPTX
  $pres = new Presentation();
  try {
    # Obtient la première diapositive
    $slide = $pres->getSlides()->get_Item(0);
    # Instancie la classe ImageEx
    $picture;
    $image = Images->fromFile("aspose-logo.jpg");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # Ajoute un AutoShape défini sur Rectangle
    $aShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
    # Définit le type de remplissage de la forme
    $aShape->getFillFormat()->setFillType(FillType::Picture);
    # Définit le mode de remplissage d'image de la forme
    $aShape->getFillFormat()->getPictureFillFormat()->setPictureFillMode(PictureFillMode->Stretch);
    # Définit l'image pour remplir la forme
    $aShape->getFillFormat()->getPictureFillFormat()->getPicture()->setImage($picture);
    # Spécifie les décalages d'image par rapport au bord correspondant de la boîte englobante de la forme
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetLeft(25);
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetRight(25);
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetTop(-20);
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetBottom(-10);
    # Écrit le fichier PPTX sur le disque
    $pres->save("StretchOffsetLeftForPictureFrame_out.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }