.NET에서 프레젠테이션 도형 썸네일 만들기

이 페이지의 내용

Aspose.Slides for .NET를 사용하여 PowerPoint 슬라이드에서 고품질 도형 썸네일을 생성하고, 프레젠테이션 썸네일을 손쉽게 만들고 내보냅니다.

소개

Aspose.Slides for .NET은 각 페이지가 슬라이드인 프레젠테이션 파일을 만들 때 사용됩니다. 이러한 슬라이드는 Microsoft PowerPoint로 프레젠테이션 파일을 열어 볼 수 있습니다. 하지만 때때로 개발자는 도형의 이미지를 이미지 뷰어에서 별도로 확인해야 할 수 있습니다. 이러한 경우 Aspose.Slides for .NET은 슬라이드 도형의 썸네일 이미지를 생성하는 데 도움을 줍니다. 이 기능을 사용하는 방법은 이 문서에 설명되어 있습니다. 이 문서에서는 슬라이드 썸네일을 다양한 방법으로 생성하는 방법을 설명합니다:

슬라이드 내부에서 도형 썸네일 생성
사용자 정의 차원을 가진 슬라이드 도형의 썸네일 생성
도형 외관의 경계 내에서 도형 썸네일 생성

슬라이드에서 도형 썸네일 생성

Presentation 클래스의 인스턴스를 생성합니다.
ID 또는 인덱스를 사용하여 원하는 슬라이드의 참조를 가져옵니다.
기본 스케일에서 참조된 슬라이드의 도형 썸네일 이미지를 가져옵니다.
썸네일 이미지를 원하는 형식으로 저장합니다.

아래 예제는 도형 썸네일을 생성합니다.

using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];
    using (IImage image = shape.GetImage())
    {
        image.Save("Shape_thumbnail_out.png", ImageFormat.Png);
    }
}

사용자 정의 스케일링 팩터 썸네일 생성

Presentation 클래스의 인스턴스를 생성합니다.
ID 또는 인덱스를 사용하여 원하는 슬라이드의 참조를 가져옵니다.
도형 경계를 포함한 참조 슬라이드의 썸네일 이미지를 가져옵니다.
썸네일 이미지를 원하는 형식으로 저장합니다.

아래 예제는 사용자 정의 스케일링 팩터를 사용하여 썸네일을 생성합니다.

ShapeThumbnailBounds bounds = ShapeThumbnailBounds.Shape;
float scale = 1; // X 및 Y 축에 대한 스케일링.

using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];
    using (IImage image = shape.GetImage(bounds, scale, scale))
    {
        image.Save("Scaling Factor Thumbnail_out.png", ImageFormat.Png);
    }
}

경계 기반 도형 외관 썸네일 생성

이 방법은 개발자가 도형 외관의 경계 내에서 썸네일을 생성하도록 합니다. 모든 도형 효과를 고려하며, 생성된 도형 썸네일은 슬라이드 경계에 제한됩니다. 도형 외관의 경계 내에서 슬라이드 도형의 썸네일을 생성하려면 다음 샘플 코드를 사용하십시오:

Presentation 클래스의 인스턴스를 생성합니다.
ID 또는 인덱스를 사용하여 원하는 슬라이드의 참조를 가져옵니다.
도형 외관을 기준으로 한 슬라이드의 썸네일 이미지를 가져옵니다.
썸네일 이미지를 원하는 형식으로 저장합니다.

아래 예제는 외관 경계를 기준으로 썸네일을 생성합니다.

ShapeThumbnailBounds bounds = ShapeThumbnailBounds.Appearance;
float scale = 1; // X 및 Y 축에 대한 스케일링.

using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
    IShape shape = presentation.Slides[0].Shapes[0];
    using (IImage image = shape.GetImage(bounds, scale, scale))
    {
        image.Save("Shape_thumbnail_Bound_Shape_out.png", ImageFormat.Png);
    }
}

도형의 실제 시각적 경계 가져오기

