ReportLab SVG: 생성한 PDF에서 로고 경로를 선명하게 유지하기

svglib.svg2rlg()로 SVG를 ReportLab Drawing으로 읽은 뒤 renderPDF.draw()로 그 drawing을 배치하세요. 페이지에 측정한 상자를 지정하고 두 축에 하나의 배율을 사용하세요. 그러면 비트맵 스크린샷을 삽입하는 대신 적합한 로고 기하학적 형태를 PDF 그리기 명령으로 유지할 수 있습니다.

문서 레이아웃 없이 독립적으로 내보내려면 CairoSVG 크기 설정 작업 흐름이 PNG 픽셀, PDF 페이지 치수, DPI를 비교합니다.

유용한 테스트 대상은 완성된 PDF입니다. 문서에 필요한 크기에서 엠블럼의 비율, 색상, 작은 구멍이 유지되었나요? 성공한 Python 호출은 그 질문에 답하지 않습니다. 아래 예제는 동일한 원본 엠블럼을 두 번 배치하고 생성한 파일을 확인합니다.

이미 편집 가능한 벡터 아트워크로 로고를 가지고 있다면 그것으로 시작하세요. PNG나 JPG만 남아 있다면 문서를 만들기 전에 벡터 마스터를 복원하세요. 사진과 수치 차트에는 다른 원본 선택이 필요합니다.

아트워크를 drawing으로 가져오기

svglib 문서의 작업 흐름은 SVG를 ReportLab drawing 객체로 변환합니다. ReportLab의 그래픽 가이드는 이 drawing을 캔버스에 렌더링하거나 Platypus flowable로 사용할 수 있다고 설명합니다. 이 예제에서는 캔버스로 각 배치에 명시적인 위치와 크기를 지정합니다.

예제는 Python 3.12, svglib 2.2.0, ReportLab 4.4.9로 실행했습니다. 프로젝트 환경에 버전을 고정한 두 패키지를 설치하세요.

python -m pip install "svglib==2.2.0" "reportlab==4.4.9"

이 작은 엠블럼을 logo.svg로 저장하세요. 단색 채우기가 있는 경로 세 개를 포함하며 연결 이미지, 글꼴, 효과는 없습니다. 시연을 위해 직접 작성한 아트워크이며 PerfectVector 변환 결과가 아닙니다.

<svg xmlns="http://www.w3.org/2000/svg"
     width="240" height="120" viewBox="0 0 240 120">
  <path fill="#1c625e" d="M0 120 L60 0 L120 120 Z"/>
  <path fill="#e5a340" d="M96 120 L156 24 L216 120 Z"/>
  <path fill="#163451" d="M228 12 L240 12 L240 108 L228 108 Z"/>
</svg>

SVG의 viewBox는 내부 좌표 사각형을 나타냅니다. 가져온 drawing의 width와 height는 PDF 배치에 사용할 치수를 알려줍니다. SVG 픽셀이 PDF 포인트와 같다고 가정하지 말고 값을 읽으세요.

이 파일에서 svglib 2.2.0은 180 × 90 포인트를 반환했습니다. 현재 단위 문서는 CSS 픽셀 하나를 PDF 포인트 0.75로 매핑합니다. 이전 예제의 가정은 다를 수 있으므로 기존 파이프라인을 업그레이드할 때 치수를 확인하세요.

늘이지 않고 로고 맞추기

다음을 SVG 옆에 place_logo.py로 저장하고 python place_logo.py를 실행하세요. 여기의 모든 페이지 위치와 상자 치수는 PDF 포인트입니다. 인치당 72 포인트이며 기본 캔버스 원점은 왼쪽 아래입니다. ReportLab 캔버스 가이드에서 설명합니다.

from reportlab.graphics import renderPDF
from reportlab.pdfgen import canvas
from svglib.svglib import svg2rlg
 
 
def draw_svg_in_box(pdf, drawing, x, y, box_w, box_h):
    if drawing.width <= 0 or drawing.height <= 0:
        raise ValueError("The SVG needs positive dimensions")
    factor = min(box_w / drawing.width, box_h / drawing.height)
    pdf.saveState()
    pdf.translate(x, y)
    pdf.scale(factor, factor)
    renderPDF.draw(drawing, pdf, 0, 0)
    pdf.restoreState()
 
 
