1. 項(xiàng)目緣起從需求到硬件的選擇最近在做一個(gè)需要離線打印小票和簡(jiǎn)單圖形的項(xiàng)目選型時(shí)看中了QR204這款熱敏打印機(jī)。它體積小巧、接口簡(jiǎn)單串口/TTL/USB價(jià)格也親民很適合嵌入式或桌面小型應(yīng)用。但上手后發(fā)現(xiàn)官方資料和常見(jiàn)庫(kù)比如Python的python-escpos主要聚焦在文本和基礎(chǔ)條碼打印上關(guān)于打印自定義位圖Bitmap的說(shuō)明要么語(yǔ)焉不詳要么就是給個(gè)十六進(jìn)制數(shù)組讓人摸不著頭腦。網(wǎng)上搜到的代碼片段也往往是“魔法數(shù)字”集合知其然不知其所以然。這促使我決定徹底搞懂在QR204這類(lèi)ESC/POS指令集的熱敏打印機(jī)上打印位圖的完整流程。目標(biāo)不是簡(jiǎn)單地復(fù)制一段能跑的代碼而是要弄清楚從一張圖片文件到打印機(jī)吐出點(diǎn)陣中間每一步發(fā)生了什么為什么要這么做以及如何應(yīng)對(duì)實(shí)際項(xiàng)目中常見(jiàn)的坑比如圖片尺寸、二值化處理、數(shù)據(jù)傳輸格式等。如果你也在為類(lèi)似的熱敏打印機(jī)位圖打印問(wèn)題頭疼希望這篇從原理到實(shí)操的完整梳理能幫到你。2. 理解核心熱敏打印與ESC/POS指令集在動(dòng)手寫(xiě)代碼之前我們必須先理解兩個(gè)基礎(chǔ)概念熱敏打印機(jī)是如何工作的以及我們?nèi)绾瓮ㄟ^(guò)指令控制它。2.1 熱敏打印機(jī)的工作原理熱敏打印機(jī)沒(méi)有墨盒其打印頭是一排微小的發(fā)熱元件熱敏點(diǎn)。打印紙是特殊的熱敏紙受熱后會(huì)變黑。打印時(shí)控制電路根據(jù)要打印的內(nèi)容按行或按一個(gè)數(shù)據(jù)塊控制哪些發(fā)熱元件瞬間通電發(fā)熱從而在紙上“灼刻”出相應(yīng)的黑點(diǎn)。多個(gè)點(diǎn)組成一行多行就構(gòu)成了完整的圖像或文字。因此打印圖像的本質(zhì)就是告訴打印機(jī)“在接下來(lái)的第N行第1、3、5、7...個(gè)點(diǎn)發(fā)熱第2、4、6...個(gè)點(diǎn)不發(fā)熱”。這些“發(fā)不發(fā)熱”的信息最終需要被編碼成二進(jìn)制數(shù)據(jù)0和1發(fā)送給打印機(jī)。一個(gè)“1”通常對(duì)應(yīng)“發(fā)熱”打印黑點(diǎn)一個(gè)“0”對(duì)應(yīng)“不發(fā)熱”留白。2.2 ESC/POS指令集簡(jiǎn)介ESC/POSEscape Code/Point of Sale是愛(ài)普生公司為POS打印機(jī)定義的一套通用指令集因其簡(jiǎn)單高效已成為行業(yè)事實(shí)標(biāo)準(zhǔn)QR204等眾多兼容打印機(jī)都支持它。指令通常以**轉(zhuǎn)義字符ESCASCII碼0x1B或圖形字符GSASCII碼0x1D**開(kāi)頭后面跟著特定的命令字節(jié)和參數(shù)。對(duì)于位圖打印最常用的是GS v 0或GS ( L等指令族。它們?cè)试S我們向打印機(jī)發(fā)送一行或一個(gè)矩形區(qū)域的點(diǎn)陣數(shù)據(jù)。指令格式大致如下[命令頭] [寬度參數(shù)L] [寬度參數(shù)H] [高度參數(shù)L] [高度參數(shù)H] [點(diǎn)陣數(shù)據(jù)...]其中寬度和高度參數(shù)用于告訴打印機(jī)接下來(lái)要接收的點(diǎn)陣數(shù)據(jù)有多大。這里的關(guān)鍵在于點(diǎn)陣數(shù)據(jù)的寬度是以“字節(jié)”為單位描述的而不是像素。因?yàn)橐粋€(gè)字節(jié)byte有8個(gè)比特bit可以表示8個(gè)像素點(diǎn)的狀態(tài)1黑0白。這就引出了圖像處理中第一個(gè)關(guān)鍵步驟位圖數(shù)據(jù)的寬度必須是8的倍數(shù)不足的需要填充。3. 圖像預(yù)處理全流程從PNG/JPG到打印機(jī)數(shù)據(jù)拿到一張彩色或灰度的圖片直接丟給打印機(jī)是行不通的。我們必須將它處理成打印機(jī)能夠理解的、單色的、尺寸合適的點(diǎn)陣數(shù)據(jù)塊。這個(gè)過(guò)程可以分為以下幾步。3.1 步驟一圖像讀取與模式轉(zhuǎn)換首先使用圖像處理庫(kù)如Python的PIL/Pillow讀取圖片。無(wú)論原圖是什么格式第一步都是將其轉(zhuǎn)換為灰度圖因?yàn)闊崦舸蛴≈挥泻诎赘鼫?zhǔn)確說(shuō)是“黑”和“紙白”。from PIL import Image # 打開(kāi)圖片 img Image.open(your_image.png) # 轉(zhuǎn)換為灰度圖 (L模式) img_gray img.convert(L)轉(zhuǎn)換為灰度后每個(gè)像素點(diǎn)由一個(gè)0-255的值表示其亮度。但打印機(jī)需要的是非黑即白的二值圖所以接下來(lái)需要二值化。3.2 步驟二二值化處理與閾值選擇二值化就是將灰度圖轉(zhuǎn)換為黑白圖設(shè)定一個(gè)閾值Threshold亮度高于閾值的變?yōu)榘咨?低于閾值的變?yōu)楹谏?。這是影響打印效果最關(guān)鍵的步驟之一。固定閾值法最簡(jiǎn)單但效果往往不佳。例如閾值設(shè)為128threshold 128 # 使用point方法進(jìn)行二值化lambda函數(shù)中如果x threshold則為0黑否則為255白 # 注意這里255是白但后續(xù)需要反轉(zhuǎn)因?yàn)橥ǔ?shù)據(jù)中1代表打印黑 img_binary img_gray.point(lambda x: 0 if x threshold else 255, mode1)對(duì)于有漸變或細(xì)節(jié)豐富的圖片抖動(dòng)算法如Floyd-Steinberg能產(chǎn)生更好的視覺(jué)效果它通過(guò)將量化誤差擴(kuò)散到周?chē)袼貋?lái)模擬灰度層次。# PIL中轉(zhuǎn)換為模式1時(shí)默認(rèn)使用Bayer抖動(dòng)可以指定方法 img_binary img_gray.convert(1, ditherImage.FLOYDSTEINBERG)實(shí)操心得對(duì)于Logo、圖標(biāo)等線條簡(jiǎn)單的圖形使用固定閾值通常需要手動(dòng)調(diào)整可能在100-180之間可以獲得更清晰銳利的邊緣。對(duì)于照片、復(fù)雜圖案使用抖動(dòng)算法能保留更多細(xì)節(jié)但可能會(huì)在文字邊緣產(chǎn)生“毛刺”。需要根據(jù)實(shí)際內(nèi)容進(jìn)行選擇和測(cè)試。3.3 步驟三尺寸調(diào)整與寬高對(duì)齊QR204的打印寬度是有限的通常是384個(gè)點(diǎn)或576個(gè)點(diǎn)取決于具體型號(hào)和DPI。你必須確保處理后的圖片像素寬度不超過(guò)打印機(jī)的物理點(diǎn)陣寬度。等比例縮放先根據(jù)打印機(jī)最大寬度進(jìn)行縮放保持寬高比。max_width 384 # QR204常見(jiàn)寬度 w_percent max_width / float(img_binary.size[0]) h_size int(float(img_binary.size[1]) * w_percent) img_resized img_binary.resize((max_width, h_size), Image.Resampling.LANCZOS)寬度字節(jié)對(duì)齊如前所述打印機(jī)按字節(jié)接收數(shù)據(jù)。圖片的像素寬度必須向上取整到8的倍數(shù)。例如一張380像素寬的圖需要補(bǔ)4個(gè)白點(diǎn)像素變成384像素寬384/848字節(jié)。width_pixels img_resized.width # 計(jì)算需要補(bǔ)足到8的倍數(shù) remainder width_pixels % 8 if remainder ! 0: new_width width_pixels (8 - remainder) # 創(chuàng)建一個(gè)新圖底色為白1把原圖貼上去 new_img Image.new(1, (new_width, img_resized.height), 1) new_img.paste(img_resized, (0, 0)) img_resized new_img現(xiàn)在img_resized.width一定是8的倍數(shù)。記下最終的像素寬度f(wàn)inal_width_pixels和像素高度f(wàn)inal_height_pixels。3.4 步驟四提取并格式化點(diǎn)陣數(shù)據(jù)這是整個(gè)流程的技術(shù)核心。我們需要從處理好的二值圖像中按行提取像素?cái)?shù)據(jù)并打包成打印機(jī)指令要求的格式。數(shù)據(jù)提取與位打包 我們需要遍歷圖像的每一行將每8個(gè)像素一個(gè)字節(jié)的寬度打包成一個(gè)字節(jié)。這里有一個(gè)重要細(xì)節(jié)在ESC/POS指令中通常一個(gè)字節(jié)的最高位MSB對(duì)應(yīng)最左邊的像素。同時(shí)數(shù)據(jù)中的1表示“加熱”打印黑點(diǎn)。而在我們之前的二值化圖像中模式‘1’下1表示白色2550表示黑色0。因此我們通常需要做一個(gè)“反轉(zhuǎn)”操作將圖像中的黑點(diǎn)0變?yōu)閿?shù)據(jù)中的1。def extract_bitmap_data(image): 從PIL二值圖像中提取ESC/POS格式的點(diǎn)陣數(shù)據(jù)。 假設(shè)image.mode 1 0為黑255為白。 返回一個(gè)字節(jié)數(shù)組其中每個(gè)bit的1代表打印黑點(diǎn)。 width, height image.size bytes_per_row width // 8 data bytearray() pixels list(image.getdata()) # 獲取所有像素值列表 for y in range(height): row_start y * width for byte_index in range(bytes_per_row): byte_value 0 # 處理一個(gè)字節(jié)8個(gè)像素 for bit in range(8): pixel_index row_start byte_index * 8 bit # 像素值為0黑 - 我們需要設(shè)置為1打印 # 像素值為255白- 我們需要設(shè)置為0不打印 # 在1模式下 pixel是0或255 if pixels[pixel_index] 0: # 將對(duì)應(yīng)bit置為1。注意位順序通常最高位(bit7)對(duì)應(yīng)最左像素 byte_value | 1 (7 - bit) data.append(byte_value) return data這個(gè)函數(shù)返回的data字節(jié)數(shù)組就是最終要嵌入到打印指令中的點(diǎn)陣數(shù)據(jù)。它的長(zhǎng)度等于字節(jié)每行 * 圖像高度。理解數(shù)據(jù)排列data數(shù)組是按行優(yōu)先順序排列的。前bytes_per_row個(gè)字節(jié)是第一行的數(shù)據(jù)接著是第二行以此類(lèi)推。4. 指令構(gòu)造與數(shù)據(jù)傳輸GS v 0 指令詳解有了格式正確的點(diǎn)陣數(shù)據(jù)下一步就是把它包裝成打印機(jī)認(rèn)識(shí)的指令。這里我們以最常用的GS v 0指令為例進(jìn)行拆解。4.1 指令格式解析GS v 0指令用于打印光柵位圖其完整格式如下GS v 0 m xL xH yL yH [d1...dk]GS: 指令起始符十六進(jìn)制0x1D。v 0: 固定命令字節(jié)v是ASCII字符對(duì)應(yīng)0x76后面跟0x30。m: 模式選擇。最常用的是m0正常密度約203 DPI和m1倍寬密度約101 DPI。m32和m33是雙密度模式約300 DPI但需要打印機(jī)支持。對(duì)于QR204通常用0或1。xL,xH: 定義點(diǎn)陣數(shù)據(jù)的寬度以字節(jié)為單位。這是一個(gè)雙字節(jié)參數(shù)低位在前高位在后。因?yàn)閷挾韧ǔ２粫?huì)超過(guò)255字節(jié)所以xH經(jīng)常是0。計(jì)算公式x bytes_per_row 然后xL x % 256,xH x // 256。yL,yH: 定義點(diǎn)陣數(shù)據(jù)的高度以像素行數(shù)為單位。同樣是雙字節(jié)低位在前。y image_height_in_pixels 然后yL y % 256,yH y // 256。[d1...dk]: 就是我們上一步提取的原始點(diǎn)陣數(shù)據(jù)字節(jié)數(shù)組長(zhǎng)度必須嚴(yán)格等于x * y。4.2 Python代碼實(shí)現(xiàn)指令組裝與發(fā)送假設(shè)我們已經(jīng)有了bitmap_data字節(jié)數(shù)組、bytes_per_row和height。import serial def send_bitmap_to_printer(bitmap_data, bytes_per_row, height, port/dev/ttyUSB0, baudrate19200): 通過(guò)串口發(fā)送位圖數(shù)據(jù)到打印機(jī)。 # 1. 構(gòu)造指令參數(shù) m 0 # 選擇正常密度模式 x bytes_per_row xL x % 256 xH x // 256 y height yL y % 256 yH y // 256 # 2. 組裝完整指令 command bytearray() command.append(0x1D) # GS command.append(0x76) # v command.append(0x30) # 0 command.append(m) # 模式 command.append(xL) command.append(xH) command.append(yL) command.append(yH) command.extend(bitmap_data) # 追加點(diǎn)陣數(shù)據(jù) # 3. 通過(guò)串口發(fā)送 try: with serial.Serial(port, baudrate, timeout2) as ser: ser.write(command) # 可選發(fā)送換行切紙指令等 # ser.write(b\n\n\n\x1B\x69) # 部分切紙指令 except Exception as e: print(f打印失敗: {e}) # 使用示例 # bitmap_data, bytes_per_row, height 來(lái)自之前的 extract_bitmap_data 函數(shù) # send_bitmap_to_printer(bitmap_data, bytes_per_row, height, portCOM3)重要提示串口參數(shù)波特率、數(shù)據(jù)位、停止位、校驗(yàn)位必須與打印機(jī)配置完全一致。QR204常見(jiàn)的波特率是19200或96008N18數(shù)據(jù)位無(wú)校驗(yàn)1停止位。首次連接時(shí)最好先用簡(jiǎn)單的文本打印指令如bHello World\n測(cè)試通信是否正常。5. 實(shí)戰(zhàn)中的疑難雜癥與深度優(yōu)化按照上述流程基本能實(shí)現(xiàn)位圖打印。但在實(shí)際項(xiàng)目中你會(huì)遇到各種“意外”。下面是我踩過(guò)的一些坑和對(duì)應(yīng)的解決方案。5.1 問(wèn)題一圖片打印不全或錯(cuò)位現(xiàn)象只打印了圖片的一部分或者圖片被橫向拉伸、壓縮甚至出現(xiàn)亂碼。根因排查寬度字節(jié)計(jì)算錯(cuò)誤這是最常見(jiàn)的原因。務(wù)必確認(rèn)bytes_per_row (image_width_pixels 7) // 8計(jì)算正確并且在構(gòu)造指令時(shí)xL, xH參數(shù)用的是這個(gè)bytes_per_row而不是像素寬度。高度參數(shù)錯(cuò)誤yL, yH必須是圖像的像素高度而不是字節(jié)數(shù)。數(shù)據(jù)長(zhǎng)度不匹配指令中(xL xH*256) * (yL yH*256)的計(jì)算結(jié)果必須嚴(yán)格等于你發(fā)送的bitmap_data的字節(jié)長(zhǎng)度。如果不相等打印機(jī)會(huì)因?yàn)榈却鄶?shù)據(jù)而超時(shí)或者直接丟棄多余數(shù)據(jù)導(dǎo)致打印錯(cuò)亂。打印機(jī)緩存與速度如果圖片很大高度很高一次性發(fā)送的數(shù)據(jù)量可能超過(guò)打印機(jī)的行緩存。這會(huì)導(dǎo)致打印機(jī)處理不過(guò)來(lái)數(shù)據(jù)丟失。需要分片發(fā)送。分片發(fā)送解決方案 ESC/POS的GS v 0指令允許你將一幅大圖分成多個(gè)數(shù)據(jù)塊發(fā)送只要保持x寬度字節(jié)數(shù)不變多次發(fā)送相同x但不同y的數(shù)據(jù)塊即可。但更簡(jiǎn)單的做法是我們自己控制每次發(fā)送的行數(shù)。def send_bitmap_in_chunks(bitmap_data, bytes_per_row, total_height, chunk_height100, ...): 分塊發(fā)送位圖數(shù)據(jù)避免緩沖區(qū)溢出。 chunk_height: 每次發(fā)送的行數(shù)像素 total_bytes len(bitmap_data) bytes_per_chunk bytes_per_row * chunk_height for start_row in range(0, total_height, chunk_height): end_row min(start_row chunk_height, total_height) current_height end_row - start_row # 計(jì)算當(dāng)前數(shù)據(jù)塊的起始和結(jié)束索引 start_index start_row * bytes_per_row end_index start_index (current_height * bytes_per_row) chunk_data bitmap_data[start_index:end_index] # 為當(dāng)前數(shù)據(jù)塊構(gòu)造指令 yL current_height % 256 yH current_height // 256 # xL, xH 不變 command bytearray([0x1D, 0x76, 0x30, m, xL, xH, yL, yH]) command.extend(chunk_data) # 發(fā)送命令 ser.write(command) # 可選小塊發(fā)送后稍作延時(shí)確保打印機(jī)處理完畢 time.sleep(0.05)chunk_height的值需要根據(jù)打印機(jī)性能和波特率測(cè)試確定通常從50-200行開(kāi)始嘗試。5.2 問(wèn)題二打印效果模糊或有條紋現(xiàn)象打印出來(lái)的圖片有橫向或縱向的缺失線條或者整體發(fā)灰、不清晰。根因與解決二值化閾值不當(dāng)閾值過(guò)高會(huì)導(dǎo)致圖像整體偏白細(xì)節(jié)丟失閾值過(guò)低則整體偏黑變成一團(tuán)。對(duì)于不同圖片需要微調(diào)。可以做一個(gè)簡(jiǎn)單的預(yù)覽功能在電腦上先顯示二值化后的效果。熱敏打印頭老化或臟污這是硬件問(wèn)題。打印頭某一行或某一列的熱敏點(diǎn)損壞或污垢覆蓋會(huì)導(dǎo)致固定的白線或黑線。清潔打印頭用棉簽蘸無(wú)水酒精輕輕擦拭通常可以解決污垢問(wèn)題。電源功率不足熱敏打印頭在打印整行黑點(diǎn)時(shí)瞬間電流很大。如果電源適配器功率不足特別是使用USB供電時(shí)可能導(dǎo)致打印頭加熱不均造成縱向深淺不一的條紋。務(wù)必使用打印機(jī)標(biāo)稱(chēng)的電源如12V/2A以上。打印濃度設(shè)置ESC/POS指令中有設(shè)置打印濃度的命令GS ( E或ESC #。濃度太低會(huì)導(dǎo)致顏色淺。可以在打印位圖前發(fā)送濃度調(diào)整指令。# 設(shè)置打印濃度和加熱時(shí)間 (示例具體指令需查手冊(cè)) # ESC # 命令示例設(shè)置濃度級(jí)別通常范圍0-255 set_density b\x1B\x23\x01 # 假設(shè)此命令設(shè)置濃度為1較深 ser.write(set_density)5.3 問(wèn)題三與其他打印內(nèi)容文本、條碼的混合排版現(xiàn)象打印完位圖后后續(xù)的文本沒(méi)有在正確的位置開(kāi)始或者位圖把之前的內(nèi)容覆蓋了。解決方案 ESC/POS打印機(jī)維護(hù)著一個(gè)邏輯“光標(biāo)”位置。打印位圖后光標(biāo)會(huì)移動(dòng)到位圖結(jié)束的下一行行首。你需要主動(dòng)控制換行和行間距。打印前復(fù)位在打印位圖前使用ESC 命令初始化打印機(jī)重置部分參數(shù)到默認(rèn)并使用ESC 2設(shè)置默認(rèn)行間距約30點(diǎn)。init_cmd b\x1B\x40 # ESC 初始化 set_line_spacing b\x1B\x32 # ESC 2 設(shè)置默認(rèn)行間距 ser.write(init_cmd set_line_spacing)精確控制換行打印完位圖后如果你希望緊接著在圖片下方打印文字直接發(fā)送文本即可。如果你希望空幾行可以發(fā)送多個(gè)換行符\n或者使用絕對(duì)垂直定位指令ESC \$或相對(duì)垂直定位指令ESC \\如果打印機(jī)支持來(lái)精確移動(dòng)打印位置。切紙如果需要自動(dòng)切紙?jiān)谌績(jī)?nèi)容打印完畢后發(fā)送切紙指令GS V mm為模式如GS V 0或GS V 1部分切紙。6. 進(jìn)階探索性能優(yōu)化與格式擴(kuò)展當(dāng)基本功能跑通后可以考慮以下優(yōu)化和擴(kuò)展讓打印更高效、效果更專(zhuān)業(yè)。6.1 使用更高效的指令GS ( LGS v 0是標(biāo)準(zhǔn)指令但有些打印機(jī)對(duì)GS ( L存儲(chǔ)并打印光柵位圖的支持更好或者能利用打印機(jī)內(nèi)部緩存。其指令格式更復(fù)雜但原理相通先傳輸數(shù)據(jù)到緩存再執(zhí)行打印。它允許你重復(fù)打印同一幅圖像而無(wú)需重復(fù)傳輸數(shù)據(jù)適合打印LOGO等固定內(nèi)容。# GS ( L 指令示例框架非完整代碼 # 1. 定義并存儲(chǔ)圖像 cmd_define bytearray([0x1D, 0x28, 0x4C, ...]) # 參數(shù)定義圖像大小和ID cmd_define.extend(bitmap_data) # 2. 打印存儲(chǔ)的圖像 cmd_print bytearray([0x1D, 0x28, 0x4C, ...]) # 指定要打印的圖像ID具體參數(shù)需要查閱打印機(jī)的ESC/POS指令手冊(cè)。6.2 圖像預(yù)處理流水線優(yōu)化對(duì)于需要批量或?qū)崟r(shí)打印的應(yīng)用圖像處理可能成為瓶頸。可以采取以下措施預(yù)計(jì)算對(duì)于固定的LOGO、模板可以預(yù)先處理好二值化數(shù)據(jù)并保存為二進(jìn)制文件或Base64字符串運(yùn)行時(shí)直接加載省去圖像處理時(shí)間。使用NumPy向量化操作用PIL的getdata()配合列表推導(dǎo)式在Python中循環(huán)處理大量像素效率較低?？梢詫D像數(shù)據(jù)轉(zhuǎn)換為NumPy數(shù)組利用其強(qiáng)大的向量和位操作功能來(lái)加速二值化和數(shù)據(jù)打包過(guò)程。import numpy as np from PIL import Image img Image.open(logo.png).convert(1) # 直接轉(zhuǎn)為二值 img_np np.array(img, dtypenp.uint8) # 0和255的數(shù)組 # 反轉(zhuǎn)0黑-1, 255白-0 img_np 1 - (img_np // 255) # 得到0和1的數(shù)組 # 重塑并打包位的操作此處略需按位操作選擇更快的二值化算法固定閾值Otsu算法自動(dòng)計(jì)算閾值在速度和效果上是一個(gè)不錯(cuò)的折中。6.3 支持透明背景與反色打印有時(shí)我們需要打印一個(gè)“鏤空”的Logo或者希望白底黑字/圖案變成黑底白字反色。透明背景在預(yù)處理時(shí)可以將原圖中特定顏色如純白色或Alpha通道的像素視為透明在二值化時(shí)直接設(shè)為白色不打印。這需要在圖像處理階段進(jìn)行像素判斷。反色打印非常簡(jiǎn)單只需在生成點(diǎn)陣數(shù)據(jù)后對(duì)每一個(gè)數(shù)據(jù)字節(jié)執(zhí)行按位取反操作byte_value ~byte_value 0xFF。這樣原本要打印的黑點(diǎn)就變成了白點(diǎn)背景則變成了黑色。注意熱敏紙全黑打印耗材且可能效果不佳慎用。7. 完整代碼示例與集成測(cè)試將以上所有步驟整合形成一個(gè)健壯的、可配置的位圖打印函數(shù)。import serial import time from PIL import Image import numpy as np class QR204BitmapPrinter: def __init__(self, port, baudrate19200, max_width384): self.port port self.baudrate baudrate self.max_width max_width self.ser None def connect(self): 連接打印機(jī) self.ser serial.Serial(self.port, self.baudrate, timeout2) # 發(fā)送初始化指令 self.ser.write(b\x1B\x40) # ESC def disconnect(self): 斷開(kāi)連接 if self.ser and self.ser.is_open: self.ser.close() def preprocess_image(self, image_path, threshold128, ditherFalse): 圖像預(yù)處理流水線 Returns: (bitmap_data, bytes_per_row, height) # 1. 打開(kāi)并轉(zhuǎn)換 img Image.open(image_path) img_gray img.convert(L) # 2. 二值化 if dither: img_binary img_gray.convert(1, ditherImage.FLOYDSTEINBERG) else: img_binary img_gray.point(lambda x: 0 if x threshold else 255, mode1) # 3. 調(diào)整尺寸 if img_binary.width self.max_width: ratio self.max_width / img_binary.width new_height int(img_binary.height * ratio) img_binary img_binary.resize((self.max_width, new_height), Image.Resampling.LANCZOS) # 4. 寬度字節(jié)對(duì)齊 width img_binary.width bytes_per_row (width 7) // 8 aligned_width bytes_per_row * 8 if width ! aligned_width: new_img Image.new(1, (aligned_width, img_binary.height), 1) new_img.paste(img_binary, (0, 0)) img_binary new_img # 5. 提取數(shù)據(jù) (使用NumPy優(yōu)化版) img_np np.array(img_binary, dtypenp.uint8) # 反轉(zhuǎn)圖像中0(黑)-1(打印)255(白)-0(不打印) # 轉(zhuǎn)換為0/1數(shù)組 data_bool (img_np 0) height, width_aligned data_bool.shape bytes_per_row width_aligned // 8 bitmap_data bytearray() for y in range(height): for x_byte in range(bytes_per_row): byte_val 0 # 處理8個(gè)像素 for bit in range(8): if data_bool[y, x_byte*8 bit]: byte_val | 1 (7 - bit) bitmap_data.append(byte_val) return bitmap_data, bytes_per_row, height def send_bitmap(self, bitmap_data, bytes_per_row, height, chunk_height100): 發(fā)送位圖數(shù)據(jù)到打印機(jī) if not self.ser: raise Exception(Printer not connected) m 0 # 模式0 x bytes_per_row xL x 0xFF xH (x 8) 0xFF total_chunks (height chunk_height - 1) // chunk_height for chunk_idx in range(total_chunks): start_row chunk_idx * chunk_height end_row min(start_row chunk_height, height) chunk_h end_row - start_row # 計(jì)算數(shù)據(jù)切片 start_idx start_row * bytes_per_row end_idx start_idx chunk_h * bytes_per_row chunk_data bitmap_data[start_idx:end_idx] yL chunk_h 0xFF yH (chunk_h 8) 0xFF cmd bytearray([0x1D, 0x76, 0x30, m, xL, xH, yL, yH]) cmd.extend(chunk_data) self.ser.write(cmd) # 小塊延時(shí)防止緩沖區(qū)溢出 time.sleep(0.02) # 打印后換行 self.ser.write(b\n\n) def print_image(self, image_path, **kwargs): 一站式打印圖片 print(預(yù)處理圖像...) data, bpr, h self.preprocess_image(image_path, **kwargs) print(f圖像處理完成尺寸{bpr*8} x {h} 像素) print(發(fā)送數(shù)據(jù)到打印機(jī)...) self.send_bitmap(data, bpr, h) print(打印指令發(fā)送完畢。) # 使用示例 if __name__ __main__: printer QR204BitmapPrinter(portCOM3, max_width384) try: printer.connect() # 打印一張圖片使用抖動(dòng)算法 printer.print_image(company_logo.png, ditherTrue) # 再打印一張使用固定閾值 printer.print_image(barcode_label.png, threshold160, ditherFalse) # 發(fā)送切紙指令 (如果支持) printer.ser.write(b\x1D\x56\x00) # GS V 0 全切 except Exception as e: print(f打印過(guò)程中出錯(cuò): {e}) finally: printer.disconnect()這個(gè)類(lèi)封裝了完整的流程從連接、預(yù)處理到分塊發(fā)送。你可以通過(guò)調(diào)整threshold和dither參數(shù)來(lái)優(yōu)化不同圖片的打印效果通過(guò)chunk_height來(lái)平衡速度和穩(wěn)定性。最后真正的穩(wěn)定性和兼容性需要在你的具體硬件QR204打印機(jī)上反復(fù)測(cè)試。不同批次或固件版本的打印機(jī)對(duì)某些指令的響應(yīng)可能有細(xì)微差別。最好的建議是準(zhǔn)備幾張包含細(xì)線、粗體、漸變、小文字等元素的測(cè)試圖片打印出來(lái)肉眼觀察效果并記錄下最優(yōu)的參數(shù)組合形成你自己項(xiàng)目的“打印配置檔案”。