IShape의 프레임 속성—X, Y, Width, Height 속성—은 프레젠테이션 모델에 저장된 사각형을 설명합니다. 실제 렌더링되는 콘텐츠는 해당 프레임을 넘어 확장되거나 다른 축 정렬 사각형을 차지할 수 있습니다. 회전, 외곽선, 화살표 머리, 텍스트 레이아웃 및 오버플로, 생성된 SmartArt 기하학 및 기타 렌더링 효과가 모두 차지하는 영역을 변경할 수 있습니다.

GetVisualBounds를 사용하면 이미지를 만들지 않고 차지하는 영역을 계산할 수 있습니다. 이 메서드는 슬라이드 좌표계의 RectangleF를 반환합니다. 반환된 사각형은 슬라이드에 클리핑되지 않으므로 콘텐츠가 슬라이드 원점을 넘어설 경우 좌표가 음수가 될 수 있습니다.

GetVisualBounds는 현재 IShape 인터페이스에 선언되어 있지 않습니다. 따라서 슬라이드의 Shape 컬렉션에서 가져온 Shape를 인터페이스 값으로 유지하고 메서드를 호출할 때만 형변환해야 합니다.

다음 예제는 프레임 경계와 시각적 경계를 가져와 비교합니다:

using var presentation = new Presentation("example.pptx");

var slide = presentation.Slides[0];
IShape shape = slide.Shapes[0];

var visualBounds = ((Shape)shape).GetVisualBounds();
var frameBounds = new RectangleF(shape.X, shape.Y, shape.Width, shape.Height);

Console.WriteLine($"Frame bounds: {frameBounds}");
Console.WriteLine($"Visual bounds: {visualBounds}");

같은 RectangleF를 사용하여 인접한 도형을 Left, Right, Top, Bottom 가장자리에 맞추거나, 생성된 레이아웃에서 충분한 공간을 확보하거나, 허용된 영역 밖의 콘텐츠를 감지할 수 있습니다. 시각적 경계는 저장된 프레임이 전체 렌더링 결과를 나타내지 않을 수 있는 SmartArt, 텍스트 상자, 화살표, 그림, 회전된 도형 및 그룹 도형에 특히 유용합니다.

레이아웃이나 검증을 위한 좌표가 필요하고 비트맵이 필요하지 않을 때는 GetVisualBounds를 사용하십시오. 도형을 실제로 렌더링해야 할 때는 IShape.GetImage를 사용하십시오. ShapeThumbnailBounds를 사용하면 ShapeThumbnailBounds.Shape는 외곽선 설정을 포함한 도형 경계에서 이미지를 크기 조정하고, ShapeThumbnailBounds.Appearance는 도형의 외관에서 크기 조정하며 결과를 슬라이드 경계에 제한합니다. 반면 GetVisualBounds는 계산된 사각형만 반환하고 슬라이드에 클리핑하지 않습니다.

FAQ

도형 썸네일을 저장할 때 사용할 수 있는 이미지 형식은 무엇입니까?
PNG, JPEG, BMP, GIF, TIFF 등이며, 도형은 내용을 SVG로 저장하여 vector SVG로 내보낼 수도 있습니다.

썸네일을 렌더링할 때 Shape 경계와 Appearance 경계의 차이점은 무엇입니까?
Shape는 도형의 기하학을 사용하고, Appearance는 시각 효과 (그림자, 발광 등)을 고려합니다.

도형이 숨김으로 표시되면 어떻게 됩니까? 썸네일에 계속 렌더링됩니까?
숨김 도형은 모델에 남아 있으며 렌더링이 가능하고, 숨김 플래그는 슬라이드쇼 표시에만 영향을 주며 도형 이미지를 생성하는 것을 방해하지 않습니다.

그룹 도형, 차트, SmartArt 및 기타 복합 객체가 지원됩니까?
예. Shape로 표시되는 모든 객체(예: GroupShape, Chart, SmartArt)는 썸네일이나 SVG로 저장할 수 있습니다.

시스템에 설치된 폰트가 텍스트 도형 썸네일 품질에 영향을 줍니까?
예. 원하지 않는 폰트 대체와 텍스트 재배치를 방지하려면 필요한 폰트를 제공하거나 폰트 대체를 구성해야 합니다.

.NET에서 프레젠테이션에 모양 애니메이션 적용하기 .NET에서 프레젠테이션의 ActiveX 컨트롤 관리