CUPS API打印至HPLJ5m时A4纸张打印区域被裁剪的技术问询

通过CUPS API打印时，生成的PDF在Firefox中显示正常，但发送到实体打印机HPLJ5m时，打印区域出现裁剪。我使用的是A4纸张，创建打印任务时也配置了对应选项，但发现打印区域高度和US Letter尺寸一致，位置对齐没问题，打印数据是仅含图像的PDF。怀疑传递给cupsCreateDestJob()的选项没有覆盖打印机.ppd文件中的默认设置，想问能不能通过API实现强制覆盖？

相关CUPS API代码 #

options=NULL; num_options=0;         
num_options = D_cupsAddOption(CUPS_COPIES, "1", num_options, &options);
num_options = D_cupsAddOption(CUPS_MEDIA, CUPS_MEDIA_A4, num_options, &options);
num_options = D_cupsAddOption(CUPS_SIDES, CUPS_SIDES_ONE_SIDED, num_options, &options);

info = D_cupsCopyDestInfo(CUPS_HTTP_DEFAULT, printer);

if (D_cupsCreateDestJob(CUPS_HTTP_DEFAULT, printer, info,
                      &job_id, "tideq", num_options,
                      options) != IPP_STATUS_OK) goto failed;

发送至CUPS的PDF数据片段 #

%PDF-1.7
%åäö

1 0 obj
  << /Type /Catalog
     /Pages 2 0 R
  >>
endobj

2 0 obj
  << /Type /Pages
     /Kids [3 0 R
            7 0 R
            ]
     /Count 2
     /MediaBox [0 0 595 842]
  >>
endobj

3 0 obj
  << /Type /Page
     /Parent 1 0 R
     /CropBox [0 0 595 842]
     /Resources 4 0 R
     /Contents 6 0 R
  >>
endobj

4 0 obj
  << /ProcSet [ /PDF /ImageB ]
     /XObject << /Im1 5 0 R >>
  >>
endobj

5 0 obj
  << /Type /XObject
     /Subtype /Image
     /Width 1281
     /Height 1500
     /ColorSpace /DeviceGray
     /BitsPerComponent 8
     /Length 3843001
     /Filter /ASCIIHexDecode
  >>
stream
<page data goes here>
endstream
endobj

6 0 obj
  << /Length 40 >>
stream
  q
  555 0 0 802 20 20 cm
  /Im1 Do
  Q
endstream
endobj

解决思路与方案 #

1. 强制匹配PPD中的纸张参数
   CUPS API支持通过打印选项覆盖PPD默认值，但要确保选项值和打印机PPD中的定义完全一致。可以通过lpoptions -p HPLJ5m -l命令查看该打印机支持的纸张参数列表，比如部分惠普打印机的PPD里A4对应的参数是iso_a4，替换代码中的CUPS_MEDIA_A4为该值尝试。

2. 调整D_cupsCopyDestInfo的调用时机
   D_cupsCopyDestInfo会获取打印机的当前默认设置，可能覆盖你自定义的选项。建议要么在添加完所有自定义选项后再调用该函数，要么直接在cupsCreateDestJob中传入NULL代替info，让CUPS优先使用你指定的选项。修改示例：

   options=NULL; num_options=0;         
   num_options = D_cupsAddOption(CUPS_COPIES, "1", num_options, &options);
   num_options = D_cupsAddOption(CUPS_MEDIA, "iso_a4", num_options, &options);
   num_options = D_cupsAddOption(CUPS_SIDES, CUPS_SIDES_ONE_SIDED, num_options, &options);
   
   // 跳过获取默认信息，直接传入NULL
   if (D_cupsCreateDestJob(CUPS_HTTP_DEFAULT, printer, NULL,
                         &job_id, "tideq", num_options,
                         options) != IPP_STATUS_OK) goto failed;
   

3. 手动指定可打印区域
   可以额外添加printablearea选项，强制设置A4的完整打印区域：

   num_options = D_cupsAddOption("printablearea", "0 0 595 842", num_options, &options);
   

4. 验证PDF页面边界
   你的PDF已经正确设置了A4的MediaBox和CropBox，可以尝试添加/BleedBox或/TrimBox，确保打印机能识别正确的页面边界。同时检查图像变换矩阵，确认缩放后的图像尺寸在打印机支持的可打印范围内。

内容的提问来源于stack exchange，提问作者Marta