如何使用 PyCUPS 为自定义页面尺寸设置打印边距_网络技术

如何使用 PyCUPS 为自定义页面尺寸设置打印边距

发布时间 - 2026-01-06 00:00:00 点击率：次

本文介绍在 pycups 中通过 ppd 属性（如 `pageregion`、imageablearea 和 margins）精确控制自定义纸张尺寸的打印区域与边距，弥补 pagesize 单一设置的局限性。

在 PyCUPS 中，仅通过 PageSize 选项（如 "720x432"）可定义物理纸张尺寸，但无法直接设置内容打印区域的边距——因为 PageSize 仅影响纸张大小，实际可打印区域（即 ImageableArea）和页边距（Margins）由打印机驱动（PPD 文件）中的底层属性控制。PyCUPS 并未暴露高级边距 API，因此需借助 PPD 属性覆盖机制，通过 printFile() 的 options 参数传入标准 CUPS PPD 关键字。

✅ 正确做法：使用 PageRegion + ImageableArea 控制有效打印区域

PageRegion 定义物理纸张尺寸（单位：points），ImageableArea 定义左下角坐标 (llx, lly) 与右上角坐标 (urx, ury)，二者共同决定内容可绘制区域，等效于设置上下左右边距。

例如：设定 10×6 英寸纸张（720×432 points），并预留 0.25 英寸（18 points）边距：

import cups

def print_with_margins(printer_name, file_path, width_inch=10, height_inch=6, margin_inch=0.25):
    conn = cups.Connection()

    # 转换为 points (1 inch = 72 points)
    w_pt = int(width_inch * 72)
    h_pt = int(height_inch * 72)
    m_pt = int(margin_inch * 72)

    # PageRegion: 物理纸张尺寸
    page_region = f"{w_pt}x{h_pt}"
    # ImageableArea: [llx lly urx ury] — 左下和右上坐标
    imageable = f"[{m_pt} {m_pt} {w_pt - m_pt} {h_pt - m_pt}]"

    options = {
        'PageSize': page_region,
        'PageRegion': page_region,
        'ImageableArea': imageable,
        'cupsPrintQuality': '3'  # 可选：3=高精度
    }

    job_id = conn.printFile(printer_name, file_path, "Print with Margins", options)
    print(f"Job {job_id} printed on '{printer_name}' with {margin_inch}\" margins.")

# 使用示例
print_with_margins(
    printer_name="TVS_MSP-250CH-TVS-original",
    file_path="/home/tk/Documents/bill.txt",
    width_inch=10,
    height_inch=6,
    margin_inch=0.25  # 左/右/上/下均为 0.25 英寸
)

⚠️ 注意事项

Margins 属性不被所有打印机支持：CUPS 文档中 Margins（如 Margins: "18 18 18 18"）虽存在，但多数热敏/票据打印机驱动忽略它；推荐优先使用 ImageableArea，兼容性更佳。
单位必须是 points：CUPS PPD 属性严格使用 postscript points（1/72 英寸），切勿混用像素或毫米。
验证 PPD 支持项：运行 lpoptions -p -l 查看打印机支持的 PageRegion、ImageableArea 等选项。
避免 raw() 方式：答案中提到的 printer.raw(...) 是非标准用法，PyCUPS 无 raw() 方法；该代码实际无效，属常见误解。

? 补充：获取打印机原生支持的边距能力

# 查询当前打印机的可用 PPD 属性
attrs = conn.getPrinterAttributes(printer_name)
if 'page-region-supported' in attrs:
    print("PageRegion supported")
if 'imageable-area-supported' in attrs:
    print("ImageableArea supported")

通过合理组合 PageRegion 与 ImageableArea，你即可在任意 PyCUPS 打印任务中实现精准、跨设备一致的边距控制，无需依赖特定驱动扩展或外部工具。

# 打印机 # 工具 # 热敏 # 打印机驱动 # 均为 # 自定义 # 可选 # 不被 # 转换为 # 更佳 # 文档 # brush

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：关于Linux CentOS MySQL数据库安装配置的图文

下一篇：详细介绍VMWare linux mysql 5.7.13安

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：关于Linux CentOS MySQL数据库安装配置的图文

下一篇：详细介绍VMWare linux mysql 5.7.13安