如何使用TCPDF设置页面边距并处理出血位问题？

核心思路 #

出血位是页面边缘预留的裁切区域，需将页面总尺寸设为「成品尺寸 + 出血位」，再通过边距定义出成品内容区域，图片可延伸至边距外的出血区域，既满足裁切需求，又能控制常规内容的显示范围。

具体步骤与修正代码 #

1. 明确尺寸参数：以A4（300dpi下对应2480×3508px）为例，常规出血位取3mm（约35px），计算带出血的总页面尺寸：

   • 总宽度 = 2480 + 35×2 = 2550px
   • 总高度 = 3508 + 35×2 = 3578px

2. 调整代码逻辑：TCPDF中AddPage会重置边距配置，因此SetMargins需放在AddPage之后；同时关闭自动分页，避免默认规则干扰自定义布局。

修正后的代码：

$unicode = true;
$format = "UTF-8";
$pdf = new TCPDF('P', 'px', 'A4', true, 'UTF-8', false);

$pdf->SetPrintHeader(false);
$pdf->SetPrintFooter(false);
$pdf->SetAutoPageBreak(false, 0);

// 添加带出血位的自定义页面
$bleed = 35; // 3mm出血位对应的像素值（300dpi）
$pageWidth = 2480 + $bleed * 2;
$pageHeight = 3508 + $bleed * 2;
$pdf->AddPage('P', array($pageWidth, $pageHeight));

// 设置边距为出血位大小，圈出成品内容区域
$pdf->SetMargins($bleed, $bleed, $bleed, true);

// 绘制带出血的图片：从页面原点(0,0)开始，铺满整个带出血的页面
$pdf->Image('your-image.jpg', 0, 0, $pageWidth, $pageHeight, 'JPG', '', '', false, 300, '', false, false, 0, false, false, false);

// 输出PDF
$pdf->Output('document-with-bleed.pdf', 'I');

关键说明 #

• 页面与边距的关联：总页面尺寸包含出血位，边距值等于出血宽度，这样GetX()/GetY()会指向成品内容区域的左上角，常规文字、内容可放在该区域内，图片则能覆盖整个页面（含出血）。
• 图片绘制规则：若要显示出血部分，必须将图片的x、y坐标设为0，宽高设为带出血的页面总尺寸，而非限制在边距范围内。
• 单位一致性：全程使用px单位，避免单位转换误差，确保出血位尺寸精准。

内容的提问来源于stack exchange，提问作者Nahuel Van Pée