# 系统 PPD 文件目录
ls /usr/share/ppd/
# 按制造商组织子目录

# CUPS 安装的打印机 PPD
ls /etc/cups/ppd/

# 查看所有可用 PPD
find /usr/share/ppd -name "*.ppd" | wc -l
# 通常有数千个

# Gutenprint PPD
ls /usr/share/ppd/gutenprint/5.3/

# HP PPD
ls /usr/share/ppd/HP/

# 搜索特定打印机 PPD
find /usr/share/ppd -name "*.ppd" | grep -i "laserjet.*m404"

# 备份原始 PPD 文件
sudo cp /etc/cups/ppd/myprinter.ppd /etc/cups/ppd/myprinter.ppd.backup

# 编辑 PPD 文件
sudo vim /etc/cups/ppd/myprinter.ppd

# 在 PPD 文件中添加自定义水印选项
sudo vim /etc/cups/ppd/myprinter.ppd

# 使用选项打印
lp -d myprinter \
  -o media=A4 \
  -o media=Letter \
  -o media=A3 \
  document.pdf

# 自定义纸张尺寸（单位：点）
lp -d myprinter -o media=Custom.210x400mm document.pdf
lp -d myprinter -o media=Custom.5x7in document.pdf

# 双面打印
lp -d myprinter -o sides=one-sided document.pdf           # 单面
lp -d myprinter -o sides=two-sided-long-edge document.pdf  # 双面（长边翻转）
lp -d myprinter -o sides=two-sided-short-edge document.pdf # 双面（短边翻转）

# 使用 PPD 选项名
lp -d myprinter -o Duplex=DuplexNoTumble document.pdf
lp -d myprinter -o Duplex=DuplexTumble document.pdf
lp -d myprinter -o Duplex=None document.pdf

# 纵向打印（默认）
lp -d myprinter -o orientation-requested=3 document.pdf

# 横向打印
lp -d myprinter -o orientation-requested=4 document.pdf

# 反向纵向（旋转 180°）
lp -d myprinter -o orientation-requested=5 document.pdf

# 反向横向
lp -d myprinter -o orientation-requested=6 document.pdf

# 简写
lp -d myprinter -o portrait document.pdf   # 纵向
lp -d myprinter -o landscape document.pdf  # 横向

# 打印全部
lp -d myprinter -o page-ranges=all document.pdf

# 打印指定页
lp -d myprinter -o page-ranges=1-5 document.pdf
lp -d myprinter -o page-ranges=1,3,5,7 document.pdf
lp -d myprinter -o page-ranges=2- document.pdf   # 从第 2 页到最后
lp -d myprinter -o page-ranges=-10 document.pdf   # 到第 10 页

# 奇偶页
lp -d myprinter -o page-set=odd document.pdf   # 奇数页
lp -d myprinter -o page-set=even document.pdf  # 偶数页

# 自动选择纸盒
lp -d myprinter -o InputSlot=Auto document.pdf

# 使用纸盒 1
lp -d myprinter -o InputSlot=Tray1 document.pdf

# 使用纸盒 2
lp -d myprinter -o InputSlot=Tray2 document.pdf

# 手动送纸
lp -d myprinter -o InputSlot=Manual document.pdf

# 普通纸
lp -d myprinter -o MediaType=Plain document.pdf

# 厚纸
lp -d myprinter -o MediaType=CardStock document.pdf

# 信封
lp -d myprinter -o MediaType=Envelope envelope.pdf

# 透明胶片
lp -d myprinter -o MediaType=Transparency document.pdf

# 照片纸
lp -d myprinter -o MediaType=Photo photo.jpg

# 标签纸
lp -d myprinter -o MediaType=Labels labels.pdf

# ppdc 是 CUPS 的 PPD 编译器
# 可以从 .drv 文件生成 .ppd 文件

# 查看 ppdc 帮助
ppdc --help