drawing = svg2rlg("logo.svg")
if drawing is None:
    raise ValueError("SVG could not be loaded")
 
pdf = canvas.Canvas("logo.pdf", pagesize=(640, 360))
draw_svg_in_box(pdf, drawing, 40, 154, 144, 72)
draw_svg_in_box(pdf, drawing, 302, 126, 288, 144)
pdf.save()

min()이 상자에 들어맞는 더 작은 배율을 선택하므로 drawing이 상자 안에 맞춰집니다. X와 Y에 같은 배율을 쓰면 비율이 유지됩니다. 함수는 drawing을 상자의 왼쪽 아래에 고정하고 사용하지 않은 공간은 위쪽이나 오른쪽에 남깁니다. 레이아웃에 필요하다면 별도로 중앙에 배치하세요.

캔버스 변환은 일시적입니다. restoreState()는 로고 확대·축소가 이후 텍스트나 페이지 요소에 영향을 주지 않게 하고 원본 drawing은 두 번째 배치에도 사용할 수 있게 남습니다.

테스트의 두 배율은 0.8과 1.6으로, 144 × 72 pt와 288 × 144 pt 아트워크가 생성되었습니다. 미리보기는 같은 두 배치에 레이블과 배경을 추가해 크기를 쉽게 비교할 수 있게 합니다.

Platypus 문서에서는 drawing을 flowable로 story에 넣을 수 있습니다. drawing.scale(factor, factor)로 콘텐츠를 확대·축소한 뒤 레이아웃이 새 차지 공간을 사용하도록 drawing.width와 drawing.height에도 같은 배율을 적용하세요. 다른 크기를 적용할 때는 새 drawing으로 작업하세요. 위 캔버스 예제는 drawing 자체를 바꾸지 않습니다.

기하학적 형태와 외관 따로 확인하기

pypdf 6.10.0으로 테스트 PDF의 콘텐츠 스트림을 검사했습니다. 엠블럼 경로 세 개를 두 번 그린 것에 해당하는 경로 시작 연산 6개와 페이지 이미지 0개가 있었습니다. Poppler로 전체 페이지도 렌더링하고 두 엠블럼을 검사했습니다. 도형, 겹침, 세로 막대, 비율이 의도한 배치와 일치했습니다.

이 관찰은 단순한 이 예제 파일에 적용됩니다. 경로 수만 세어서는 다른 SVG의 모든 기능이 올바르게 렌더링되었음을 입증할 수 없습니다. 마찬가지로 화면에서 PDF를 확대한다고 벡터 명령인지 큰 비트맵인지 확실히 알 수는 없습니다.

자신의 문서에서는 다음을 확인하세요.

1. 완성한 PDF를 브라우저나 편집기의 SVG와 비교하세요. 누락된 디테일, 바뀐 채우기, 클리핑, 예상 밖 흰색 영역을 살펴보세요.
2. 좁은 틈과 가는 스트로크가 알아보기 쉬워야 하는 실제 문서 크기로 엠블럼을 확인하세요.
3. 작업 흐름에 벡터 아트워크가 필요하면 PDF 이미지 객체를 검사하세요. 페이지 다른 곳에 의도적으로 넣은 사진은 구분하세요.
4. 문서 생성 코드와 함께 SVG 마스터를 보관하세요. 아트워크나 렌더링 의존성을 바꾸면 PDF를 다시 확인하세요.

SVG 자체에 래스터 이미지가 포함될 수 있습니다. 그 래퍼를 읽어도 픽셀에서 경로가 복원되지는 않습니다. 삽입 이미지 진단은 벡터 마스터와 비트맵을 여전히 담고 있는 SVG를 구분하는 데 도움이 됩니다.

가져오기 도구가 재현하지 못하는 기능 처리하기

현재 svglib 제한에는 지원되지 않는 마스크와 foreignObject 요소, 무시되는 스타일시트 @import 규칙, CSS 및 클리핑 제한이 있습니다. 따라서 브라우저 미리보기는 PDF 가져오기 도구 테스트를 대신할 수 없습니다.

