[python] ReportLab 그룹화

30 Nov 2023

python

ReportLab은 파이썬으로 PDF 문서를 생성하는 강력한 라이브러리입니다. 이 라이브러리는 텍스트, 이미지, 표, 차트 등 다양한 요소를 포함한 PDF 문서를 만들 수 있습니다. 이번에는 ReportLab을 사용하여 그룹화된 요소를 PDF에 추가하는 방법에 대해 알아보겠습니다.

그룹 생성하기

먼저, ReportLab에서 그룹을 생성하는 방법을 살펴보겠습니다. 다음 코드를 사용하여 그룹을 생성할 수 있습니다.

from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas

def create_pdf():
    c = canvas.Canvas("grouping_example.pdf", pagesize=letter)
    c.showPage()

    c.save()

create_pdf()

위의 코드에서는 ReportLab의 canvas 클래스를 사용하여 PDF 캔버스를 생성합니다. showPage() 메서드를 호출하여 페이지를 추가하고, save() 메서드를 호출하여 PDF 파일로 저장합니다.

요소를 그룹에 추가하기

한 번 그룹을 생성했으면, 이제 그룹에 요소를 추가해보겠습니다. 다음 코드를 사용하여 이미지와 텍스트를 그룹에 추가할 수 있습니다.

from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
from reportlab.lib import colors
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.units import inch
from reportlab.platypus import Paragraph, Image

def create_pdf():
    c = canvas.Canvas("grouping_example.pdf", pagesize=letter)
    c.saveState()

    # 그룹 시작
    c.beginForm(0, 0, inch * 6, inch * 3)

    # 이미지 추가
    img = Image("example.jpg", width=inch * 2, height=inch * 2)
    img.drawOn(c, inch, inch)

    # 텍스트 추가
    styles = getSampleStyleSheet()
    title_style = styles["Title"]
    title = Paragraph("그룹화된 요소", style=title_style)
    title.wrapOn(c, inch * 4, inch)
    title.drawOn(c, inch * 2, inch)

    # 그룹 종료
    c.endForm()

    c.save()

create_pdf()

위의 코드에서는 canvas 객체의 saveState() 및 restoreState() 메서드를 사용하여 현재 그림 상태를 저장 및 복원합니다. beginForm() 메서드로 그룹을 시작하고, endForm() 메서드로 그룹을 종료합니다.

그룹 위치 조정하기

그룹을 원하는 위치로 이동하려면 translate() 메서드를 사용하면 됩니다. 다음과 같이 코드를 수정하여 그룹 위치를 조정할 수 있습니다.

from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
from reportlab.lib.units import inch
from reportlab.platypus import Image

def create_pdf():
    c = canvas.Canvas("grouping_example.pdf", pagesize=letter)
    c.saveState()

    # 그룹 시작
    c.beginForm(inch, inch, inch * 6, inch * 3)

    # 그룹 이동
    c.translate(inch, inch)

    # 이미지 추가
    img = Image("example.jpg", width=inch * 2, height=inch * 2)
    img.drawOn(c, 0, 0)

    # 그룹 종료
    c.endForm()

    c.save()

create_pdf()

위의 코드에서 c.beginForm() 메서드의 인수를 조정하여 그룹의 위치를 설정합니다. 그리고 c.translate() 메서드를 사용하여 그룹 내부의 모든 요소를 이동시킵니다.

이제 위의 예제 코드를 실행시키면, 그룹화된 이미지와 텍스트가 포함된 PDF 문서가 생성됩니다. ReportLab을 사용하여 그룹화된 요소를 추가하고 위치를 조정하는 방법에 대해 알아보았습니다. 추가로 다른 요소도 그룹에 추가할 수 있으며, 요소들의 스타일 및 위치를 유연하게 조정할 수 있습니다. ReportLab의 다양한 기능을 적절히 활용하여 원하는 형식의 PDF 문서를 만들 수 있습니다.

그룹 생성하기

요소를 그룹에 추가하기

그룹 위치 조정하기

참고 자료