PHP を使用したプレゼンテーションで画像フレームを管理する

画像フレームは画像を含む形状です—フレームに入った画像のようなものです。

画像フレームを介してスライドに画像を追加できます。この方法で、画像フレームの書式設定により画像を整形できます。

ヒント

Aspose は無料コンバータ—JPEG to PowerPoint と PNG to PowerPoint—を提供しており、画像からプレゼンテーションをすばやく作成できます。

画像フレームの作成

Presentation クラスのインスタンスを作成します。
インデックスでスライドの参照を取得します。
プレゼンテーションオブジェクトに関連付けられた IImagescollection に画像を追加して、IPPImage オブジェクトを作成します。
画像の幅と高さを指定します。
参照されたスライドに関連付けられた shape オブジェクトの AddPictureFrame メソッドを使用して、画像の幅と高さに基づく PictureFrame を作成します。
スライドに画像フレーム（画像を含む）を追加します。
変更されたプレゼンテーションを PPTX ファイルとして書き出します。

この PHP コードは画像フレームの作成方法を示します:

  # PPTX ファイルを表す Presentation クラスのインスタンスを作成します
  $pres = new Presentation();
  try {
    # 最初のスライドを取得します
    $sld = $pres->getSlides()->get_Item(0);
    # Image クラスのインスタンスを作成します
    $imgx = $pres->getImages()->addImage(new Java("java.io.FileInputStream", new Java("java.io.File", "asp1.jpg")));
    # 画像と同じ高さと幅でピクチャーフレームを追加します
    $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # PPTX ファイルをディスクに保存します
    $pres->save("RectPicFrame.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

画像フレームを使用すると、画像からプレゼンテーションスライドをすばやく作成できます。Aspose.Slides の保存オプションと組み合わせることで、入力/出力操作を操作して画像形式を変換できます。次のページもご参考ください: 変換 image to JPG; 変換 JPG to image; 変換 JPG to PNG, 変換 PNG to JPG; 変換 PNG to SVG, 変換 SVG to PNG.

相対スケール付き画像フレームの作成

画像の相対スケーリングを変更することで、より複雑な画像フレームを作成できます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドの参照を取得します。
プレゼンテーションの画像コレクションに画像を追加します。
プレゼンテーションオブジェクトに関連付けられた IImagescollection に画像を追加して、IPPImage オブジェクトを作成します。
画像フレーム内の画像の相対幅と高さを指定します。
変更されたプレゼンテーションを PPTX ファイルとして書き出します。

この PHP コードは相対スケール付き画像フレームの作成方法を示します:

  # PPTX を表す Presentation クラスをインスタンス化する
  $pres = new Presentation();
  try {
    # 最初のスライドを取得する
    $sld = $pres->getSlides()->get_Item(0);
    # Image クラスをインスタンス化する
    $imgx = $pres->getImages()->addImage(new Java("java.io.FileInputStream", new Java("java.io.File", "asp1.jpg")));
    # 画像と同等の高さと幅でピクチャーフレームを追加する
    $pf = $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # 相対スケールの幅と高さを設定する
    $pf->setRelativeScaleHeight(0.8);
    $pf->setRelativeScaleWidth(1.35);
    # PPTX ファイルをディスクに書き込む
    $pres->save("RectPicFrame.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

画像フレームからラスタ画像を抽出する

PictureFrame オブジェクトからラスタ画像を抽出し、PNG、JPG などの形式で保存できます。以下のコード例は、ドキュメント「sample.pptx」から画像を抽出し、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();
  }

画像フレームから SVG 画像を抽出する

プレゼンテーションに PictureFrame 形状内に埋め込まれた SVG グラフィックが含まれる場合、Aspose.Slides for PHP via Java は元のベクター画像を完全な忠実度で取得できます。スライドの shape コレクションを走査し、各 PictureFrame を特定し、基になる PPImage が SVG コンテンツを保持しているか確認し、ネイティブ SVG 形式でディスクまたはストリームに保存できます。

以下のコード例は、画像フレームから SVG 画像を抽出する方法を示しています:

$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();
}

画像の透明度を取得する

Aspose.Slides は画像に適用された透明度効果を取得できます。この PHP コードは操作を示しています:

  $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);
    }
  }

画像フレームの書式設定

