plakativ/README.md

110 lines
3.7 KiB
Markdown
Raw Normal View History

2019-07-04 10:03:30 +00:00
[![Travis Status](https://travis-ci.org/josch/plakativ.svg?branch=master)](https://travis-ci.org/josch/plakativ)
[![Appveyor Status](https://ci.appveyor.com/api/projects/status/32r7s2skrgm9ubva/branch/master?svg=true)](https://ci.appveyor.com/project/josch/plakativ/branch/master)
2019-06-30 23:39:09 +00:00
plakativ
========
Plakativ is German for "striking" or "eye-catching" and comes from the German
word "Plakat" which means poster in English.
2020-06-09 22:17:40 +00:00
This software allows one to stretch a PDF document or raster image across
multiple pages that can then be printed on a common inkjet or laser printer,
cut and glued together into a larger poster.
2019-06-30 23:39:09 +00:00
2019-07-04 10:33:00 +00:00
Features
========
Plakativ allows one to create a poster using one of three different approaches:
2019-07-17 10:01:20 +00:00
- I want a poster that fits into size X
- I want a poster Y times the input page page area
- I have Z pages of paper and want to print the biggest possible poster on them
2019-07-04 10:33:00 +00:00
Plakativ works on Windows, Linux and MacOS. It offers a GUI based on tkinter, a
command line interface and can be used as a Python module. Everything is inside
a single file.
2019-07-04 10:03:30 +00:00
Demo
====
![](demo.gif)
2019-07-04 10:11:56 +00:00
[//]: # (To make a new Video, run:)
[//]: # (ffmpeg -f x11grab -framerate 30 -video_size 800x600 -i :0.0+41,46 -preset ultrafast -c:v libx264 -crf 0 out.mp4)
[//]: # (ffmpeg -i out.mp4 -ss 00:00:04.000 -r 2.5 plakativ%04d.png)
[//]: # (convert -loop 0 plakativ*.png +map -layers Optimize plakativ.gif)
[//]: # (gifsicle -b -O3 plakativ.gif)
2019-07-04 10:03:30 +00:00
2019-07-04 10:33:00 +00:00
The demo shows a user choosing between the three different ways to define the
2019-07-17 10:01:20 +00:00
poster size. Either by picking a size that the input will be fit into, by
2019-07-04 10:33:00 +00:00
multiplying the area of the input page or by maximizing the poster size, given
a number of pages one is willing to print on.
2019-06-30 23:39:09 +00:00
2019-07-17 10:01:20 +00:00
Installation
============
Plakativ is available from pypi: https://pypi.org/project/plakativ/
2019-07-17 10:01:20 +00:00
Thus you can just run `pip install plakativ` on your platform of choice.
For Microsoft Windows users, PyInstaller based .exe files are produced by
appveyor. The resulting artifacts are attached to each release:
https://gitlab.mister-muffin.de/josch/plakativ/releases
2019-07-17 10:01:20 +00:00
Complex Layouter
================
Oftentimes there is a way to create a poster of a specific size with less pages
than would be needed with a regular arrangement of pages into rows and columns.
For regular poster sizes, a more complex layout can save up to 3 or 5 pages of
paper. If the regular simple layout and the complex layout require the same
number of pages for a particular poster size, then plakativ will fall back to
the simple layout. The following animation shows the complex layout that
plakativ chooses when asked to produce the largest possible poster using X
pages. The number of pages X can be seen in the center.
![](layout.gif)
2019-07-04 10:33:00 +00:00
Bugs
====
2019-06-30 23:39:09 +00:00
2019-07-04 10:33:00 +00:00
https://gitlab.mister-muffin.de/josch/plakativ/issues
2019-06-30 23:39:09 +00:00
2019-07-04 10:03:30 +00:00
TODO
====
While basic functionality is implemented, lots of work remains to be done:
- help button
- changing units
- changing language
- make PyMuPDF dependency optional
- optionally, use pypdf2 to read/write PDF
2019-07-04 10:03:30 +00:00
- improve module interface
2019-07-17 10:01:20 +00:00
Comparison to similar software
==============================
PosteRazor
----------
2019-06-30 23:39:09 +00:00
http://posterazor.sourceforge.net/
PosteRazor served as the inspiration for this software. But in contrast to
PosteRazor, plakativ allows PDF documents as input and outputs PDF document
with the exact same quality as the input. It is thus not necessary anymore
to first do a lossy rasterization of an input PDF so that one can work with
PosteRazor.
2019-07-17 10:01:20 +00:00
pdfposter
---------
2019-06-30 23:39:09 +00:00
https://pdfposter.readthedocs.io/en/stable/
- no GUI
- cumbersome box definition
2020-06-09 22:17:40 +00:00
- no page borders for gluing
2019-06-30 23:39:09 +00:00
- superfluous empty pages
- only very simple layouter
2019-07-17 10:01:20 +00:00
- scaling by width/height instead by area makes doubling unintuitive