C#打印PDF至Star TSP100热敏打印机输出模糊问题求助

核心原因 #

Star TSP100这类热敏打印机出现打印模糊的问题，核心是PDF渲染参数与热敏打印机的硬件特性不匹配，具体包括：

1. 单位转换错误：Pdfium返回的页面尺寸是点（Point，1英寸=72点），但.NET PaperSize的宽度/高度单位是百分之一英寸，直接赋值会导致纸张尺寸计算错误，引发拉伸模糊。
2. 分辨率不匹配：热敏打印机原生DPI多为203或300，PDF默认渲染分辨率（通常96DPI）与打印机DPI不一致，插值缩放后导致模糊。
3. 渲染模式不适配：PDF打印库默认的彩色/灰度渲染模式，不适合热敏打印机的单色输出特性，额外的颜色转换会损失清晰度。

可行解决办法 #

1. 修正纸张尺寸单位转换 #

将Pdfium返回的点单位转换为.NET要求的百分之一英寸，避免尺寸错误导致的拉伸：

// PdfiumViewer初始化
var pdfViewer = new PdfViewer
{
    Document = PdfDocument.Load(filename)
};

var printerSettings = new PrinterSettings
{
    PrinterName = printer,
    Copies = (short)1,
};

// 转换PDF页面尺寸（点）为百分之一英寸
var pdfPageSize = pdfViewer.Document.PageSizes[0];
const float pointsPerInch = 72;
float widthInHundredths = pdfPageSize.Width * 100 / pointsPerInch;
float heightInHundredths = pdfPageSize.Height * 100 / pointsPerInch;

var pageSettings = new PageSettings(printerSettings)
{
    Margins = new Margins(0, 0, 0, 0),
    Color = false,
    PaperSize = new PaperSize("Custom PDF Size", widthInHundredths, heightInHundredths)
};

// 执行打印
using (var document = PdfDocument.Load(filename))
{
    using (var printDocument = document.CreatePrintDocument())
    {
        printDocument.PrinterSettings = printerSettings;
        printDocument.DefaultPageSettings = pageSettings;
        printDocument.PrintController = new StandardPrintController();
        printDocument.Print();
    }
}

2. 匹配打印机原生DPI渲染 #

获取打印机的原生DPI，强制Pdfium以该分辨率渲染PDF，避免缩放插值：

var printerSettings = new PrinterSettings
{
    PrinterName = printer,
    Copies = (short)1,
};

// 获取打印机原生DPI
var printerDpiX = printerSettings.DefaultPageSettings.PrinterResolution.X;
var printerDpiY = printerSettings.DefaultPageSettings.PrinterResolution.Y;

// 转换PDF为对应DPI的单色位图（适配热敏打印机）
using (var document = PdfDocument.Load(filename))
{
    var page = document.Pages[0];
    using (var bitmap = page.Render(printerDpiX, printerDpiY, PdfRenderFlags.CorrectFromDpi | PdfRenderFlags.Grayscale))
    {
        using (var monochromeBitmap = new Bitmap(bitmap.Width, bitmap.Height, PixelFormat.Format1bppIndexed))
        {
            using (var g = Graphics.FromImage(monochromeBitmap))
            {
                g.Clear(Color.White);
                g.DrawImage(bitmap, new Rectangle(0, 0, bitmap.Width, bitmap.Height));
            }

            // 打印单色位图
            using (var printDoc = new PrintDocument())
            {
                printDoc.PrinterSettings = printerSettings;
                printDoc.DefaultPageSettings.Margins = new Margins(0,0,0,0);
                printDoc.PrintPage += (s, e) =>
                {
                    e.Graphics.DrawImage(monochromeBitmap, e.PageBounds);
                };
                printDoc.Print();
            }
        }
    }
}

3. 使用Star官方SDK替代PDF打印 #

Star TSP100有官方.NET SDK，直接通过SDK打印收据内容（文本、条码等），完全规避PDF渲染的兼容性问题，这是最可靠的方案。

4. 调整打印机驱动设置 #

• 打开打印机属性，将纸张类型设置为热敏纸；
• 启用“收据模式”或“文本优化”选项；
• 关闭“图像平滑”“自动缩放”等功能，确保驱动按原始尺寸输出。

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