Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LukeShortCloud/card_games_converter
A Python program for making printable sheets of cards.
https://github.com/LukeShortCloud/card_games_converter
Last synced: 4 months ago
JSON representation
A Python program for making printable sheets of cards.
- Host: GitHub
- URL: https://github.com/LukeShortCloud/card_games_converter
- Owner: LukeShortCloud
- License: apache-2.0
- Created: 2018-08-26T16:06:15.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-11-05T05:20:19.000Z (over 4 years ago)
- Last Synced: 2024-11-02T14:10:14.390Z (4 months ago)
- Language: Python
- Size: 78.1 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Card Games Converter (CGC)
[](https://travis-ci.org/ekultails/card_games_converter)
This program is used to batch convert standard 2.5 by 3.5 inches playing cards into a printable format. Each card in the `/tmp/cards/` directory will be rotated and have it's pixel per inch density changed to be the actual physical card size. Those card images will then be merged into stacks of 4 vertically. Next, every two stacks of 4 cards are merged horizontally to make a total of up to the maximum of 8 images per page to print. The completed images are saved to `/tmp/cgc/horizontal/`.
This is aimed for use with independent and free card games that are intended for personal use.
## Installation
Install a modern version of [Python 3](https://www.python.org/downloads/). Python 3.6 and above is supported. Stable CGC releases can be manually downloaded from [here](https://github.com/ekultails/card_games_converter/releases). Alternatively, use `pip` to automatically install CGC.
```
$ pip install --user cgc
```
## Usage
* Create the directory `/tmp/cards/` (Linux and macOS) or `C:\TEMP\cards\` (Windows).
* Copy individual images of cards to be printed to that directory.
* Execute the CGC program: `cgc-cli.py`
* Print the resulting pages from `/tmp/cgc/horizontal/` (Linux and macOS) or `C:\TEMP\cgc\horizontal\` (Windows).
* PDF files for each "horizontal" image are saved to `/tmp/cgc/pdfs/`.
### Printing
#### LibreOffice Writer Document
Insert the image to the document and ensure it is the correct size.
```
Insert > Image... > Open
(right click on the image) > Properties... > Width: 7" Height: 10" > OK
```
### CLI
Help options:
`cgc-cli.py --help`
### Python Object
Minimal Python code example:
```
#!/usr/bin/env python3
from cgc.cgc import CGC
cgc = CGC()
cgc.convert_batch_append_all()
```
### Example Usage
#### Star Wars Trading Card Game (Wizards of the Coast)
The [Star Wars Trading Card Game (TCG)](http://starwars.wikia.com/wiki/Star_Wars_Trading_Card_Game) lasted from 2001 to 2005 before being cancelled. It is now unofficially maintained by the [Independent Development Committee (IDC)](https://swtcgidc.wordpress.com/) that continues to make new cards and expansion packs. The latest rulebook explaining how to play can be found [here](https://swtcgidc.wordpress.com/rules/).
Download the "Zipped Card JPGs" archive of an expansion pack of playing cards from [here](https://swtcgidc.wordpress.com/expansions-home/). Extract the archive and copy the desired cards to print into a different folder. Then use CGC to process the cards.
```
$ cgc-cli.py --src /home/user/Documents/cards_to_print/
```
Printable pages of cards with the correct size and pixel density will be created and placed in the directory `/tmp/cgc/horizontal/`.
This utility avoids the need to use the "Printable PDFs" provided for some IDC expansions. Ink and paper are not wasted, a person can print the exact cards they want, and this addresses how not every expansion has "Printable PDFs" available.
## Caching
The cache modes decreases the amount of time to re-process similar images. It was introduced in CGC 1.3.0 and is disabled by default because the cache methods could be unreliable in unknown edge case scenarios. Using cache mode requires to first run CGC at least once.
* name = A simple cache to see if an image name has already been processed.
* sha512 = A checksum check to see if an image has been modified already.
* none (default) = A no-operation to explicitly not use caching.
```
$ cgc-cli.py --cache name
```
# Developers
Refer to the technical design document for more information about the development of CGC.
[cgc_tdd.md](cgc_tdd.md)
All of the cgc.py code should get a perfect 10/10 Pylint score.
```
$ pylint cgc.py
No config file found, using default configuration
------------------------------------
Your code has been rated at 10.00/10
```
## License
Apache v2.0