Metadata-Version: 2.1
Name: meerk40t-barcodes
Version: 0.2.6
Summary: MeerK40t Barcode Extension
Home-page: https://github.com/meerk40t/meerk40t-barcodes
Author: jpirnay
Author-email: tatarize@gmail.com
License: MIT
Keywords: lasercutter,laser,vector,parser
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Graphics :: Editors :: Vector-Based
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: meerk40t>=0.8.0001
Requires-Dist: qrcode>=7.0
Requires-Dist: python-barcode>=0.10

# meerk40t-barcodes
MeerK40t 0.8+ Barcode extension.


# Barcode-Extension

* Registers the console command: `qrcode` which will generate a qrcode

Usage:    `qrcode x_pos y_pos dim code`

Arguments:
>     x_pos          X-position of qr-code
>     y_pos          Y-position of qr-code
>     dim            Width/length of qr-code
>     code           Text to create qr-code from

Options:
>     --boxsize  (-x)      Boxsize (default 10)
>     --border   (-b)      Border around qr-code (default 4)
>     --version  (-v)      size (1..40)
>     --errcorr  (-e)      error correction, one of L (7%), M (15%), Q (25%), H (30%)

* Registers the console command: `barcode` which will generate a barcode

Usage:    `barcode x_pos y_pos dimx dimy btype code`

Arguments:
>     x_pos     X-Position of barcode
>     y_pos     Y-Position of barcode
>     dim       Width of barcode, may be 'auto' to keep native width
>     dimy      Height of barcode, may be 'auto' to keep native height
>     btype     Barcode type
>     code      The code to process

 Options:
>    --notext  (-n)      suppress text display

* GUI-Support
The installation of this tool will register a new button in the Design section of MeerK40t:
<img width="639" alt="image" src="https://user-images.githubusercontent.com/2670784/232893108-c2f4293c-f084-4d5b-8900-b4cbd74f0e38.png">

If you click on it then a dialog will pop up allowing you to design a qr-code / a barcode:

<img width="258" alt="image" src="https://user-images.githubusercontent.com/2670784/232893402-88694837-370a-4b34-a0b7-e9e2ac83c0bc.png">

This will create an element in Meerk40t that can be treated like any other regular path, but which will allow post-creation change of the underlying code (ie the barcode will be regenerated based on the new input).

<img width="432" alt="image" src="https://user-images.githubusercontent.com/2670784/232892296-c3cbae13-53d8-4143-9667-94cdc31cb4a5.png">

# Installing
* `pip install meerk40t-barcodes`
Or
* Download into a directory:
* `$ pip install .`

# Development

* If you are developing your own extension for meerk40t you will want to use:
* `$ pip install -e .` this installs the python module in edit mode which allows you to easily see and experience your changes. Without reinstalling your module.

# Acknowledgements

* This MeerK40t extension uses the work of two great libraries to create barcodes & QR codes:

- The python-barcode library (https://github.com/WhyNotHugo/python-barcode)
- The qrcode library (https://github.com/lincolnloop/python-qrcode)
