1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
Structured Append
=================
The Structured Append mode can be used to split a message across several
QR codes (it's not available for Micro QR codes).
Example: The 2-L QR code encodes the same information ("I read the news today oh boy")
as the following 1-L QR codes which are using Structured Append:
.. image:: _static/sa/structured_append_2_l.svg
:alt: 2-L QR code encoding 'I read the news today oh boy'
With Structured Append (version 1):
.. image:: _static/sa/structured_append_1_l-02-01.svg
:alt: 1-L QR code encoding 'I read the news today oh boy' part 1/2
.. image:: _static/sa/structured_append_1_l-02-02.svg
:alt: 1-L QR code encoding 'I read the news today oh boy' part 2/2
Segno provides a special factory function, :py:func:`segno.make_sequence`, to
create a sequence of (up to 16) QR codes. The function returns instances of
:py:class:`segno.QRCodeSequence`.
Structured Append by QR Code version
------------------------------------
To create a sequence of QR codes, the QR Code version must be specified. The
number of symbols is automatically determined by the QR Code version.
.. code-block:: python
>>> import segno
>>> qrcode_seq = segno.make_sequence('I read the news today oh boy', version=1)
>>> len(qrcode_seq)
2
>>> # Creates "a-day-in-the-life-02-01.svg" and "a-day-in-the-life-02-02.svg"
>>> qrcode_seq.save('a-day-in-the-life.svg', scale=10)
If the provided content fits into one QR code, the sequence behaves like a
:py:class:`segno.QRCode` instance.
.. code-block:: python
>>> import segno
>>> qrcode_seq = segno.make_sequence('I read', version=1)
>>> len(qrcode_seq)
1
>>> qrcode_seq.designator
'1-H'
>>> # Creates "a-day-in-the-life.svg"
>>> qrcode_seq.save('a-day-in-the-life.svg', scale=10)
Structured Append by number of symbols
--------------------------------------
The number of desired QR code symbols may be specified directly. The utilized
QR Code version is automatically determined by the number of symbols.
.. code-block:: python
>>> import segno
>>> qrcode_seq = segno.make_sequence('Day after day, alone on the hill', symbol_count=4)
>>> [qrcode.designator for qr in seq]
['1-Q', '1-Q', '1-Q', '1-Q']
>>> qrcode_seq = segno.make_sequence('Day after day, alone on the hill', symbol_count=2)
>>> [qrcode.designator for qr in seq]
['2-Q', '2-Q']
>>> qrcode_seq = segno.make_sequence('Day after day, alone on the hill', symbol_count=6)
>>> [qrcode.designator for qr in seq]
['1-Q', '1-Q', '1-H', '1-H', '1-H', '1-H']
Example: The 6-L QR code encodes the same information (first verse of the song "Yesterday")
as the four 2-L QR codes.
.. image:: _static/sa/structured_append_example_2_6-L.svg
:alt: 6-L QR code encoding 'Yesterday...'
The following 2-L QR codes were created by specifying that 4 codes should be generated
(:paramref:`symbol_count=4 <segno.make_sequence.symbol_count>` ).
The result would be the same if the user specifies that a sequence of QR codes
with version 2 should be created.
.. image:: _static/sa/structured_append_example_2_2-L-04-01.svg
:alt: 2-L QR code encoding first verse of 'Yesterday' part 1/4
.. image:: _static/sa/structured_append_example_2_2-L-04-02.svg
:alt: 2-L QR code encoding first verse of 'Yesterday' part 2/4
.. image:: _static/sa/structured_append_example_2_2-L-04-03.svg
:alt: 2-L QR code encoding first verse of 'Yesterday' part 3/4
.. image:: _static/sa/structured_append_example_2_2-L-04-04.svg
:alt: 2-L QR code encoding first verse of 'Yesterday' part 4/4
|