Aspose.Slides は画像フレームに適用できる多数の書式設定オプションを提供します。これらのオプションを使用して、特定の要件に合わせて画像フレームを変更できます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドの参照を取得します。
プレゼンテーションオブジェクトに関連付けられた IImagescollection に画像を追加して、IPPImage オブジェクトを作成します。
画像の幅と高さを指定します。
参照されたスライドに関連付けられた IShapes オブジェクトの AddPictureFrame メソッドを使用して、画像の幅と高さに基づく PictureFrame を作成します。
スライドに画像フレーム（画像を含む）を追加します。
画像フレームの線色を設定します。
画像フレームの線幅を設定します。
正の値または負の値で画像フレームを回転させます。
- 正の値は時計回りに回転させます。
- 負の値は反時計回りに回転させます。
画像フレーム（画像を含む）をスライドに追加します。
変更されたプレゼンテーションを PPTX ファイルとして書き出します。

この PHP コードは画像フレームの書式設定プロセスを示します:

  # PPTX を表す Presentation クラスをインスタンス化します
  $pres = new Presentation();
  try {
    # 最初のスライドを取得します
    $sld = $pres->getSlides()->get_Item(0);
    # Image クラスをインスタンス化します
    $imgx = $pres->getImages()->addImage(new Java("java.io.FileInputStream", new Java("java.io.File", "asp1.jpg")));
    # 画像と同等の高さと幅でピクチャーフレームを追加します
    $pf = $sld->getShapes()->addPictureFrame(ShapeType::Rectangle, 50, 150, $imgx->getWidth(), $imgx->getHeight(), $imgx);
    # PictureFrameEx にいくつかの書式設定を適用します
    $pf->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $pf->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
    $pf->getLineFormat()->setWidth(20);
    $pf->setRotation(45);
    # PPTX ファイルをディスクに書き込みます
    $pres->save("RectPicFrame.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

ヒント

Aspose は最近、無料 Collage Maker を開発しました。JPG/JPEG や PNG 画像を結合したり、写真からグリッドを作成したりしたい場合にこのサービスを利用できます。

リンクとして画像を追加する

プレゼンテーションのサイズが大きくなるのを防ぐため、ファイルを直接埋め込む代わりにリンクとして画像（またはビデオ）を追加できます。この PHP コードはプレースホルダーに画像とビデオを追加する方法を示します:

  $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();
    }
  }

画像をトリミングする