# 编译 .drv 文件为 .ppd
ppdc -d /tmp/ppds myprinter.drv

# 反编译 PPD 文件（提取选项）
ppdhtml myprinter.ppd > myprinter.html
ppdi -I myprinter myprinter.ppd -o myprinter.drv

# 创建 .drv 文件
cat << 'EOF' > /tmp/myprinter.drv
# My Printer Driver

Manufacturer "MyBrand"

ModelName "My Printer 1000"
NickName "My Printer 1000, CUPS driver"
PCFileName "myprinter1000.ppd"

% Resolution options
HWMargins 9 36 9 9
*Resolution k 0 0 0 0 "300dpi/300 DPI - Draft": ""
*Resolution k 0 0 0 0 "600dpi/600 DPI - Normal": ""
*Resolution k 0 0 0 0 "1200dpi/1200 DPI - High": ""

% Paper sizes
*PageSize Letter/US Letter:    "<< /PageSize [612 792] >> setpagedevice"
*PageSize A4/A4:               "<< /PageSize [595 842] >> setpagedevice"
*PageSize Legal/US Legal:      "<< /PageSize [612 1008] >> setpagedevice"

*PageRegion Letter/US Letter:  "<< /PageSize [612 792] >> setpagedevice"
*PageRegion A4/A4:             "<< /PageSize [595 842] >> setpagedevice"
*PageRegion Legal/US Legal:    "<< /PageSize [612 1008] >> setpagedevice"

*ImageableArea Letter/US Letter:  "18 36 594 756"
*ImageableArea A4/A4:             "18 36 577 806"
*ImageableArea Legal/US Legal:    "18 36 594 972"

*PaperDimension Letter/US Letter: "612 792"
*PaperDimension A4/A4:           "595 842"
*PaperDimension Legal/US Legal:  "612 1008"

% Duplex
*OpenUI *Duplex/Duplex: PickOne
*DefaultDuplex: None
*Duplex None/Off:             "<< /Duplex false >> setpagedevice"
*Duplex DuplexNoTumble/Long Edge:  "<< /Duplex true /Tumble false >> setpagedevice"
*Duplex DuplexTumble/Short Edge:   "<< /Duplex true /Tumble true >> setpagedevice"
*CloseUI: *Duplex
EOF

# 编译生成 PPD 文件
ppdc -d /tmp/ppds /tmp/myprinter.drv

# 查看生成的 PPD 文件
ls /tmp/ppds/
cat /tmp/ppds/myprinter1000.ppd

# 合并两个 PPD 文件的选项
# 使用 ppdi 导入选项
ppdi -o combined.drv file1.ppd
ppdi -I model2 file2.ppd -o combined.drv

# 编译合并后的文件
ppdc -d /tmp/merged combined.drv

# 使用 cupsfilter 验证 PPD 文件
sudo cupsfilter -m application/vnd.cups-postscript \
  -p myprinter.ppd /dev/null 2>&1

# 使用 cupstestppd 验证（CUPS 2.x）
# 注意：某些版本可能没有此命令
cupstestppd /etc/cups/ppd/myprinter.ppd

# 使用 ppdpo 检查 PPD 选项
ppdpo -o /tmp/options.txt /etc/cups/ppd/myprinter.ppd

# 检查 PPD 文件语法
grep -c "^\*" /etc/cups/ppd/myprinter.ppd
# 统计 PPD 指令数量

# 错误 1: 缺少必需字段
# PPD 文件必须包含以下字段:
# *PPD-Adobe
# *FormatVersion
# *NickName
# *PageSize (至少一个)

# 错误 2: 无效的 PostScript 代码
# 确保所有 setpagedevice 命令正确闭合

# 错误 3: 编码问题
# PPD 文件应使用 ISO-8859-1 编码
file myprinter.ppd
# 应显示: ISO-8859-1 或 ASCII

