Extract Text from Presentation

It’s not uncommon that developers need to extract the text from a presentation. To do so, you need to extract text from all the shapes on all the slides in a presentation. This article explains how to extract text from Microsoft PowerPoint PPTX presentations using Aspose.Slides.

Extract Text from Slide

Aspose.Slides for PHP via Java provides the SlideUtil class. This class exposes a number of overloaded static methods for extracting the entire text from a presentation or slide. To extract the text from a slide in a PPTX presentation, use the getAllTextBoxes overloaded static method exposed by the SlideUtil class. This method accepts the Slide object as a parameter. Upon execution, the Slide method scans the entire text from the slide passed as parameter and returns an array of TextFrame objects. This means that any text formatting associated with the text is available. The following piece of code extracts all the text on the first slide of the presentation:

  # Instatiate Presentation class that represents a PPTX file
  $pres = new Presentation("demo.pptx");
  $Array = new java_class("java.lang.reflect.Array");
  try {
    foreach($pres->getSlides() as $slide) {
      # Get an Array of ITextFrame objects from all slides in the PPTX
      $textFramesPPTX = SlideUtil->getAllTextBoxes($slide);
      # Loop through the Array of TextFrames
      for($i = 0; $i < java_values($Array->getLength($textFramesPPTX)) ; $i++) {
        # Loop through paragraphs in current ITextFrame
        foreach($textFramesPPTX[$i]->getParagraphs() as $para) {
          # Loop through portions in the current IParagraph
          foreach($para->getPortions() as $port) {
            # Display text in the current portion
            echo($port->getText());
            # Display font height of the text
            echo($port->getPortionFormat()->getFontHeight());
            # Display font name of the text
            if (!java_is_null($port->getPortionFormat()->getLatinFont())) {
              echo($port->getPortionFormat()->getLatinFont()->getFontName());
            }
          }
        }
      }
    }
  } finally {
    $pres->dispose();
  }

Extract Text from Presentation

To scan the text from the whole presentation, use the getAllTextFrames static method exposed by the SlideUtil class. It takes two parameters:

First, a Presentation object that represents the presentation from which the text is being extracted.
Second, a boolean value determining whether the master slide is to be included when the text is scanned from the presentation. The method returns an array of TextFrame objects, complete with text formatting information. The code below scans the text and formatting information from a presentation, including the master slides.

  # Instatiate Presentation class that represents a PPTX file
  $pres = new Presentation("demo.pptx");
  $Array = new java_class("java.lang.reflect.Array");
  try {
    # Get an Array of ITextFrame objects from all slides in the PPTX
    $textFramesPPTX = SlideUtil->getAllTextFrames($pres, true);
    # Loop through the Array of TextFrames
    for($i = 0; $i < java_values($Array->getLength($textFramesPPTX)) ; $i++) {
      # Loop through paragraphs in current ITextFrame
      foreach($textFramesPPTX[$i]->getParagraphs() as $para) {
        # Loop through portions in the current IParagraph
        foreach($para->getPortions() as $port) {
          # Display text in the current portion
          echo($port->getText());
          # Display font height of the text
          echo($port->getPortionFormat()->getFontHeight());
          # Display font name of the text
          if (!java_is_null($port->getPortionFormat()->getLatinFont())) {
            echo($port->getPortionFormat()->getLatinFont()->getFontName());
          }
        }
      }
    }
  } finally {
    $pres->dispose();
  }

Categorized and Fast Text Extraction

The new static method getPresentationText has been added to Presentation class. There are three overloads for this method:

The TextExtractionArrangingMode enum argument indicates the mode to organize the output of text result and can be set to the following values:

Unarranged - The raw text with no respect to position on the slide
Arranged - The text is positioned in the same order as on the slide

Unarranged mode can be used when speed is critical, it’s faster than Arranged mode.

IPresentationText represents the raw text extracted from the presentation. It contains a getSlidesText method which returns an array of ISlideText objects. Every object represent the text on the corresponding slide. ISlideText object have the following methods:

ISlideText.getText - The text on the slide’s shapes
ISlideText.getMasterText - The text on the master page’s shapes for this slide
ISlideText.getLayoutText - The text on the layout page’s shapes for this slide
ISlideText.getNotesText - The text on the notes page’s shapes for this slide

There is also a SlideText class which implements the ISlideText interface.

The new API can be used like this:

  $text1 = PresentationFactory->getInstance()->getPresentationText("presentation.pptx", TextExtractionArrangingMode->Unarranged);
  echo($text1->getSlidesText()[0]->getText());
  echo($text1->getSlidesText()[0]->getLayoutText());
  echo($text1->getSlidesText()[0]->getMasterText());
  echo($text1->getSlidesText()[0]->getNotesText());

Superscript and Subscript Presentation Localization