# PHP를 사용한 핸드아웃 모드에서 PowerPoint 프레젠테이션 변환

> PHP에서 프레젠테이션을 핸드아웃으로 변환합니다. 페이지당 슬라이드 수를 설정하고, 메모를 유지하며, Aspose.Slides for PHP를 사용해 PDF 또는 이미지로 내보낼 수 있는 샘플 코드와 함께 제공합니다. 무료로 사용해 보세요.

Source: https://docs.aspose.com/slides/ko/php-java/convert-powerpoint-in-handout-mode/
Updated: 2026-06-14

## **소개**

Aspose.Slides는 프레젠테이션을 다양한 형식으로 변환하고 Handout 모드로 인쇄용 핸드아웃을 만들 수 있는 기능을 제공합니다. 이 모드를 사용하면 한 페이지에 여러 슬라이드를 배치하는 방식을 구성할 수 있어 회의, 세미나 및 기타 행사에 유용합니다. `setSlidesLayoutOptions` 메서드를 [PdfOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/pdfoptions/), [RenderingOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/renderingoptions/), [HtmlOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/htmloptions/), [TiffOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/tiffoptions/) 클래스에 설정하여 이 모드를 활성화할 수 있습니다.

## **핸드아웃 모드 내보내기**

Handout 모드를 구성하려면 [HandoutLayoutingOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/handoutlayoutingoptions/) 객체를 사용합니다. 이 객체는 한 페이지에 배치되는 슬라이드 수와 기타 표시 매개변수를 결정합니다.

아래는 Handout 모드에서 프레젠테이션을 PDF로 변환하는 코드 예제입니다.

```php
// 프레젠테이션을 로드합니다.
$presentation = new Presentation("sample.pptx");

// Set the export options.
$slidesLayoutOptions = new HandoutLayoutingOptions();
$slidesLayoutOptions->setHandout(HandoutType::Handouts4Horizontal);  // 한 페이지에 가로로 4개의 슬라이드
$slidesLayoutOptions->setPrintSlideNumbers(true);                    // 슬라이드 번호 출력
$slidesLayoutOptions->setPrintFrameSlide(true);                      // 슬라이드 주변에 테두리 출력
$slidesLayoutOptions->setPrintComments(false);                       // 주석 없음

$pdfOptions = new PdfOptions();
$pdfOptions->setSlidesLayoutOptions($slidesLayoutOptions);

// Export the presentation to PDF with the chosen layout.
$presentation->save("output.pdf", SaveFormat::Pdf, $pdfOptions);
$presentation->dispose();
```

{{% alert color="warning" %}} 
`setSlidesLayoutOptions` 메서드는 PDF, HTML, TIFF와 같이 특정 출력 형식 및 이미지로 렌더링할 때만 사용할 수 있다는 점을 기억하십시오.
{{% /alert %}} 

## **FAQ**

**Handout 모드에서 페이지당 최대 슬라이드 썸네일 수는 얼마입니까?**

Aspose.Slides는 페이지당 최대 9개의 썸네일을 지원하며, 가로 또는 세로 순서로 배치할 수 있는 [presets](https://reference.aspose.com/slides/ko/php-java/aspose.slides/handouttype/)을 제공합니다: 1, 2, 3, 4(가로/세로), 6(가로/세로), 9(가로/세로).

**페이지당 5개 또는 8개의 슬라이드와 같은 사용자 정의 그리드를 정의할 수 있나요?**

아니요. 썸네일의 수와 순서는 [HandoutType](https://reference.aspose.com/slides/ko/php-java/aspose.slides/handouttype/) 클래스로 엄격히 제어되며, 임의의 레이아웃은 지원되지 않습니다.

**Handout 출력에 숨겨진 슬라이드를 포함할 수 있나요?**

예. 대상 형식의 내보내기 설정에서 `setShowHiddenSlides` 메서드를 사용하여 숨겨진 슬라이드를 활성화하면 됩니다. 예: [PdfOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/pdfoptions/), [HtmlOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/htmloptions/), [TiffOptions](https://reference.aspose.com/slides/ko/php-java/aspose.slides/tiffoptions/).