This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Easily encode your data into a 2D barcode using the PDF417 format.

Licensed under the MIT License, see LICENSE.

Installation

Install using pip:

pip install pdf417gen

Usage

Creating bar codes is done in two steps:

  • Encode a string to a list of code words using encode()
  • Render the barcode using one of the rendering functions: render_image(), render_svg().

Usage overview:

from pdf417gen import encode, render_image, render_svg

# Some data to encode
text = """Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated."""

# Convert to code words
codes = encode(text)

# Generate barcode as image
image = render_image(codes)  # Pillow Image object
image.save('barcode.jpg')

# Generate barcode as SVG
svg = render_svg(codes)  # ElementTree object
svg.write("barcode.svg")

Encoding data

The first step is to encode your data to a list of code words.

encode(data, columns=6, security_level=2˙)

Columns

The bar code size can be customized by defining the number of columns used to render the data, between 1 and 30, the default value is 6. A bar code can have a maximum of 90 rows, so for larger data sets you may need to increase the number of columns to decrease the rows count.

codes = encode(text, columns=12)
image = render_image(codes)
image.show()

Security level

Increasing the security level will produce stronger (and more numerous) error correction codes, making the bar code larger, but less prone to corruption. The security level can range from 0 to 8, and procuces 2^(level+1) error correction code words, meaning level 0 produces 2 code words and level 8 produces 512. The default security level is 2.

codes = encode(text, columns=12, security_level=6)
image = render_image(codes)
image.show()

Render image

The render_image function takes the following options:

  • scale - module width, in pixels (default: 3)
  • ratio - module height to width ratio (default: 3)
  • padding - image padding, in pixels (default: 20)
  • fg_color - foreground color (default: #000000)
  • bg_color - background color (default: #FFFFFF)

Note

A module is the smallest element of a barcode, analogous to a pixel. Modules in a PDF417 bar code are tall and narrow.

The function returns a Pillow Image object containing the barcode.

Colors can be specified as hex codes or using HTML color names.

codes = encode(text, columns=3)
image = render_image(codes, scale=5, ratio=2, padding=5, fg_color="Indigo", bg_color="#ddd")
image.show()

Render SVG

The render_svg function takes the following options:

  • scale - module width, in pixels (default: 3)
  • ratio - module height to width ratio (default: 3)
  • padding - image padding, in pixels (default: 20)
  • color - foreground color (default: #000000)

The function returns a ElementTree object containing the barcode in SVG format.

Unlike render_image, this function does not take a background color option. The background is left transparent.

codes = encode(text, columns=3)
svg = render_svg(codes, scale=5, ratio=2, color="Seaweed")
svg.write('barcode.svg')

## See also

Release History

Release History

0.3.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pdf417gen-0.3.0-py2.py3-none-any.whl (22.1 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Sep 4, 2016
pdf417gen-0.3.0.tar.gz (19.0 kB) Copy SHA256 Checksum SHA256 Source Sep 4, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting