在 PHP 中從簡報匯出數學方程式

簡介

Aspose.Slides for PHP via Java 允許您從簡報中匯出數學方程式。例如，您可能需要從投影片（來自特定簡報）中提取數學方程式，並在其他程式或平台中使用它們。

匯出數學方程式為 LaTeX

Aspose.Slides 能直接將 PowerPoint 數學方程式轉換為 LaTeX；不需要中介的 MathML 檔案或外部轉換器。數學方程式以 MathPortion 的形式存儲在文字框中。使用 MathPortion::getMathParagraph 取得 MathParagraph，接著呼叫 MathParagraph::toLatex。此方法會回傳字串，您可以將其儲存、顯示、傳送至其他應用程式，或進一步處理。

以下範例會檢查每一張投影片上的所有文字框，找出所有數學區段，並將每個方程式寫入單獨的 .tex 檔案：

$presentation = new Presentation("equations.pptx");
$arrayClass = new JavaClass("java.lang.reflect.Array");
$mathPortionClass = new JavaClass("com.aspose.slides.MathPortion");

try {
    $slideCount = java_values($presentation->getSlides()->size());
    for ($slideIndex = 0; $slideIndex < $slideCount; $slideIndex++) {
        $slide = $presentation->getSlides()->get_Item($slideIndex);
        $slideNumber = $slideIndex + 1;
        $equationNumber = 1;
        $textFrames = SlideUtil::getAllTextBoxes($slide);
        $textFrameCount = java_values($arrayClass->getLength($textFrames));

        for ($textFrameIndex = 0; $textFrameIndex < $textFrameCount; $textFrameIndex++) {
            $textFrame = $textFrames[$textFrameIndex];
            $paragraphCount = java_values($textFrame->getParagraphs()->getCount());
            for ($paragraphIndex = 0; $paragraphIndex < $paragraphCount; $paragraphIndex++) {
                $paragraph = $textFrame->getParagraphs()->get_Item($paragraphIndex);
                $portionCount = java_values($paragraph->getPortions()->getCount());
                for ($portionIndex = 0; $portionIndex < $portionCount; $portionIndex++) {
                    $portion = $paragraph->getPortions()->get_Item($portionIndex);
                    if (!java_instanceof($portion, $mathPortionClass)) {
                        continue;
                    }

                    $mathParagraph = $portion->getMathParagraph();
                    $latexFileName = "slide_" . $slideNumber . "_equation_" . $equationNumber . ".tex";

                    $latexText = java_values($mathParagraph->toLatex());
                    file_put_contents($latexFileName, $latexText);
                    $equationNumber++;
                }
            }
        }
    }
} finally {
    $presentation->dispose();
}

SlideUtil::getAllTextBoxes 會返回投影片上找到的所有文字框。 MathPortion 的型別檢查會將真正可編輯的方程式與普通文字和影像區分開來。

LaTeX 引擎與文件範本並非全部支援相同的指令、套件或 Unicode 字元。請使用您應用程式所使用的 LaTeX 引擎測試回傳的字串。若某個符號或 Office Math 元素在該環境中沒有合適的表示方式，請在回傳的字串中以專案特定的指令取代，或跳過該方程式並記錄問題以供檢視。

將數學方程式儲存為 MathML

雖然人類可以輕鬆撰寫 LaTeX 等某些方程式格式的程式碼，但對於 MathML 則較為困難，因為後者本應由應用程式自動產生。程式能輕鬆讀取與解析 MathML，因為其程式碼是 XML，所以 MathML 常被用作許多領域的輸出與列印格式。

以下範例程式碼示範如何將簡報中的數學方程式匯出為 MathML：

  $pres = new Presentation();
  try {
    $autoShape = $pres->getSlides()->get_Item(0)->getShapes()->addMathShape(0, 0, 500, 50);
    $mathParagraph = $autoShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
    $mathParagraph->add(new MathematicalText("a")->setSuperscript("2")->join("+")->join(new MathematicalText("b")->setSuperscript("2"))->join("=")->join(new MathematicalText("c")->setSuperscript("2")));
    $stream = new Java("java.io.FileOutputStream", "mathml.xml");
    $mathParagraph->writeAsMathMl($stream);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

常見問題

到底匯出到 MathML 的是整段還是單一公式區塊？
您可以將整個數學段落（MathParagraph）或單一區塊（MathBlock）匯出為 MathML。兩種型別皆提供寫入 MathML 的方法。

如何判斷投影片上的物件是數學公式而非普通文字或影像？
公式存在於 MathPortion 中，且具有 MathParagraph。沒有 MathParagraph 的影像或普通文字區段不是可匯出的公式。

簡報中的 MathML 來源是什麼——它是 PowerPoint 專屬的還是標準？
匯出目標是標準的 MathML（XML）。Aspose 使用的是 Presentation MathML——標準的呈現子集，廣泛應用於各種應用程式與網路上。

是否支援匯出位於表格、SmartArt、群組等內的公式？
是的，只要這些物件包含帶有 MathParagraph 的文字區段（即真正的 PowerPoint 公式），就會被匯出。若公式以影像形式嵌入，則不會被匯出。

匯出為 MathML 會修改原始簡報嗎？
不會。寫入 MathML 只是將公式內容序列化，並不會修改簡報檔案。