Python에서 프레젠테이션 만들기

Aspose.Slides FOSS for Python은 Microsoft Office에 대한 의존 없이 완전히 Python만으로 PowerPoint 프레젠테이션을 만들 수 있게 해줍니다. 이 가이드는 새 프레젠테이션을 만들고, 슬라이드와 도형을 추가하고, 텍스트를 서식 지정하고, 결과를 저장하는 방법을 보여줍니다.

단계별 가이드

단계 1: 패키지 설치

PyPI에서 Aspose.Slides FOSS를 설치하십시오. Python 3.10 이상이 필요합니다.

pip install aspose-slides-foss

설치 확인:

import aspose.slides_foss as slides
print("Aspose.Slides FOSS ready")

lxml 종속성은 자동으로 설치됩니다. 다른 시스템 패키지는 필요하지 않습니다.

2단계: 필요한 모듈 가져오기

저장에 필요한 패키지와 SaveFormat 열거형을 가져오세요.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
from aspose.slides_foss import ShapeType

모든 도형 유형 상수는 aspose.slides_foss.ShapeType에 있습니다. 모든 서식 유형(FillType, NullableBool)도 aspose.slides_foss에 있습니다.

3단계: 프레젠테이션 만들기

slides.Presentation()를 컨텍스트 매니저로 사용하십시오. 새 프레젠테이션은 빈 슬라이드 하나로 시작합니다.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    print(f"Slides in new presentation: {len(prs.slides)}")
    # work with prs inside this block
    prs.save("output.pptx", SaveFormat.PPTX)

중요: 항상 Presentation을 with 블록 안에서 열고 사용하십시오. with 문 밖에 참조를 저장하지 마세요; 리소스가 올바르게 해제되지 않을 수 있습니다.

단계 4: 슬라이드에 액세스

첫 번째 슬라이드는 인덱스 0에 있습니다. 빈 프레젠테이션에는 정확히 한 개의 슬라이드가 있습니다.

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]  # zero-based index
    print(f"Slide at index 0: {slide}")
    prs.save("output.pptx", SaveFormat.PPTX)

Step 5: 도형 추가

slide.shapes.add_auto_shape()을(를) 사용하여 AutoShape을 추가합니다. 매개변수는 (shape_type, x, y, width, height)이며 모두 포인트 단위입니다 (1 포인트 = 1/72 인치; 표준 슬라이드는 720 × 540 pt).

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Rectangle at (50, 50) with 400 wide and 120 tall
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 120)

    # Attach a text frame
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")

    prs.save("with-shape.pptx", SaveFormat.PPTX)

6단계: 프레젠테이션 저장

prs.save(path, SaveFormat.PPTX)를 with 블록이 종료되기 전에 호출하십시오. PPTX는 유일하게 지원되는 출력 형식입니다.

prs.save("result.pptx", SaveFormat.PPTX)

파일은 원자적으로 기록됩니다; 이 호출 전에 오류가 발생하면 출력 파일이 생성되지 않습니다.

완전한 작업 예제

다음 스크립트는 첫 번째 슬라이드에 제목 도형이 있고 두 번째 슬라이드에 표가 포함된 두 슬라이드 프레젠테이션을 생성합니다.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    # --- Slide 1: title shape ---
    slide1 = prs.slides[0]
    title = slide1.shapes.add_auto_shape(ShapeType.RECTANGLE, 40, 40, 640, 80)
    tf = title.add_text_frame("Q1 Results: Executive Summary")
    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 32
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)

    # --- Slide 2: table ---
    prs.slides.add_empty_slide(prs.layout_slides[0])
    slide2 = prs.slides[1]
    table = slide2.shapes.add_table(40, 40, [200.0, 120.0, 120.0], [40.0, 40.0, 40.0])
    headers = ["Region", "Revenue", "Growth"]
    data = [
        ["North", "$1.2M", "+8%"],
        ["South", "$0.9M", "+4%"],
    ]
    for col, header in enumerate(headers):
        table.rows[0][col].text_frame.text = header
    for row_idx, row_data in enumerate(data):
        for col, cell_text in enumerate(row_data):
            table.rows[row_idx + 1][col].text_frame.text = cell_text

    prs.save("q1-results.pptx", SaveFormat.PPTX)

print("Saved q1-results.pptx")

일반적인 문제 및 해결책

ResourceWarning: unclosed Presentation

Presentation을(를) with 블록 없이 인스턴스화하고 있습니다. 항상 사용하십시오:

with slides.Presentation() as prs:
    ...

AttributeError: __enter__

이 오류가 표시되면 aspose.slides_foss을(를) 가져왔는지 확인하십시오 (aspose.slides이 아니라). PyPI의 패키지 이름은 aspose-slides-foss이며 런타임 가져오기는 aspose.slides_foss입니다.

TypeError: SaveFormat.PPTX is not callable

SaveFormat.PPTX은 열거형 멤버이며 함수가 아닙니다. prs.save("file.pptx", SaveFormat.PPTX)처럼 사용하십시오.

자주 묻는 질문

기본 슬라이드 크기는 무엇인가요?

새로운 Presentation()은 표준 10 × 7.5인치(720 × 540 포인트) 크기의 슬라이드를 생성합니다. 이 버전에서는 슬라이드 크기 변경을 아직 지원하지 않습니다.

한 번에 여러 슬라이드를 추가할 수 있나요?

예. prs.slides.add_empty_slide(prs.layout_slides[0])를 호출하여 빈 슬라이드를 추가하고 인덱스로 접근하십시오:

prs.slides.add_empty_slide(prs.layout_slides[0])
slide2 = prs.slides[1]

기존 파일을 열고 슬라이드를 추가할 수 있나요?

예:

with slides.Presentation("existing.pptx") as prs:
    prs.slides.add_empty_slide(prs.layout_slides[0])
    prs.save("existing.pptx", SaveFormat.PPTX)

어떤 형식으로 저장할 수 있나요?

SaveFormat.PPTX만 지원됩니다. PDF, HTML, SVG 또는 이미지로 내보내기는 이 버전에서 사용할 수 없습니다.