.NET에서 프레젠테이션 모양 맞춤화

이 페이지의 내용

Aspose.Slides for .NET을 사용하여 PowerPoint 프레젠테이션에서 모양을 만들고 맞춤화합니다: 기하학 경로, 곡선 모서리, 복합 모양.

개요

이 문서는 편집 포인트와 기하학 경로를 통해 모양 기하학을 편집하여 Aspose.Slides에서 프레젠테이션 모양을 사용자 지정하는 방법을 설명합니다. 기존 모양을 수정하고, 기본 경로 편집 작업을 수행하며, 포인트를 추가하거나 제거하고, 업데이트된 기하학을 모양에 적용하기 위해 GeometryPath 및 IGeometryPath를 사용하는 방법을 보여줍니다.

또한 사용자 정의 및 복합 모양을 만들고, 곡선 모서리가 있는 모양을 구성하며, 모양 기하학이 닫혀 있는지 확인하고, 추가적인 기하학 사용자 지정 시나리오를 위해 GeometryPath와 GraphicsPath 간의 레거시 변환을 사용하는 방법을 시연합니다.

편집 포인트를 사용하여 모양 변경

PowerPoint에서 Edit Points를 사용하여 정사각형을 수정할 수 있습니다:

모서리를 안쪽이나 바깥쪽으로 이동합니다.
포인트에서 곡률을 조정합니다.
새로운 포인트를 추가합니다.

편집 포인트를 사용하면 모양의 외곽선을 수정하거나 기존 모양을 새 모양의 기반으로 사용할 수 있습니다.

모양 편집 팁

overview_image

PowerPoint 모양을 편집할 때 다음 개념을 기억하십시오:

모양(또는 그 경로)은 닫힌 형태이거나 열린 형태일 수 있습니다.
모양의 경로는 세그먼트로 연결된 앵커 포인트로 구성됩니다.
세그먼트는 직선이거나 곡선일 수 있습니다. 앵커 포인트와 제어 핸들이 형태를 결정합니다.
앵커 포인트는 코너 포인트, 직선 포인트, 부드러운 포인트로 존재합니다:
- 코너 포인트에서는 인접 세그먼트가 각도로 만날 수 있습니다.
- 부드러운 포인트에서는 두 제어 핸들이 정렬되고 앵커 포인트에서 같은 거리에 있습니다.
- 직선 포인트에서는 두 제어 핸들이 정렬되지만 앵커 포인트에서 거리가 다를 수 있습니다.
앵커 포인트를 이동하거나 핸들을 조정하면 모양의 외곽선이 변화합니다.

편집 포인트를 통해 PowerPoint 모양을 편집하려면 Aspose.Slides가 GeometryPath 클래스와 IGeometryPath 인터페이스를 제공합니다.

GeometryPath 인스턴스는 IGeometryShape 객체의 기하학 경로를 나타냅니다.
IGeometryShape 인스턴스에서 GeometryPath를 가져오려면 IGeometryShape.GetGeometryPaths 메서드를 사용할 수 있습니다.
모양에 GeometryPath를 설정하려면 단일 경로 모양에는 IGeometryShape.SetGeometryPath, 다중 경로 모양에는 IGeometryShape.SetGeometryPaths 메서드를 사용할 수 있습니다.
세그먼트를 추가하려면 IGeometryPath 아래에 있는 메서드를 사용할 수 있습니다.
IGeometryPath.Stroke 및 IGeometryPath.FillMode 속성을 사용하여 기하학 경로의 외관을 설정할 수 있습니다.
IGeometryPath.PathData 속성을 사용하면 GeometryShape의 기하학 경로를 세그먼트 배열로 가져올 수 있습니다.
아래 변환 메서드를 지원하는 레거시 버전에서는 GeometryPath를 GraphicsPath로 변환할 수 있습니다.
ShapeUtil 클래스의 GeometryPathToGraphicsPath 및 GraphicsPathToGeometryPath 메서드를 사용하여 GeometryPath와 GraphicsPath 간에 변환합니다.