# 错误 4: 选项冲突
# 检查 Default* 值是否与对应的选项定义一致
grep "Default" myprinter.ppd

# 将自定义 PPD 文件复制到 CUPS 目录
sudo cp myprinter.ppd /usr/share/ppd/custom/

# 或复制到打印机特定目录
sudo cp myprinter.ppd /etc/cups/ppd/

# 使用自定义 PPD 添加打印机
sudo lpadmin -p CustomPrinter -E \
  -v socket://192.168.1.100:9100 \
  -P /usr/share/ppd/custom/myprinter.ppd

# 替换现有打印机的 PPD
sudo lpadmin -p myprinter -P /path/to/new.ppd

# 使用指定 PPD 转换文档为 PostScript
cupsfilter -p myprinter.ppd -m application/postscript document.pdf > output.ps

# 使用指定打印机转换文档
cupsfilter -d myprinter -m application/postscript document.pdf > output.ps

# 转换为光栅数据
cupsfilter -d myprinter -m application/vnd.cups-raster document.pdf > output.raster

# 需求：配置专用信头纸纸盒
# 步骤 1: 在 PPD 中添加信头纸类型
sudo vim /etc/cups/ppd/myprinter.ppd

# 添加以下内容
# *OpenUI *MediaType/Media Type: PickOne
# *DefaultMediaType: Plain
# *MediaType Plain/普通纸: "<</MediaType(Plain)>>setpagedevice"
# *MediaType Letterhead/信头纸: "<</MediaType(Letterhead)>>setpagedevice"
# *MediaType Preprinted/预印纸: "<</MediaType(Preprinted)>>setpagedevice"
# *CloseUI: *MediaType

# 步骤 2: 使用信头纸打印
lp -d myprinter -o MediaType=Letterhead -o InputSlot=Tray2 report.pdf

# 步骤 3: 创建打印脚本
cat << 'SCRIPT' > ~/print-letterhead.sh
#!/bin/bash
lp -d myprinter -o MediaType=Letterhead -o InputSlot=Tray2 \
  -o sides=one-sided "$@"
SCRIPT
chmod +x ~/print-letterhead.sh

# 需求：配置标签打印机
# 创建标签尺寸 PPD

# 编辑 PPD 文件
sudo vim /etc/cups/ppd/label-printer.ppd

# 添加自定义标签尺寸
# *% 标签尺寸定义
# *PageSize Label4x6/标签 4x6: "<</PageSize[288 432]>>setpagedevice"
# *PageRegion Label4x6/标签 4x6: "<</PageSize[288 432]>>setpagedevice"
# *ImageableArea Label4x6/标签 4x6: "0 0 288 432"
# *PaperDimension Label4x6/标签 4x6: "288 432"

# *PageSize Label2x4/标签 2x4: "<</PageSize[144 288]>>setpagedevice"
# *PageRegion Label2x4/标签 2x4: "<</PageSize[144 288]>>setpagedevice"
# *ImageableArea Label2x4/标签 2x4: "0 0 144 288"
# *PaperDimension Label2x4/标签 2x4: "144 288"

# 打印标签
lp -d label-printer -o media=Label4x6 shipping-label.pdf

# 需求：大批量打印优化配置
# 创建优化的 PPD 选项

# 使用草稿模式快速打印
lp -d myprinter -o Resolution=300dpi -o ColorModel=Gray large-document.pdf

# 使用每页多版节省纸张
lp -d myprinter -o number-up=4 -o sides=two-sided-long-edge document.pdf

# 创建优化脚本
cat << 'SCRIPT' > ~/print-eco.sh
#!/bin/bash
# 环保打印模式：草稿、双面、每页 2 版
lp -d myprinter \
  -o Resolution=300dpi \
  -o ColorModel=Gray \
  -o sides=two-sided-long-edge \
  -o number-up=2 \
  "$@"
SCRIPT
chmod +x ~/print-eco.sh