Segno Documentation Author Aug 27, 2020 CONTENTS 1 Creating QR codes or Micro QR codes3 1.1 QR Code version.............................................5 1.2 QR Code error correction level.....................................6 1.3 QR Code data masking..........................................7 1.3.1 Micro QR code with different data masks...........................7 1.3.2 QR code with different data masks...............................8 2 QR code and Micro QR code serialization 11 2.1 Border.................................................. 11 2.2 Scale................................................... 12 2.3 Color of dark and light modules..................................... 14 2.4 Saving QR codes to streams....................................... 15 2.5 More colorful QR Codes......................................... 16 2.6 Available serializers........................................... 16 3 Boost error correction level 19 3.1 Examples................................................. 19 4 QR Code modes 21 4.1 Numeric mode.............................................. 21 4.2 Alphanumeric mode........................................... 22 4.3 Kanji mode................................................ 23 4.4 Byte mode................................................ 24 4.5 Hanzi mode................................................ 24 5 Structured Append 27 5.1 Structured Append by QR Code version................................. 27 5.2 Structured Append by number of symbols................................ 28 6 Colorful QR Codes 29 6.1 Module names.............................................. 30 6.1.1 dark / --dark ......................................... 30 6.1.2 light / --light ........................................ 31 6.1.3 alignment_dark / --align-dark .............................. 31 6.1.4 alignment_light / --align-light ............................. 32 6.1.5 dark_module / --dark-module ............................... 32 6.1.6 data_dark / --data-dark .................................. 33 6.1.7 data_light / --data-light ................................. 34 6.1.8 finder_dark / --finder-dark ................................ 35 6.1.9 finder_light / --finder-light ............................... 35 6.1.10 format_dark / --format-dark ............................... 36 i 6.1.11 format_light / --format-light .............................. 37 6.1.12 quiet_zone / --quiet-zone ................................. 37 6.1.13 separator / --separator ................................... 38 6.1.14 timing_dark / --timing-dark ............................... 39 6.1.15 timing_light / --timing-light ............................... 39 6.1.16 version_dark / --version-dark .............................. 40 6.1.17 version_light / --version-light ............................. 40 7 SVG options 43 7.1 Options.................................................. 43 7.1.1 xmldecl............................................. 43 7.1.2 svgns.............................................. 43 7.1.3 svgid / --svgid ........................................ 43 7.1.4 svgclass / --svgclass .................................... 43 7.1.5 lineclass / --lineclass ................................... 43 7.1.6 omitsize / --no-size ..................................... 43 7.1.7 nl................................................ 44 7.1.8 title / --title ......................................... 44 7.1.9 desc / --desc ......................................... 44 7.1.10 unit / --unit ......................................... 44 7.1.11 encoding / --encoding ................................... 44 7.1.12 draw_transparent........................................ 44 7.1.13 svgversion / --svgversion ................................. 44 7.2 Optimizing SVG............................................. 45 8 Special QR Code factory functions 49 8.1 Create a QR code for a WIFI configuration............................... 49 8.2 Create a QR code encoding geographic information.......................... 50 9 Creating a QR Code encoding contact information 53 9.1 MeCard.................................................. 53 9.2 vCard................................................... 53 10 EPC QR Codes 55 11 Artistic QR Codes 57 12 Web development 59 12.1 Flask................................................... 59 12.1.1 Data URIs............................................ 59 12.1.2 Embed SVG QR codes into HTML............................... 60 12.1.3 Create a view.......................................... 60 12.2 Django.................................................. 60 12.2.1 Saving a QR code to an ImageField.............................. 61 13 QR Code creation from the command line 63 13.1 Usage................................................... 63 13.2 QR Code version............................................. 65 13.3 QR Code error correction level..................................... 67 13.4 QR code serialization.......................................... 67 13.5 Scaling QR codes............................................ 68 13.6 Changing the size of the quiet zone................................... 69 13.7 Colors.................................................. 70 13.8 Structured Append............................................ 71 ii 14 Comparison of Python QR Code libraries 75 14.1 Features.................................................. 75 14.2 Performance............................................... 77 14.2.1 Create a 1-M QR code..................................... 77 14.2.2 Create a 7-Q QR code...................................... 77 14.2.3 Create a 30-H QR code..................................... 77 14.2.4 Create a QR code and serialize it as SVG........................... 77 14.2.5 Create a QR code and serialize it as PNG........................... 77 15 Man pages 79 15.1 segno................................................... 79 15.1.1 Synopsis............................................. 79 15.1.2 Description........................................... 79 15.1.3 Command Line Options.................................... 79 15.1.3.1 QR Code Options................................... 79 15.1.3.2 Output Options.................................... 80 15.1.3.3 Module Colors..................................... 80 15.1.3.4 SVG Options..................................... 81 15.1.3.5 PNG Options..................................... 82 15.1.4 Exit Status............................................ 82 15.1.5 Examples............................................ 82 16 Writing plugins for Segno 83 16.1 Simple plugin............................................... 83 17 API 85 17.1 Module contents............................................. 85 17.2 High level QR Code factories...................................... 96 18 Python 2 statement 103 19 Changes 105 19.1 1.2.1 – 2020-08-27............................................ 105 19.2 1.2.0 – 2020-08-18............................................ 105 19.3 1.1.0 – 2020-08-05............................................ 105 19.4 1.0.2 – 2020-07-30............................................ 106 19.5 1.0.1 – 2020-07-28............................................ 106 19.6 1.0.0 – 2020-02-14............................................ 106 19.7 0.4.0 – 2020-01-21............................................ 106 19.8 0.3.9 – 2020-01-19............................................ 107 19.9 0.3.8 – 2020-01-15............................................ 107 19.10 0.3.7 – 2020-01-09............................................ 107 19.11 0.3.6 – 2020-01-06............................................ 107 19.12 0.3.5 – 2020-01-03............................................ 108 19.13 0.3.4 – 2020-01-02............................................ 108 19.14 0.3.3 – 2019-12-29............................................ 109 19.15 0.3.2 – 2019-07-15............................................ 109 19.16 0.3.1 – 2019-07-15............................................ 109 19.17 0.3.0 – 2019-06-25............................................ 110 19.18 0.2.9 – 2019-04-24............................................ 110 19.19 0.2.8 – 2018-10-17............................................ 110 19.20 0.2.7 – 2018-02-18............................................ 110 19.21 0.2.6 – 2018-02-18............................................ 110 19.22 0.2.5 – 2017-02-14............................................ 111 19.23 0.2.4 – 2017-01-31............................................ 111 iii 19.24 0.2.3 – 2016-10-17............................................ 111 19.25 0.2.2 – 2016-09-21............................................ 112 19.26 0.2.1 – 2016-09-15............................................ 112 19.27 0.2.0 – 2016-09-15............................................ 112 19.28 0.1.9 – 2016-09-15............................................ 112 19.29 0.1.8 – 2016-09-14............................................ 112 19.30 0.1.7 – 2016-09-04............................................ 112 19.31 0.1.6 – 2016-08-25............................................ 113 19.32 0.1.5 – 2016-08-24............................................ 113 19.33 0.1.4 – 2016-08-21............................................ 113 19.34 0.1.3 – 2016-08-20............................................ 113 19.35 0.1.2 – 2016-08-17............................................ 114 19.36 0.1.1 – 2016-08-14............................................ 114 20 Indices and tables 115 Python Module Index 117 Index 119 iv Segno Documentation Pure Python QR Code generator with no dependencies. Segno (Italian