단순화하기 전에 마스터 복사본을 보관하세요. 로고가 지원되지 않는 효과에 의존한다면 그 부분을 일반적인 기하학적 형태로 재구성하거나 검증 가능한 다른 내보내기 방식을 고려하세요. 경로 편집보다 사진 같은 외관이 중요하면 원래 래스터를 유지하세요. 합쳐진 이미지는 외관을 유지할 수 있지만 벡터 요구사항은 달라집니다.

글자는 문서 텍스트와 윤곽 아트워크 중 의도적으로 선택하세요. 단어를 텍스트로 유지하면 편집과 검색이 가능하지만 문서 작업 흐름에서 의도한 글꼴을 사용할 수 있어야 합니다. 확정한 로고 글자를 윤곽으로 만들면 모양을 유지하는 대신 일반적인 텍스트 편집을 포기합니다. 경로만 있는 이 엠블럼은 글꼴 처리를 테스트하지 않습니다. 같은 파이프라인에 의존하기 전에 실제 글자 샘플을 사용하세요.

Python 대신 조판 시스템에서 문서를 구성한다면 LaTeX에서 SVG 사용 작업 흐름이 별도의 그래픽 및 레이블 방식을 설명합니다.

PDF 배치 전에 래스터 로고 복원하기

원래 로고 파일이 없다면 송장 템플릿의 오래된 PNG는 벡터 복원을 고려할 만한 대상입니다. PerfectVector의 로고 벡터화 도구로 래스터 아트워크를 SVG로 미리 보고 윤곽과 구멍을 검사한 뒤 문서 파이프라인용 후보를 다운로드하세요.

가져오기 전에 작은 글자와 테두리를 확인하세요. 정확한 타이포그래피가 필요한 요소는 다시 그리거나 다시 조판하고 편집기에서 불필요한 배경 기하학적 형태를 제거하세요. 로고 벡터화 가이드는 원본에서 마스터로 가는 결정을 더 자세히 다룹니다.

그런 다음 위의 실제 ReportLab 가져오기와 PDF 확인을 실행하세요. 좋은 추적 결과도 가져오기 도구를 통과하고 문서에 맞아야 합니다. PerfectVector는 아트워크 경로를 제공합니다. ReportLab 좌표를 선택하거나 문서 글꼴을 등록하거나 결과 PDF를 검증하지는 않습니다. 차트는 레이블이나 그려진 값을 추적하는 대신 데이터와 플로팅 원본에서 다시 생성하세요.

FAQ

SVG를 일반 비트맵 이미지처럼 ReportLab에 전달할 수 있나요? 이 벡터 작업 흐름에서는 svglib로 Drawing을 생성하고 renderPDF로 렌더링하세요. 먼저 SVG를 PNG로 변환하면 대신 래스터가 삽입됩니다.

가져온 SVG가 예전 예제보다 작은 이유는 무엇인가요? 테스트한 svglib 2.2.0은 CSS 픽셀을 PDF 포인트로 0.75 배율로 매핑합니다. 예전 픽셀-포인트 가정에 의존하지 말고 반환된 drawing 치수를 읽어 명시적인 상자에 맞추세요.

모든 SVG 효과가 유지되나요? 아닙니다. 가져오기 도구에는 마스크와 foreignObject 등 문서화된 기능 제한이 있습니다. 스크립트가 오류 없이 끝나도 내보낸 PDF를 의도한 아트워크와 비교하세요.

차트 스크린샷을 벡터화해야 하나요? 가능하면 언제나 데이터와 플로팅 원본에서 차트를 다시 생성하세요. 로고 추적은 편집 가능한 원본이 없는 적합한 장식 아트워크에 사용하세요.

Sources

1. svglib — 패키지 및 단위 문서 — SVG-Drawing 변환, 설치, PDF 포인트 크기 설정을 설명합니다.
2. ReportLab — 그래픽 — Drawing 객체, PDF 렌더링, Platypus flowable 사용을 설명합니다.
3. ReportLab — pdfgen의 그래픽과 텍스트 — 캔버스 좌표, 포인트, 변환을 설명합니다.
4. svglib — 알려진 제한 — 완성한 PDF 확인이 필요한 가져오기 제한을 설명합니다.

편집 가능한 원본이 있다면 보관하세요. 래스터 로고 아트워크만 남아 있다면 SVG 로고 후보를 준비하고 경로를 검사한 뒤 필요한 크기로 배치하고 완성한 PDF를 확인하세요.