> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions.

# SVG ใน ReportLab: รักษาพาธโลโก้ให้คมชัดใน PDF ที่สร้างขึ้น

> วางโลโก้ SVG ใน PDF ของ ReportLab ด้วย svglib รักษาสัดส่วน และตรวจไฟล์สุดท้ายว่ามีพาธเวกเตอร์ ขนาดถูกต้อง และรายละเอียดไม่หาย

Source: https://perfectvector.com/th/blog/reportlab-svg

Language: th
Author: Irene Kim
Published: 2026-09-17T08:00:00+09:00

ใช้ `svglib.svg2rlg()` อ่าน SVG เป็น `Drawing` ของ ReportLab แล้ววางด้วย `renderPDF.draw()` กำหนดกรอบบนหน้าที่วัดขนาดชัดเจนและใช้ตัวคูณมาตราส่วนเดียวกับทั้งสองแกน วิธีนี้เก็บรูปทรงโลโก้ที่เหมาะสมเป็นคำสั่งวาด PDF แทนการแทรกภาพหน้าจอบิตแมป

สำหรับการส่งออกไฟล์เดี่ยวที่ไม่มีเลย์เอาต์เอกสาร [กระบวนการกำหนดขนาด CairoSVG](https://perfectvector.com/th/blog/cairosvg-output-size) เปรียบเทียบพิกเซล PNG ขนาดหน้า PDF และ DPI

การทดสอบที่มีประโยชน์คือ PDF สุดท้าย: ตรายังรักษาสัดส่วน สี และช่องเปิดเล็กตามขนาดที่เอกสารต้องการหรือไม่? การเรียก Python สำเร็จไม่ตอบคำถามเหล่านั้น ตัวอย่างด้านล่างวางตราต้นฉบับเดียวกันสองครั้งและตรวจไฟล์ที่สร้าง

หากมีโลโก้เป็นเวกเตอร์ที่แก้ไขได้อยู่แล้ว ให้เริ่มจากนั้น หากเหลือเพียง PNG หรือ JPG ให้กู้คืนไฟล์หลักเวกเตอร์ก่อนสร้างเอกสาร ภาพถ่ายและกราฟตัวเลขต้องเลือกต้นฉบับต่างกัน

## นำเข้างานภาพเป็น drawing

[กระบวนการในเอกสาร svglib](https://pypi.org/project/svglib/) แปลง SVG เป็นวัตถุ drawing ของ ReportLab [คู่มือกราฟิก ReportLab](https://docs.reportlab.com/reportlab/userguide/ch11_graphics/) อธิบายว่าสามารถเรนเดอร์ drawing บน canvas หรือใช้เป็น flowable ของ Platypus ได้ สำหรับตัวอย่างนี้ canvas ให้แต่ละตำแหน่งมีพิกัดและขนาดชัดเจน

เรารันตัวอย่างด้วย Python 3.12, svglib 2.2.0 และ ReportLab 4.4.9 ติดตั้งสองแพ็กเกจที่ล็อกเวอร์ชันในสภาพแวดล้อมโปรเจกต์:

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

บันทึกตราเล็กนี้เป็น `logo.svg` มีสามพาธสีเติมทึบ ไม่มีภาพลิงก์ ฟอนต์ หรือเอฟเฟกต์ นี่เป็นงานเขียนเองสำหรับการสาธิต ไม่ใช่ผลแปลง PerfectVector

```xml
<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>
```

`viewBox` ของ SVG อธิบายสี่เหลี่ยมพิกัดภายใน `width` และ `height` ของ drawing ที่นำเข้าบอกขนาดที่ควรใช้วางใน PDF อ่านค่าเหล่านั้นแทนการสมมติว่าพิกเซล SVG เท่ากับพอยต์ PDF

สำหรับไฟล์นี้ svglib 2.2.0 คืนขนาด **180 × 90 พอยต์** [เอกสารหน่วยปัจจุบัน](https://pypi.org/project/svglib/#units-and-output-sizes) แมปพิกเซล CSS เป็น 0.75 พอยต์ PDF ตัวอย่างเก่าอาจมีสมมติฐานต่างกัน จึงตรวจขนาดเมื่ออัปเกรดกระบวนการเดิม

## จัดโลโก้ให้พอดีโดยไม่ยืดผิดสัดส่วน

บันทึกต่อไปนี้เป็น `place_logo.py` ข้าง SVG แล้วรัน `python place_logo.py` ตำแหน่งหน้าและขนาดกรอบทั้งหมดในที่นี้เป็นพอยต์ PDF หนึ่งนิ้วมี 72 พอยต์ จุดกำเนิด canvas ปริยายอยู่ล่างซ้ายตาม [คู่มือ canvas ของ ReportLab](https://docs.reportlab.com/reportlab/userguide/ch2_graphics/)

```python
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 ที่มุมล่างซ้ายของกรอบ พื้นที่เหลืออยู่ด้านบนหรือขวา จัดกึ่งกลางแยกหากเลย์เอาต์ต้องการ

การแปลง canvas เป็นแบบชั่วคราว `restoreState()` ป้องกันมาตราส่วนโลโก้ไม่ให้เปลี่ยนข้อความหรือองค์ประกอบหน้าที่ตามมา และ drawing ต้นฉบับยังใช้วางครั้งที่สองได้

ในการทดสอบ ตัวคูณทั้งสองคือ **0.8** และ **1.6** ให้งานภาพขนาด **144 × 72 pt** และ **288 × 144 pt** พรีวิวเพิ่มป้ายและพื้นหลังให้ตำแหน่งเดียวกันทั้งสองเพื่อเปรียบเทียบขนาดง่าย

![ตราสีเขียวและทองเดียวกันวางที่ 144 คูณ 72 พอยต์และ 288 คูณ 144 พอยต์ใน PDF ที่เรนเดอร์](https://perfectvector.com/blog/reportlab-svg/pdf-placements.webp)

*ภาพจับจาก PDF ทดสอบที่เรนเดอร์ โลโก้ประกอบด้วยพาธต้นฉบับสามพาธวาดสองขนาด ภาพบนเว็บเป็นพรีวิวราสเตอร์ การตรวจ PDF ยืนยันพาธวาดและไม่มีภาพฝัง*

สำหรับเอกสาร Platypus นำ drawing เข้า story เป็น flowable ได้ หลังปรับเนื้อหาด้วย `drawing.scale(factor, factor)` ให้อัปเดต `drawing.width` และ `drawing.height` ด้วยตัวคูณเดียวเพื่อให้เลย์เอาต์ใช้พื้นที่ใหม่ ทำจาก drawing ใหม่เมื่อใช้ขนาดต่างกัน ตัวอย่าง canvas ด้านบนเลี่ยงการเปลี่ยน drawing เอง

## ตรวจรูปทรงและรูปลักษณ์แยกกัน

เราตรวจสตรีมเนื้อหา PDF ทดสอบด้วย pypdf 6.10.0 พบคำสั่งเริ่มพาธหกรายการตรงกับพาธตราสามพาธที่วาดสองครั้ง และไม่มีภาพบนหน้า เรายังเรนเดอร์ทั้งหน้าด้วย Poppler และตรวจตราทั้งสอง รูปทรง การซ้อน แท่งแนวตั้ง และสัดส่วนตรงกับตำแหน่งที่ตั้งใจ

ผลสังเกตเหล่านั้นใช้กับตัวอย่างเรียบง่ายนี้ การนับพาธเพียงอย่างเดียวไม่พิสูจน์ว่าฟีเจอร์ทั้งหมดของ SVG อื่นเรนเดอร์ถูกต้อง เช่นเดียวกันการซูม PDF บนหน้าจอไม่สามารถบอกอย่างเด็ดขาดว่ามีคำสั่งเวกเตอร์หรือบิตแมปใหญ่

สำหรับเอกสารของคุณ:

1. เปรียบเทียบ PDF สุดท้ายกับ SVG ในเบราว์เซอร์หรือโปรแกรมแก้ไข มองหารายละเอียดหาย สีเติมเปลี่ยน การตัดภาพ และพื้นที่ขาวผิดคาด
2. ตรวจตราตามขนาดเอกสารที่ตั้งใจ ซึ่งช่องแคบและเส้นละเอียดต้องยังอ่านได้
3. ตรวจวัตถุรูปภาพ PDF หากกระบวนการต้องการเวกเตอร์ คำนึงถึงภาพถ่ายที่ตั้งใจไว้ส่วนอื่นของหน้าด้วย
4. เก็บไฟล์หลัก SVG คู่กับโค้ดสร้างเอกสาร ตรวจ PDF ใหม่หลังเปลี่ยนงานภาพหรือ dependency เรนเดอร์

SVG เองอาจมีภาพราสเตอร์ การอ่านกรอบห่อนั้นไม่กู้พาธจากพิกเซล [วิธีวินิจฉัยภาพฝัง](https://perfectvector.com/th/blog/svg-contains-raster-image) ช่วยแยกไฟล์หลักเวกเตอร์จาก SVG ที่ยังมีบิตแมป

## จัดการฟีเจอร์ที่ตัวนำเข้าไม่สร้างตาม

[ข้อจำกัด svglib ปัจจุบัน](https://github.com/deeplook/svglib#known-limitations) รวมมาสก์และองค์ประกอบ `foreignObject` ที่ไม่รองรับ กฎ `@import` ของสไตล์ชีตที่ถูกละเลย และข้อจำกัด CSS กับการตัดภาพ พรีวิวเบราว์เซอร์จึงไม่ทดแทนการทดสอบตัวนำเข้า PDF

เก็บสำเนาไฟล์หลักก่อนลดความซับซ้อน เมื่อโลโก้พึ่งเอฟเฟกต์ที่ไม่รองรับ ให้พิจารณาสร้างส่วนนั้นใหม่เป็นรูปทรงทั่วไปหรือใช้วิธีส่งออกอื่นที่ตรวจได้ เก็บราสเตอร์ต้นฉบับเมื่อรูปลักษณ์ภาพถ่ายสำคัญกว่าการแก้พาธ ภาพที่รวมทุกชั้นเป็นภาพเดียวรักษารูปลักษณ์ได้ แต่เปลี่ยนข้อกำหนดเวกเตอร์

สำหรับตัวอักษร เลือกอย่างตั้งใจระหว่างข้อความเอกสารกับงานเส้นรอบรูป การเก็บคำเป็นข้อความให้แก้และค้นหาได้ แต่ต้องมีฟอนต์ที่ตั้งใจในกระบวนการเอกสาร การทำตัวอักษรโลโก้ที่อนุมัติเป็นเส้นรอบรูปเก็บรูปทรงแต่เสียการแก้ข้อความปกติ ตราที่เป็นพาธล้วนของเราไม่ทดสอบฟอนต์ ใช้ตัวอย่างตัวอักษรจริงก่อนพึ่งกระบวนการเดียวกัน

หากประกอบเอกสารในระบบจัดเรียงพิมพ์แทน Python [กระบวนการ SVG ใน LaTeX](https://perfectvector.com/th/blog/svg-in-latex) อธิบายอีกวิธีสำหรับกราฟิกและป้ายข้อความ

## กู้คืนโลโก้ที่มีเพียงราสเตอร์ก่อนวาง PDF

PNG เก่าบนเทมเพลตใบแจ้งหนี้เหมาะจะกู้เวกเตอร์เมื่อต้นฉบับโลโก้หาย ด้วย [ตัวแปลงโลโก้เป็นเวกเตอร์ของ PerfectVector](https://perfectvector.com/th/vectorize-logo) คุณพรีวิวงานราสเตอร์เป็น SVG ตรวจเส้นรอบรูปและช่องเปิด แล้วดาวน์โหลดไฟล์สำหรับประเมินในกระบวนการเอกสารได้

ตรวจตัวอักษรเล็กและกรอบก่อนนำเข้า วาดใหม่หรือเรียงข้อความใหม่สำหรับส่วนที่ต้องใช้ตัวอักษรตรงเป๊ะ และลบรูปทรงพื้นหลังที่ไม่ต้องการในโปรแกรมแก้ไข [คู่มือแปลงโลโก้เป็นเวกเตอร์](https://perfectvector.com/th/blog/how-to-vectorize-a-logo) ครอบคลุมการเลือกจากต้นฉบับสู่ไฟล์หลักละเอียดขึ้น

จากนั้นรันการนำเข้า ReportLab จริงและตรวจ PDF ตามด้านบน ผลลากพาธดีต้องผ่านตัวนำเข้าและพอดีเอกสารด้วย PerfectVector ให้พาธงานภาพ ไม่ได้เลือกพิกัด ReportLab ลงทะเบียนฟอนต์เอกสาร หรือตรวจ PDF ผลลัพธ์ สำหรับกราฟ ให้สร้างใหม่จากข้อมูลและต้นฉบับโปรแกรมพล็อตแทนลากพาธป้ายหรือค่าที่พล็อต

## คำถามที่พบบ่อย

**ส่ง SVG ให้ ReportLab เป็นภาพบิตแมปทั่วไปได้หรือไม่?**
ใช้ svglib สร้าง Drawing และเรนเดอร์ด้วย renderPDF สำหรับกระบวนการเวกเตอร์นี้ การแปลง SVG เป็น PNG ก่อนให้การแทรกราสเตอร์แทน

**ทำไม SVG ที่นำเข้าเล็กกว่าตัวอย่างเก่า?**
svglib 2.2.0 ที่ทดสอบแมปพิกเซล CSS เป็นพอยต์ PDF ด้วยตัวคูณ 0.75 อ่านขนาด drawing ที่คืนมาและจัดให้พอดีกรอบชัดเจนแทนพึ่งสมมติฐานพิกเซลต่อพอยต์เก่า

**วิธีนี้รักษาเอฟเฟกต์ SVG ทุกอย่างหรือไม่?**
ไม่ ตัวนำเข้ามีข้อจำกัดฟีเจอร์ในเอกสาร รวมมาสก์และ foreignObject เปรียบเทียบ PDF ที่ส่งออกกับงานที่ตั้งใจ แม้สคริปต์จบโดยไม่มีข้อผิดพลาด

**ควรแปลงภาพหน้าจอกราฟเป็นเวกเตอร์ไหม?**
สร้างกราฟใหม่จากข้อมูลและต้นฉบับโปรแกรมพล็อตเมื่อทำได้ เก็บการลากพาธโลโก้ไว้สำหรับงานตกแต่งที่เหมาะสมซึ่งต้นฉบับแก้ไขได้หายไป

## แหล่งอ้างอิง

1. [svglib — เอกสารแพ็กเกจและหน่วย](https://pypi.org/project/svglib/) — การแปลง SVG เป็น Drawing การติดตั้ง และขนาดพอยต์ PDF
2. [ReportLab — กราฟิก](https://docs.reportlab.com/reportlab/userguide/ch11_graphics/) — วัตถุ Drawing การเรนเดอร์ PDF และการใช้เป็น flowable ของ Platypus
3. [ReportLab — กราฟิกและข้อความด้วย pdfgen](https://docs.reportlab.com/reportlab/userguide/ch2_graphics/) — พิกัด canvas พอยต์ และการแปลง
4. [svglib — ข้อจำกัดที่ทราบ](https://github.com/deeplook/svglib#known-limitations) — ข้อจำกัดนำเข้าที่ต้องตรวจ PDF สุดท้าย

***

เก็บต้นฉบับที่แก้ไขได้เมื่อมี หากเหลือเพียงโลโก้ราสเตอร์ ให้ [เตรียมโลโก้ SVG สำหรับประเมิน](https://perfectvector.com/th/vectorize-logo) ตรวจพาธ แล้ววางตามขนาดที่ต้องการและตรวจ PDF สุดท้าย

## Explore

- [Read the HTML article](https://perfectvector.com/th/blog/reportlab-svg)
- [ภาพ SVG ใน fpdf2: เก็บพาธใน PDF จาก Python](https://perfectvector.com/th/blog/fpdf2-svg-image.md)
- [SVG ใน PDFKit: วางโลโก้เวกเตอร์โดยไม่แบนเป็นภาพ](https://perfectvector.com/th/blog/pdfkit-svg.md)
- [Product facts](https://perfectvector.com/product-facts.md)
- [FAQ](https://perfectvector.com/faq.md)
- [Pricing and credits](https://perfectvector.com/pricing.md)
