setop/python-escpos
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update barcode examples and docs

Browse Source
This commit is contained in:
belono 2023-05-16 12:19:13 +02:00
parent 8cac2a1fc6
commit 991efddbd6
3 changed files with 13 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/user/barcode.rst
View File

@ -1,17 +1,18 @@
Printing Barcodes Printing Barcodes
----------------- -----------------
:Last Reviewed: 2016-07-31 :Last Reviewed: 2023-05-16
Most ESC/POS-printers implement barcode-printing. Many printers implement barcode printing natively.
The barcode-commandset is implemented in the barcode-method. This hardware renderered barcodes are fast but the supported formats are limited by the printer itself and different between models.
For a list of compatible barcodes you should check the manual of your printer. However, almost all printers support printing images, so barcode renderization can be performed externally by software and then sent to the printer as an image.
As a rule of thumb: even older Epson-models support most 1D-barcodes. As a drawback, this operation is much slower and the user needs to know and choose the image implementation method supported by the printer's commandset.
To be sure just try some implementations and have a look at the notices below.
barcode-method barcode-method
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~
The barcode-method is rather low-level and orients itself on the implementation of ESC/POS. Since version 3.0, the ``barcode`` method unifies the previous ``barcode`` (hardware) and ``soft_barcode`` (software) methods.
In the future this class could be supplemented by a high-level class that helps the user generating the payload. It is able to choose automatically the best printer implementation for barcode printing based on the capabilities of the printer and the type of barcode desired.
To achieve this, it relies on the information contained in the escpos-printer-db profiles.
The chosen profile needs to match the capabilities of the printer as closely as possible.
.. py:currentmodule:: escpos.escpos .. py:currentmodule:: escpos.escpos

4
examples/barcodes.py
View File

@ -2,10 +2,10 @@ from escpos.printer import Usb
# Adapt to your needs # Adapt to your needs
p = Usb(0x0416, 0x5011, profile="POS-5890") p = Usb(0x0416, 0x5011, profile="TM-T88II")
# Print software and then hardware barcode with the same content # Print software and then hardware barcode with the same content
p.soft_barcode("code39", "123456") p.barcode("123456", "CODE39", width=2, force_software=True)
p.text("\n") p.text("\n")
p.text("\n") p.text("\n")
p.barcode("123456", "CODE39") p.barcode("123456", "CODE39")

4
examples/software_barcode.py
View File

@ -5,5 +5,5 @@ from escpos.printer import Usb
p = Usb(0x0416, 0x5011, profile="POS-5890") p = Usb(0x0416, 0x5011, profile="POS-5890")
# Some software barcodes # Some software barcodes
p.soft_barcode("code128", "Hello") p.barcode("Hello", "code128", width=2, force_software="bitImageRaster")
p.soft_barcode("code39", "1234") p.barcode("1234", "code39", width=2, force_software=True)