.Net下的PDF打印

简单研究了一下.Net下的PDF打印,一路发现了很多小坑。

第三方组件

这里使用的解析PDF的组件是mupdf,特点和C#调用在 这里 有介绍。

实现的功能

支持页面大小、边距、打印机选择、打印机dpi、打印范围、单双面、奇偶页、缩放、对齐、填充、打印份数、自动旋转等。

关于pt、px、dpi、inch的解释

pt 点(Point)。pt是一种固定长度的度量单位,是能够使用测量设备测得的长度。绝对单位作用有限,因为它们不能够缩放。

1点 = 0.376毫米 = 1.07英美点 = 0.0148英尺 = 0.1776英寸。

1英寸 = 72点。

px 像素(Pixel),屏幕最小的显示单元。常见分辨率,如高清的1920*1080,即表示横纵分别有1920和1080个像素点。

dpi 每英寸(Inch)长度内的像素点数。dpi越高,即每英寸内的像素点越多,描述细节的能力也就越高,即清晰度越高。

Inch 即英寸。

1英寸 = 2.54厘米。

通过以上可以得到下面的公式。注意这个计算在后续频繁用到。

dx/dpi = inch = pt /72

即,dx = pt * dpi / 72

打印配置类

.Net的System.Drawing.Printing下面支持的打印功能类基本满足了开发需要。其中,

PageSettings类初始化后即为当前的默认打印机的页面属性配置。值得注意的是,PageSettings.Bounds的单位是百分之一英尺,这一点十分重要!

PrinterSettings类初始化后即为当前默认打印机的属性配置。同样,PrinterSettings.PaperSizes是PaperSize的集合,即打印机支持的纸张类型。PaperSize的单位,同样是百分之一英尺

PDF的页面的尺寸

在mupdf中,pdf的页面尺寸是由函数pdf_bound_page计算得到的,其单位是pt,注意了,这个单位和上面打印配置的纸张尺寸单位是不一致的。

打印实现方式

mupdf本身没有支持打印,这里使用mupdf将pdf页面转换成图片(System.Drawing.Bitmap),使用.Net的打印组件将图片渲染到打印机。因此,打印过程需要自己控制各项打印配置。其中,纸张大小、打印颜色、单双面打印等可以在打印配置类中配置,而自动旋转、缩放、打印范围、奇偶页打印等需要自行控制。如果没有考虑上述单位不一致的问题,会导致使用PrintDocument.DrawImage时,渲染的图片实际偏小。考虑到:

设打印机配置的纸张尺寸数值为SzP0,以英尺为单位的纸张尺寸为SzP1。以pt为单位的纸张尺寸为SzP2,则

SzP0 / 100 = SzP1 = SzP2 / 72,即

SzP2 = SzP0 / 100 * 72

因此,当pdf使用单位为pt时,纸张使用百分之一英尺的数值会让纸张尺寸实际偏大。

关于打印dpi

不同打印机支持不同的打印dpi,有的打印机甚至可以配置打印dpi。打印dpi影响什么呢?例如,一个a0 Inch(pt单位的数值为a1)的纸张(仅用一个维度说明),其dpi为dpi0,图片的尺寸为a2 px,那么可以做如下计算:

a2 / dpi0 = a0 = a1 / 72

其中,a0和a1大小对应且固定不变,则dpi0越大,a2也将会越大。结论是:

打印出结果的物理尺寸不变的情况下,dpi越高,待打印图片的像素要求也将越高。因此,为了保证打印结果足够的清晰度,需要调高打印机的dpi(如果支持)。而为了保证得到预期的结果尺寸,则同时需要提供更高分辨率的图片。

关于预览

demo的界面使用wpf实现,打印预览是通过Control.OnRender中的DrawingContext绘制图片来实现的。为了提高性能,预览的图片可以适当减小渲染精度(尺寸),因为本身预览图是缩放了的。

另外,为了保持不同纸张的预览图尺寸相对固定,使用固定尺寸的ViewBox来控制预览控件的大小。

遇到的异常 值“0”不是枚举“PaperSourceKind”的有效值

英文报错为:The value \'0\' is not a valid value for the enum \'PaperSourceKind。

这个问题是因为,某些打印驱动,对枚举PaperSourceKind给的值是0,属于非法的枚举值,当调用ToString方法时,就会抛出异常。根据了解到会发生这个问题的打印驱动包括:Solid Pdf Creator和PCL6 Driver for Universal Print(问题参考这里)。下面给出正常和异常的值示例:

// Microsoft Pdf Printer {[PaperSource unknown Kind=FormSource]} Kind: FormSource RawKind: 15 SourceName: "unknown" // Solid Pdf Creator {System.Drawing.Printing.PaperSource} Kind: 0 RawKind: 0 SourceName: "unknown" 感谢

感谢wmjordan提供的mupdf的.Net调用和图片转换教程。

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zzyggy.html