간단한 편집 작업

다음 메서드를 사용하여 기하학 경로를 편집합니다. 인덱스를 허용하는 오버로드는 경로 세그먼트 배열의 해당 0 기반 위치에 세그먼트를 삽입합니다.

작업	메서드
직선을 추가하거나 삽입합니다.	GeometryPath.LineTo
두 개의 제어점과 끝점이 있는 큐빅 베지어 곡선을 추가하거나 삽입합니다.	GeometryPath.CubicBezierTo
하나의 제어점과 끝점이 있는 2차 베지어 곡선을 추가하거나 삽입합니다.	GeometryPath.QuadraticBezierTo
지정된 치수와 각도(도)로 타원 호를 추가합니다.	GeometryPath.ArcTo
현재 도형을 닫아 끝점을 시작점에 연결합니다.	GeometryPath.CloseFigure
도형의 시작점을 설정합니다.	GeometryPath.MoveTo
0 기반 인덱스의 세그먼트를 제거합니다.	GeometryPath.RemoveAt

모양에 사용자 정의 포인트 추가

이 예제는 GeometryPath.LineTo을 사용하여 직사각형 모양에 두 개의 포인트를 삽입하고, 편집된 경로를 IGeometryShape.SetGeometryPath으로 적용합니다. 좌표는 모양에 대해 로컬이며, 두 새 포인트는 모양의 중앙에 위치하고 왼쪽에서 100포인트, 위쪽에서 50포인트 떨어져 있습니다. 세그먼트 인덱스 1과 4는 각각 상단과 하단 가장자리에 배치되어 해당 가장자리를 안쪽으로 끌어당깁니다.

using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);

var geometryPath = shape.GetGeometryPaths()[0];
geometryPath.LineTo(100, 50, 1);
geometryPath.LineTo(100, 50, 4);

shape.SetGeometryPath(geometryPath);

example1_image

모양에서 포인트 제거

이 예제는 GeometryPath.RemoveAt을 사용하여 0 기반 인덱스 2에서 세그먼트를 제거함으로써 하트 모양의 외곽선을 변경합니다. 수정된 경로를 IGeometryShape.SetGeometryPath으로 적용하면 모양의 윤곽이 업데이트됩니다.

using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Heart, 100, 100, 300, 300);

var path = shape.GetGeometryPaths()[0];
path.RemoveAt(2);

shape.SetGeometryPath(path);

example2_image

사용자 정의 모양 만들기

이 예제는 GeometryPath를 사용하여 5각 별을 구축합니다. 외부 반경 100포인트와 내부 반경 50포인트를 교대로 사용하여 팁과 들쭉날쭉한 부분을 정의하고, 72도 간격으로 다섯 팁을 균등하게 배치합니다. 경로는 GeometryPath.CloseFigure로 닫히며, IGeometryShape.SetGeometryPath을 사용하여 직사각형 모양에 적용되어 기존 외곽선을 대체합니다.

using System;
using System.Collections.Generic;
using System.Drawing;
using Aspose.Slides;

var points = new List<PointF>();

var outerRadius = 100f;
var innerRadius = 50f;
var angleStep = 72;

for (var angle = -90; angle < 270; angle += angleStep)
{
    var radians = angle * (Math.PI / 180f);
    var x = outerRadius * Math.Cos(radians);
    var y = outerRadius * Math.Sin(radians);
    points.Add(new PointF((float)x + outerRadius, (float)y + outerRadius));

    radians = Math.PI * (angle + angleStep / 2) / 180.0;
    x = innerRadius * Math.Cos(radians);
    y = innerRadius * Math.Sin(radians);
    points.Add(new PointF((float)x + outerRadius, (float)y + outerRadius));
}

var starPath = new GeometryPath();
starPath.MoveTo(points[0]);

for (var i = 1; i < points.Count; i++)
{
    starPath.LineTo(points[i]);
}

starPath.CloseFigure();

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, outerRadius * 2, outerRadius * 2);
shape.SetGeometryPath(starPath);

