From 854b75be30c8161f41b41dcae747d86d47d93e9b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Michael=20Elsd=C3=B6rfer?= Date: Thu, 25 Aug 2016 15:56:32 +0200 Subject: [PATCH 1/4] Support changing the line spacing. --- src/escpos/constants.py | 7 +++++++ src/escpos/escpos.py | 23 +++++++++++++++++++++++ test/test_functions.py | 20 ++++++++++++++++++++ 3 files changed, 50 insertions(+) create mode 100644 test/test_functions.py diff --git a/src/escpos/constants.py b/src/escpos/constants.py index 93721cb..703e48b 100644 --- a/src/escpos/constants.py +++ b/src/escpos/constants.py @@ -101,6 +101,13 @@ TXT_ALIGN_RT = ESC + b'\x61\x02' # Right justification TXT_INVERT_ON = GS + b'\x42\x01' # Inverse Printing ON TXT_INVERT_OFF = GS + b'\x42\x00' # Inverse Printing OFF +# Spacing +LINESPACING_FUNCS = { + 60: ESC + b'A', # line_spacing/60 of an inch, 0 <= line_spacing <= 85 + 360: ESC + b'+', # line_spacing/360 of an inch, 0 <= line_spacing <= 255 + 180: ESC + b'3', # line_spacing/180 of an inch, 0 <= line_spacing <= 255 +} + # Char code table CHARCODE_PC437 = ESC + b'\x74\x00' # USA: Standard Europe CHARCODE_JIS = ESC + b'\x74\x01' # Japanese Katakana diff --git a/src/escpos/escpos.py b/src/escpos/escpos.py index c0df537..99c9308 100644 --- a/src/escpos/escpos.py +++ b/src/escpos/escpos.py @@ -565,6 +565,29 @@ class Escpos(object): else: self._raw(TXT_INVERT_OFF) + def line_spacing(self, spacing=30, divisor=180): + """ Set line character spacing. + + There are different commands for setting the line spacing, using + a different denominator: + + + line_spacing/360 of an inch, 0 <= line_spacing <= 255 + 3 line_spacing/180 of an inch, 0 <= line_spacing <= 255 + A line_spacing/60 of an inch, 0 <= line_spacing <= 85 + + Some printers may not support all of them. The most commonly + available command (using a divisor of 180) is chosen. + """ + if divisor not in LINESPACING_FUNCS: + raise ValueError("divisor must be either 360, 180 or 60") + if (divisor in [360, 180] \ + and (not(0 <= spacing <= 255))): + raise ValueError("spacing must be a int between 0 and 255 when divisor is 360 or 180") + if divisor == 60 and (not(0 <= spacing <= 85)): + raise ValueError("spacing must be a int between 0 and 85 when divisor is 60") + + self._raw(LINESPACING_FUNCS[divisor] + six.int2byte(spacing)) + def cut(self, mode=''): """ Cut paper. diff --git a/test/test_functions.py b/test/test_functions.py new file mode 100644 index 0000000..a78cc14 --- /dev/null +++ b/test/test_functions.py @@ -0,0 +1,20 @@ +from nose.tools import assert_raises +from escpos.printer import Dummy + + +def test_line_spacing_code_gen(): + printer = Dummy() + printer.line_spacing(10) + assert printer.output == '\x1b3\n' + + +def test_line_spacing_error_handling(): + printer = Dummy() + with assert_raises(ValueError): + printer.line_spacing(divisor=44) + with assert_raises(ValueError): + printer.line_spacing(divisor=80, spacing=86) + with assert_raises(ValueError): + printer.line_spacing(divisor=360, spacing=256) + with assert_raises(ValueError): + printer.line_spacing(divisor=180, spacing=256) \ No newline at end of file From 07d47765aad69c6ee5512e3b0580b9ce1f7e95e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Michael=20Elsd=C3=B6rfer?= Date: Fri, 26 Aug 2016 10:38:36 +0200 Subject: [PATCH 2/4] Allow linespacing reset. Make this the default. --- src/escpos/constants.py | 1 + src/escpos/escpos.py | 8 +++++++- test/test_functions.py | 8 +++++++- 3 files changed, 15 insertions(+), 2 deletions(-) diff --git a/src/escpos/constants.py b/src/escpos/constants.py index 703e48b..999dba1 100644 --- a/src/escpos/constants.py +++ b/src/escpos/constants.py @@ -102,6 +102,7 @@ TXT_INVERT_ON = GS + b'\x42\x01' # Inverse Printing ON TXT_INVERT_OFF = GS + b'\x42\x00' # Inverse Printing OFF # Spacing +LINESPACING_RESET = ESC + b'2' LINESPACING_FUNCS = { 60: ESC + b'A', # line_spacing/60 of an inch, 0 <= line_spacing <= 85 360: ESC + b'+', # line_spacing/360 of an inch, 0 <= line_spacing <= 255 diff --git a/src/escpos/escpos.py b/src/escpos/escpos.py index 99c9308..797b5ed 100644 --- a/src/escpos/escpos.py +++ b/src/escpos/escpos.py @@ -565,9 +565,11 @@ class Escpos(object): else: self._raw(TXT_INVERT_OFF) - def line_spacing(self, spacing=30, divisor=180): + def line_spacing(self, spacing=None, divisor=180): """ Set line character spacing. + If no spacing is given, we reset it to the default. + There are different commands for setting the line spacing, using a different denominator: @@ -578,6 +580,10 @@ class Escpos(object): Some printers may not support all of them. The most commonly available command (using a divisor of 180) is chosen. """ + if spacing is None: + self._raw(LINESPACING_RESET) + return + if divisor not in LINESPACING_FUNCS: raise ValueError("divisor must be either 360, 180 or 60") if (divisor in [360, 180] \ diff --git a/test/test_functions.py b/test/test_functions.py index a78cc14..f35de54 100644 --- a/test/test_functions.py +++ b/test/test_functions.py @@ -8,10 +8,16 @@ def test_line_spacing_code_gen(): assert printer.output == '\x1b3\n' +def test_line_spacing_rest(): + printer = Dummy() + printer.line_spacing() + assert printer.output == '\x1b2' + + def test_line_spacing_error_handling(): printer = Dummy() with assert_raises(ValueError): - printer.line_spacing(divisor=44) + printer.line_spacing(99, divisor=44) with assert_raises(ValueError): printer.line_spacing(divisor=80, spacing=86) with assert_raises(ValueError): From ae9b3785c2d859aecab7d005ca757aab74c471fd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Michael=20Elsd=C3=B6rfer?= Date: Fri, 26 Aug 2016 11:48:58 +0200 Subject: [PATCH 3/4] Fix broken tests. --- test/test_functions.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/test/test_functions.py b/test/test_functions.py index f35de54..22ee737 100644 --- a/test/test_functions.py +++ b/test/test_functions.py @@ -5,13 +5,13 @@ from escpos.printer import Dummy def test_line_spacing_code_gen(): printer = Dummy() printer.line_spacing(10) - assert printer.output == '\x1b3\n' + assert printer.output == b'\x1b3\n' def test_line_spacing_rest(): printer = Dummy() printer.line_spacing() - assert printer.output == '\x1b2' + assert printer.output == b'\x1b2' def test_line_spacing_error_handling(): From 632a10421960e14645a08e686f0ef0a877c2c728 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Michael=20Elsd=C3=B6rfer?= Date: Fri, 26 Aug 2016 11:59:40 +0200 Subject: [PATCH 4/4] Fix docstring warning. --- src/escpos/escpos.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/escpos/escpos.py b/src/escpos/escpos.py index 797b5ed..c102e2c 100644 --- a/src/escpos/escpos.py +++ b/src/escpos/escpos.py @@ -573,9 +573,9 @@ class Escpos(object): There are different commands for setting the line spacing, using a different denominator: - + line_spacing/360 of an inch, 0 <= line_spacing <= 255 - 3 line_spacing/180 of an inch, 0 <= line_spacing <= 255 - A line_spacing/60 of an inch, 0 <= line_spacing <= 85 + '+'' line_spacing/360 of an inch, 0 <= line_spacing <= 255 + '3' line_spacing/180 of an inch, 0 <= line_spacing <= 255 + 'A' line_spacing/60 of an inch, 0 <= line_spacing <= 85 Some printers may not support all of them. The most commonly available command (using a divisor of 180) is chosen.