# 在 PHP 中將簡報投影片轉換為影像

> 使用 Aspose.Slides for PHP via Java 將 PPT、PPTX 與 ODP 投影片轉換為影像 — 快速、高品質的渲染，並提供清晰的程式碼範例。

Source: https://docs.aspose.com/slides/zh-hant/php-java/convert-slide/


## **簡介**

Aspose.Slides for PHP via Java 讓您可以輕鬆將 PowerPoint 與 OpenDocument 簡報投影片轉換為各種影像格式，包括 BMP、PNG、JPG（JPEG）、GIF 等等。

要將投影片轉換為影像，請依照以下步驟：

1. 定義所需的轉換設定，並使用以下方式選取要匯出的投影片：
    - 使用 [TiffOptions](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/tiffoptions/) 類別，或
    - 使用 [RenderingOptions](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/renderingoptions/) 類別。
2. 呼叫 [getImage](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/slide/#getImage) 方法產生投影片影像。

在 Aspose.Slides for PHP via Java 中，[IImage](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/iimage/) 是一個允許您處理以像素資料定義之影像的類別。您可以使用此類別將影像儲存為各種格式（BMP、JPG、PNG 等）。

## **將投影片轉換為點陣圖並以 PNG 儲存影像**

您可以將投影片轉換為點陣圖物件，直接在應用程式中使用。或者，您也可以先將投影片轉換為點陣圖，然後以 JPEG 或其他偏好的格式儲存影像。

以下程式碼示範如何將簡報的第一張投影片轉換為點陣圖物件，並以 PNG 格式儲存影像：

```php
$presentation = new Presentation("Presentation.pptx");
try {
    // 將簡報中的第一張投影片轉換為點陣圖。
    $image = $presentation->getSlides()->get_Item(0)->getImage();
    try {
        // 以 PNG 格式儲存影像。
        $image->save("Slide_0.png", ImageFormat::Png);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}
```

## **以自訂尺寸將投影片轉換為影像**

您可能需要取得特定尺寸的影像。透過 [getImage](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/slide/#getImage) 的重載，您可以將投影片轉換為具有指定寬度與高度的影像。

以下範例程式碼說明如何執行此操作：

```php
$imageSize = new Java("java.awt.Dimension", 1820, 1040);

$presentation = new Presentation("Presentation.pptx");
try {
    // 將簡報中的第一張投影片以指定尺寸轉換為點陣圖。
    $image = $presentation->getSlides()->get_Item(0)->getImage($imageSize);
    try {
        // 以 JPEG 格式儲存影像。
        $image->save("Slide_0.jpg", ImageFormat::Jpeg);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}
```

## **將含備註與評論的投影片轉換為影像**

某些投影片可能包含備註與評論。

Aspose.Slides 提供兩個類別 [TiffOptions](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/tiffoptions/) 與 [RenderingOptions](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/renderingoptions/)，讓您能控制簡報投影片轉換為影像的渲染方式。兩個類別皆包含 `setSlidesLayoutOptions` 方法，您可以透過此方法在將投影片轉換為影像時設定備註與評論的渲染方式。

使用 [NotesCommentsLayoutingOptions](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/notescommentslayoutingoptions/) 類別，您可以指定備註與評論在最終影像中的顯示位置。

以下程式碼示範如何將含備註與評論的投影片轉換為影像：

```php
$scaleX = 2;
$scaleY = $scaleX;

$presentation = new Presentation("Presentation_with_notes_and_comments.pptx");
try {
    $notesCommentsOptions = new NotesCommentsLayoutingOptions();
    $notesCommentsOptions->setNotesPosition(NotesPositions::BottomTruncated);         // 設定備註的位置。
    $notesCommentsOptions->setCommentsPosition(CommentsPositions::Right);             // 設定評論的位置。
    $notesCommentsOptions->setCommentsAreaWidth(500);                                 // 設定評論區域的寬度。
    $notesCommentsOptions->setCommentsAreaColor(java("java.awt.Color")->LIGHT_GRAY);  // 設定評論區域的顏色。

    // 建立渲染選項。
    $options = new RenderingOptions();
    $options->setSlidesLayoutOptions($notesCommentsOptions);

    // 將簡報的第一張投影片轉換為影像。
    $image = $presentation->getSlides()->get_Item(0)->getImage($options, $scaleX, $scaleY);
    try {
        // 以 GIF 格式儲存影像。
        $image->save("Image_with_notes_and_comments_0.gif", ImageFormat::Gif);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}
```

{{% alert title="Note" color="warning" %}} 

在任何投影片轉為影像的過程中，[setNotesPosition](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/notescommentslayoutingoptions/#setNotesPosition) 方法無法套用 `BottomFull`（用以指定備註位置），因為備註文字可能過長，無法容納在指定的影像尺寸內。

{{% /alert %}} 

## **使用 TIFF 選項將投影片轉換為影像**

[TiffOptions](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/tiffoptions/) 類別允許您透過設定尺寸、解析度、色彩調色盤等參數，對最終的 TIFF 影像進行更精細的控制。

以下程式碼示範一個使用 TIFF 選項，將影像輸出為 300 DPI、尺寸為 2160 × 2800 的黑白影像的轉換過程：

```php
// 載入簡報檔案。
$presentation = new Presentation("sample.pptx");
try {
    // 取得簡報的第一張投影片。
    $slide = $presentation->getSlides()->get_Item(0);

    // 設定輸出 TIFF 影像的參數。
    $options = new TiffOptions();
    $options->setImageSize(new Java("java.awt.Dimension", 2160, 2880));  // 設定影像尺寸。
    $options->setPixelFormat(ImagePixelFormat::Format1bppIndexed);       // 設定像素格式（黑白）。
    $options->setDpiX(300);                                              // 設定水平解析度。
    $options->setDpiY(300);                                              // 設定垂直解析度。
    
    // 使用指定的選項將投影片轉換為影像。
    $image = $slide->getImage($options);
    try {
        // 以 TIFF 格式儲存影像。
        $image->save("output.tiff", ImageFormat::Tiff);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}
```

{{% alert title="Note" color="warning" %}} 

在 JDK 9 之前的版本中，無法保證支援 Tiff。

{{% /alert %}} 

## **將全部投影片轉換為影像**

Aspose.Slides 允許您將簡報中的所有投影片轉換為影像，亦即將整個簡報轉換為一系列影像。

以下範例程式碼示範如何在 PHP 中將簡報的所有投影片轉換為影像：

```php
$scaleX = 2;
$scaleY = $scaleX;

$presentation = new Presentation("Presentation.pptx");
try {
    // 逐張渲染簡報為影像。
    for($i = 0; $i < java_values($presentation->getSlides()->size()) ; $i++) {
        // 控制隱藏投影片（不渲染隱藏的投影片）。
        if (java_values($presentation->getSlides()->get_Item($i)->getHidden())) {
            continue;
        }

        // 將投影片轉換為影像。
        $image = $presentation->getSlides()->get_Item($i)->getImage($scaleX, $scaleY);
        try {
            // 以 JPEG 格式儲存影像。
            $image->save("Slide_" . $i . ".jpg", ImageFormat::Jpeg);
        } finally {
            $image->dispose();
        }
    }
} finally {
    $presentation->dispose();
}
```

## **常見問題**

**Aspose.Slides 是否支援渲染包含動畫的投影片？**

不支援，`getImage` 方法僅儲存投影片的靜態影像，不會包含動畫。

**隱藏的投影片可以匯出為影像嗎？**

可以，隱藏的投影片可像一般投影片一樣處理。只要確保它們包含在處理迴圈中即可。

**影像可以儲存為帶有陰影與效果的樣式嗎？**

可以，Aspose.Slides 在將投影片儲存為影像時支援渲染陰影、透明度以及其他圖形效果。