example3_image

복합 사용자 정의 모양 만들기

이 예제는 모양의 상·하 3분의 1을 위해 두 개의 닫힌 GeometryPath 객체를 정의합니다. 두 경로를 IGeometryShape.SetGeometryPaths로 적용하면 가운데 3분의 1에 틈이 있는 단일 복합 모양이 생성됩니다.

using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);

var topPath = new GeometryPath();
topPath.MoveTo(0, 0);
topPath.LineTo(shape.Width, 0);
topPath.LineTo(shape.Width, shape.Height / 3);
topPath.LineTo(0, shape.Height / 3);
topPath.CloseFigure();

var bottomPath = new GeometryPath();
bottomPath.MoveTo(0, shape.Height / 3 * 2);
bottomPath.LineTo(shape.Width, shape.Height / 3 * 2);
bottomPath.LineTo(shape.Width, shape.Height);
bottomPath.LineTo(0, shape.Height);
bottomPath.CloseFigure();

shape.SetGeometryPaths(new GeometryPath[] { topPath, bottomPath });

example4_image

곡선 모서리가 있는 사용자 정의 모양 만들기

이 예제는 직선 세그먼트와 GeometryPath.ArcTo를 결합하여 안쪽으로 굽은 모서리를 가진 모양을 생성합니다. 각 모서리 크기는 호의 너비와 높이를 포인트 단위로 설정하고, -90도 스윕은 반시계 방향 사분원 타원을 그립니다. 완성된 경로는 IGeometryShape.SetGeometryPath으로 적용되며, 프레젠테이션은 PPTX 형식으로 저장됩니다.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

var shapeX = 20f;
var shapeY = 20f;
var shapeWidth = 300f;
var shapeHeight = 200f;

var leftTopSize = 50f;
var rightTopSize = 20f;
var rightBottomSize = 40f;
var leftBottomSize = 10f;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var topLeft = new PointF(leftTopSize, 0);
var topRight = new PointF(shapeWidth - rightTopSize, 0);
var rightBottom = new PointF(shapeWidth, shapeHeight - rightBottomSize);
var bottomLeft = new PointF(leftBottomSize, shapeHeight);
var leftTop = new PointF(0, leftTopSize);

var geometryPath = new GeometryPath();
geometryPath.MoveTo(topLeft);
geometryPath.LineTo(topRight);
geometryPath.ArcTo(rightTopSize, rightTopSize, 180, -90);
geometryPath.LineTo(rightBottom);
geometryPath.ArcTo(rightBottomSize, rightBottomSize, -90, -90);
geometryPath.LineTo(bottomLeft);
geometryPath.ArcTo(leftBottomSize, leftBottomSize, 0, -90);
geometryPath.LineTo(leftTop);
geometryPath.ArcTo(leftTopSize, leftTopSize, 90, -90);
geometryPath.CloseFigure();

var shape = slide.Shapes.AddAutoShape(ShapeType.Custom, shapeX, shapeY, shapeWidth, shapeHeight);
shape.SetGeometryPath(geometryPath);

presentation.Save("output.pptx", SaveFormat.Pptx);

모양 기하학이 닫혀 있는지 확인하기

다음 헬퍼는 모든 비어 있지 않은 기하학 경로가 닫는 세그먼트로 끝나는지 확인합니다. IGeometryPath.PathData를 읽고 최종 세그먼트의 IPathSegment.PathCommand를 PathCommandType.Close와 비교합니다. 비어 있지 않은 경로가 없을 경우 false를 반환합니다. 이 검사는 각 경로의 최종 명령만을 확인하며, 경로 내의 모든 하위 도형을 검사하지는 않습니다. 예제는 직사각형에 대해 True를 출력합니다.

using System;
using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);
Console.WriteLine(IsGeometryClosed(shape));

