setop/python-escpos
1
0
Fork 0
mirror of https://github.com/python-escpos/python-escpos synced 2025-12-02 09:43:30 +00:00
Code Activity

further revise

Browse Source
This commit is contained in:
Patrick Kanzler
2023-08-10 01:32:23 +02:00
parent 58b50b1736
commit 9a7ac83f89
8 changed files with 76 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc/dev/release-process.rst
View File

@@ -1,6 +1,8 @@
Release process
===============
:Last Reviewed: 2023-08-10
* Update authors file
* Update changelog
* Set annotated tag for release and push to public github

2
doc/dev/todo.rst
View File

@@ -1,6 +1,8 @@
TODO
====
:Last Reviewed: 2023-08-10
Open points and issues of the project are tracked in the GitHub issues.
Some annotations still remain in the code and should be moved over time
into the issue tracker.

7
doc/printer_profiles/available-encodings.rst
View File

@@ -1,6 +1,11 @@
Available Encodings
-------------------
:Last Reviewed: 2023-07-29
:Last Reviewed: 2023-08-10
If you find any issues with the described encodings,
please open an issue in the
`ESC/POS printer database <https://github.com/receipt-print-hq/escpos-printer-db>`_.
The data shown here is directly taken from there.
.. datatemplate:json:: ../../capabilities-data/dist/capabilities.json
:template: capabilities-template-encoding.jinja

3
doc/printer_profiles/available-profiles.rst
View File

@@ -2,7 +2,7 @@
Available Profiles
------------------
:Last Reviewed: 2023-07-29
:Last Reviewed: 2023-08-10
The following list describes which printer profiles are
available in this release.
@@ -12,6 +12,7 @@ that this printer actually can be controlled by this library.
If you find any issues with the described capabilities,
please open an issue in the
`ESC/POS printer database <https://github.com/receipt-print-hq/escpos-printer-db>`_.
The data shown here is directly taken from there.
.. datatemplate:json:: ../../capabilities-data/dist/capabilities.json
:template: capabilities-template.jinja

2
doc/printer_profiles/capabilities.rst
View File

@@ -2,7 +2,7 @@
Capabilities
------------
:Last Reviewed: 2023-07-29
:Last Reviewed: 2023-08-10
Since the used command set often differs between printers,
a model for supporting different printers is implemented.

29
doc/user/barcode.rst
View File

@@ -1,19 +1,29 @@
Printing Barcodes
-----------------
:Last Reviewed: 2023-05-16
:Last Reviewed: 2023-08-10
Many printers implement barcode printing natively.
This hardware renderered barcodes are fast but the supported formats are limited by the printer itself and different between models.
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 drawback, this operation is much slower and the user needs to know and choose the image implementation method supported by the printer's commandset.
This hardware renderered barcodes are fast but the supported
formats are limited by the printer itself and different between models.
However, almost all printers support printing images, so barcode
rendering can be performed externally by software and then sent
to the printer as an image.
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.
barcode-method
~~~~~~~~~~~~~~
Since version 3.0, the ``barcode`` method unifies the previous ``barcode`` (hardware) and ``soft_barcode`` (software) methods.
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.
Since version 3.0, the ``barcode`` method unifies the previous
``barcode`` (hardware) and ``soft_barcode`` (software) methods.
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
@@ -33,4 +43,5 @@ For alphanumeric CODE128 you have to preface your payload with `{B`.
# print CODE128 012ABCDabcd
p.barcode("{B012ABCDabcd", "CODE128", function_type="B")
A very good description on CODE128 is also on `Wikipedia <https://en.wikipedia.org/wiki/Code_128>`_.
A very good description on CODE128 is also on
`Wikipedia <https://en.wikipedia.org/wiki/Code_128>`_.

2
doc/user/usage.rst
View File

@@ -1,7 +1,7 @@
Usage
=====
:Last Reviewed: 2017-06-10
:Last Reviewed: 2023-08-10
Define your printer
-------------------