Node.js via .NET에서 프레젠테이션 슬라이드를 이미지로 변환

개요

Aspose.Slides for Node.js via .NET은 PowerPoint 및 OpenDocument 프레젠테이션의 슬라이드를 이미지로 렌더링합니다. 예를 들어 웹 페이지에 슬라이드 미리보기를 표시할 때 사용할 수 있습니다. 이 문서에서는 이미지 크기를 선택하는 두 가지 방법, 즉 슬라이드 크기에 대한 비율 인자와 픽셀 단위의 정확한 크기를 보여줍니다. 두 예제 모두 PNG 파일을 저장합니다.

예제는 프로젝트 폴더에 sample.pptx라는 이름의 프레젠테이션이 있다고 가정합니다. 이 프레젠테이션은 Installation에서 설정한 프로젝트 폴더에 있어야 합니다. 어떤 PowerPoint 프레젠테이션이든 사용할 수 있습니다. 각 예제를 프로젝트 폴더에 .js 파일로 저장하고 해당 폴더에서 node 명령으로 실행하십시오.

슬라이드를 이미지로 변환하려면 다음 단계를 따르세요:

  1. Presentation 생성자를 사용해 프레젠테이션을 엽니다.
  2. get(index)를 사용해 slides 컬렉션에서 슬라이드를 가져옵니다. 인덱스는 0부터 시작합니다.
  3. getImageWithScale 또는 getImageWithImageSize로 슬라이드를 렌더링합니다. .NET API 레퍼런스에서는 두 메서드 모두 Slide.GetImage의 오버로드이며, IImage 객체를 반환합니다.
  4. 이미지의 save 메서드와 ImageFormat 값을 사용해 저장한 뒤, dispose 메서드로 해제합니다.

모든 슬라이드를 PNG 이미지로 변환

getImageWithScale은 가로와 세로 비율 인자를 받습니다. 비율이 1이면 슬라이드의 1포인트가 이미지의 1픽셀에 해당합니다. 다음 예제는 모든 슬라이드를 비율 2로 렌더링합니다:

const { Presentation, ImageFormat } = require("aspose.slides.via.net");

// 스케일 1은 포인트당 한 픽셀을 렌더링합니다; 2는 너비와 높이를 두 배로 늘립니다.
const scaleX = 2;
const scaleY = scaleX;

const presentation = new Presentation("sample.pptx");
try {
    const slideCount = presentation.slides.count;
    for (let index = 0; index < slideCount; index++) {
        const slide = presentation.slides.get(index);
        const image = slide.getImageWithScale(scaleX, scaleY);
        try {
            image.save(`slide_${index + 1}.png`, ImageFormat.Png);
        } finally {
            image.dispose();
        }
    }
    console.log(`Saved ${slideCount} images`);
} finally {
    presentation.dispose();
}

스크립트는 슬라이드마다 하나의 파일을 작성합니다(slide_1.png, slide_2.png 등). 파일 번호는 1부터 시작합니다. 960 × 540 포인트 슬라이드를 가진 16:9 프레젠테이션의 경우 각 이미지 크기는 1920 × 1080 픽셀입니다. 숨김 슬라이드도 렌더링되며, 이를 건너뛰려면 슬라이드의 hidden 속성을 확인하세요. 각 이미지는 자체 finally 블록에서 해제되어 다음 슬라이드가 렌더링되기 전에 메모리가 해제됩니다. 라이선스가 없으면 이미지에 평가용 워터마크가 표시됩니다. 자세한 내용은 Licensing를 참조하세요.

지정 크기의 이미지로 슬라이드 변환

getImageWithImageSize는 픽셀 단위의 width와 height를 포함하는 객체를 받습니다. 다음 예제는 첫 번째 슬라이드를 가로 1280픽셀로 렌더링하고 슬라이드 크기로부터 높이를 계산하여 이미지가 슬라이드의 종횡비를 유지하도록 합니다:

const { Presentation, ImageFormat } = require("aspose.slides.via.net");

const imageWidth = 1280;

const presentation = new Presentation("sample.pptx");
try {
    const slideSize = presentation.slideSize.size;
    const imageHeight = Math.round(imageWidth * slideSize.height / slideSize.width);

    const slide = presentation.slides.get(0);
    const image = slide.getImageWithImageSize({ width: imageWidth, height: imageHeight });
    try {
        image.save("slide_1_1280px.png", ImageFormat.Png);
    } finally {
        image.dispose();
    }
    console.log(`Saved a ${imageWidth} x ${imageHeight} image`);
} finally {
    presentation.dispose();
}

slideSize.size 속성은 슬라이드의 너비와 높이를 포인트 단위로 반환합니다. 16:9 프레젠테이션의 경우 스크립트는 Saved a 1280 x 720 image를 출력하고 slide_1_1280px.png 파일을 생성합니다. 4:3 프레젠테이션에서는 이미지가 1280 × 960 픽셀이 됩니다.

FAQ

getImage를 인수 없이 호출하면 이미지가 왜 이렇게 작나요?
인수를 제공하지 않을 경우 getImage는 슬라이드를 포인트 크기의 20%로 렌더링하므로, 960 × 540 포인트 슬라이드가 192 × 108 픽셀 이미지가 됩니다. 크기를 지정하려면 getImageWithScale 또는 getImageWithImageSize를 사용하세요.

JPEG 등 다른 이미지 형식으로 저장하려면 어떻게 해야 하나요?
이미지의 save 메서드에 다른 ImageFormat 값을 전달하면 됩니다. 예: image.save("slide_1.jpg", ImageFormat.Jpeg). 형식은 ImageFormat 값에 따라 결정되며 파일 확장자와 일치시켜야 합니다.

Linux에서 이미지의 텍스트가 다르게 보이는 이유는 무엇인가요?
Aspose.Slides는 슬라이드를 렌더링하는 머신에 설치된 폰트만 사용할 수 있습니다. 프레젠테이션에 사용된 폰트가 누락된 경우(예: 일반적인 Linux 서버에 Calibri가 없을 때) Aspose.Slides는 대체 폰트를 사용해 텍스트 모양과 줄 바꿈이 달라질 수 있습니다. Windows와 동일한 이미지를 얻으려면 프레젠테이션에 사용된 폰트를 설치하세요.

getThumbnailWithImageSize가 TypeError를 발생시키는 이유는 무엇인가요?
패키지 README에 getThumbnailWithImageSize가 언급되어 있지만 패키지에는 getThumbnail 메서드가 없습니다. 대신 동일한 { width, height } 인자를 받는 getImageWithImageSize를 사용하세요.

Node.js를 통한 .NET에서 PowerPoint를 PDF로 변환 Node.js(.NET)에서 프레젠테이션 텍스트 관리