PHP에서 프레젠테이션 슬라이드를 이미지로 변환
소개
Aspose.Slides for PHP via Java은 PowerPoint 및 OpenDocument 프레젠테이션의 개별 슬라이드를 PNG, JPEG, GIF, TIFF 등 다양한 이미지 형식으로 렌더링할 수 있습니다.
슬라이드를 이미지로 변환하려면 다음 단계를 따르세요:
- Presentation 클래스를 사용하여 프레젠테이션을 로드합니다.
- 렌더링하려는 슬라이드를 선택합니다.
- 필요에 따라 RenderingOptions 또는 TiffOptions 클래스를 사용하여 렌더링을 구성합니다.
- Slide::getImage 메서드를 호출합니다. 이 메서드는 IImage 객체를 반환합니다.
- IImage::save 메서드를 호출하고 ImageFormat 값을 사용하여 출력 형식을 지정합니다.
슬라이드를 PNG 이미지로 변환
가장 간단한 변환은 기본 렌더링 설정을 사용합니다. 결과로 생성된 IImage 객체는 메모리에서 처리하거나 파일로 저장할 수 있습니다.
다음 PHP 예제는 첫 번째 슬라이드를 렌더링하고 PNG 이미지로 저장합니다:
use aspose\slides\ImageFormat;
use aspose\slides\Presentation;
$presentation = new Presentation("Presentation.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$image = $slide->getImage();
try {
$image->save("Slide_0.png", ImageFormat::Png);
} finally {
$image->dispose();
}
} finally {
$presentation->dispose();
}
맞춤 크기로 슬라이드 이미지를 변환
Dimension 값을 수락하는 Slide::getImage 오버로드를 사용하여 정확한 픽셀 크기로 슬라이드를 렌더링합니다.
다음 예제는 1820 × 1040 JPEG 이미지를 생성합니다:
use aspose\slides\ImageFormat;
use aspose\slides\Presentation;
$imageSize = new Java("java.awt.Dimension", 1820, 1040);
$presentation = new Presentation("Presentation.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$image = $slide->getImage($imageSize);
try {
$image->save("Slide_0.jpg", ImageFormat::Jpeg);
} finally {
$image->dispose();
}
} finally {
$presentation->dispose();
}
노트 및 댓글이 포함된 슬라이드를 이미지로 변환
기본적으로 슬라이드 이미지에는 노트나 댓글이 포함되지 않습니다. 노트와 댓글의 위치를 제어하려면 NotesCommentsLayoutingOptions 객체를 RenderingOptions::setSlidesLayoutOptions 메서드에 전달합니다.
다음 예제는 잘린 노트를 슬라이드 아래에, 댓글을 오른쪽에 배치합니다:
use aspose\slides\CommentsPositions;
use aspose\slides\ImageFormat;
use aspose\slides\NotesCommentsLayoutingOptions;
use aspose\slides\NotesPositions;
use aspose\slides\Presentation;
use aspose\slides\RenderingOptions;
$scaleX = 2;
$scaleY = $scaleX;
$commentsAreaColor = new Java("java.awt.Color", 250, 235, 215);
$layoutOptions = new NotesCommentsLayoutingOptions();
$layoutOptions->setNotesPosition(NotesPositions::BottomTruncated);
$layoutOptions->setCommentsPosition(CommentsPositions::Right);
$layoutOptions->setCommentsAreaWidth(500);
$layoutOptions->setCommentsAreaColor($commentsAreaColor);
$renderingOptions = new RenderingOptions();
$renderingOptions->setSlidesLayoutOptions($layoutOptions);
$presentation = new Presentation("Presentation_with_notes_and_comments.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$image = $slide->getImage($renderingOptions, $scaleX, $scaleY);
try {
$image->save("Image_with_notes_and_comments_0.gif", ImageFormat::Gif);
} finally {
$image->dispose();
}
} finally {
$presentation->dispose();
}
Warning
슬라이드-이미지 변환 시, NotesCommentsLayoutingOptions::setNotesPosition 메서드에 BottomFull을 전달하지 마세요. 노트는 고정된 이미지 크기보다 더 많은 텍스트를 포함할 수 있습니다. 대신 BottomTruncated을 사용하세요.TIFF 옵션을 사용하여 슬라이드를 이미지로 변환
TiffOptions 클래스를 사용하면 렌더링된 TIFF 이미지의 크기, 해상도 및 기타 속성을 제어할 수 있습니다.
다음 예제는 첫 번째 슬라이드를 300 DPI에서 2160 × 2880 TIFF 이미지로 렌더링합니다:
use aspose\slides\ImageFormat;
use aspose\slides\Presentation;
use aspose\slides\TiffOptions;
$imageSize = new Java("java.awt.Dimension", 2160, 2880);
$tiffOptions = new TiffOptions();
$tiffOptions->setImageSize($imageSize);
$tiffOptions->setDpiX(300);
$tiffOptions->setDpiY(300);
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$image = $slide->getImage($tiffOptions);
try {
$image->save("output.tiff", ImageFormat::Tiff);
} finally {
$image->dispose();
}
} finally {
$presentation->dispose();
}
Warning
JDK 9 이전의 Java 버전에서는 TIFF 지원이 보장되지 않습니다.모든 슬라이드를 이미지로 변환
슬라이드 컬렉션을 반복하여 전체 프레젠테이션을 일련의 이미지로 변환합니다. 명시적으로 건너뛰지 않는 한 숨겨진 슬라이드도 포함됩니다.
다음 예제는 모든 슬라이드를 가로 및 세로 배율 2인 JPEG 이미지로 렌더링합니다:
use aspose\slides\ImageFormat;
use aspose\slides\Presentation;
$scaleX = 2;
$scaleY = $scaleX;
$presentation = new Presentation("Presentation.pptx");
try {
$slideCount = java_values($presentation->getSlides()->size());
for ($index = 0; $index < $slideCount; $index++) {
$slide = $presentation->getSlides()->get_Item($index);
$image = $slide->getImage($scaleX, $scaleY);
try {
$image->save("Slide_" . $index . ".jpg", ImageFormat::Jpeg);
} finally {
$image->dispose();
}
}
} finally {
$presentation->dispose();
}
향상 메타파일 출력 만들기
Enhanced Metafile (EMF)은 벡터 기반 그래픽을 Microsoft Office 또는 Windows 메타파일을 지원하는 기타 Windows 애플리케이션과 교환해야 할 때 유용합니다. 픽셀 기반 이미지와 달리 EMF는 샤프함 손실 없이 확대/축소할 수 있는 벡터 그리기 작업을 유지합니다. 그러나 EMF는 Windows 메타파일을 지원하는 애플리케이션을 위한 호환성 포맷으로, 보편적인 교환 포맷은 아닙니다. 또한 비트맵 이미지와 일부 효과와 같은 복잡한 슬라이드 콘텐츠는 벡터 메타파일 컨테이너 내부의 래스터화된 요소로 저장될 수 있습니다.
슬라이드를 EMF로 내보내기
Slide::writeAsEmf 메서드는 슬라이드를 EMF 형식의 대상 스트림에 씁니다. 다음 예제는 프레젠테이션을 로드하고, 첫 번째 슬라이드를 선택한 뒤, EMF 파일 스트림에 씁니다:
use aspose\slides\Presentation;
$presentation = new Presentation("Presentation.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$emfStream = new Java("java.io.FileOutputStream", "Slide_0.emf");
try {
$slide->writeAsEmf($emfStream);
} finally {
$emfStream->close();
}
} finally {
$presentation->dispose();
}
Slide::writeAsEmf에 전달된 스트림은 호출자가 소유하며, 위와 같이 스트림을 닫는 책임이 있습니다.
SVG 이미지를 EMF로 변환하고 프레젠테이션에 추가하기
SvgImage::writeAsEmf를 사용하여 SVG 내용을 EMF로 변환합니다. 결과 바이트는 ImageCollection::addImage을 통해 프레젠테이션에 추가하고, ShapeCollection::addPictureFrame으로 슬라이드에 배치할 수 있습니다.
다음 예제는 SVG 마크업에서 SvgImage을 생성하고, 이를 메모리 내 EMF로 변환한 뒤, 첫 번째 슬라이드에 메타파일을 삽입하고 프레젠테이션을 저장합니다:
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\SvgImage;
$svgContent = '<svg xmlns="http://www.w3.org/2000/svg" width="200" height="100"><rect width="200" height="100" fill="#4472C4"/></svg>';
$svgImage = new SvgImage($svgContent);
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$emfStream = new Java("java.io.ByteArrayOutputStream");
try {
$svgImage->writeAsEmf($emfStream);
$emfData = $emfStream->toByteArray();
$image = $presentation->getImages()->addImage($emfData);
$slide->getShapes()->addPictureFrame(ShapeType::Rectangle, 20, 20, 200, 100, $image);
} finally {
$emfStream->close();
}
$presentation->save("Presentation_with_emf.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
SvgImage::writeAsEmf은 대상 스트림의 소유권을 갖지 않습니다. ByteArrayOutputStream은 모든 생성 데이터를 메모리에 저장하므로 toByteArray 호출 전에 위치를 재설정할 필요가 없습니다. 반환된 바이트 배열은 스트림이 닫힌 후에도 유효합니다.
EMF 생성은 선택한 Aspose.Slides for PHP via Java 및 JDK 구성에서 지원되는 운영 체제에서 사용할 수 있지만, 글꼴이나 그래픽 종속성이 없을 경우 플랫폼마다 렌더링이 다를 수 있습니다. 원본 콘텐츠에서 사용된 글꼴을 설치하거나 적절한 대체 글꼴을 구성하고, Aspose.Slides for PHP via Java에 대한 platform requirements를 따른 후 대상 EMF 소비 애플리케이션에서 결과를 검증하세요. Linux 및 macOS 애플리케이션은 Windows 메타파일을 표시하고 편집하는 지원이 제한적이거나 일관되지 않을 수 있습니다.
컬러 이모지 렌더링
Note
프레젠테이션 슬라이드를 이미지로 변환할 때 컬러 이모지를 올바르게 렌더링하려면 프레젠테이션에 사용된 이모지 글꼴이 변환을 수행하는 시스템에 설치되고 사용 가능해야 합니다. 예를 들어 프레젠테이션이 Segoe UI Emoji를 사용하고 해당 글꼴이 없으면 출력 이미지에서 이모지가 단색으로 표시될 수 있습니다.FAQ
Aspose.Slides가 애니메이션이 있는 슬라이드 렌더링을 지원합니까?
아니요. Slide::getImage 메서드는 슬라이드의 정적 이미지를 렌더링하며 애니메이션을 내보내지 않습니다.
숨겨진 슬라이드를 이미지로 내보낼 수 있나요?
예. 숨겨진 슬라이드는 일반 슬라이드처럼 렌더링할 수 있습니다. 위 예제와 같이 처리 루프에 포함하면 됩니다.
그림자 및 기타 효과가 슬라이드 이미지에 보존됩니까?
예. Aspose.Slides는 슬라이드 이미지에 그림자, 투명도 및 기타 지원되는 그래픽 효과를 렌더링합니다.