bool IsGeometryClosed(IGeometryShape geometryShape)
{
    var hasNonemptyPath = false;

    foreach (var geometryPath in geometryShape.GetGeometryPaths())
    {
        var segments = geometryPath.PathData;
        if (segments.Length == 0)
        {
            continue;
        }

        hasNonemptyPath = true;
        var lastSegment = segments[segments.Length - 1];
        if (lastSegment.PathCommand != PathCommandType.Close)
        {
            return false;
        }
    }

    return hasNonemptyPath;
}

모양 요소 추출 및 검사

IGeometryShape.CreateShapeElements을 사용하여 기존 모양을 경로 포인트와 포인트 유형을 포함하는 요소로 검사합니다. 반환된 각 IShapeElement을 ShapeElement으로 캐스팅하여 PathPoints와 PathTypes 배열을 읽을 수 있습니다. 이 표현은 등고선 분석이나 기하학을 사용자 정의 그리기 도구에 전달할 때 유용합니다.

예제는 프레젠테이션을 열고 첫 번째 슬라이드의 첫 번째 기하학 모양을 찾아 그 경로 세그먼트를 출력합니다. 직선 및 곡선 세그먼트를 모두 포함하는 모양이 있는 프레젠테이션을 사용하면 두 종류의 출력이 모두 표시됩니다. 그룹 내부는 검색하지 않습니다.

using System;
using System.Linq;
using Aspose.Slides;

using var presentation = new Presentation("input.pptx");
var slide = presentation.Slides[0];

var shape = slide.Shapes.OfType<IGeometryShape>().FirstOrDefault();
if (shape == null)
{
    Console.WriteLine("No geometry shape found on the first slide.");
    return;
}

foreach (IShapeElement element in shape.CreateShapeElements())
{
    var shapeElement = (ShapeElement)element;
    var points = shapeElement.PathPoints;
    var types = shapeElement.PathTypes;
    Console.WriteLine("Shape element:");

    for (var i = 0; i < points.Length; i++)
    {
        var pointType = types[i] & 0x07; // Keep the segment type, excluding flags.
        switch (pointType)
        {
            case 0:
                Console.WriteLine($"Start figure at {points[i]}");
                break;
            case 1:
                Console.WriteLine($"Line to {points[i]}");
                break;
            case 3:
                Console.WriteLine($"Cubic Bezier: controls {points[i]}, {points[i + 1]}; end {points[i + 2]}");
                i += 2; // Consume both control points and the endpoint.
                break;
        }

        if ((types[i] & 0x80) != 0)
        {
            Console.WriteLine("Close subpath back to its starting point.");
        }
    }
}

배열은 인덱스로 대응됩니다: points[i]는 포인트이며 types[i]는 해당 역할을 설명합니다. 유형 0은 도형 시작을, 유형 1은 이전 포인트에서 현재 포인트까지 선을 그립니다. 큐빅 베지어 세그먼트는 이전 끝점에서 시작하여 연속된 타입 3 세 개(두 제어점과 새로운 끝점)를 사용합니다. 루프는 이 세 항목을 함께 소비하고 끝점이 닫혔는지 확인합니다.

포인트 유형에는 플래그도 포함됩니다. 0x07 마스크를 사용해 세그먼트 유형을 확인하고, 0x80을 별도로 테스트해 닫힌 하위 경로를 감지합니다. 예를 들어 129(0x81)은 하위 경로를 닫는 선 끝점이며, 131(0x83)은 닫힌 베지어 끝점입니다. 기본 세그먼트 유형만 1이나 3과 비교하면 이러한 경우를 놓칠 수 있습니다. 대시(0x10)와 마커(0x20)와 같은 다른 플래그는 기본 세그먼트 유형을 변경하지 않습니다.

좌표 및 변환. 포인트는 포인트 단위(인치당 72포인트)로 측정되며, X는 오른쪽으로, Y는 아래쪽으로 증가합니다. 그룹화되지 않은 모양의 경우 추출된 좌표에는 이미 X 및 Y 위치가 포함되어 있으며 현재 너비와 높이를 반영합니다. 예를 들어 (100, 200) 위치에 크기 120 × 80인 회전되지 않은 직사각형은 외곽선 경계가 (100, 200)–(220, 280)이 됩니다. 모양의 위치를 다시 더하지 마십시오. X와 Y를 빼서 회전되지 않은 프레임에 대한 좌표를 얻으십시오.

