Skip to main content

Pibooth plugin to customize the final picture layout using Flowchart Maker.

Project description

Python 3.6+ PyPi package PyPi downloads

pibooth-picture-template is a plugin for the pibooth application.

It permits to define the captures/texts positions and sizes using a template. The template file (XML based on mxGraphModel definition) can be easily created/edited using the free online diagram software Flowchart Maker.

Flowchart Maker

A set of templates can be found on GitHub.

The fancy.xml template is automatically installed by this plugin in ~/.config/pibooth/picture_template.xml.

Below are the pictures generated with this one (learn here how to Create a template):

fancy1_landscape

fancy3_landscape

fancy2_landscape

fancy4_landscape

fancy1_portrait

fancy2_portrait

fancy3_portrait

fancy4_portrait

Install

$ pip3 install pibooth-picture-template

Configuration

Here below the new configuration options available in the pibooth configuration. The keys and their default values are automatically added to your configuration after first pibooth restart.

[PICTURE]

# Pictures template path, it should contain 8 pages (4 capture numbers and 2 orientations)
template = picture_template.xml

Picture orientation

A TemplateParserError is raised if the requested orientation for the selected captures number can not be found in the template file.

If [PICTURE][orientation] = auto the best orientation is chosen following these rules:

  • find a template with the correct number of captures and placeholders with same orientation than the captures.

  • find a template with the correct number of captures.

  • find a template with portrait orientation

Create a template

The steps below will show how to create a basic template file from scratch using the Flowchart Maker application.

This file may contain several templates to define the picture layout for 1 / 2 / 3 / 4 captures and portrait / landscape orientations.

Step 1: create a new file

step1_1_create

Click on Create New Diagram.

step1_2_blank

Choose a blank diagram. Modify the name of the diagram, it will be the name of the exported file. Click on Create.

step1_3_size

Select the appropriated paper size. A custom one can be defined in inches.

Step 2: placeholder for captures

step2_1_rectangle

Choose a rectangle to define a capture placeholder. Other shapes have no effect and will be considered as rectangles.

step2_2_rectangle_resize

Resize the rectangle to fit the desired size. The rectangle can overflow the border of the page to make design effects. Up to 4 rectangles can be drawn.

step2_3_numbering

The captures placeholders shall be numbered (1 to 4) to define the captures to be placed inside. Colored shapes give a better overview of the layout but they are not rendered on the final picture.

Step 3: placeholder for texts

step3_1_text

Choose a text box to represent a text placeholder.

step3_2_text_resize

Resize the text box to fit the desired size. Up to 2 text boxes can be drawn depending on the pibooth configuration.

step2_3_numbering

The text placeholders shall be numbered (1, 2, footer_text1 or footer_text2) to define the text to be placed inside.

Step 4: picture resolution

step4_1_property

Extra properties can be set to the template. Click on the button Edit Data (close to the paper size settings). Type dpi in the entry box and click on Add Property.

step4_2_dpi

By default a resolution of 600 DPI is used. It means that the picture size will be 2400x3600 pixels for a resolution of 4x6 inches. Set it to the desired value and click on Apply.

Step 5: add new a template

step5_1_new_template

Once the template is created. A new one can be defined for an other captures number or other orientation. Click on + to add a new page.

step5_2_symetric

The same picture can be used several times in the template to allows a symmetric template for example (one copy for you, one for your guests).

Step 6: save the template file

step6_1_xml

Generate the XML file by clicking File, Export as, XML....

step6_2_export

Click on Export (unselect Compressed if you want to edit the file manually later).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pibooth_picture_template-1.1.0.tar.gz (26.8 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page