FPDF 图片水平居中：精确控制与常见问题解决方案

image(name, x, y, w, h, type='', link='')

x = (pdf.w - desired_image_width) / 2

pdf.image(name=image_path, x=calculated_x, y=some_y_position, w=desired_image_width, h=0)

from fpdf import FPDF
import os

# 假设你的图片文件名为 'logo.png'，并与脚本在同一目录下
# 或者提供一个完整的图片路径
IMAGE_PATH = "logo.png" 

# 如果图片不存在，创建一个占位图用于演示
if not os.path.exists(IMAGE_PATH):
    print(f"Warning: Image '{IMAGE_PATH}' not found. Please ensure it exists for the example to work fully.")
    # 创建一个简单的占位图，用于演示
    from PIL import Image
    img = Image.new('RGB', (200, 50), color = 'red')
    img.save(IMAGE_PATH)
    print(f"Created a placeholder image '{IMAGE_PATH}'.")

class MyFPDF(FPDF):
    def header(self):
        """
        创建PDF文件的头部，并在其中居中插入图片。
        """
        # 设置页边距和填充颜色，与原问题保持一致
        self.set_left_margin(0)
        self.set_fill_color(242, 242, 242)

        # 字体设置 (如果需要自定义字体，确保字体文件路径正确)
        # self.add_font('DejaVuSerif', '', 'path/to/DejaVuSerif.ttf', uni=True)
        # self.set_font('DejaVuSerif', size=14)
        self.set_font('Arial', 'B', 14) # 使用默认字体以便演示

        # 绘制背景条
        self.cell(0, 18, '', 0, 0, 'C', True)
        self.ln(1) # 换行，为图片留出空间

        # --- 图片居中逻辑开始 ---
        # 1. 定义图片在PDF中显示的宽度
        # 假设我们希望图片宽度为页面宽度的1/3，或者一个固定值
        desired_image_width = 65 # 例如，设定图片宽度为65mm

        # 2. 计算图片左上角的X坐标
        # self.w 是当前PDF页面的总宽度
        x_centered = (self.w - desired_image_width) / 2

        # 3. 插入图片
        # name: 图片路径
        # x: 计算出的居中X坐标
        # y: 图片的Y坐标，这里可以根据需求调整
        # w: 期望的图片宽度
        # h: 设置为0，让FPDF自动根据宽度和原始比例计算高度，避免拉伸
        self.image(name=IMAGE_PATH, x=x_centered, y=5, w=desired_image_width, h=0)
        # --- 图片居中逻辑结束 ---

        self.ln(5) # 图片下方留出一些空间

    def footer(self):
        """
        创建PDF文件的底部。
        """
        self.set_y(-15) # 从底部15mm处开始
        self.set_font('Arial', 'I', 8)
        self.cell(0, 10, f'Page {self.page_no()}/{{nb}}', 0, 0, 'C')

# 创建PDF实例
pdf = MyFPDF()
pdf.alias_nb_pages() # 启用页码计数
pdf.add_page()

# 添加一些内容到PDF中
pdf.set_font('Arial', '', 12)
for i in range(1, 40):
    pdf.cell(0, 10, f'This is line {i}', 0, 1)

# 保存PDF文件
pdf_output_path = "centered_image_example.pdf"
pdf.output(pdf_output_path)
print(f"PDF generated successfully: {pdf_output_path}")

# 清理占位图（如果创建了）
if not os.path.exists("logo.png") and os.path.exists(IMAGE_PATH):
    os.remove(IMAGE_PATH)
    print(f"Removed placeholder image '{IMAGE_PATH}'.")