추출된 포인트는 모양의 Rotation이나 가水平·수직 뒤집기를 적용하지 않습니다. 표시된 외곽선을 재현하려면 해당 변환을 모양의 중심을 기준으로 적용하십시오. 그룹화된 모양의 경우 그룹 좌표 매핑 및 변환도 고려해야 하며, 추출된 포인트가 최종 렌더링된 슬라이드 좌표가 아니거나 이미 자식 프레임에 반영된 경우 중복 번역이나 스케일을 적용하지 마십시오.

검사 vs. 편집. 추출된 배열은 외곽선을 설명하며, 이를 변경해도 원본 모양이 업데이트되지 않습니다. 포인트/유형 배열이 분석이나 그리기 코드에 필요할 때 이 접근 방식을 선택하십시오. 모양의 로컬 좌표계에서 기하학 명령이 필요하거나 기하학을 편집하려면 GetGeometryPaths를 사용하고, 편집된 경로는 SetGeometryPath 또는 SetGeometryPaths를 통해 적용하십시오.

GeometryPath를 GraphicsPath로 변환 (System.Drawing.Drawing2D)

다음 예제는 ShapeUtil.GraphicsPathToGeometryPath를 지원하는 레거시 Aspose.Slides for .NET 어셈블리(예: 버전 25.10)와 System.Drawing.Common이 설치된 Windows 환경이 필요합니다. 변환 메서드는 버전 25.11에서 제거되었습니다.

이 예제는 텍스트를 기하학으로 변환한 후 직사각형 외곽선과 결합합니다. 외곽선의 IGeometryPath.FillMode을 비활성화하여 채우기를 끕니다. GraphicsPath 객체가 텍스트 외곽선을 저장하고, ShapeUtil.GraphicsPathToGeometryPath가 이를 채워진 기하학 경로로 변환합니다. 두 경로를 IGeometryShape.SetGeometryPaths로 적용하면 직사각형과 텍스트를 포함하는 단일 모양이 생성됩니다. 반대 방향 변환은 ShapeUtil.GeometryPathToGraphicsPath를 사용하십시오.

using System.Drawing;
using System.Drawing.Drawing2D;
using Aspose.Slides;
using Aspose.Slides.Util;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 100);

var originalPath = shape.GetGeometryPaths()[0];
originalPath.FillMode = PathFillModeType.None;

using var graphicsPath = new GraphicsPath();
using var fontFamily = new FontFamily("Arial");
using var stringFormat = StringFormat.GenericDefault;

graphicsPath.AddString("Text in shape", fontFamily, (int)FontStyle.Bold, 40, new PointF(10, 10), stringFormat);

var textPath = ShapeUtil.GraphicsPathToGeometryPath(graphicsPath);
textPath.FillMode = PathFillModeType.Normal;

shape.SetGeometryPaths(new[] { originalPath, textPath });

example5_image

FAQ

기하학을 교체한 후 채우기와 외곽선은 어떻게 되나요?

스타일은 모양에 그대로 남으며, 윤곽선만 변경됩니다. 채우기와 외곽선은 새로운 기하학에 자동으로 적용됩니다.

기하학과 함께 사용자 정의 모양을 올바르게 회전하려면 어떻게 해야 하나요?

모양의 Rotation 속성을 사용하십시오. 기하학은 모양에 바인딩되어 있기 때문에 모양과 함께 회전됩니다.

사용자 정의 모양을 이미지로 변환하여 결과를 “잠그”고 싶나요?

예. 필요한 slide 영역이나 shape 자체를 래스터 형식으로 내보내면 복잡한 기하학 작업을 더 쉽게 진행할 수 있습니다.

.NET에서 프레젠테이션의 연결선 관리 .NET에서 프레젠테이션에 타원 추가