この PHP コードはスライド上の既存画像をトリミングする方法を示します:

  $pres = new Presentation();
  # 新しい画像オブジェクトを作成します
  try {
    $picture;
    $image = Images->fromFile($imagePath);
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # スライドに PictureFrame を追加します
    $picFrame = $pres->getSlides()->get_Item(0)->getShapes()->addPictureFrame(ShapeType::Rectangle, 100, 100, 420, 250, $picture);
    # 画像をトリミングします（パーセンテージ値）
    $picFrame->getPictureFormat()->setCropLeft(23.6);
    $picFrame->getPictureFormat()->setCropRight(21.5);
    $picFrame->getPictureFormat()->setCropTop(3);
    $picFrame->getPictureFormat()->setCropBottom(31);
    # 結果を保存します
    $pres->save($outPptxFile, SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

画像フレームのトリミング領域を削除する

フレームに含まれる画像のトリミング領域を削除したい場合は、deletePictureCroppedAreas() メソッドを使用できます。このメソッドは、トリミングが不要な場合は元画像を返します。

この PHP コードは操作を示します:

  $presentation = new Presentation("PictureFrameCrop.pptx");
  try {
    $slide = $presentation->getSlides()->get_Item(0);
    # 最初のスライドから PictureFrame を取得します
    $picFrame = $slide->getShapes()->get_Item(0);
    # PictureFrame 画像のトリミング領域を削除し、トリミングされた画像を返します
    $croppedImage = $picFrame->getPictureFormat()->deletePictureCroppedAreas();
    # 結果を保存します
    $presentation->save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

注

deletePictureCroppedAreas() メソッドは、トリミングされた画像をプレゼンテーションの画像コレクションに追加します。画像が処理された PictureFrame のみで使用されている場合、この設定によりプレゼンテーションサイズを削減できます。そうでない場合、結果のプレゼンテーション内の画像数は増加します。

このメソッドは、トリミング操作中に WMF/EMF メタファイルをラスタ PNG 画像に変換します。

アスペクト比ロック

画像を含む形状の寸法を変更してもアスペクト比を保持したい場合は、setAspectRatioLocked メソッドを使用して Lock Aspect Ratio 設定を有効にできます。

この PHP コードは形状のアスペクト比をロックする方法を示します:

  $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);
    # リサイズ時にアスペクト比を保持するようにシェイプを設定する
    $pictureFrame->getPictureFrameLock()->setAspectRatioLocked(true);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

注

この Lock Aspect Ratio 設定は形状のアスペクト比のみを保持し、含まれる画像のアスペクト比は保持しません。

StretchOff プロパティの使用

IPictureFillFormat インターフェイスおよび PictureFillFormat クラスの StretchOffsetLeft、StretchOffsetTop、StretchOffsetRight、StretchOffsetBottom プロパティを使用して、塗りつぶし矩形を指定できます。

画像のストレッチが指定されると、ソース矩形が指定された塗りつぶし矩形に合わせてスケーリングされます。塗りつぶし矩形の各辺は、形状のバウンディングボックスの対応する辺からのパーセンテージオフセットで定義されます。正のパーセンテージはインセット、負のパーセンテージはアウトセットを示します。

Presentation クラスのインスタンスを作成します。
インデックスでスライドの参照を取得します。
四角形 AutoShape を追加します。
画像を作成します。
形状の塗りつぶしタイプを設定します。
形状の画像塗りつぶしモードを設定します。
塗りつぶし用の画像を設定します。
形状のバウンディングボックスの対応する辺からの画像オフセットを指定します。
変更されたプレゼンテーションを PPTX ファイルとして書き出します。

この PHP コードは StretchOff プロパティを使用したプロセスを示します:

  # PPTX ファイルを表す Presentation クラスのインスタンスを作成します
  $pres = new Presentation();
  try {
    # 最初のスライドを取得します
    $slide = $pres->getSlides()->get_Item(0);
    # ImageEx クラスのインスタンスを作成します
    $picture;
    $image = Images->fromFile("aspose-logo.jpg");
    try {
      $picture = $pres->getImages()->addImage($image);
    } finally {
      if (!java_is_null($image)) {
        $image->dispose();
      }
    }
    # 矩形に設定された AutoShape を追加します
    $aShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
    # シェイプの塗りつぶしタイプを設定します
    $aShape->getFillFormat()->setFillType(FillType::Picture);
    # シェイプの画像塗りつぶしモードを設定します
    $aShape->getFillFormat()->getPictureFillFormat()->setPictureFillMode(PictureFillMode->Stretch);
    # 画像をシェイプの塗りつぶしに設定します
    $aShape->getFillFormat()->getPictureFillFormat()->getPicture()->setImage($picture);
    # シェイプのバウンディングボックスの対応する辺からの画像オフセットを指定します
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetLeft(25);
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetRight(25);
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetTop(-20);
    $aShape->getFillFormat()->getPictureFillFormat()->setStretchOffsetBottom(-10);
    # PPTX ファイルをディスクに書き込みます
    $pres->save("StretchOffsetLeftForPictureFrame_out.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

PictureFrame がサポートする画像形式はどれですか？

Aspose.Slides は、PictureFrame に割り当てられた画像オブジェクトを通じて、ラスタ画像（PNG、JPEG、BMP、GIF など）とベクタ画像（例: SVG）をサポートします。サポートされる形式の一覧は、スライドおよび画像変換エンジンの機能とほぼ一致します。

多数の大きな画像を追加すると PPTX のサイズとパフォーマンスにどのような影響がありますか？

大きな画像を埋め込むとファイルサイズとメモリ使用量が増加します。画像をリンクとして追加するとプレゼンテーションサイズを抑えられますが、外部ファイルがアクセス可能である必要があります。Aspose.Slides はリンクで画像を追加する機能を提供しています。

画像オブジェクトを誤って移動・サイズ変更されないようにロックするには？

PictureFrame 用の shape locks を使用します（例: 移動やサイズ変更の無効化）。ロックの仕組みは別の記事 protection article に記載されており、さまざまな形状タイプでサポートされています。

SVG ベクタの忠実度は PDF/画像へのエクスポート時に保持されますか？

Aspose.Slides は、PictureFrame から元のベクターとして SVG を抽出できます。PDF へエクスポートする場合 (/slides/ja/php-java/convert-powerpoint-to-pdf/) やラスタ形式 (/slides/ja/php-java/convert-powerpoint-to-png/) では、エクスポート設定に応じてラスタ化されることがありますが、抽出時には元の SVG がベクターとして保持されていることが確認できます。